Responsabile globale (controllo ospitato)

Data di pubblicazione: novembre 2016

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

Il tipo di controllo ospitato Responsabile globale è il centro di Unified Service Desk e un'istanza del controllo ospitato è necessaria per Unified Service Desk. Il controllo ospitato carica e legge tutti i dati di configurazione di Unified Service Desk da Microsoft Dynamics 365 all'avvio dell'applicazione, interpreta le regole di spostamento finestra, fornisce dati ai componenti della barra degli strumenti e agli script agente e gestisce i dati della sessione. È possibile caricare una sola istanza del tipo di controllo ospitato Responsabile globale.

Importante

I tre pacchetti di applicazioni di esempio per Unified Service Desk, New Environment, CRM Web Client e Interactive Service Hub vengono preconfigurati con un'istanza del tipo di controllo ospitato Responsabile globale. Per informazioni sulle applicazioni di esempio, vedi TechNet: Distribuire le applicazioni Unified Service Desk di esempio nel server CRM utilizzando Package Deployer.

Oltre a fornire l'interpretazione per la maggior parte delle funzioni in Unified Service Desk, il tipo di controllo ospitato Responsabile globale fornisce le funzionalità multilingue nel sistema in modo da poter localizzare in più lingue stringhe e messaggi dell'interfaccia utente nell'applicazione. Per ulteriori informazioni, vedere Aggiungere il supporto multilingua per le applicazioni agente. Fornisce inoltre il provider di ricerca, che è progettato per essere generico e adattabile tramite la configurazione.

In questo argomento

Creare un controllo ospitato Responsabile globale

Azioni UII predefinite

Eventi predefiniti

Creare un controllo ospitato Responsabile globale

Durante la creazione di un nuovo controllo ospitato, i campi della schermata Nuovo controllo ospitato variano in base al tipo di controllo ospitato che si desidera creare. In questa sezione sono incluse informazioni sui campi specifici esclusivi del tipo di controllo ospitato Responsabile globale. Per informazioni dettagliate sulla creazione di un controllo ospitato, vedere Creare o modificare un controllo ospitato.

Controllo ospitato Responsabile globale

Nella schermata Nuovo controllo ospitato, nell'area Unified Service Desk selezionare Responsabile globale nell'elenco a discesa Tipo componente USD. Inoltre, verifica di aver impostato il valore Ordinamento del controllo ospitato su 2 per garantire che venga caricato dall'applicazione dell'agente immediatamente dopo avere stabilito la connessione a Dynamics 365 tramite il controllo ospitato Gestione connessione. Per informazioni su altri campi Generale, vedere Creare o modificare un controllo ospitato.

Dopo il salvataggio del record, l'area Servizi lingua sarà disponibile per aggiungere le risorse per l'aggiunta di stringhe localizzate per l'interfaccia utente dell'applicazione dell'agente. Per informazioni su come aggiungere le risorse della lingua, vedere Aggiungere il supporto multilingua per le applicazioni agente.

Azioni UII predefinite

Responsabile globale fornisce una serie di azioni predefinite che consentono di modificare i dati dei record Dynamics 365 tramite i servizi Web. Queste possono essere utilizzate durante la configurazione per eseguire funzioni avanzate in Dynamics 365.

Le seguenti azioni di UII predefinite sono disponibili per il tipo di controllo ospitato Responsabile globale:

Controllo

Aggiunge una voce di controllo nei registri di controllo di Unified Service Desk. Per ulteriori informazioni, vedi Technet: Configurare il controllo in Unified Service Desk

Parametro	Descrizione
Nome	Nome della voce di controllo. Devi aggiungere un'opzione nell'area Opzioni (Impostazioni > Unified Service Desk > Opzioni (Come ci arrivo?)) con il valore impostato su 1.
Azione	Stringa che rappresenta l'azione sottoposta al controllo.
TargetApplication	Stringa che rappresenta l'applicazione di destinazione per il controllo.
CustomerId	Stringa che rappresenta l'ID cliente.
ContextId	Stringa che rappresenta l'ID contesto.
ApplicationId	GUID del controllo ospitato per il controllo.
AgentState	Stringa che rappresenta lo stato dell'agente
ActionData	Si tratta dei dati da scrivere nella voce di controllo. Se questo parametro non viene specificato in modo esplicito, utilizzerà tutte le righe rimanenti nel campo Dati della definizione dell'invito all'azione.

