Arbejdskøhandlinger
Arbejdskøer i Power Automate kan bruges til at lagre procesrelevante data og gør det muligt at afbilde komplekse processer og automatiseringer, så de kan kommunikere asynkront.
Arbejdskøer kan spille en væsentlig rolle for forbedringen af effektiviteten, skalerbarheden og fleksibiliteten i forbindelse med automatisering og prioritering af arbejde. Arbejdskøer giver dig mulighed for at udføre elementer med højeste prioritet først, uanset om de behandles af digitale medarbejdere, personale eller via integrationer.
Bemærk
- Understøttelse på produktionsniveau for det første sæt arbejdskøsrelaterede handlinger kræver Power Automate til skrivebord version 2.37 eller nyere.
- Handlinger for arbejdskø i Power Automate til skrivebord er en premium-funktion, der kræver et Power Automate-abonnement.
- I øjeblikket er det kun handlingerne Behandle arbejdskøelementer og Opdater arbejdskøelement, der kan klassificeres og tillades eller begrænses via DLP-politikker (politikker til forebyggelse af datatab). Der kommer snart andre handlinger. Bemærk, at cloudflowbaseret brug af arbejdskøer ikke kan begrænses af DLP-politikker.
Behandling af arbejdskøelementer
Handlingen Behandle arbejdskøelementer angiver for køorganisatoren, at maskinen er klar til at behandle et eller flere elementer i arbejdskøen. Den brugerkontekst, der anmoder om et nyt element, skal have tilstrækkelige rettigheder til tabellen over arbejdskøer og arbejdskøelementer for at kunne behandle arbejdskøer.
Den arbejdskø i den forrige handling bruges af kø-orkestratoren til at bestemme de næste tilgængelige elementer i den pågældende arbejdskø, der er i tilstanden Kø. Når skrivebordsflow gennemgår handlingerne i løkken Behandle arbejdskøelementer, som denne handling gengiver, kan du kalde på værdien ved at bruge den variabel, du har angivet til handlingen, sammen med egenskaben .Value. I dette tilfælde kan du kalde værdien af elementet i arbejdskøen ved hjælp af variablen %WorkQueueItem.Value%
Vigtigt!
Når du angiver et FetchXML-udtryk i feltet "Filterrækker", omgår du standardarbejdskøorkestratorens FIFO-logik for elementer, der er sat i kø. Dette giver dig mulighed for at angive en brugerdefineret rækkefølge for fjernelse fra kø og ignorere udløbsdatoer for varer og andre indstillinger, der anvendes automatisk, når der ikke er angivet et filterudtryk.
Processworkqueueitemaction
Handlingen Behandle arbejdskøelement kræver følgende argumenter.
Inputparametre
| Argument | Valgfrit | Accepterer | Standardværdi | Description |
|---|---|---|---|---|
| Arbejdskø | Nej | SMS-besked | Id'et for arbejdskøen for den arbejdskø, der indeholder elementer, der skal behandles. | |
| Filtrer rækker | Ja | SMS-besked | Det FetchXML forespørgselsudtryk, der bruges til at hente elementer fra arbejdskøen. | |
| Overskriv konfiguration af automatisk forsøg på arbejdskø | Ja | Boolean | False | Når indstillingen er aktiveret, vises der et felt, hvor du kan angive eller overskrive det maksimale antal forsøg for IT Exceptions. |
| Maks. antal gentagelse af forsøg | Nej | Tekstværdi, Numerisk værdi | Når den ikke overskrives, bruges det maksimale antal standardforsøg, der er defineret for arbejdskøposten. | Det højeste antal tilladte forsøg for IT Exceptions. Med denne parameter kan du justere antallet af nye forsøg til en højere eller lavere værdi eller endda deaktivere mekanismen for nyt forsøg ved at indstille antallet til 0. |
Oprettede variabler
| Argument | Type | Description |
|---|---|---|
| WorkQueueItem | Nej | Oplysninger, der er gemt i elementet i arbejdskøen, som behandles |
Undtagelser
| Undtagelse | Beskrivelse |
|---|---|
| Arbejdskøen blev ikke fundet | Den værdi, der er angivet i parameteren for arbejdskøen, er ugyldig. |
| Arbejdskøen er standset midlertidigt eller stoppet | Arbejdskøen er sat på pause eller stoppet, hvilket ikke er en gyldig tilstand, når elementer behandles. |
| Ugyldig FetchXML | Der blev angivet et ugyldigt FetchXML-udtryk. |
| Arbejdskøen kunne ikke behandles | Ugyldig anmodning – fejl i forespørgselssyntaks. |
Hvad er FetchXML forespørgsler?
Microsoft Dataverse FetchXML er et sprog, der bruges til at hente data fra en Dataverse database. Det er udviklet, så det er nemt at oprette, bruge og forstå. Du kan f.eks. bede orkestratoren om at behandle elementer i en anden rækkefølge end FIFO (first-in-first-out) og inden for en bestemt udløbstidsramme.
Hvis du vil begrænse FetchXML-forespørgselssupporten til behandling af arbejdskøelementer, understøttes et begrænset sæt FetchXML-termer og -udtryk. Disse udtryk omfatter filtre, betingelser og ordreudtryk, som alle er begrænset til tabellen arbejdskøelement (workqueueitem). Kun elementer, der er i tilstanden Queued, returneres.
Eksempel på FetchXML-forespørgsel
Følgende er et eksempel på et forespørgselsudtryk for, hvordan du filtrerer på name og sorterer resultaterne efter de poster, der udløber først (FEFO).
<filter type="and">
<condition attribute="expirydate" operator="on-or-before" value="2024-10-18" />
<condition attribute="name" operator="eq" value="MyNonUniqueNameString" />
</filter>
<order attribute="expirydate" descending="false" />
Supportdetaljer og referencedata til forespørgsler
- Liste over forespørgselsoperatorer, der kan bruges, herunder operatorer som f.eks. on-or-before, between og last-month.
- Liste over attributter, der er tilgængelige i tabellen arbejdskøelement.
Opdater arbejdskøelement
Handlingen Opdater arbejdskøelement giver brugere mulighed for at ændre status for og behandle resultaterne af det valgte element i arbejdskøen.
Updateworkqueueitemaction
Handlingen Opdatere arbejdskøelement kræver følgende argumenter.
| Argument | Valgfrit | Accepterer | Standardværdi | Beskrivelse |
|---|---|---|---|---|
| Arbejdskøelement | Nej | SMS-besked | Elementvariabel for arbejdskø, der tidligere er returneret af køorganisatoren | |
| Status | Nej | Behandlet, Generisk undtagelse | Forarbejdede | Opdater det element i arbejdskøen, der behandles, ved hjælp af en status fra listen over indstillinger. |
| Behandlingsnoter | Ja | SMS-besked | Brugerdefinerede behandlingsnoter eller værdier, der skal føjes til det køelement, der behandles. | |
| Ryd behandlingsnoter | Ja | Boolean | False | Når det er aktiveret, skjules og ryddes feltet med behandlingsnoter på denne skærm, og eventuelle behandlingsnoter fjernes fra den database, der tidligere er registreret for dette element. |
Undtagelser
| Argument | Description |
|---|---|
| Arbejdskøelement blev ikke fundet | Elementet i arbejdskøen, der behandles, er enten blevet slettet eller tilhører ikke længere den kø, det blev kaldt fra. |
| Arbejdskøelement er i venteposition | Det arbejdskøelement, der behandles, indeholder statussen on hold i køorganisatoren og kan ikke længere opdateres. |
| Arbejdskøelementet kunne ikke opdateres | Det arbejdskø element, der opdateres, er stødt på en uventet fejl. Se flere oplysninger i fejlmeddelelser. |
Tilføj et arbejdskøelement
Handlingen Tilføj arbejdskøelement gør det muligt for brugere at udfylde elementer i arbejdskøen i en arbejdskø, der er konfigureret i flowportalen.
Enqueueworkqueueitemaction
Handlingen Tilføj arbejdskøelement kræver følgende argumenter.
Inputparametre
| Argument | Valgfrit | Accepterer | Standardværdi | Description |
|---|---|---|---|---|
| Arbejdskø | Nej | Tekstværdi | Det arbejdskøelement, som elementet skal føjes til | |
| Prioritet | Nej | Høj, Normal, Lav | Normal | Den prioritet, der angives for elementet i arbejdskøen |
| Navn | Nej | Tekstværdi, Numerisk værdi | Brugerdefineret navn eller id for det nye arbejdskøelement | |
| Input | Nej | Tekstværdi, Numerisk værdi | De data, der tilhører den værdikolonne, der skal behandles | |
| Udløber | Ja | Datetime | Den dato-/klokkeslætsværdi, der er angivet, hvor køelementet udløber. Ellers anvendes standardværdien, hvis der er angivet en for køen | |
| Behandlingsnoter | Ja | Tekstværdi, Numerisk værdi | Brugerdefinerede noter om behandling, der skal føjes til det nye køelement | |
| Har entydigt id eller entydig reference | Ja | Tekstværdi, Numerisk værdi | Når indstillingen er aktiveret, skal der gives en værdi, der er entydig i denne kø. Hvis værdien ikke er angivet, oprettes der automatisk en unik værdi i systemets format system-<GUID> |
Oprettede variabler
| Argument | Type | Description |
|---|---|---|
| WorkQueueItem | Nej | Oplysninger, der er gemt for det element i arbejdskøen, som tilføjes |
Undtagelser
| Argument | Beskrivelse |
|---|---|
| Arbejdskøen blev ikke fundet | Den værdi, der er angivet i parameteren for arbejdskøen, er ugyldig |
| Elementet kunne ikke føjes til arbejdskøen | Arbejdskøelementet kan ikke tilføjes i arbejdskøen. Forkert anmodning - fejl i forespørgselssyntaks |
Tilføj flere arbejdskøelementer
Handlingen Tilføj flere arbejdskøelementer giver brugerne mulighed for at føje et eller flere arbejdskøelementer til en arbejdskø baseret på de data, der er angivet som datatabellen for arbejdskøelementet.
Denne handling kræver en brugerdefineret datatabel, der indeholder et eller flere arbejdskøelementer. Datatabellen skal have otte kolonner og overholde følgende skema:
| Kolonnenavn | Description | Påkrævet | Tilladte værdier |
|---|---|---|---|
| Name | Varens navn. | Nej | Enhver alfanumerisk streng |
| Input | Inputdetaljer eller data for elementet. | Ja | Enhver alfanumerisk streng |
| Udløber om | Angiver varighed, indtil elementet udløber. | Nej | Værdi for dato og klokkeslæt |
| Behandlingsnoter | Behandlingsnoter, der er relateret til elementet. | Nej | Enhver alfanumerisk streng |
| Prioritet | Prioritetsniveauet for elementet. | Ja | Numerisk værdi på enten 100 (Høj), 200 (Normal), 300 (Lav) |
| Entydigt reference | Et entydigt id eller en entydig referenceværdi for elementet. | Nej | Enhver entydig alfanumerisk streng eller reference |
| Status | Status af elementet ved indtagelse. | Ja | Numerisk værdi af nul (sat i kø), én (I venteposition). |
| Forsink indtil | Angiver en dato og et klokkeslæt, indtil arbejdskøen skal ignoreres til behandling af elementerne. | Nej | Værdi for dato og klokkeslæt |
Robin-kodestykke til oprettelse af datatabellen
Følgende eksempel er et robin-kodestykke (bruges i traditionelle arbejdsgange), som du kan kopiere og indsætte direkte i vinduet med Power Automate-skrivebordsdesigneren. Dette kodestykke føjer handlingen Opret ny datatabel med det forventede sæt felter til dit flow.
Variables.CreateNewDatatable InputTable: { ^['Name', 'Input', 'Expires in', 'Processing notes', 'Priority', 'Unique reference', 'Status', 'Delay until'], [$'''''', $'''''', $'''''', $'''''', $'''''', $'''''', $'''''', $''''''] } DataTable=> DataTable
PowerFx-kodestykke til oprettelse af datatabellen
Følgende eksempel er et PowerFx-kodestykke, som du kan kopiere og indsætte direkte i vinduet med Power Automate-skrivebordsdesigneren. Dette kodestykke føjer handlingen Opret ny datatabel med det forventede sæt felter til dit flow.
Variables.CreateNewDatatable InputTable: { ^['Name', 'Input', 'Expires in', 'Processing notes', 'Priority', 'Unique reference', 'Status', 'Delay until'], [$fx'', $fx'', $fx'', $fx'', $fx'', $fx'', $fx'', $fx''] } DataTable=> DataTable
Batchenqueueworkqueueitemsaction
Handlingen Tilføj flere arbejdskøelementer kræver følgende argumenter.
Inputparametre
| Argument | Valgfrit | Accepterer | Standardværdi | Description |
|---|---|---|---|---|
| Arbejdskø | Nej | Text value | Det arbejdskøelement, som elementet skal føjes til | |
| Data til arbejdskøelement | Ja | Datatabel | Den brugerdefinerede datatabel, der indeholder arbejdskøelementer, der skal føjes til arbejdskøen |
Oprettede variabler
| Argument | Type | Standardværdi | Description |
|---|---|---|---|
| FailedWorkQueueItems | Nej | Aktiveret | Hvis der er fejl, indeholder dette objekt indekset for det element, der ikke blev indsat sammen med en fejlkode. Det indeks, der returneres, er placeringen (indekset) af elementet i den angivne data tabel for arbejdskø for handlingen Tilføj flere elementer til arbejdskøen . |
| HasFailedItems | Nej | Aktiveret | En indikator for, om handlingerne stødte på indlæsningsfejl pga. problemer med arbejdskøelementdata. |
| SuccessfulWorkQueueItems | Disabled | Nej | Et brugerdefineret objekt, som indeholder indekset og arbejdskøelementer, der blev føjet til arbejdskøen. |
Undtagelser
| Argument | Description |
|---|---|
| Arbejdskøen blev ikke fundet | Den værdi, der er angivet i parameteren for arbejdskøen, er ugyldig |
| Arbejdskøen er standset midlertidigt eller stoppet | Arbejdskøelementet kunne ikke føjes til arbejdskøen, fordi arbejdskøen er sat på pause eller stoppet. |
| Det mislykkedes at sætte en liste over arbejdskøelementer i batchkø | Arbejdskøelementerne kunne ikke føjes til arbejdskøen på grund af en anmodnings- eller kommunikationsfejl. |
Sæt element i kø igen med forsinkelse
Handlingen sætte i kø igen med forsinkelse giver brugere mulighed for at tilføje et køelement, der behandles i skrivebordsflow, tilbage til dets oprindelige kø. Derudover kan det element, der er sat i kø, opbevares og frigives indtil et defineret tidspunkt.
Requeueworkqueueitemaction
Handlingen Sæt i kø igen med forsinkelse kræver følgende argumenter.
Inputparametre
| Argument | Valgfrit | Accepterer | Standardværdi | Description |
|---|---|---|---|---|
| Arbejdskøelement | Nej | Arbejdskøelement | Det arbejdskøelement, som elementet skal føjes til | |
| Forsink indtil | Nej | Datetime-værdi | Normal | Den datetime-værdi, der anvendes til at udskyde køelementet, indtil |
| Udløber | Ja | Datetime-værdi | Brugerdefineret udløbstid for det element, der skal genforespørges | |
| Behandlingsnoter | Ja | Tekstværdi, Numerisk værdi | Brugerdefinerede noter om behandling, der skal føjes til det nye køelement | |
| Ryd behandlingsnoter | Ja | Boolean | False | Når det er aktiveret, skjules og ryddes feltet med behandlingsnoter på denne skærm, og eventuelle behandlingsnoter fjernes fra den database, der tidligere er registreret for dette element |
Undtagelser
| Argument | Description |
|---|---|
| Arbejdskøen blev ikke fundet | Den værdi, der er angivet i parameteren for arbejdskøen, er ugyldig |
| Arbejdskøelement blev ikke fundet | Værdien for køelementet er ugyldig |
| Arbejdskøelementet kunne ikke sættes i kø igen | Arbejdskøelementet kan ikke tilføjes i arbejdskøen. Forkert anmodning - fejl i forespørgselssyntaks |
Opdater behandlingsnoter for arbejdskøelement
Handlingen Opdater behandlingsnoter for arbejdskø-element giver brugere mulighed for at opdatere eller rydde behandlingsnoter for det valgte arbejdskø-element uden at ændre tilstanden eller nogen anden egenskab.
updateprocessingnotesaction
Handlingen Opdater behandlingsnoter for arbejdskø-element nødvendiggør følgende argumenter.
| Argument | Valgfrit | Accepterer | Standardværdi | Description |
|---|---|---|---|---|
| Arbejdskøelement | Nej | SMS-besked | Arbejdskø elementvariabel, der tidligere er returneret af kø-orkestratoren | |
| Behandlingsnoter | Ja | SMS-besked | Brugerdefineret behandlingsresultat eller værdi, der skal føjes til det behandlede kø-element | |
| Ryd behandlingsnoter | Ja | Boolean | False | Når det er aktiveret, skjules og ryddes feltet med behandlingsnoter på denne skærm, og eventuelle behandlingsnoter fjernes fra den database, der tidligere er registreret for dette element |
Undtagelser
| Argument | Description |
|---|---|
| Arbejdskøen blev ikke fundet | Det arbejdskø, der er knyttet til elementet, er enten blevet slettet eller er ikke længere tilgængeligt |
| Arbejdskøelement blev ikke fundet | Arbejdskø-elementet er ugyldigt |
| Kunne ikke tilføje behandlingsresultater | Det arbejdskø element, der opdateres, er stødt på en uventet fejl. Se flere oplysninger i fejlmeddelelser. |
Hent arbejdskøelementer med filter
Handlingen Hent arbejdskøelementer efter filter giver brugerne mulighed for at hente et eller flere arbejdskøelementer baseret på et FetchXML filterudtryk.
Getworkqueueitemsaction
Handlingen Hent arbejdskøelementer efter filter kræver følgende argumenter.
Inputparametre
| Argument | Valgfrit | Accepterer | Standardværdi | Description |
|---|---|---|---|---|
| Arbejdskø | Nej | SMS-besked | Arbejdskø, der skal hentes elementer fra | |
| Filtrer rækker | Nej | SMS-besked | FetchXML-forespørgselsudtryk, der bruges til at hente elementer fra arbejdskøen | |
| Rækker, der skal returneres | Nej | Nummer | 5000 | Det maksimale antal arbejdskøelementer, der returneres af orkestratoren |
Oprettede variabler
| Argument | Type | Standardværdi | Description |
|---|---|---|---|
| WorkQueueItems | Nej | Aktiveret | Liste over arbejdskøelementer, der svarer til filterudtrykket. |
Undtagelser
| Argument | Description |
|---|---|
| Arbejdskø | Den arbejdskø, der skal hentes elementer fra. |
| Filtrer rækker | Det FetchXML forespørgselsudtryk, der bruges til at hente elementer fra arbejdskøen. |
| Rækker, der skal returneres | Det maksimale antal arbejdskøelementer, der returneres af orkestratoren (standard er 5000). |
Hvad er FetchXML forespørgsler?
Microsoft Dataverse FetchXML er et sprog, der bruges til at hente data fra en Dataverse database. Det er udviklet, så det er nemt at oprette, bruge og forstå. Du vil måske f.eks. bede Dataverse at få vist en liste over alle arbejdskøelementer, der er i IT Exception-tilstand.
Hvis vi vil begrænse understøttelsen af FetchXml-forespørgsler til hentning af arbejdskøelementer, understøtter vi kun et begrænset sæt FetchXML-termer og -udtryk. Disse termer og udtryk omfatter attributter, filtre, betingelser og ordreudtryk, som alle er begrænset til tabellen med arbejdskøelementet (workqueueitem). Du skal eksplicit angive, hvilke egenskaber der skal returneres fra arbejdskøelementtabellen og den ønskede sorteringsrækkefølge.
Eksempel på FetchXML-forespørgsel
Følgende eksempel er et forespørgselsudtryk for, hvordan du henter flere egenskaber, filtrerer fejlbehæftede elementer, der er markeret som IT Exceptions, og sorterer resultaterne efter de poster, der udløber først (FEFO).
<attribute name="statecode" />
<attribute name="uniqueidbyqueue" />
<attribute name="createdon" />
<attribute name="completedon" />
<attribute name="workqueueitemid" />
<attribute name="executioncontext" />
<attribute name="name" />
<attribute name="expirydate" />
<attribute name="processingresult" />
<attribute name="priority" />
<attribute name="statuscode" />
<attribute name="modifiedon" />
<attribute name="processingstarttime" />
<attribute name="retrycount" />
<attribute name="requeuecount" />
<attribute name="input" />
<attribute name="delayuntil" />
<filter type="and">
<condition attribute="statecode" operator="eq" value="4" />
<condition attribute="statuscode" operator="eq" value="5" />
<condition attribute="expirydate" operator="on-or-before" value="2024-10-18" />
</filter>
<order attribute="expirydate" descending="false" />
Supportdetaljer og referencedata til forespørgsler
- Liste over forespørgselsoperatorer, der kan bruges, herunder operatorer som f.eks. on-or-before, between og last-month.
- Liste over attributter, der er tilgængelige i tabellen arbejdskøelement.
Status (statecode)
| Status | Kode | Description |
|---|---|---|
| I kø | 0 | Elementet er sat i kø |
| Forarbejdning | 0 | Elementet behandles |
| Forarbejdede | 2 | Elementet blev behandlet |
| I venteposition | 3 | Elementet er sat på hold |
| Error | 4 | Der opstod en fejl i elementet |
Årsag til status (statuscode)
| Statusårsag | Kode | Description |
|---|---|---|
| I kø | 0 | Elementet er sat i kø |
| Forarbejdning | 0 | Elementet behandles |
| Forarbejdede | 2 | Elementet blev behandlet |
| OnHold (sat på pause) | 3 | Elementet er sat på hold (sat på pause) |
| Generisk undtagelse | 4 | Der opstod en generisk undtagelse for elementet |
| IT-undtagelse | 5 | Der opstod en IT-undtagelse for elementet |
| Forretningsmæssig undtagelse | 6 | Der opstod en forretningsundtagelse for elementet |
| Uanbringeligt brev | 7 | Elementet er på hold |
| ProcessingTimeout | 8 | Timeout for elementbehandling |