Contesto sul lato client (riferimento sul lato client)

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.

• Valore restituito
  Tipo: stringa.

getCurrentTheme

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

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.

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.

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