Contesto sul lato client (riferimento sul lato client)

  • Articolo

 

Data di pubblicazione: novembre 2016

Si applica a: Dynamics CRM 2015

Il codice dovrà funzionare in un contesto in cui una serie di variabili non sono note nella fase di progettazione. L'oggetto del contesto offre metodi per recuperare informazioni specifiche di un'organizzazione o un utente o i parametri passati a una pagina.

L'oggetto di contesto è disponibile nei moduli facendo riferimento a Xrm.Page.context.

Per le risorse Web eseguite all'esterno di un modulo, utilizzare Funzione GetGlobalContext per recuperare un oggetto di contesto.

Proprietà di contesto e metodi

  • client
    Consente di accedere ai metodi getClient, getClientState e getFormFactor che è possibile utilizzare per identificare il client utilizzato, se il client è connesso al server e il tipo di dispositivo utilizzato.

  • getClientUrl
    Restituisce l'URL di base utilizzato per accedere all'applicazione.

  • getCurrentTheme
    Restituisce una stringa che rappresenta il tema Microsoft Office Outlook corrente scelto dell'utente.

  • getIsAutoSaveEnabled
    Restituisce se il Salvataggio automatico è abilitato per l'organizzazione.

  • getOrgLcid
    Restituisce il valore dell'identificativo del codice della lingua che rappresenta la lingua di base per l'organizzazione.

  • getOrgUniqueName
    Restituisce il valore del testo univoco del nome dell'organizzazione.

  • getQueryStringParameters
    Restituisce un oggetto Dictionary delle coppie chiave-valore che rappresentano gli argomenti della stringa di query passati alla pagina.

  • getTimeZoneOffsetMinutes
    Restituisce la differenza tra l'ora locale e l'ora UTC.

    Questo metodo è stato introdotto con Aggiornamento 1 di Microsoft Dynamics CRM Online 2015.

  • getUserId
    Restituisce il GUID del valore SystemUser.Id per l'utente corrente.

  • getUserLcid
    Restituisce il valore LCID che rappresenta la lingua di cui è stato eseguito il provisioning che l'utente ha selezionato come lingua preferita.

  • getUserName
    Restituisce il nome dell'utente corrente.

  • getUserRoles
    Restituisce una matrice di stringhe che rappresenta i valori GUID di ogni ruolo di sicurezza a cui è associato l'utente o tutti i team cui l'utente è associato.

  • prependOrgName
    Antepone il nome dell'organizzazione al percorso specificato.

  • Metodi rimossi
    I metodi rimossi sono obsoleti o sono sostituiti con altri metodi. È necessario verificare che questi metodi non siano utilizzati negli script.

    I metodi getAuthenticationHeader e getServerUrl sono stati dichiarati deprecati con Microsoft Dynamics CRM 2011 e non sono più presenti in Aggiornamento di Microsoft Dynamics CRM 2015 e Microsoft Dynamics CRM Online 2015.

    I metodi isOutlookClient e isOutlookOnline sono stati dichiarati deprecati con Microsoft Dynamics CRM 2013 e non sono più presenti in Aggiornamento di Microsoft Dynamics CRM 2015 e Microsoft Dynamics CRM Online 2015.

client

In Microsoft Dynamics CRM 2013 e Microsoft Dynamics CRM Online è stato aggiunto l'oggetto client contenente i metodi getClientState e getClient per ottenere informazioni sul client.

In Aggiornamento 1 di Microsoft Dynamics CRM Online 2015 è stato aggiunto il metodo getFormFactor.

getClient

Restituisce un valore per indicare il client in cui viene eseguito lo script.

context.client.getClient()

Utilizzare questo invece del metodo isOutlookClient rimosso.

  • Valore restituito
    Tipo: stringa.

    I valori restituiti sono:

    Cliente

    Valore

    Browser

    Web

    Outlook

    Outlook

    Cellulare

    Cellulare

getClientState

Utilizzare questo invece del metodo isOutlookClient rimosso.

Restituisce un valore per indicare lo stato del client.

context.client.getClientState()

  • Valore restituito
    Tipo: stringa.

    I possibili valori restituiti sono:

    Cliente

    Valori restituiti

    Web, Outlook, Mobile

    Online

    Outlook, Mobile

    Offline

getFormFactor

Utilizza questo metodo per ottenere informazioni sul tipo di dispositivo utilizzato dall'utente.

context.client.getFormFactor()

  • Valore restituito
    Tipo: Numero

    I possibili valori restituiti sono:

    Valore

    Elemento del modulo

    0

    Sconosciuto

    1

    Desktop

    2

    Tablet

    3

    Telefono

  • Note
    Questo metodo è stato introdotto con Aggiornamento 1 di Microsoft Dynamics CRM Online 2015

getClientUrl

Restituisce l'URL di base utilizzato per accedere all'applicazione.

context.getClientUrl()

Utilizzare questo invece del metodo getServerUrl rimosso.

I valori restituiti somiglieranno a quelli elencati nella tabella seguente.

Cliente

Valore

Microsoft Dynamics CRM (locale)

http(s)://server/org

Microsoft Dynamics CRM Online

https://org.crm.dynamics.com

Microsoft Dynamics CRM per Outlook con accesso offline in modalità offline

https://localhost:2525
  • Valore restituito
    Tipo: stringa.

getCurrentTheme

Restituisce una stringa che rappresenta il tema Microsoft Office Outlook corrente scelto dell'utente.

Nota

Questa funzione non funziona con Microsoft Dynamics CRM per tablet.

context.getCurrentTheme()
  • Valore restituito
    Tipo: stringa.

