Parametri sostitutivi

Data di pubblicazione: novembre 2016

Si applica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2013, Dynamics CRM 2015, Dynamics CRM 2016

I parametri sostitutivi possono essere utilizzati nell'applicazione per effettuare il pull dei dati da elementi dati (denominati parametri dati) acquisiti durante l'esecuzione dell'applicazione che aumentano e includono il contesto di Unified Service Desk. Il contesto è costituito da coppie nome/valore stringa che cambiano frequentemente in quanto i dati vengono individuati in vari modi durante l'utilizzo dell'applicazione. I parametri sostitutivi vengono utilizzati per varie attività come la specifica delle stringhe di query dell'URL, la generazione dell'output di script negli scriptlet, la specifica dei valori di ricerca per le ricerche in entità, l'integrazione CTI e la specifica dell'input per le azioni chiamate su altri controlli ospitati. I parametri sostitutivi sono gli elementi chiave che consentono un alto livello di configurazione o di personalizzazione in Unified Service Desk senza dover utilizzare il codice.

Per informazioni su come utilizzare i parametri sostitutivi per configurare l'applicazione dell'agente, vedere Utilizzare i parametri sostitutivi per configurare Unified Service Desk.

In questo argomento

Visualizzare i parametri sostitutivi in Unified Service Desk

Parametri sostitutivi di sistema

Visualizzare i parametri sostitutivi in Unified Service Desk

Il controllo Debugger nell'applicazione client può essere utilizzato per visualizzare l'elenco dei parametri sostitutivi disponibili in un dato momento.

1. Avviare il client di Unified Service Desk e accedere a Microsoft Dynamics 365 dove sono stati installati i pacchetti di esempio.

2. Nella schermata principale del client Unified Service Desk fare clic sulla freccia in giù accanto all'icona a ingranaggio nell'angolo superiore destro e selezionare Debug. Verrà visualizzato la finestra del debugger.

   

3. In questa finestra fare clic su Parametri dati per visualizzare i parametri sostitutivi.

   

Per rappresentare le variabili disponibili è utilizzata una visualizzazione albero. Quando si specifica la variabile, specificare il nome al livello radice, seguito da un punto (.) e dal nome nell'elenco. Di seguito sono riportati alcuni esempi.

• [[$Session.IsGlobal]]

• [[$User.fullname]]

Questi valori cambieranno man mano che l'utente interagirà con il client Unified Service Desk. Gli inviti all'azione prenderanno il valore corrente e lo utilizzeranno nel relativo elenco di parametri o in qualsiasi altra posizione in cui possa essere utilizzato. Ogni volta che le variabili vengono aggiornate, un evento NotifyContextChange viene generato nei controlli di base anche se il contesto di Unified Service Desk non è cambiato. Questo consente a funzionalità come le Righe sessione di controllare nuovamente i valori dei parametri sostitutivi per verificare l'eventuale necessità di aggiornare le visualizzazioni.

Parametri sostitutivi di sistema

I parametri sostitutivi di sistema sono i parametri sostitutivi definiti e popolati dal sistema. I nomi di questi parametri iniziano con il simbolo $ per distinguerli dai parametri sostitutivi definiti dall'utente. Ad esempio: $Global. In Unified Service Desk sono presenti i parametri di sostituzione seguenti:

• $Context

• $Debug

• $Global

• $Panel

• $Resources

• $Return

• $Session

• $Settings

• $Subject

• $SystemParameters

• $User

$Context

Questa sezione contiene il contenuto del contesto della sessione User Interface Integration (UII) e fornisce in modo conveniente per utilizzare le variabili di contesto della sessione UII nell'applicazione Unified Service Desk.

$Debug

È un valore sostitutivo speciale utilizzato solo nello Scriptlet per determinare se viene chiamato dalla finestra di debug. Soprattutto quando gli scriptlet causano l'esecuzione di azioni sul sistema, questo parametro viene testato per determinare se è possibile ignorare il blocco di codice per evitare effetti collaterali durante il debug. Il seguente scriptlet avvia il controllo ospitato Account e visualizza la scheda quando viene aperta la finestra di debug.

CRMGlobalManager.GetApp(“Account”);

Questo perché gli script sono eseguiti nel contesto corrente per determinare i relativi valori dello stato corrente del sistema. Per evitare questo effetto collaterale, attenersi a quanto segue.

If ([[$Debug]]!= true) CRMGlobalManager.GetApp(“Account”);

Questo eviterà l'effetto collaterale e fornirà comunque le informazioni utili al debugger.

$Global

Questa sezione viene aggiunta automaticamente per visualizzare tutte le opzioni configurate in Opzioni di Dynamics 365 e i rispettivi valori. In questo modo è possibile accedere facilmente alle opzioni in quanto possono essere utilizzate per controllare l'esecuzione o per controllare i comportamenti creati nei flussi di lavoro o negli inviti all'azione. Tutti i flag di controllo sono visibili automaticamente da questa sezione.

$Panel

Il parametro sostitutivo $Panel contiene tutti i controlli ospitati e i relativi nomi riquadro correnti coppie chiave-valore spostate in un altro riquadro dopo aver avviato per l'ultima volta il client Unified Service Desk. Il parametro sostitutivo sarà disponibile solo se almeno un controllo ospitato ha modificato i riquadri dopo aver avviato l'ultima volta il client Unified Service Desk. Tutti gli altri controlli ospitati e i relativi riquadri esistenti attualmente caricati nell'Agent Desktop non sono disponibili nel parametro sostitutivo.

