Skapa en anpassad processåtgärd

Använd anpassade processåtgärder när du vill automatisera en serie kommandon i systemet. Anpassade processåtgärder expanderar en terminologi som är tillgänglig för utvecklare för att uttrycka affärsprocesser. En anpassad processåtgärd använder kärnverb som tillhandahålls av systemet som till exempel, som skapa (Create), uppdatera (Update), ta bort (Delete) och tilldela (Assign) för att skapa mer uttrycksfulla verb, som godkänn (Approve), eskalera (Escalate), väg (Route) eller schema (Schedule). Om du ändrar definitionen av en affärsprocess kan någon som inte är utvecklare redigera anpassad processåtgärd så att koden inte behöver ändras.

Anteckning

Om du tänkt skriva ett plugin-program för att implementera logiken för en anpassad processåtgärd i stället för att använda arbetsflödesdesignern bör du använda anpassat API i stället. Mer information: Jämför åtgärder för anpassade processer och anpassat API

Skapa en anpassad processåtgärd

Viktigt

Om du skapar en anpassad processå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 anpassad processåtgärder 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.

• Tabell

  Med åtgärdsprocesser kan du välja en tabell 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 tabell 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 anpassad processåtgärd från grunden eller att starta från en befintlig mall.

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.

Anpassad processåtgärd har också något som arbetsflödesprocesser inte har – in- och utdataargument.

Anteckning

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

Redigera en anpassad processåtgärd

Innan du kan redigera anpassade processåtgärder måste du inaktivera dem.

Du kan redigera en anpassad processå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 anpassad processåtgärd 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.

  Anteckning

  Du kan inte aktivera återställning om en anpassad processåtgärd anropas direkt från ett arbetsflöde. Du kan aktivera återställning om en åtgärd som utlöses av ett Power Apps-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ägga till stadier och steg

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

Definiera processargument

När en utvecklare använder meddelanden kan de börja med vissa data som de kan skicka till meddelandet. Om du exempelvis vill skapa en ny ärenderad 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 anpassad processå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.
Tabell	En rad för den angivna tabellen. När du väljer tabell aktiveras den nedrullningsbara listan och gör att du kan välja tabelltypen.
entityCollection	En samling med tabellrader.
entityReference	Ett objekt som innehåller namn, id och typ av en tabellraden som unikt identifierar den. När du väljer entityReference aktiveras den nedrullningsbara listan och gör att du kan välja tabelltypen.
Float	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.

Anteckning

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 meddelanden

Lägga till stadier och steg

Anpassad processå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 rad som åtgärden körs mot, rader relaterade till rad med en N:1-relation, rader skapade i ett tidigare steg eller värden som är en del av själva processen.

Hanterade egenskaper

Anpassade processåtgärder har två relevanta hanterade egenskaper

Är anpassningsbar

Den hanterade egenskapen Är anpassningsbar styr om en användare som installerar en hanterad lösning som innehåller en anpassad processåtgärd kan redigera eller ta bort den. Om du vill att den anpassade processåtgärden ska redigeras eller tas bort när den ingår i hanterad lösning ska egenskapen anges som sann.

Är anpassat bearbetningssteg tillåtet för andra utgivare

Hanterade egenskapen Är anpassat bearbetningssteg tillåtet för andra utgivare styr om tredjeparts plugin-utvecklare kan registrera plugin-steg på meddelandet skapas av anpassade processåtgärden. När detta är sant körs plugin-program som har registrerats av vem som helst i det här meddelandet och kan ändra funktionen för den anpassade processåtgärden. Om falskt är det bara plugin-program som registrerats i en lösning från samma utgivare som körs.

Nästa steg

Anropa anpassade processåtgärder från ett arbetsflöde

Anteckning

Kan du berätta om dina inställningar för dokumentationsspråk? Svara i en kort undersökning. (observera att undersökningen är på engelska)

Undersökningen tar ungefär sju minuter. Inga personuppgifter samlas in (sekretesspolicy).