CallDoAction

Chiama un'azione in un altro controllo ospitato.

Parametro	Descrizione
panel	Questo è il pannello per trovare l'applicazione attiva, se non viene specificata alcuna applicazione.
azione	Si tratta dell'azione da chiamare nel controllo ospitato.
Dati di	Questo è il parametro dati da passare all'azione.
application	Si tratta del nome del controllo ospitato in cui si desidera eseguire un invito all'azione. Se specificato, il parametro panel viene ignorato.

ClearAppBar

Annulla l'ancoraggio del controllo ospitato specificato nell'applicazione client.

Parametro	Descrizione
ApplicationName	Nome del controllo ospitato di cui si annulla l'ancoraggio. Se questo parametro non viene specificato, viene annullato l'ancoraggio della finestra principale dell'applicazione client.

ClearEntityList

Cancella l'elenco dei risultati della ricerca accumulati e deve essere sempre chiamato prima dell'azione DoSearch

Parametro	Descrizione
global	True se si desidera che i risultati di ricerca legati alla sessione globale vengano cancellati. Prestare attenzione quando si archiviano i risultati della ricerca nella sessione globale in quanto essi non vengono automaticamente cancellati dal sistema. In questo caso, è necessario chiamare l'azione ClearEntityList prima dell'azione DoSearch.

Chiusura

Chiude il controllo ospitato. A differenza dell'azione CloseActive se in questa scheda viene visualizzata più di una pagina, tutte le pagine visualizzate nella scheda verranno chiuse nell'applicazione dell'agente.

CloseActive

Chiude il controllo ospitato attivo nel pannello specificato.

Parametro	Descrizione
	La prima riga dell'invito all'azione deve contenere il nome del pannello per individuare l'applicazione attiva. Se non viene specificato alcun parametro, si utilizza MainPanel.

CopyToClipboard

Copia o aggiunge l'URL dell'articolo negli Appunti.

Parametro	Descrizione
Dati di	Dati che desideri copiare. Puoi inoltre utilizzare i parametri sostitutivi. Ad esempio: data=[[$context.title]]
append	Indica se aggiungere o meno i dati negli Appunti. Imposta true o false. Ad esempio: append=false.

CopyToContext

Copia un valore o una serie di valori nelle variabili di contesto. Le variabili di contesto possono essere serializzate con la sessione. Questa azione accetta una serie di coppie name=value, dove name è il nome della variabile di contesto.

CopyLogicalEntityToContext

Copia i valori da un'intera sezione dei parametri dati nel contesto.

Parametro	Descrizione
LogicalName	Tipo o sezione dei parametri dati da cui copiare i valori.

CloseActivity

Chiude un record di attività in Dynamics 365.

Parametro	Descrizione
ID	GUID del record relativo all'impegno da chiudere.
LogicalName	Nome logico dell'impegno da chiudere.
StatusCode	Nome visualizzato del codice di stato finale dopo la chiusura dell'impegno.
StateCode	Nome visualizzato del codice di stato finale dopo la chiusura dell'impegno.

Ad esempio, per chiudere un impegno di tipo Telefonata, è necessario specificare quanto segue:

Id=<GUID of the phone activity record>
LogicalName=phonecall
statuscode=Received
statecode=Completed

Dopo la chiusura del record relativo all'impegno, il parametro sostitutivo di sistema $Return verrà popolato con un valore booleano che indica se l'azione è stata completata.

CreateEntity

Crea un nuovo record in Dynamics 365.

Parametro	Descrizione
LogicalName	Nome logico dell'entità da creare.

Ogni riga successiva nell'elenco di parametri contiene una serie di coppie Name=Value che definiranno gli altri campi da compilare alla creazione.

I riferimenti a entità possono essere descritti come di seguito:

Param=EntityReference(“logicalname”, “id”)

È possibile specificare OptionSetValue come di seguito:

Param=OptionSetValue(value)

È possibile descrivere Boolean come di seguito:

Param=Boolean(value)

PartyList (utilizzato con la posta elettronica) può essere descritto come di seguito:

Param=PartyList(email[“test@test.com”], er[“contact”, guid])

