Del via

Oprette en brugerdefineret hændelse

  • Artikel

 

Udgivet: november 2016

Gælder for: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2013, Dynamics CRM 2015, Dynamics CRM 2016

Unified Service Desk indeholder foruddefinerede hændelser til tilknyttede kontrolelementer, afhængigt af typen af det tilknyttede kontrolelement. Ud over disse foruddefinerede hændelser kan du også oprette dine egne hændelser i Unified Service Desk, som kaldes brugerdefinerede hændelser. Du kan bruge FireEvent handlingen eller hændelses-monikeren til at køre brugerdefinerede hændelser.

Dette emne indeholder

Brug FireEvent-handlingen

Brug hændelses-monikeren

Brug FireEvent-handlingen

Alle de foruddefinerede og brugerdefinerede tilknyttede kontrolelementer af typen Unified Service Desk, med undtagelse af CCA-værtsprogrammet, har en særlig UII-handling, der hedder FireEvent. Du kan kalde denne handling for at starte en brugerdefineret hændelse fra kontrolelementet. Dette er en praktisk måde at gruppere flere handlingsopkald til et enkelt opkald på, hvilket effektivt opretter en funktion i Unified Service Desk. Det er også en rimelig måde at teste hændelser og deres handlingssekvenser på før installation.

Den første parameter til FireEvent er navnet på hændelsen:

name=MyEvent

Alle efterfølgende navn/værdi-par bliver parametre til hændelsen og kan dermed bruges som erstatningsparametre inden for de handlinger, der kaldes som resultat deraf. Hvis du f.eks. overfører følgende parameterliste:

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

Derved udløses den brugerdefinerede hændelse MyEvent, hvilket giver hændelsen mulighed for at oprette et handlingsopkald, som bruger parameteren var1 på følgende måde:

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

Dette overfører hændelsesparameteren som en dataparameter til handlingen for det tilknyttede kontrolelement. I dette eksempel betyder det, at dataparameteren til det tilknyttede kontrolelement bliver account.name-værdien fra sessionen.

Brug hændelses-monikeren

Du kan oprette en brugerdefineret hændelse på et tilknyttet kontrolelement og derefter kalde den ved hjælp af følgende hændelses-monikersyntaks:

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

I syntaksen skal du angive key=value-parret for at overføre den parameterliste, der skal bruges, når hændelsen udløses.

Overvej et eksempel, hvor du vil udløse en brugerdefineret hændelse, hver gang titlen på sagen i sagsformularen ændres i Dynamics 365. Hvis du vil:

  1. Opret en ny hændelse, TitleChanged, for det tilknyttede kontrolelement Hændelse i Microsoft Dynamics 365.

  2. Opret handlingskaldet Action Call for Title Change med følgende værdier:

    Felt

    Værdi

    Navn

    Action Call for Title Change

    Tilknyttet kontrolelement

    Hændelse

    Handling

    RunXrmCommand

    Data

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

  3. Tilføj det nye handlingskald, du har oprettet til BrowserDocumentComplete-hændelsen i det tilknyttede kontrolelementet Hændelse.Flere oplysninger:Tilføje handlingsopkald til en hændelse

    Når TitleChanged-hændelsen udløses, oprettes følgende anmodning: http://event/?EventName=TitleChanged&NewTitle=<NEW_TITLE>

    Dette medfører, at TitleChanged-hændelsen udløses med følgende dataparameter: NewTitle=<NEW_TITLE>

Hvis du bruger JavaScript i Dynamics 365 til at kalde en hændelse i Unified Service Desk ved hjælp af hændelses-monikeren (http://event/?EventName=<EVENT_NAME>&key=value&key=value&…), kan du bruge egenskaben window.IsUSD til at afgøre, om JavaScript-koden kører under Unified Service Desk, når hændelsen aktiveres. Følgende kodeeksempel kan medtages i din JavaScript kode for at sikre, at hændelsen kun aktiveres, når den kaldende JavaScript kører i Unified Service Desk.

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

Se også

Hændelser
Tilknyttede kontrolelementtyper og reference for handling/hændelse
Administrere tilknyttede kontrolelementer, handlinger og hændelser
MSDN: Bruge JavaScript med Microsoft Dynamics CRM

Unified Service Desk 2.0

© 2017 Microsoft. Alle rettigheder forbeholdes. Ophavsret