Utilizzare queste informazioni per selezionare un tema appropriato per le risorse Web HTML e Silverlight quando sono visualizzate in Microsoft Dynamics CRM per Outlook. Nella tabella seguente sono elencati i valori che possono essere restituiti da questo metodo.

Nota

I moduli non si adattano alle modifiche apportate al tema di Microsoft Office, quindi l'unico caso in cui è possibile adattarsi ai temi di Microsoft Office è quando viene visualizzata una pagina nella navigazione utilizzando una risorsa Web HTML. Anche in questo scenario, le differenze visive possono essere difficili da rilevare.

Valore

Tema

predefinito

Applicazione Web Microsoft Dynamics 365

Office12Blue

Tema Blu di Microsoft Dynamics CRM per Outlook 2007 o 2010

Office14Silver

Tema argento o nero di Microsoft Dynamics CRM per Outlook 2007 o 2010

getIsAutoSaveEnabled

Questo metodo è una novità per Aggiornamento di Microsoft Dynamics CRM 2015 e Microsoft Dynamics CRM Online 2015

Restituisce se il Salvataggio automatico è abilitato per l'organizzazione.

context.getIsAutoSaveEnabled()

  • Valore restituito
    Tipo: booleano

    Nota

    Questa funzione restituisce il set di valori quando la pagina viene aperta. Quando si esegue il test del codice utilizzando questo valore, è necessario aggiornare la pagina dopo aver modificato il valore per ottenere il nuovo valore.

    Ulteriori informazioni:TechNet: Gestire il salvataggio automatico.

getOrgLcid

Restituisce il valore LCID che rappresenta la lingua di base per l'organizzazione.

context.getOrgLcid()

  • Valore restituito
    Tipo: numero

    Esempio: 1033 indica la lingua inglese.Valori LCID (ID impostazioni locali) validi sono disponibili alla pagina Grafico LCID (impostazioni ID locali).

    1033

getOrgUniqueName

Restituisce il valore del testo univoco del nome dell'organizzazione.

context.getOrgUniqueName()

  • Valore restituito
    Tipo: stringa.

    Esempio: questo valore corrispondente al valore del nome dell'organizzazione

    "adventureworkscycle"

getQueryStringParameters

Restituisce un oggetto Dictionary delle coppie chiave-valore che rappresentano gli argomenti della stringa di query passati alla pagina.

context.getQueryStringParameters()
  • Valore restituito
    Tipo: oggetto.

getTimeZoneOffsetMinutes

Restituisce la differenza tra l'ora locale e l'ora UTC.

Nota

Questo metodo è stato introdotto con Aggiornamento 1 di Microsoft Dynamics CRM Online 2015.

context.getTimeZoneOffsetMinutes()
  • Valore restituito
    Tipo: Numero

getUserId

Restituisce il GUID del valore SystemUser.Id per l'utente corrente.

context.getUserId()

  • Valore restituito
    Tipo: stringa.

    Esempio:

    "{B05EC7CE-5D51-DF11-97E0-00155DB232D0}"

getUserLcid

Restituisce il valore LCID che rappresenta il Language Pack di Microsoft Dynamics CRM selezionato dall'utente come lingua preferita.

context.getUserLcid()

  • Valore restituito
    Tipo: numero

    Esempio: 1041 indica la lingua giapponese.Valori LCID (ID impostazioni locali) validi sono disponibili alla pagina Grafico LCID (impostazioni ID locali).

    1041

getUserName

Restituisce il nome dell'utente corrente.

context.getUserName()
  • Valore restituito
    Tipo: stringa.

getUserRoles

Restituisce una matrice di stringhe che rappresenta i valori GUID di ogni ruolo di sicurezza a cui è associato l'utente o tutti i team cui l'utente è associato.

Per ulteriori informazioni sui ruoli di sicurezza, vedere Come usare la sicurezza basata sui ruoli per controllare l'accesso alle entità in Microsoft Dynamics CRM 2015.

context.getUserRoles()

  • Valore restituito
    Tipo: matrice

    Esempio: questo utente dispone di un solo ruolo di sicurezza associato al proprio account utente. La rappresentazione JSON di questa matrice con un valore singolo è:

    ["cf4cc7ce-5d51-df11-97e0-00155db232d0"]

prependOrgName

Antepone il nome dell'organizzazione al percorso specificato.

context.prependOrgName(sPath)

  • Argomenti
    Tipo: stringa.

    Un percorso locale a una risorsa.

  • Valore restituito
    Tipo: stringa.

    Il valore restituito segue questo modello:

    "/"+ OrgName + sPath

Metodi rimossi

I metodi rimossi sono obsoleti o sono sostituiti con altri metodi. È necessario verificare che questi metodi non siano utilizzati negli script.

I seguenti metodi sono stati dichiarati deprecati con le versioni precedenti di Microsoft Dynamics 365 e non sono più presenti nella versione corrente:

  • getAuthenticationHeader
    Questo metodo supportava l'utilizzo dei servizi Web di Microsoft Dynamics CRM 4.0 che non esistono più.

  • getServerUrl
    Questo metodo è stato sostituito da getClientUrl.

  • isOutlookClient
    Questo metodo è stato sostituito da client.getClient.

  • isOutlookOnline
    Questo metodo è stato sostituito da client.getClientState.

Vedere anche

Funzione GetGlobalContext e ClientGlobalContext.js.aspx (riferimento sul lato client)
Riferimento rapido dello scripting dei moduli
Creare il codice per moduli di Microsoft Dynamics CRM 2015
Utilizzare il modello a oggetti Xrm.Page
Riferimento programmazione sul lato client

© 2017 Microsoft. Tutti i diritti sono riservati. Copyright