Puoi utilizzare un numero indefinito di voci email ed er per rappresentare gli indirizzi di posta elettronica e i riferimenti a entità, rispettivamente.

Altri valori come i valori stringa possono essere specificati come di seguito:

Param=value

Una volta creato il record, il valore $Return verrà popolato con il GUID del record appena creato.

CreateSession

Crea una sessione.

DeleteEntity

Elimina un record in Dynamics 365.

Parametro	Descrizione
ID	ID del valore da eliminare. Deve essere il GUID del record da eliminare.
LogicalName	Nome logico dell'entità da eliminare.

DoRoute

Può essere utilizzato per testare le regole di spostamento finestre simulando una finestra di popup da un controllo ospitato specifico. Può essere utilizzata in produzione per attivare le regole di spostamento finestre manualmente secondo il requisito.

Parametro	Descrizione
nome	ID dell'entità a cui è destinato queueItem
entità	Nome logico dell'entità che viene aperta in una finestra popup.
ID	ID dell'entità che viene aperta in una finestra popup.
frame	Frame da cui viene generato il popup.

DoSearch

Chiama i servizi Web Dynamics 365 utilizzando FetchXML definito come ricerca di entità in Unified Service Desk. Per ulteriori informazioni sulla definizione di una ricerca di entità, vedi Cercare i dati utilizzando ricerche di entità in Unified Service Desk.

Parametro	Descrizione
name	Nome della ricerca in più entità da utilizzare per la ricerca di record.
global	True se si desidera che i risultati di ricerca legati alla sessione globale vengano cancellati. Prestare attenzione quando si archiviano i risultati della ricerca nella sessione globale in quanto essi non vengono automaticamente cancellati dal sistema. In questo caso, è necessario chiamare l'azione ClearEntityList prima di chiamare questa azione.
maxcount	Numero massimo di record da archiviare nei risultati EntityList della chiamata.

Nota

Per impostazione predefinita, il numero della pagina (numero di record per pagina) per un set di risultati è impostato su 50. Questo implica che se vengono restituiti più di 50 record, vengono visualizzate più pagine. Per specificare un valore di conteggio pagine diverso per l'azione DoSearch, specifica il nuovo valore nell'opzione EntitySearchPageCount.Ulteriori informazioni:TechNet: Gestire le opzioni per Unified Service Desk

Quando chiami l'azione DoSearch, il parametro sostitutivo $Return visualizza il numero di record rilevati e archiviati in EntityList come risultato di questa ricerca.Ulteriori informazioni:$Return.

DisplayMessage

Visualizza una finestra del messaggio all'utente.

Parametro	Descrizione
testo	Questo è il testo visualizzato nella finestra del messaggio. Se non si specifica questo parametro, verrà utilizzato l'eventuale testo rimanente (parametro rimanente) o una stringa vuota.
caption	Questa è la didascalia visualizzata nella finestra del messaggio. Se non viene specificata una didascalia, verrà utilizzato Messaggio Dynamics 365.

ExecuteOnDataAvailable

Ritarda l'esecuzione delle azioni secondarie finché non diventa disponibile un set specifico di parametri sostitutivi. Un valore di timeout può essere specificato per limitare la quantità di tempo in attesa della disponibilità dei parametri sostitutivi. Se non si specifica il timeout, si attende all'infinito o fino al termine della sessione.Ulteriori informazioni: Blog: Come utilizzare le azioni speciali, ExecuteOnTimeout, ExecuteOnDataAvailable, ExecuteOnExpressionTrue

Parametro	Descrizione
millisecondi	Il tempo, in millisecondi, per indicare la quantità di tempo di attesa prima della scadenza e dell'annullamento di questa azione. I parametri rimanenti devono contenere i parametri sostitutivi che devono esistere prima dell'esecuzione delle azioni secondarie. Esempio di parametro dati: millisecondi=5000 [[account.Id]] [[incident.Id]]

millisecondi

Il tempo, in millisecondi, per indicare la quantità di tempo di attesa prima della scadenza e dell'annullamento di questa azione. I parametri rimanenti devono contenere i parametri sostitutivi che devono esistere prima dell'esecuzione delle azioni secondarie.

Esempio di parametro dati:

millisecondi=5000
[[account.Id]]
[[incident.Id]]

