Skapa eller redigera anpassade åtgärder från ett arbetsflöde

  • Artikel

Det här ämnet gäller för Dynamics 365 Customer Engagement (on-premises). En Power Apps-version för det här ämnet finns i: Konfigurera anpassade åtgärder från ett arbetsflöde

Du kan aktivera en anpassad åtgärd från ett arbetsflöde utan att skriva kod. Mer information: Anropa anpassade åtgärder från ett arbetsflöde.

Du kan också skapa en åtgärd så att utvecklare kan använda den i sin kod, eller så kan du redigera en åtgärd som du har definierat tidigare. På samma sätt som i arbetsflödesprocesser ska du tänka på följande:

  • Vad gör åtgärden?

  • Vilka villkor gäller för åtgärden när den utförs?

Till skillnad från arbetsflödesprocesser behöver du inte ange följande alternativ:

  • Starta när: åtgärder startar när koden anropar meddelandet som har genererats för dem.

  • Omfattning: åtgärder som alltid körs i kontexten för den anropande användaren.

  • Kör i bakgrunden: åtgärder är alltid realtidsarbetsflöden.

Åtgärder har också något som arbetsflödesprocesser inte har – in- och utdataargument. Mer information: Definiera processargument

Skapa en åtgärd

Viktigt!

Om du skapar en åtgärd som ska ingå i en lösning som kommer att distribueras, kan du skapa den i samband med lösningen. Gå till Inställningar>Lösningar och leta upp den ohanterade lösningen åtgärden ska vara en del av. I menyraden, markera Nytt>Process. Detta säkerställer att anpassningsprefixet som är associerat med namnet på åtgärden är förenlig med andra komponenter i lösningen. När du skapar åtgärden, kan du inte ändra prefixet.

På samma sätt som i arbetsflödesprocesser har åtgärder följande egenskaper i dialogrutan Skapa process:

Processnamn
När du har angett ett namn på processen skapas ett unikt namn för den genom att alla blanksteg eller specialtecken tas bort från processens namn.

Kategori
Den här egenskapen anger att detta är en åtgärd. Det går inte att ändra detta efter att du har sparat processen.

Enhet
Med åtgärdsprocesser kan du välja en entitet för att ge kontext för arbetsflödet, precis som i andra typer av processer, men du har också möjlighet att välja Ingen (global). Använd det här om åtgärden inte kräver en särskild entitets kontext. Det går inte att ändra detta efter att du har sparat processen.

Typ
Du kan använda den här egenskapen för att välja om du vill skapa en ny åtgärd från grunden eller att starta från en befintlig mall.

Redigera en åtgärd

Innan du kan redigera processer måste du inaktivera dem.

Du kan redigera en åtgärd som skapats som en del av en ohanterad lösning eller som ingår i en lösning som är installerad i din organisation. Om lösningen är hanterad kan det hända att du inte kan redigera den. Lösningsutgivaren har möjlighet att redigera de hanterade egenskaperna så att åtgärden som installeras med en hanterad lösning inte kan redigeras.

När en åtgärd sparas skapas ett unikt namn baserat på processnamn. Detta unika namn har anpassningsprefixet tillagt från utgivaren. Det här är namnet på det meddelande som utvecklare använder i sin kod.

När du redigerar en åtgärd har du följande alternativ:

Processnamn
När processen har skapats och det unika namnet har genereratas av processens namn, kan du redigera processens namn. Du kanske vill använda en namnkonvention som gör det enklare att hitta specifika processer.

Unikt namn
När en åtgärd sparas skapas ett unikt namn baserat på processnamn. Detta unika namn har anpassningsprefixet tillagt från utgivaren. Det här är namnet på det meddelande som utvecklare använder i sin kod. Ändra inte detta unika namn om processen har aktiverats och koden är på plats och väntar på att anropa åtgärden med detta namn.

Viktigt!

När åtgärden är aktiverad och kod skrivs för att använda ett unikt namn, får det unika namnet inte utan att också koden som hänvisar till det ändras.

Aktivera återställning
I allmänhet kan processer som stöder transaktioner ångra hela operationen om någon del går fel. Det finns vissa undantag till detta. Vissa åtgärder som utvecklare kan göra i koden som initieras av åtgärden kanske inte stöder transaktioner. Om exempelvis koden utför åtgärder i andra system som är utanför ramen för transaktionen. Dessa kan inte återställas av den åtgärd som körs i en app. Vissa meddelanden på plattformen stöder inte transaktioner. Men allt du kan göra med användargränssnittet för åtgärden stöder transaktioner. Alla åtgärder som ingår i ett realtidsarbetsflöde anses vara i transaktionen, men tack vare åtgärder har du möjlighet att välja bort detta.