$Resources

Questa raccolta di parametri sostitutivi viene popolata dal Responsabile globale con gli identificatori di lingua. Nella configurazione del controllo ospitato del Responsabile globale è possibile specificare diverse risorse di lingua. Queste risorse sono file .resx ma vengono caricati nelle risorse Web come file XML. Durante il caricamento dell'applicazione, in Unified Service Desk verranno lette le impostazioni di lingua correnti da Dynamics 365 e verrà cercata la lingua nell'elenco delle lingue del Responsabile globale. Se l'elemento è disponibile, la risorsa di identificatori di lingua verrà caricata nella raccolta$Resources.

Ovunque si desideri fornire testo in lingua neutrale nell'output, è possibile utilizzare i parametri sostitutivi dalla raccolta $Resources. Ad esempio, è possibile utilizzare quanto segue per il testo del pulsante.

[[$Resources.MyButtonName]+]

A seconda della lingua selezionata per l'utente, viene utilizzato il testo localizzato appropriato.

È importante notare anche che questi parametri sostitutivi e, di conseguenza, i file .resx caricati possono contenere la sintassi stessa di parametro sostitutivo. Una volta che i valori di $Resources sono sostituiti, vengono controllati nuovamente alla ricerca di parametri sostitutivi aggiuntivi. In questo modo, se si forniscono stringhe specifiche della lingua, è possibile sostituire anche i dati del resto dell'applicazione in questa stringa.

Per informazioni sull'aggiunta di risorse localizzate per configurare Unified Service Desk, vedere Aggiungere il supporto multilingua per le applicazioni agente.

$Return

Alcune azioni restituiscono un valore stringa. Questo valore stringa viene inserito nel parametro sostitutivo $Return utilizzando il nome dell'invito all'azione. Segue questo modello:

[[$Return.ActionCallName]]

Un esempio consiste nel chiamare CreateEntity sul Responsabile globale. Verrà creato un record in Dynamics 365 e verrà restituito il GUID del nuovo record. Questo nuovo GUID sarà disponibile nell'elenco dei parametri sostitutivi $Return e può essere utilizzato come input per l'azione successiva.

$Session

La sezione $Session espone le variabili utili richieste dagli inviti all'aazione, ad esempio il numero della sessione, se la sessione attiva è globale, l'ID sessione attualmente attivo. Il valore di StartTime può essere utilizzato per scrivere l'ora di inizio di un attività. Questa sezione viene popolata automaticamente.

$Settings

In questa sezione sono fornite le impostazioni utente applicabili solo all'utente corrente. Queste impostazioni vengono caricate automaticamente all'avvio e possono essere lette tramite un invito all'azione in fase di esecuzione. Includono spesso impostazioni per la selezione del tema da parte dell'utente ma possono fornire l'accesso a tutte le impostazioni specifiche dell'utente che il configuratore desidera rendere disponibili.

Le impostazioni utente vengono definite nell'area Impostazioni utente (Impostazioni > Impostazioni utente) in Dynamics 365 durante la configurazione di Unified Service Desk.

Queste impostazioni possono essere utilizzate come qualsiasi altro parametro sostitutivo nel sistema. Il controllo ospitato del Responsabile globale fornisce un'azione, SaveSetting, che determinerà la scrittura delle impostazioni utente nel server, purché l'utente disponga dell'accesso in scrittura. Questo metodo può essere utilizzato per archiviare preferenze specifiche dell'utente, come la selezione del tema e i layout.

$Subject

Una funzionalità utile in Unified Service Desk consiste nel popolamento automatico dell'albero degli argomenti in un nuovo caso che viene creato per conto dell'utente. Talvolta è possibile che si desideri popolare automaticamente il campo dell'argomento ma occorre sapere quali valori utilizzare, in quanto i valori possono variare a seconda del sistema.

Con questa voce è possibile fare riferimento a un argomento specifico quando si crea il caso, utilizzando il parametro sostitutivo seguente.

[[$Subject.Default Subject.Id]][[$Subject.Default Subject.LogicalName]]

$SystemParameters

Questa sezione include una variabile chiamataHighContrast che viene visualizzata se la modalità a contrasto elevato di Windows è abilitata o meno (true/false). Puoi utilizzare questa variabile per indicare se desideri abilitare i colori personalizzati normali o i colori di sistema (compatibili con l'impostazione del contrasto elevato) quando personalizzi il tema nel client.Ulteriori informazioni:Customize themes for High Contrast settings

$User

Questo gruppo di parametri sostitutivi viene popolato automaticamente con il contenuto del record dell'utente corrente in Dynamics 365. Ad esempio, se l'amministratore estende l'entità utente di sistema in Dynamics 365 per includere un ID agente, tale ID verrà visualizzato nell'elenco. Può essere utilizzato per configurare le impostazioni utente speciali.

Vedere anche

Utilizzare i parametri sostitutivi per configurare Unified Service Desk
Eseguire script utilizzando gli scriptlet in Unified Service Desk
Cercare i dati utilizzando ricerche di entità in Unified Service Desk
Imparare a utilizzare Unified Service Desk
Responsabile globale (controllo ospitato)

Unified Service Desk 2.0

© 2017 Microsoft. Tutti i diritti sono riservati. Copyright