Condividi tramite

Creare un evento definito dall'utente

 

Data di pubblicazione: novembre 2016

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

Unified Service Desk offre eventi predefiniti per i controlli ospitati in base al tipo di controllo ospitato. Oltre a questi eventi predefiniti, è inoltre possibile creare eventi personalizzati in Unified Service Desk, chiamati eventi definiti dall'utente. Utilizzare l'azione FireEvent o il moniker evento per eseguire gli eventi definiti dall'utente.

In questo argomento

Utilizzare l'azione FireEvent

Utilizzare il moniker evento

Utilizzare l'azione FireEvent

Tutti i tipi di controlli ospitati di Unified Service Desk predefiniti e personalizzati, eccetto il controllo Applicazione ospitata di CCA, dispongono di un'azione di UII speciale denominata FireEvent. È possibile chiamare questa azione per avviare un evento definito dall'utente dal controllo. Si tratta di metodo comodo per raggruppare più inviti all'azione in un unico invito, creando così una funzione in Unified Service Desk. Questo metodo consente inoltre di testare gli eventi e le sequenze delle azioni prima della distribuzione.

Il primo parametro a FireEvent è il nome dell'evento:

name=MyEvent

Tutte le successive coppie nome/valore diventano i parametri dell'evento e possono quindi essere utilizzati come parametri sostitutivi nelle azioni che sono chiamate di conseguenza. Se ad esempio si passa il seguente elenco di parametri:

name=MyEvent
var1=[[account.name]]

Verrà generato l'evento personalizzato MyEvent che consentirà di creare un invito all'azione che utilizza il parametro var1 come segue:

Hosted Control=Some Hosted Control
UII Action=Some action on the Hosted Control
Data=[[var1]]

Verrà passato il parametro di evento come parametro dati all'azione del controllo ospitato. In questo esempio, significa che il parametro dati al controllo ospitato sarà il valore account.name della sessione.

Utilizzare il moniker evento

È possibile creare un evento personalizzato in un controllo ospitato e quindi chiamarlo tramite la seguente sintassi del moniker evento:

http://event/?EventName=<EVENT_NAME>&key=value&key=value&…

Nella sintassi, specificare la coppia key=value per passare l'elenco dei parametri da utilizzare quando l'evento viene attivato.

Si consideri un esempio in cui si desidera generare un evento definito dall'utente quando il titolo del caso nel modulo cambia in Dynamics 365. Per eseguire questa operazione:

  1. Creare un nuovo evento denominato TitleChanged, per il controllo ospitato Caso in Microsoft Dynamics 365.

  2. Creare un invito all'azione chiamato Action Call for Title Change, con i valori seguenti:

    Campo

    Valore

    Nome

    Action Call for Title Change

    Controllo ospitato

    Caso

    Azione

    RunXrmCommand

    Dati

    		 
    function titleChangeReaction() 
{ 
   window.open("http://event/?EventName=TitleChanged&NewTitle="+encodeURIComponent(Xrm.Page.getAttribute("title").getValue()));
}
Xrm.Page.getAttribute("title").addOnChange(titleChangeReaction);

  3. Aggiungere il nuovo invito all'azione appena creato all'evento BrowserDocumentComplete del controllo ospitato Caso.Ulteriori informazioni:Aggiungere inviti all'azione a un evento

    Quando l'evento TitleChanged viene attivato, viene generata la seguente richiesta: http://event/?EventName=TitleChanged&NewTitle=<NEW_TITLE>

    In tal modo l'evento TitleChanged viene attivato con il seguente parametro dati: NewTitle=<NEW_TITLE>

Se utilizzi JavaScript in Dynamics 365 per richiamare un evento in Unified Service Desk utilizzando il moniker evento (http://event/?EventName=<EVENT_NAME>&key=value&key=value&…), puoi utilizzare la proprietà window.IsUSD per determinare se il codice JavaScript è in esecuzione in Unified Service Desk quando l'evento viene richiamato. Il seguente esempio di codice può essere incluso nel codice JavaScript per verificare che l'evento è richiamato solo quando il JavaScript chiamante è in esecuzione in Unified Service Desk.

if ((window.IsUSD != null) && (window.IsUSD == true))
{
   window.open(http://event/?EventName=<EVENT_NAME>&key=value&key=value&…);
}

Vedere anche

Eventi
Tipi di controllo ospitato e riferimento ad azioni o eventi
Gestire i controlli ospitati, le azioni e gli eventi
MSDN: Utilizzare JavaScript con Microsoft Dynamics CRM

Unified Service Desk 2.0

© 2017 Microsoft. Tutti i diritti sono riservati. Copyright

  • Last updated on