Du bör kontakta utvecklaren som använder det här meddelandet för att bestämma om den måste vara i transaktion eller inte. En åtgärd bör i allmänhet vara i transaktionen om de åtgärder som utförs av affärsprocessen inte är relevanta, om inte alla har slutförts utan fel. Klassiska exempel är överföring av medel mellan två bankkonton. Om att ta ut ett belopp från ett konto måste du sätta in det i det andra. Om en åtgärd misslyckas, måste båda misslyckas.

Kommentar

Du kan inte aktivera återställning om en anpassad åtgärd anropas direkt från ett arbetsflöde. Du kan aktivera återställning om en åtgärd som utlöses av ett Dynamics 365 Customer Engagement (on-premises)-webbtjänstmeddelande.

Aktivera som
Du kan aktivera processen som en mall och använda den som en avancerad startpunkt för processer som följer ett liknande mönster.

Definiera processargument
I det här området anger du data som åtgärden förväntas starta och vilka data som ska skickas ut av åtgärden. Mer information: Definiera processargument

Lägg till stadier, villkor och åtgärder
Precis som i andra processer, anger du vilka åtgärder som ska utföras och när de ska utföras. Mer information: Lägg till steg, villkor och åtgärder

Definiera processargument

När en utvecklare använder ett meddelande kan de börja med vissa data som de kan skicka till meddelandet. Om du exempelvis vill skapa en ny ärendepost kanske du har ärenderubrikvärdet som ska skickas som ett indataargument.

När meddelandet är klart kan utvecklaren behöva överföra data som har ändrats eller skapats av meddelandet till en annan operation i koden. Dessa data är utdataargumentet.

Både indata- och utdataargument måste ha ett namn, en typ och information om att argumentet alltid krävs eller inte. Du kan också ange en beskrivning.

Namnet på meddelandet och information om alla processargument representerar meddelandets "signatur". När en åtgärd är aktiverad och används i koden, får signaturen inte ändras. Om signaturen ändras kommer kod som använder meddelandet att misslyckas. Det enda undantaget kan vara att ändra en av parametrarna så att det inte alltid krävs.

Du kan ändra ordningen på argumenten genom att sortera dem eller flytta dem uppåt eller nedåt eftersom argumenten identifieras med namnen, inte av ordning. Att ändra beskrivningen bryter inte kod med hjälp av meddelandet.

Argumenttyper för åtgärdprocess

I följande tabell beskrivs argumenttyper för åtgärdprocesser.

Type Beskrivning
Boolean Värdet true eller false.
DatumTid Ett värde som lagrar information om datum och tid.
Decimaltal Ett numeriskt värde med decimaler. Används när precision är mycket viktigt.
Enhet En post för den angivna entiteten. När du väljer Entitet aktiveras den nedrullningsbara listan och gör att du kan välja entitetstypen.
EntityCollection En samling entitetsposter.
EntityReference Ett objekt som innehåller namn, id och typ av en entitetspost som unikt identifierar den. När du väljer Entitetsreferens aktiveras den nedrullningsbara listan och gör att du kan välja entitetstypen.
Flyttal Ett numeriskt värde med decimaler. Används när data kommer från ett mått som inte är helt exakt.
Integer Heltal.
Belopp Ett värde som lagrar data om en summa pengar.
Plocklista Ett värde som representerar ett alternativ för ett alternativuppsättningsattribut.
String Textvärde.

Kommentar

EntityCollection-argumentvärden kan inte anges i användargränssnittet för villkor eller åtgärder. Dessa ges för användning av utvecklare i anpassad kod. Mer information: Skapa egna åtgärder

Lägga till stadier och steg

Åtgärder är en typ av process som liknar realtidsarbetsflöden. Alla steg som kan användas i realtidsarbetsflöden kan användas i åtgärder. Information om steg som kan användas för både realtidsarbetsflöden och åtgärder finns i Arbetsflödesstadier och steg.

Utöver de steg som kan användas för arbetsflöden i realtid, åtgärder också har Tilldela värde-steg. I åtgärder kan dessa användas som utdataargument. Du kan använda formulärassistenten för att ge utdataargument specifika värden eller, mer sannolikt, värden från den post som åtgärden körs mot, poster relaterade till posten med en N:1-relation, poster skapade i ett tidigare steg eller värden som är en del av själva processen.

Se även

Åtgärder
Starta anpassade åtgärder från ett arbetsflöde
Övervakning av realtidsarbetsflöden och åtgärder
Arbetsflödesprocesser
Översikt över affärsprocesser
Övervaka och hantera arbetsflödeprocesser
Skapa egna åtgärder