Importante

Questa azione si applica a tutti i tipi di controllo ospitato. Questa azione non viene esposta per impostazione predefinita quando crei un'istanza di un tipo di controllo ospitato. Per utilizzare l'azione ExecuteOnDataAvailable con un'istanza di un tipo di controllo ospitato devi esplicitamente aggiungere un'azione UII chiamata ExecuteOnDataAvailable alla rispettiva istanza del controllo ospitato.Ulteriori informazioni:Aggiungere un'azione UII a un controllo ospitato

ExecuteOnTimeout

Ritarda l'esecuzione delle azioni secondarie fino a un'ora specificata. Un valore di timeout è necessario per specificare quando le azioni secondarie devono essere eseguite.Ulteriori informazioni: Blog: Come utilizzare le azioni speciali, ExecuteOnTimeout, ExecuteOnDataAvailable, ExecuteOnExpressionTrue

Parametro	Descrizione
millisecondi	Il tempo, in millisecondi, per indicare la quantità di tempo di attesa prima dell'esecuzione delle azioni secondarie. Esempio di parametro dati: millisecondi=5000

millisecondi

Il tempo, in millisecondi, per indicare la quantità di tempo di attesa prima dell'esecuzione delle azioni secondarie.

Esempio di parametro dati:

millisecondi=5000

Importante

Questa azione si applica a tutti i tipi di controllo ospitato. Questa azione non viene esposta per impostazione predefinita quando crei un'istanza di un tipo di controllo ospitato. Per utilizzare l'azione ExecuteOnTimeout con un'istanza di un tipo di controllo ospitato devi esplicitamente aggiungere un'azione UII chiamata ExecuteOnTimeout alla rispettiva istanza del controllo ospitato.Ulteriori informazioni:Aggiungere un'azione UII a un controllo ospitato

ExecuteOnExpressionTrue

Ritarda l'esecuzione delle azioni secondarie finché un'espressione JavaScript specifica restituisce true. Un valore di timeout può essere specificato per limitare il periodo di tempo di attesa prima della scadenza. Se non si specifica il timeout, si attende all'infinito o fino al termine della sessione.Ulteriori informazioni: Blog: Come utilizzare le azioni speciali, ExecuteOnTimeout, ExecuteOnDataAvailable, ExecuteOnExpressionTrue

Parametro	Descrizione
millisecondi	Il tempo, in millisecondi, per indicare la quantità di tempo di attesa prima della scadenza e dell'annullamento di questa azione. Il parametro rimanente è un'espressione JavaScript da calcolare. Se questa espressione è true, le azioni secondarie vengono eseguite. Esempio di parametro dati: milliseconds=5000 function IsAccountLoaded() { return “[[account.Id]$+]” != “”; } IsAccountLoaded();

millisecondi

Il tempo, in millisecondi, per indicare la quantità di tempo di attesa prima della scadenza e dell'annullamento di questa azione. Il parametro rimanente è un'espressione JavaScript da calcolare. Se questa espressione è true, le azioni secondarie vengono eseguite.

Esempio di parametro dati:

milliseconds=5000
function IsAccountLoaded()
{
return “[[account.Id]$+]” != “”;
}
IsAccountLoaded();

Importante

Questa azione si applica a tutti i tipi di controllo ospitato. Questa azione non viene esposta per impostazione predefinita quando crei un'istanza di un tipo di controllo ospitato. Per utilizzare l'azione ExecuteOnExpressionTrue con un'istanza di un tipo di controllo ospitato devi esplicitamente aggiungere un'azione UII chiamata ExecuteOnExpressionTrue alla rispettiva istanza del controllo ospitato.Ulteriori informazioni:Aggiungere un'azione UII a un controllo ospitato

ExecuteScriptlet

Esegue lo scriptlet specificato.

Parametro	Descrizione
	Specificare il nome dello scriptlet da eseguire nel campo Dati.

FireEvent

Genera un evento definito dall'utente dal controllo ospitato.

Parametro	Descrizione
nome	Nome dell'evento definito dall'utente.

Tutte di coppie successive di name=value diventano i parametri dell'evento. Per ulteriori informazioni sulla creazione di un evento definito dall'utente, vedere Creare un evento definito dall'utente.

