Aangepaste acties op basis van een werkstroom maken of bewerken

Dit onderwerp is van toepassing op Dynamics 365 Customer Engagement (on-premises). Voor de Power Apps-versie van dit onderwerp, zie: Aangepaste acties op basis van een werkstroom configureren

U kunt een aangepaste actie inschakelen vanuit een werkstroom, zonder dat u code hoeft te schrijven. Meer informatie: Aangepaste acties aanroepen vanuit een werkstroom.

U kunt ook een actie maken zodat een ontwikkelaar deze kan gebruiken in code of u moet wellicht een actie bewerken die eerder is gedefinieerd. Zoals workflowprocessen, overweeg het volgende:

• Wat moet de actie doen?

• Onder welke voorwaarden moet de actie worden uitgevoerd?

In tegenstelling tot workflowprocessen, hoeft u geen van de volgende opties in te stellen:

• Starten wanneer: acties beginnen wanneer de code het bericht dat voor hen wordt gemaakt oproept.

• Bereik: acties worden altijd uitgevoerd in de context van de oproepende gebruiker.

• Op de achtergrond uitvoeren: acties zijn altijd realtime-werkstromen.

Acties hebben ook iets dat werkstroomprocessen niet hebben: in- en uitvoerargumenten. Meer informatie: Procesargumenten definiëren

Een actie maken

Belangrijk

Als u een actie maakt die als onderdeel wordt opgenomen van een oplossing die wordt gedistribueerd, maak deze dan in de context van de oplossing. Ga naar Instellingen>Oplossingen en ga naar de onbeheerde oplossing waarvan deze actie een deel zal zijn. Vervolgens selecteert u in de menubalk Nieuw>Proces. Dit zorgt ervoor dat het aanpassingsvoorvoegsel dat is gekoppeld aan de actienaam met andere onderdelen in de oplossing consistent is. Nadat u de actie maakt, kunt u de prefix niet wijzigen.

Zoals werkstroomprocessen hebben acties de volgende eigenschappen in het dialoogvenster Proces maken.

Procesnaam
Nadat u een naam voor het proces hebt ingevoerd, wordt hiervoor een unieke naam gemaakt door spaties of speciale tekens uit de procesnaam te verwijderen.

Categorie
Deze eigenschap bepaalt dat dit een actieproces is. U kunt deze niet wijzigen nadat u het proces hebt opgeslagen.

Entiteit
Met actieprocessen kunt u net zoals bij andere procestypen een entiteit selecteren om context te geven voor de realtime-werkstroom, maar u kunt ook Geen (algemeen) selecteren. Gebruik deze indien uw actie niet de context van een specifieke entiteit vereist. U kunt deze niet wijzigen nadat u het proces hebt opgeslagen.

Type
Gebruik deze eigenschap om te kiezen of u een nieuwe actie vanaf het begin wilt maken of vanuit een bestaande sjabloon wilt beginnen.

Een actie bewerken

U moet processen deactiveren voordat u ze kunt bewerken.

U kunt een actie bewerken dat werd gemaakt als onderdeel van een onbeheerde oplossing opgenomen in een geïnstalleerde oplossing in uw organisatie. Als de oplossing een beheerde oplossing is, dan kunt u deze wellicht niet bewerken. De oplossingsuitgever heeft de optie om de beheerde eigenschappen te bewerken zodat de actie die is geïnstalleerd met een beheerde oplossing niet kan worden bewerkt.

Wanneer een actie wordt opgeslagen, wordt een unieke naam gemaakt op basis van de procesnaam. Aan deze unieke naam wordt het aanpassingsvoorvoegsel toegevoegd vanuit de oplossingsuitgever. Dit is de naam van het bericht dat een ontwikkelaar zal gebruiken in de code.

U hebt bij het bewerken van een actie de volgende opties:

Procesnaam
Nadat het proces is gemaakt en de unieke naam is gemaakt vanuit de procesnaam, kunt u de procesnaam bewerken. U wilt wellicht een naamconventie toepassen om het eenvoudiger te maken om specifieke processen te zoeken.

Unieke naam
Wanneer een actie wordt opgeslagen, wordt een unieke naam gemaakt op basis van de procesnaam. Aan deze unieke naam wordt het aanpassingsvoorvoegsel toegevoegd vanuit de oplossingsuitgever. Dit is de naam van het bericht dat een ontwikkelaar zal gebruiken in de code. Wijzig deze unieke naam niet indien het proces is geactiveerd, en de code is geïmplementeerd en verwacht dat de actie met deze naam wordt opgeroepen.

Belangrijk

Nadat de actie is geactiveerd en de code is geschreven om een unieke naam te gebruiken, moet de unieke naam niet meer wijzigen zonder dat ook de code waarop deze betrekking heeft wordt gewijzigd.

Terugdraaien inschakelen
Over het algemeen, zullen processen die transacties ondersteunen door de gehele bewerking ongedaan maken (of terugdraaien) indien een deel ervan faalt. Er zijn enkele uitzonderingen. Sommige acties die ontwikkelaars in code kunnen doen die door de actie worden geïnitieerd, ondersteunen wellicht niet transacties. Bijvoorbeeld: indien de code acties uitvoert in andere systemen die buiten het bereik van de transactie zijn. Deze kunnen niet worden teruggedraaid door de actie die wordt uitgevoerd in een app. Sommige berichten in het platform ondersteunen geen transacties. Hetgeen u doet met louter en alleen de gebruikersinterface van de actie zal transacties ondersteunen. Alle acties die deel uitmaken van een realtime-werkstroom worden overwogen in transacties, maar met acties hebt u de mogelijkheid om dit uit te schakelen.

