Delen via


Een aangepaste procesactie maken

Gebruik aangepaste procesacties als u een reeks opdrachten in het systeem wilt automatiseren. Met aangepaste procesacties vergroot u het vocabulaire dat beschikbaar is voor ontwikkelaars om bedrijfsprocessen uit te drukken. In een aangepaste procesactie worden door het systeem verschafte kernwerkwoorden, zoals Maken, Updaten, Verwijderen, en Toewijzen, gebruikt om expressievere werkwoorden zoals Goedkeuren, Escaleren, Routeren of Plannen te maken. Als de definitie van een bedrijfsproces verandert, kan iemand die geen ontwikkelaar is de aangepaste procesactie bewerken zodat de code niet hoeft te worden gewijzigd.

Notitie

Als u van plan bent een invoegtoepassing te schrijven om uw logica voor een aangepaste procesactie te implementeren in plaats van de werkstroomontwerper te gebruiken, moet u in plaats daarvan Aangepaste API gebruiken. Meer informatie: Aangepaste procesactie en Aangepaste API vergelijken

Een aangepaste procesactie maken

Belangrijk

Als u een aangepaste procesactie maakt die moet worden opgenomen als onderdeel 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.

Net als werkstroomprocessen hebben aangepaste procesacties 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.

  • Tabel

    Met actieprocessen kunt u net zoals bij andere procestypen een tabel 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 tabel vereist. U kunt deze niet wijzigen nadat u het proces hebt opgeslagen.

  • Type

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

In tegenstelling tot werkstroomprocessen, 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.

Aangepaste procesacties hebben ook iets dat werkstroomprocessen niet hebben: in- en uitvoerargumenten.

Notitie

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

Een aangepaste procesactie bewerken

U moet aangepaste procesacties deactiveren voordat u ze kunt bewerken.

U kunt een aangepaste procesactie bewerken die is gemaakt als onderdeel van een onbeheerde oplossing of die is opgenomen in een in uw organisatie geïnstalleerde oplossing. 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 uitvoeren die door de aangepaste procesactie is geïnitieerd, ondersteunen transacties wellicht niet. 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 procesactie direct wordt aangeroepen binnen een werkstroom. U kunt terugdraaien inschakelen als een actie door een Power Apps-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 en stappen toevoegen

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

Procesargumenten definiëren

Wanneer een ontwikkelaar berichten gebruikt, kan deze beginnen met enkele gegevens die in het bericht worden opgenomen. Bijvoorbeeld: als u een nieuwe aanvraagrij wilt maken, kan er de waarde van de aanvraagtitel zijn die wordt opgenomen als het 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 aangepaste procesactie is geactiveerd en in code wordt gebruikt, mag de handtekening niet worden gewijzigd. 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.
Tabel Een rij voor de opgegeven tabel. Als u tabel selecteert, wordt de vervolgkeuzelijst ingeschakeld en geeft deze u de mogelijkheid om het tabeltype te selecteren.
entityCollection Een verzameling tabelrijen.
entityReference Een object dat de naam, id en het type van een tabelrij bevat wardoor het uniek wordt geïdentificeerd. Als u entityReference selecteert, wordt de vervolgkeuzelijst ingeschakeld en geeft deze u de mogelijkheid om het tabeltype te selecteren.
Float 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 berichten maken

Fasen en stappen toevoegen

Aangepaste procesacties zijn een procestype dat erg lijkt op 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 rijen waarop de actie wordt uitgevoerd, rijen die zijn gekoppeld aan een veel-op-een-relatie, rijen die u in een vorige stap hebt gemaakt, of waarden die deel uitmaken van het proces zelf.

Beheerde eigenschappen

Aangepaste procesacties hebben twee relevante beheerde eigenschappen

Is aanpasbaar

Met de beheerde eigenschap Is aanpasbaar wordt bepaald of iemand die een beheerde oplossing met de aangepaste procesactie installeert, deze wel of niet kan bewerken of verwijderen. Als u wilt dat de aangepaste procesactie wordt bewerkt of verwijderd wanneer deze is opgenomen in een beheerde oplossing, moet u deze eigenschap instellen op true.

Is Aangepaste verwerkingsstap toegestaan voor andere uitgevers

Met de beheerde eigenschap Is aangepaste verwerkingsstap toegestaan voor andere uitgevers wordt bepaald of ontwikkelaars van externe invoegtoepassingen invoegtoepassingsstappen kunnen registreren voor het bericht dat is gemaakt door de aangepaste procesactie. Als dit waar is, worden invoegtoepassingen die door iedereen in dit bericht zijn geregistreerd, uitgevoerd en kunnen ze het gedrag van de aangepaste procesactie wijzigen. Als dit onwaar is, worden alleen invoegtoepassingsstappen uitgevoerd die binnen een oplossing van dezelfde oplossingsuitgever zijn geregistreerd.

Volgende stappen

Aangepaste procesacties aanroepen vanuit een werkstroom

Notitie

Laat ons uw taalvoorkeuren voor documentatie weten! Beantwoord een korte enquête. (houd er rekening mee dat deze in het Engels is)

De enquête duurt ongeveer zeven minuten. Er worden geen persoonlijke gegevens verzameld (privacyverklaring).