GetTemplate

Recupera il contenuto di un modello e-mail unito.

Parametro	Descrizione
nome	Nome del modello da recuperare.
ID	ID dell'entità da associare a questo modello per l'operazione di unione.

InvokeCTI

Simula eventi di CTI

Parametro	Descrizione
tipo	Questo è il tipo di evento CTI, ad esempio telefonata o chat.
appname	Nome del responsabile desktop da utilizzare per questa simulazione di popup.
ani	ANI (Automatic Number Identification) o numero di telefono del chiamante.
dnis	DNIS o numero composto.
	Tutti i parametri rimanenti saranno passati come parametri al processore di eventi CTI.

LaunchURL

Avvia un URL in Internet Explorer esternamente all'applicazione Unified Service Desk. Devi specificare l'URL come parametro nel campo Dati.

LookupQueueItem

Cerca queueitem nel sistema e ottiene le informazioni.

Parametro	Descrizione
ID	ID dell'entità a cui è destinato queueItem
EntityType	Tipo o nome logico dell'entità a cui si fa riferimento nel campo ID.

I dettagli risultanti di queueitem verranno posizionati nel parametro sostitutivo di queueitem e vi si potrà fare riferimento in seguito.

MoveApplicationToPanel

Sposta un controllo ospitato nel pannello specificato nell'applicazione client.

Parametro	Descrizione
applicazione	Nome del controllo ospitato da spostare.
panel	Nome del pannello di destinazione.

MoveToPanel

Sposta i controlli ospitati tra i pannelli in fase di esecuzione.

Parametro	Descrizione
applicazione	Nome del controllo ospitato da spostare.
panel	Pannello di destinazione del controllo ospitato.

New_CRM_Page

Crea una pagina per la creazione di un nuovo record di Dynamics 365 dell'entità specificata e la considera come una pagina di popup dal controllo ospitato specificato. Le regole di spostamento finestre sono valutate per determinare la posizione in cui viene visualizzata la pagina per creare il record dell'entità.

Parametro	Descrizione
LogicalName	Nome logico dell'entità per creare una nuova istanza.

Nota

Il resto dei parametri deve essere costituito da coppie name=value. Sono i valori aggiuntivi già popolati nel modulo per la creazione di un nuovo record per l'entità specificata. Per ulteriori informazioni sull'uso di questa azione, vedere il passaggio 4 in Procedura dettagliata 7: configurare lo scripting dell'agente nell'applicazione dell'agente.

Open_CRM_Page

Apre un'istanza esistente dell'entità specificata e identificata dall'ID e considera la pagina come un popup dal controllo ospitato specificato. Le regole di spostamento finestre vengono valutate per determinare la posizione in cui deve essere visualizzata la finestra di popup.

Parametro	Descrizione
LogicalName	Nome logico dell'entità da aprire.
ID	ID del record dell'entità da aprire.

Sospendi

Sospende l'esecuzione dell'azione senza bloccare l'elaborazione dei messaggi. Questa azione è diversa dalla sospensione del thread corrente per la quantità di tempo specificata (Thread.Sleep) perché l'azione consente di continuare l'elaborazione. Questa azione è utile durante l'attesa del completamento di operazioni Web.

Parametro	Descrizione
millisecondi	Numero di millisecondi di pausa.

Visualizza un URL dal controllo ospitato ed esegue le regole di spostamento finestre su di esso per indirizzare il popup nella posizione appropriata.

Parametro	Descrizione
URL	Indirizza un popup da questo controllo ospitato utilizzando questo URL come se fosse un popup richiesto dal controllo visualizzato.
frame	Frame da cui ha avuto origine il popup.

RealignWindow

Visualizza il controllo ospitato nella posizione specificata su un monitor. Puoi visualizzare un controllo ospitato su un massimo di due monitor. Questa azione è applicabile per le istanze di controlli ospitati configurate per essere posizionate in un tipo di pannello USDFloatingPanel o USDFloatingToolPanel.