U kunt met de ontwikkelaar overleggen die dit bericht zal gebruiken om te bepalen of het in de transactie moet of niet. Over het algemeen moet een actie in transactie zijn indien de acties die door het bedrijfsproces worden uitgevoerd zinloos zijn, tenzij ze allemaal met succes zijn voltooid. Het meest bekende voorbeeld is de overdracht van fondsen tussen twee bankrekeningen. Als u een fondsen vanuit één account opneemt, moet u ze in de andere storten. Als een van beide mislukt, dan zullen beide mislukken.

Notitie

U kunt terugdraaien niet inschakelen als een aangepaste actie direct wordt aangeroepen vanuit een werkstroom. U kunt terugdraaien inschakelen als een actie door een Dynamics 365 Customer Engagement (on-premises)-webservicesbericht wordt geactiveerd.

Activeren als
Zoals alle processen, kunt u het proces activeren als een sjabloon en het gebruiken als een geavanceerd beginpunt voor processen die een soortgelijk patroon volgen.

Procesargumenten definiëren
U kunt in dit gebied alle gegevens specificeren die de actie verwacht te beginnen en welke gegevens uit de actie zullen worden genomen. Meer informatie: Procesargumenten definiëren

Fasen, voorwaarden en acties toevoegen
Zoals andere processen, moet u specificeren welke acties uit te voeren en wanneer ze uit te voeren. Meer informatie: Fasen, voorwaarden en acties toevoegen

Procesargumenten definiëren

Wanneer een ontwikkelaar een bericht gebruikt, kan deze beginnen met enkele gegevens die in het bericht worden opgenomen. Bijvoorbeeld: als u een nieuwe caserecord wilt maken, kan er de waarde van de casetitel zijn die wordt opgenomen als een invoerargument.

Wanneer het bericht is voltooid, moet de ontwikkelaar wellicht bepaalde gegevens verwerken die werden gewijzigd of gemaakt door het bericht naar een andere bewerking in de code. Deze gegevens zijn het uitvoerargument.

Zowel de in- als uitvoerargumenten moeten een naam, een type en enige informatie over of het argument altijd is vereist hebben. U kunt ook een beschrijving toevoegen.

De naam van het bericht en de gegevens over alle procesargumenten vertegenwoordigen de 'handtekening' voor het bericht. Nadat een actie is geactiveerd en in code wordt gebruikt, moet u de handtekening niet wijzigen. Als deze handtekening wijzigt, mislukken alle codes die het bericht gebruiken. De enige uitzondering hierop is het wijzigen van een van de parameters zodat het niet altijd is vereist.

U kunt de volgorde van argumenten wijzigen door ze te sorteren of verplaatsen naar boven of omlaag, omdat de argumenten worden geïdentificeerd op naam en niet op volgorde. Het wijzigen van de beschrijving zal code die het bericht gebruikt niet beschadigen.

Argumenttypen van actieprocessen

De volgende tabel beschrijft de argumenttypen van het actieproces.

Type	Beschrijving
Boolean	Een waarde true of false.
DateTime	Een waarde die datum- en tijdinformatie opslaat.
Decimaal	Een numerieke waarde met decimale nauwkeurigheid. Wordt gebruikt wanneer precisie uiterst belangrijk is.
Entiteit	Een record voor de gespecificeerde entiteit. Als u Entiteit selecteert, dan wordt de vervolgkeuzelijst ingeschakeld en geeft deze u de mogelijkheid om het entiteitstype te selecteren.
EntityCollection	Een verzameling van entiteitsrecords.
EntityReference	Een object dat de naam, id en het type van een entiteitsrecord bevat wardoor het uniek wordt geïdentificeerd. Als u EntityReference selecteert, dan wordt de vervolgkeuzelijst ingeschakeld en geeft deze u de mogelijkheid om het entiteitstype te selecteren.
Zwevend	Een numerieke waarde met decimale nauwkeurigheid. Wordt gebruikt wanneers de gegevens uit een meting komen die niet absoluut betrouwbaar is.
Geheel getal	Een geheel getal.
Geld	Een waarde die gegevens opslaat over een hoeveelheid geld.
Picklist	Een waarde die een optie voor een OptionSet-kenmerk vertegenwoordigt.
String	Een tekstwaarde.

Notitie

EntityCollection-argumentwaarden kunnen niet in de gebruikersinterface voor voorwaarden of acties worden ingesteld. Deze zijn beschikbaar voor gebruik door ontwikkelaars in aangepaste code. Meer informatie: Uw eigen acties maken

Fasen en stappen toevoegen

Acties zijn een procestype dat soortgelijk is met realtime-werkstromen. Alle stappen die in realtime-werkstromen kunnen worden gebruikt kunnen in acties in worden gebruikt. Zie voor informatie over de stappen die voor zowel realtime-werkstromen als acties kunnen worden gebruikt Werkstroomfasen en stappen.

Naast de stappen die voor realtime-werkstromen kunnen worden gebruikt, hebben acties ook de stap Waarde toewijzen. In acties kan deze alleen worden gebruikt om uitvoerargumenten in te stellen. U kunt de formulierenassistent gebruiken om uitvoerargumenten op specifieke waarden in te stellen of, meer waarschijnlijk, op waarden van de record waarop de actie wordt uitgevoerd, records die zijn gekoppeld aan een veel-op-een-relatie, records die u in een vorige stap hebt gemaakt, of waarden die deel uitmaken van het proces zelf.

Zie ook

Acties
Aangepaste acties aanroepen vanuit een werkstroom
Realtime-werkstromen en acties controleren
Workflowprocessen
Overzicht van bedrijfsprocesstromen
Workflowprocessen controleren en beheren
Uw eigen acties maken