Konfigurer brugerdefinerede proceshandlinger fra en arbejdsproces

Du kan aktivere en brugerdefineret proceshandling fra en arbejdsproces i realtid uden at skrive kode. Flere oplysninger: Aktivere brugerdefinerede handlinger fra en arbejdsproces

Du kan også oprette en brugerdefineret proceshandling, så en udvikler kan bruge den i kode, eller det kan være nødvendigt at redigere en handling, som er defineret tidligere. Som med arbejdsprocesser i realtid skal du overveje følgende:

• Hvad skal handlingen foretage sig?

• Under hvilke betingelser skal handlingen udføres?

I modsætning til arbejdsprocesser i realtid behøver du ikke at angive følgende indstillinger :

• Start når:Brugerdefinerede proceshandlinger starter, når kode kalder den meddelelse, der er oprettet for dem.

• Omfang: Brugerdefinerede proceshandlinger køres altid i forbindelse med kald til bruger.

• Kør i baggrunden: Brugerdefinerede proceshandlinger er altid arbejdsprocesser i realtid.

Brugerdefinerede proceshandlinger indeholder også noget, som arbejdsprocesser i realtid ikke har – input- og outputargumenter. Flere oplysninger: Definere procesargumenter

Oprette en brugerdefineret proceshandling

Vigtigt

Hvis du opretter en handling, der skal medtages som en del af en løsning, der distribueres, skal du oprette den på baggrund af løsningen. Gå til Indstillinger > Løsninger, og find den ikke-administrerede løsning, som denne handling bliver en del af. Derefter skal du vælge Ny > Proces på menulinjen. Derved sikres, at det tilpasningspræfiks, der er knyttet til navnet på handlingen, er konsistent med andre komponenter i løsningen. Når du har oprettet handlingen, kan du ikke ændre præfikset.

Bemærk

Hvis du vil skrive en plug-in for at implementere din logik for en brugerdefineret proceshandling i stedet for at bruge arbejdsprocesdesigneren, skal du i stedet bruge brugerdefineret API. Flere oplysninger: Sammenligning af brugerdefineret proceshandling og brugerdefineret API

Som i arbejdsprocesser i realtid har handlinger følgende egenskaber i dialogboksen Opret proces:

• Procesnavn

  Når du har indtastet et navn til processen, oprettes der et entydigt navn for den ved at fjerne eventuelle mellemrum eller specialtegn i procesnavnet.

• Kategori

  Denne egenskab fastslår, at dette er en handlingsproces. Du kan ikke ændre dette, når du har gemt processen.

• Objekt

  Med handlingsprocesser kan du vælge en tabel for at give en kontekst for arbejdsprocessen i realtid på samme måde som andre typer processer, men du har også mulighed for at vælge Ingen (organisation). Brug denne indstilling, hvis din handling ikke kræver konteksten af en bestemt tabel. Du kan ikke ændre dette, når du har gemt processen.

• Type

  Brug denne egenskab til at vælge, om du vil oprette en ny brugerdefineret proceshandling fra bunden, eller om du vil starte ud fra en eksisterende skabelon.

Rediger en handling

Du skal deaktivere processer, før du kan redigere dem.

Du kan redigere en brugerdefineret proceshandling, som er oprettet som en del af en ikke-administreret løsning eller inkluderet i en løsning, der er installeret i organisationen. Hvis det er en administreret løsning, kan du muligvis ikke redigere den. Løsningsudgiveren har mulighed for at redigere de administrerede egenskaber, så den handling, der installeres sammen med en administreret løsning, ikke kan redigeres.

Når en handling gemmes, oprettes der et entydigt navn på basis af procesnavn. Det entydige navn er tildelt tilpasningspræfikset fra løsningsudgiveren. Det er navnet på den meddelelse, som en udvikler bruger i kode.

Når du redigerer en handling, har du følgende muligheder:

• Procesnavn

  Når processen er oprettet, og det entydige navn er genereret ud fra procesnavnet, kan du redigere procesnavnet. Du kan evt. anvende en navngivningskonvention for at gøre det nemmere at finde bestemte processer.

