Delen via

Aangepaste procesacties op basis van een werkstroom configureren

  • Artikel

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

U kunt ook een aangepaste procesacties maken zodat een ontwikkelaar deze kan gebruiken in code of u moet wellicht een actie bewerken die eerder is gedefinieerd. Overweeg net als bij realtime-werkstroomprocessen het volgende:

  • Wat moet de actie doen?

  • Onder welke voorwaarden moet de actie worden uitgevoerd?

In tegenstelling tot realtime-werkstroomprocessen, hoeft u de volgende opties niet in te stellen:

  • Starten wanneer: aangepaste procesacties beginnen wanneer het bericht dat ervoor is gemaakt met code wordt aangeroepen.

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

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

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

Een aangepaste procesactie 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.

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

Net zoals realtime-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 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.

Een actie bewerken

U moet processen deactiveren voordat u ze kunt bewerken.

U kunt een aangepaste procesacties 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 aangepaste procesacties 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. Hierop zijn enkele uitzonderingen. Aangepaste procesacties die zijn uitgevoerd door een ontwikkelaar in code geïnitieerd door de aangepaste procesactie, ondersteunen wellicht transacties niet. Bijvoorbeeld: als 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 aangepaste procesactie wordt geactiveerd door een bericht van Power Apps-webservices.
    • Als de gedefinieerde actie gegevens niet wijzigt, maar alleen gegevens ophaalt, zijn er bepaalde situaties waarin prestaties kunnen worden verbeterd door Terugdraaien inschakelen uit te schakelen.

  • 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 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 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.
Tabel Een rij voor de opgegeven tabel. Als u Tabel selecteert, dan wordt de vervolgkeuzelijst ingeschakeld zodat u de mogelijkheid hebt 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 tableReference 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

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. Informatie over de stappen die voor zowel realtime-werkstromen als acties kunnen worden gebruikt, vindt u in 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

Acties gebruiken
Aangepaste acties aanroepen vanuit een werkstroom
Realtime-werkstromen en acties controleren

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).