Parametro	Descrizione
screen	Specifica lo schermo su cui visualizzare il controllo ospitato. I valori validi sono 1 o 2. Se non specifichi questo parametro, per impostazione predefinita viene passato il valore 1.
left	Specifica la posizione, in percentuale, dalla sinistra dello schermo al monitor di destinazione in cui deve essere visualizzato il controllo ospitato. I valori validi sono compresi tra 0 e 100. Se non specifichi questo parametro, per impostazione predefinita viene passato il valore 0.
top	Specifica la posizione, in percentuale, dalla parte superiore dello schermo al monitor di destinazione in cui deve essere visualizzato il controllo ospitato. I valori validi sono compresi tra 0 e 100. Se non specifichi questo parametro, per impostazione predefinita viene passato il valore 0.
width	Specifica la larghezza, in percentuale, della finestra del controllo ospitato sul monitor di destinazione. I valori validi sono compresi tra 1 e 100. Se non specifichi questo parametro, per impostazione predefinita viene passato il valore 100.
height	Specifica l'altezza, in percentuale, della finestra del controllo ospitato sul monitor di destinazione. I valori validi sono compresi tra 1 e 100. Se non specifichi questo parametro, per impostazione predefinita viene passato il valore 100.

ReadSettings

Vengono lette le impostazioni salvate in precedenza dal parametro sostitutivo $Settings.

Parametro	Descrizione
readfromcache	True se si desidera leggere la versione memorizzata nella cache locale di queste impostazioni. In caso contrario, False o mancante.

RedoScreenPop

Visualizza di nuovo l'ultima schermata. Ciò può risultare utile nei casi in cui il limite di sessione è stato raggiunto e quindi il popup ha avuto esito negativo o la sessione è stata chiusa ma erano necessarie altre operazioni. Questa azione non richiede parametri.

ResetLocalCache

Reimposta la cache di configurazione in Unified Service Desk. La prossima volta che verrà avviato Unified Service Desk, la configurazione verrà scaricata dal server. L'utente deve disporre di accesso in scrittura all'entità msdyusd_usersettings affinché questa azione funzioni.

RouteToQueue

Indirizza un'entità a una coda in Dynamics 365.

Parametro	Descrizione
destination	ID della coda di destinazione. Questo e il parametro destinationqueuename si escludono reciprocamente
destinationqueuename	Questo è il nome della coda in cui distribuire l'entità.
entitytype	Questo è il nome logico dell'entità da distribuire.
entityid	Questo è il GUID/ID dell'entità da inserire nella coda.

Saveall

Salva tutti i moduli nel controllo ospitato che consente la visualizzazione di più pagine (Consenti più pagine = Sì). Se il controllo ospitato consente la visualizzazione di una sola pagina (Consenti più pagine = No), si tratta di un'azione equivalente a Salva.

SaveSetting

Archivia un'impostazione specifica dell'utente.

Parametro	Descrizione
Nome	Nome dell'impostazione. Verrà visualizzato nel parametro sostitutivo $Settings.
valore	Valore dell'impostazione da salvare.

SetTheme

Applica un tema per modificare il layout o l'aspetto dei componenti dell'interfaccia utente.Ulteriori informazioni:Personalizzare l'aspetto dell'applicazione

Parametro	Descrizione
clear	True se si intende cancellare completamente il tema corrente prima di applicare il tema specificato. Se questo parametro è false o non viene specificato, le nuove informazioni del tema verranno unite al tema corrente.
	Il parametro rimanente (ciò che resta dopo la rimozione degli altri parametri) deve contenere il nome del tema da utilizzare. Deve essere un nome della risorsa Web di un file XAML (rinominato in XML e caricato come risorsa Web), un URL di un server di accesso anonimo o il file XAML non elaborato che rappresenta il tema.

SetAppBar

Esegue l'ancoraggio di un controllo ospitato al bordo specificato della finestra principale dell'applicazione client.

Parametro	Descrizione
ApplicationName	Nome del controllo ospitato da ancorare. Se questo parametro è specificato, la finestra padre che ospita il controllo ospitato verrà ancorata.
width	Larghezza in pixel della finestra ancorata. Se non viene specificata, viene utilizzata la larghezza corrente della finestra.
height	Altezza in pixel della finestra ancorata. Se non viene specificata, viene utilizzata l'altezza corrente della finestra.
Bordo	Bordo a cui ancorarsi. Se non viene specificato nulla, si presuppone sia Alto. Specificare uno dei valori seguenti: In alto, In basso, Sinistro, o Destro.