• Entydigt navn

  Når en brugerdefineret proceshandling gemmes, oprettes der et entydigt navn på basis af procesnavn. Det entydige navn er tildelt tilpasningspræfikset fra løsningsudgiveren. Det er navnet på den meddelelse, som en udvikler bruger i kode. Du skal ikke ændre det entydige navn, hvis processen er aktiveret, og der er kode, som forventer kald til handlingen ved hjælp af dette navn.

  Vigtigt

  Når handlingen er aktiveret, og koden er skrevet, så den bruger et entydigt navn, må det entydige navn ikke ændres uden også at ændre den kode, der henviser til det.

• Aktivér annullering af opdatering

  Generelt fortryder (eller annullerer) processer, der understøtter transaktioner, hele handlingen, hvis en del af dem mislykkes. Der er visse undtagelser. Handlinger, der udføres i kode af en udvikler, der er startet af en brugerdefineret proceshandling, understøtter måske ikke transaktioner. Det kan f.eks. være, hvis koden udfører handlinger i andre systemer, der er uden for omfanget af transaktionen. Disse kan ikke annulleres af den handling, der kører i en app. Nogle meddelelser på platformen understøtter ikke transaktioner. Men alt det, du kun kan gøre med brugergrænsefladen for handlingen, understøtter transaktioner. Alle handlinger, der er en del af en arbejdsproces i realtid, overvejes i transaktionen, men med handlinger har du mulighed for at fravælge dette.

  Du bør henvende dig til den udvikler, der skal anvende denne meddelelse, for at finde ud af, om den skal være i transaktionen eller ej. Generelt skal en handling være i transaktionen, hvis de handlinger, der udføres af forretningsprocessen ikke giver mening, medmindre de alle er fuldført. Det klassiske eksempel er overførsel af arbejdskapital mellem to bankkonti. Hvis du hæver arbejdskapital fra én konto, skal du deponere den i den anden. Hvis den ene ikke lykkes, mislykkes begge.

  Bemærk

  • Du kan ikke aktivere annullering af opdateringen, hvis en brugerdefineret proceshandling aktiveres direkte inde fra en arbejdsproces. Du kan aktivere annullering, hvis en brugerdefineret proceshandling udløses af en Power Apps-webtjenestemeddelelse.
  • Hvis den definerede handling ikke ændrer data, men kun henter data, er der visse situationer, hvor du kan forbedre ydeevnen ved at deaktivere Aktivér annullering af opdatering.

• Aktivér som

  På samme måde som med alle processer kan du aktivere processen som en skabelon og bruge den som et avanceret udgangspunkt for processer, der følger et lignende mønster.

• Definere procesargumenter

  I dette område skal du angive data, som handlingen forventer vil starte, og de data, der skal føres ud af handlingen. Flere oplysninger: Definere procesargumenter

• Tilføje faser, betingelser og handlinger

  På samme måde som med andre processer skal du angive, hvilke handlinger der skal udføres, og hvornår de skal udføres. Flere oplysninger: Tilføje faser, betingelser og handlinger

Definere procesargumenter

Når en udvikler bruger en meddelelse, begynder vedkommende måske med data, som han eller hun kan føre ind i meddelelsen. Hvis du f.eks. vil oprette en ny sagsrække, er det måske sagens titelværdi, der skal overføres som inputargument.

Når meddelelsen er færdig, skal udvikleren måske overføre visse data, der er ændret eller genereret af meddelelsen, til en anden handling i koden. Disse data er outputargumentet.

Både input- og outputargumenter skal have et navn, en type og visse oplysninger, der fortæller, om argumentet altid er påkrævet. Du kan også angive en beskrivelse.

Navnet på meddelelsen og oplysningerne om alle procesargumenter repræsenterer signaturen for meddelelsen. Når en handling er aktiveret, og den bruges i kode, må signaturen ikke ændres. Hvis signaturen ændres, medfører det, at kode, der bruger meddelelsen, mislykkes. Den eneste undtagelse er, at du kan ændre en af de parametrene, så den ikke altid er påkrævet.

