Een door de gebruiker gedefinieerde gebeurtenis maken

 

Gepubliceerd: november 2016

Is van toepassing op: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2013, Dynamics CRM 2015, Dynamics CRM 2016

Unified Service Desk biedt vooraf bepaalde gebeurtenissen voor gehoste besturingselementen, op basis van het type gehost besturingselement. Behalve deze vooraf gedefinieerde gebeurtenissen kunt u ook uw eigen gebeurtenissen in Unified Service Desk maken, die door de gebruiker gedefinieerde gebeurtenissen worden genoemd. U kunt de FireEvent-actie of de gebeurtenismoniker gebruiken om door de gebruiker gedefinieerde gebeurtenissen uit te voeren.

In dit onderwerp

De FireEvent-actie gebruiken

De gebeurtenismoniker gebruiken

De FireEvent-actie gebruiken

Alle vooraf gedefinieerde en aangepaste gehoste Unified Service Desk-besturingselementtypen, behalve CCA-gehoste toepassing, hebben een speciale UII-actie genaamd FireEvent. U kunt deze actie aanroepen om een door de gebruiker gedefinieerde gebeurtenis te starten vanuit dat besturingselement. Dit is een handige manier om meerdere actieoproepen in één taak te groeperen, waardoor u in feite een functie maakt binnen Unified Service Desk. Het is ook een redelijke manier om gebeurtenissen en hun actievolgordes vóór de distributie te testen.

De eerste parameter van FireEvent is de naam van de gebeurtenis:

name=MyEvent

Alle volgende naam/waarde-paren worden de parameters van de gebeurtenis en kunnen als vervangingsparameters worden gebruikt binnen de acties die als resultaat zijn aangeroepen. Als u bijvoorbeeld de volgende parameterlijst doorgeeft;

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

Hierdoor wordt de aangepaste gebeurtenis MyEvent geactiveerd, waardoor het mogelijk wordt een actieoproep te maken die de parameter var1 als volgt gebruikt:

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

Hiermee wordt de gebeurtenisparameter als gegevensparameter doorgegeven aan de actie van het gehoste besturingselement. In dit voorbeeld betekent dit dat de gegevensparameter voor het gehoste besturingselement de waarde account.name van de sessie is.

De gebeurtenismoniker gebruiken

U kunt een aangepaste gebeurtenis maken in een gehost besturingselement en deze vervolgens aanroepen met de volgende gebeurtenismonikersyntaxis:

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

In de syntaxis geeft u het key=value-paar op om de parameterlijst door te geven die moet worden gebruikt wanneer de gebeurtenis wordt geactiveerd.

Bekijk een voorbeeld waarin u een door de gebruiker gedefinieerde gebeurtenis wilt activeren wanneer de titel van de aanvraag op het aanvraagformulier verandert in Dynamics 365. Dit doet u als volgt:

  1. Maak een nieuwe gebeurtenis met de naam TitleChanged voor het gehoste besturingselement Incident in Microsoft Dynamics 365.

  2. Maak een actieoproep, genaamd Action Call for Title Change met de volgende waarden:

    Veld

    Waarde

    Naam

    Action Call for Title Change

    Gehost beheer

    Incident

    Actie

    RunXrmCommand

    Gegevens

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

  3. Voeg de nieuwe actieoproep die u hebt gemaakt, toe aan de gebeurtenis BrowserDocumentComplete van het gehoste besturingselement Incident.Meer informatie:Actieoproepen toevoegen aan een gebeurtenis

    Wanneer de TitleChanged-gebeurtenis wordt geactiveerd, wordt de volgende aanvraag geactiveerd: http://event/?EventName=TitleChanged&NewTitle=<NEW_TITLE>

    Hierdoor wordt de gebeurtenis TitleChanged geactiveerd met de volgende gegevensparameter: NewTitle=<NEW_TITLE>

Als u JavaScript in Dynamics 365 gebruikt om een gebeurtenis aan te roepen in Unified Service Desk met behulp van de gebeurtenismoniker (http://event/?EventName=<EVENT_NAME>&key=value&key=value&…), kunt u de eigenschap window.IsUSD gebruiken om te bepalen of de JavaScript-code onder Unified Service Desk werkt wanneer de gebeurtenis wordt aangeroepen. De volgende voorbeeldcode kan worden opgenomen in uw JavaScript-code om te controleren of de gebeurtenis alleen wordt aangeroepen wanneer de aanroepende JavaScript werkt binnen Unified Service Desk.

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

Zie ook

Gebeurtenissen
Typen gehoste besturingselementen en actie/gebeurtenisnaslag
Gehoste besturingselementen, acties, en evenementen beheren
MSDN: JavaScript gebruiken met Microsoft Dynamics CRM

Unified Service Desk 2.0

© 2017 Microsoft. Alle rechten voorbehouden. Auteursrecht

  • Last updated on