SetEventTimer

Imposta un timer eventi da avviare.

Parametro	Descrizione
Nome	Nome del timer eventi.

SetSize

Imposta la larghezza e l'altezza del controllo ospitato. È particolarmente utile quando si utilizza "auto" nei layout pannello.

Parametro	Descrizione
width	Larghezza del controllo ospitato.
height	Altezza del controllo ospitato.

SetWindowProperty

Imposta lo stato della finestra per la finestra principale dell'applicazione client.

Parametro	Descrizione
WindowState	Uno dei valori seguenti: ingrandito, ridotto a icona o normale.

ShellExecute

Questa azione è progettata per avviare un URL o una riga di comando. Nota che l'utente deve disporre dei diritti per eseguire l'applicazione.

Parametro	Descrizione
	L'unico parametro è la riga di comando oppure l'URL dell'applicazione da eseguire.

ShowAbout

Visualizza la finestra di dialogo delle informazioni per Unified Service Desk contenente le informazioni come il nome dell'utente corrente, il server Dynamics 365 e l'organizzazione a cui l'utente è connesso, il numero di versione dell'applicazione client Unified Service Desk e l'URL del sito di supporto.

ShowTab

Imposta lo stato attivo su una scheda (controllo ospitato) nell'applicazione dell'agente.

Parametro	Descrizione
	La prima riga dell'invito all'azione deve contenere il nome del controllo ospitato da visualizzare in primo piano. Non utilizzare il nome visualizzato del controllo ospitato. Per ulteriori informazioni sull'uso di questo invito all'azione, vedere il passaggio 4 di Procedura dettagliata 2: visualizzare una pagina Web esterna nell'applicazione dell'agente.

StopEventTimer

Arresta un timer eventi.

Parametro	Descrizione
nome	Nome del timer eventi da arrestare.

Translate

Ti consente di eseguire la traduzione in lingua con Microsoft Translator

Parametro	Descrizione
valore	Questo è il testo da tradurre. È possibile impostare la sequenza di escape per questo valore per un supporto a più righe. Alcuni esempi validi: `value=$Escaped("my string<br>new line\\\"my text\\\"")` `value=[[myapp.myparam]^]` `value=$Escaped([[myapp.myparam]$])` Per ulteriori informazioni su queste chiavi sostitutive, vedere Utilizzare i parametri sostitutivi per configurare Unified Service Desk.
fromlanguage	Nome della lingua da cui tradurre. Se è vuoto, il sistema tenterà di rilevare la lingua del valore specificato da tradurre prima di iniziare la traduzione. Per un elenco di valori di lingua validi, vedere Codici lingua traduttore.
tolanguage	Nome della lingua in cui tradurre. Per un elenco di valori di lingua validi, vedere Codici lingua traduttore.
clientId	ID client ottenuto da Microsoft Azure per i servizi di traduzione. Per informazioni sulla registrazione con Azure, vedi https://datamarket.azure.com.
clientsecret	Un segreto client ottenuto da Microsoft Azure per i servizi di traduzione. Per informazioni sulla registrazione con Azure, vedi https://datamarket.azure.com.

Il valore tradotto viene visualizzato nel parametro sostitutivo $Return.

UpdateEntity

Aggiorna un record in Dynamics 365.

Parametro	Descrizione
ID	ID del valore da aggiornare. Deve essere il GUID del record da aggiornare.
LogicalName	Nome logico dell'entità da aggiornare.

Ogni riga successiva nell'elenco di parametri contiene una serie di coppie Name=Value che definiranno gli altri campi da compilare all'aggiornamento.

I riferimenti a entità possono essere descritti come di seguito:

Param=EntityReference(“logicalname”, “id”)

È possibile specificare OptionSetValue come di seguito:

Param=OptionSetValue(value)

È possibile descrivere Boolean come di seguito:

Param=Boolean(value)

PartyList (utilizzato con la posta elettronica) può essere descritto come di seguito:

Param=PartyList(email[“test@test.com”], er[“contact”, guid])

È possibile utilizzare un numero indefinito di voci email ed er per rappresentare gli indirizzi di posta elettronica e i riferimenti a entità, rispettivamente.

Altri valori come i valori stringa possono essere specificati come di seguito:

Param=value

Utilizzo