Du kan ændre rækkefølgen af argumenterne ved at sortere dem eller flytte dem op eller ned, fordi argumenterne identificeres ved navn, ikke ved rækkefølgen. Og hvis du ændrer beskrivelsen, afbrydes kode, der bruger meddelelsen, ikke.

Argumenttyper for handlingsprocesser

I følgende tabel beskrives argumenttyperne for handlingsprocesser.

Skriv	Beskrivelse
Boolesk	En værdi af typen true eller false.
DateTime	En værdi, der gemmer oplysninger om dato og klokkeslæt.
Decimal	En talværdi med antal decimaler. Bruges, når præcisionstal er yderst vigtige.
Tabel	En række for den angivne tabel. Når du vælger Tabel, aktiveres rullelisten, hvor du kan vælge tabeltypen.
entityCollection	En samling af tabelrækker.
entityReference	Et objekt, der indeholder navn, id og typen af en tabelrække, der entydigt identificerer den. Når du vælger tableReference, aktiveres rullelisten, hvor du kan vælge tabeltypen.
Float	En talværdi med antal decimaler. Bruges, når data stammer fra en måleenhed, der ikke er fuldstændig præcis.
Heltal	Et heltal.
Penge	En værdi, der gemmer data om et pengebeløb.
Valgliste	En værdi, der repræsenterer en indstilling for en OptionSet-attribut.
String	En tekstværdi.

Bemærk

Værdier for argumentet entityCollection kan ikke angives i brugergrænsefladen for betingelser eller handlinger. Disse er tilgængelige til brug for udviklere i brugerdefineret kode. Flere oplysninger: Opret dine egne meddelelser

Tilføje faser og trin

Handlinger er en type proces, der er meget lig med arbejdsprocesser i realtid. Alle de trin, der kan bruges i arbejdsprocesser i realtid, kan bruges i handlinger. Du kan finde oplysninger om de trin, der kan bruges til både arbejdsprocesser i realtid og handlinger, i Faser og trin i arbejdsprocessen.

Ud over de trin, der kan bruges til arbejdsprocesser i realtid, har handlinger også trinnet Tildel værdi. I handlinger kan disse kun bruges til at angive outputargumenter. Du kan bruge formularassistenten til at angive outputargumenter til bestemte værdier eller, mere sandsynligt, til værdier fra den række, som handlingen køres på, rækker, der er relateret til den pågældende række med en mange til en-relation, rækker, der er oprettet i et tidligere trin, eller værdier, som er en del af selve processen.

Administrerede egenskaber

Brugerdefinerede proceshandlinger har to relevante administrerede egenskaber

Kan tilpasses

Den administrerede egenskab Is Customizabl e-styrede egenskabskontrolelementer, om en bruger, der installerer en administreret løsning, der indeholder den brugerdefinerede proceshandling, kan redigere eller slette den. Hvis du ønsker, at den brugerdefinerede proceshandling skal redigeres eller slettes, når den inkluderes i en administreret løsning, skal denne egenskab angives til sand.

Er brugerdefineret behandlingstrin tilladt for andre udgivere

Trinnet Er brugerdefineret behandling tilladt for andre udgivere-administrerede egenskabskontrolelementer styrer, om tredjeparts plug-in-udviklere kan registrere plug-in-trin i den meddelelse, der oprettes af den brugerdefinerede proceshandling. Når det er tilfældet, kører de plug-ins, der er registreret af nogen i denne meddelelse, og de kan ændre funktionsmåden for den brugerdefinerede proceshandling. Når false, er det kun de trin i plug-ins, der registreres i en løsning fra løsningsudgiver, der kører.

Næste trin

Bruge handlinger
Aktivér brugerdefinerede handlinger fra en arbejdsproces
Overvåge arbejdsprocesser og handlinger i realtid

Bemærk

Kan du fortælle os om dine sprogpræferencer for dokumentation? Tag en kort undersøgelse. (bemærk, at denne undersøgelse er på engelsk)

Undersøgelsen tager ca. syv minutter. Der indsamles ingen personlige data (erklæring om beskyttelse af personlige oplysninger).