Questa azione è equivalente alla selezione di un elemento da una coda e del pulsante WorkOn sulla barra multifunzione. Contrassegna l'elemento della coda utilizzato da un agente specifico.

Parametro	Descrizione
ID	ID di queueitem. Vedi LookupQueueItem per informazioni su come ottenere l'ID di un'entità di destinazione.
Azione	Parametro facoltativo che consente all'amministratore di specificare che desidera rimuovere l'attributo WorkOn per restituirlo alla coda. Valori validi: Rimuovi: rimuove l'attributo WorkOn e restituisce l'elemento alla coda per l'utilizzo da parte di altri utenti.

ID di queueitem. Vedi LookupQueueItem per informazioni su come ottenere l'ID di un'entità di destinazione.

Azione

Parametro facoltativo che consente all'amministratore di specificare che desidera rimuovere l'attributo WorkOn per restituirlo alla coda.

Valori validi:

Rimuovi: rimuove l'attributo WorkOn e restituisce l'elemento alla coda per l'utilizzo da parte di altri utenti.

Eventi predefiniti

Di seguito sono indicati gli eventi predefiniti associati al controllo ospitato.

DesktopReady

Si verifica all'avvio quando l'intera inizializzazione desktop è stata completata e le connessioni a Dynamics 365 sono state stabilite. Questo evento verrà generato una sola volta ed è comune utilizzare questo evento per impostare i temi ed eseguire altre azioni di avvio.

SessionActivated

Si verifica ogni volta che una sessione viene attivata.

Parametro	Descrizione
SessionId	ID della sessione al momento attiva.
IsGlobal	Indica se questo evento si applica alla sessione globale. Restituisce True o False.
Attivazione	È impostato su True.

SessionClosed

Si verifica ogni volta che viene chiusa una sessione.

Parametro	Descrizione
SessionId	ID della sessione chiusa.
IsGlobal	Indica se questo evento si applica alla sessione globale. Restituisce True o False.

SessionDeactivated

Si verifica ogni volta che una sessione viene disattivata.

Parametro	Descrizione
SessionId	ID della sessione inattiva.
IsGlobal	Indica se questo evento si applica alla sessione globale. Restituisce True o False.
Attivazione	È impostato su False.

SessionNew

Si verifica quando viene creata una nuova sessione.

Parametro	Descrizione
SessionId	ID della sessione appena creata.
IsGlobal	Restituisce True se la nuova sessione è una sessione globale. In caso contrario, restituisce False.

Vedere anche

Azioni di UII
Eventi
Visualizzare le azioni e gli eventi predefiniti per un controllo ospitato
Visualizzare la guida incorporata per azioni ed eventi
Procedure dettagliate per la configurazione di Unified Service Desk
Tipi di controllo ospitato e riferimento ad azioni o eventi
TechNet: Guida all'amministrazione di Unified Service Desk per Microsoft Dynamics CRM

Unified Service Desk 2.0

Last updated on 2017-03-06

Condividi tramite

Responsabile globale (controllo ospitato)

In questo argomento

Creare un controllo ospitato Responsabile globale

Azioni UII predefinite

Controllo

CallDoAction

ClearAppBar

ClearEntityList

Chiusura

CloseActive

CopyToClipboard

CopyToContext

CopyLogicalEntityToContext

CloseActivity

CreateEntity

CreateSession

DeleteEntity

DoRoute

DoSearch

DisplayMessage

ExecuteOnDataAvailable

ExecuteOnTimeout

ExecuteOnExpressionTrue

ExecuteScriptlet

FireEvent

GetTemplate

InvokeCTI

LaunchURL

LookupQueueItem

MoveApplicationToPanel

MoveToPanel

New_CRM_Page

Open_CRM_Page

Sospendi

Popup

RealignWindow

ReadSettings

RedoScreenPop

ResetLocalCache

RouteToQueue

Saveall

SaveSetting

SetTheme

SetAppBar

SetEventTimer

SetSize

SetWindowProperty

ShellExecute

ShowAbout

ShowTab

StopEventTimer

Translate

UpdateEntity

Utilizzo

Eventi predefiniti

DesktopReady

SessionActivated

SessionClosed

SessionDeactivated

SessionNew

Vedere anche

Risorse aggiuntive