Arbetsköåtgärder
Arbetsköer i Power Automate kan användas för att lagra processrelevanta data och ge ett sätt att frikoppla komplexa processer och automatiseringar, detta så att de kan kommunicera asynkront.
Arbetsköer kan spela en viktig roll när det gäller att öka effektiviteten, skalbarheten och underlätta automatiseringar samt prioritera arbetet. Med arbetsköer kan du först slutföra objekt med högsta prioritet, oavsett om de bearbetas av digitala medarbetare, personer eller via integreringar.
Kommentar
- Produktionsstöd för den första uppsättningen med arbetskörelaterade åtgärder kräver Power Automate dator version 2.37 eller senare.
- Arbetsköåtgärder i Power Automate för datorer är en premium-funktion som kräver en Power Automate prenumeration.
- För närvarande är det bara åtgärderna Bearbeta arbetsköobjekt och Uppdatera arbetsköobjekt som kan användas för att förhindra dataförlust och andra åtgärder kommer snart att vidtas. Observera att molnbaserad användning av arbetsköer inte kan begränsas av DLP-principer.
Bearbeta arbetsköobjekt
Åtgärden Bearbeta arbetsköobjekt indikerar till köorganisatören att datorn är redo att bearbeta en eller flera arbetsköobjekt. Användarkontexten som begär ett nytt objekt måste ha tillräckliga privilegier i tabellen arbetskö och arbetsköobjekt för att arbetsköer ska kunna bearbetas.
Den arbetskö som har använts i den föregående åtgärden används av köinitieraren för att fastställa nästa tillgängliga objekt i arbetskö som är i tillståndet kö. När arbetsflödessteget igenom åtgärderna i slingan Bearbeta arbetsköobjekt som den här åtgärden återges, kan du anropa värdet genom att använda variabeln du har angett för åtgärden tillsammans med egenskapen .Value. I det här fallet kan du anropa värdet för arbetsköobjektet med variabeln %WorkQueueItem.Value%
Viktigt
Genom att ange ett FetchXML-uttryck i fältet "Filtrera rader" kringgår du standardarbetsköinitiatorns FIFO-logik för köade objekt. På så sätt kan du ange en anpassad ordning för att ta ur kön och ignorera objektets förfallodatum och andra inställningar som tillämpas automatiskt när inget filteruttryck anges.
Processworkqueueitemaction
För åtgärden Bearbeta arbetsköobjekt krävs följande argument.
Indataparametrar
| Argument | Valfri | Accepterar | Standardvärde | Description |
|---|---|---|---|---|
| Arbetskö | Nej | Text | Arbetskö-ID för arbetskön som innehåller objekt att bearbeta. | |
| Filtrera rader | Ja | Text | Frågeuttrycket FetchXML används för att hämta objekt från arbetskön. | |
| Skriva över automatiska nya konfigurationsförsök för arbetskö | Ja | Booleskt | Falsk | När det här alternativet är aktiverat visas ett fält där du kan ange eller skriva över det maximala antalet återförsök för IT Exceptions. |
| Maximalt antal nya försök | Nej. | Textvärde, Numeriskt värde | När det inte skrivs över används det maximala antalet återförsök som har definierats för arbetsköposten. | Det maximala antalet tillåtna återförsök för IT Exceptions. Med den här parametern kan du justera antalet återförsök till ett högre eller lägre värde, eller till och med inaktivera återförsöksmekanismen genom att ange antalet till 0. |
Producerade variabler
| Argument | Type | Description |
|---|---|---|
| WorkQueueItem | Nej | Information som lagras i det arbetsköobjekt som bearbetas |
Undantag
| Undantag | Beskrivning |
|---|---|
| Arbetskön hittades inte | Värdet som anges i arbetsköparametern är ogiltigt. |
| Arbetskön har pausats eller stoppats | Arbetskön är antingen pausad eller stoppad, vilket inte är ett giltigt tillstånd när objekt bearbetas. |
| Ogiltig FetchXML | Ett ogiltigt FetchXML-uttryck har tillhandahållits. |
| Det gick inte att bearbeta arbetskön | Felbegäran – fel i frågesyntaxen. |
Vad är FetchXML-frågor?
Microsoft Dataverse FetchXML är ett språk som används för att hämta data från en Dataverse-databas. Det är utformat för att vara enkelt att skapa, använda och förstå. Du kanske till exempel vill be initiatorn att bearbeta objekt i en annan ordning än FIFO (first-in-first-out) och inom en viss tidsram för förfallodatum.
För att begränsa FetchXML-frågestödet till bearbetning av arbetsköobjekt stöds en begränsad uppsättning FetchXML-termer och -uttryck. Dessa villkor omfattar filter, villkor och ordningsuttryck, som alla är begränsade till tabellen för arbetsköobjekt (workqueueitem). Endast objekt som har statusen Queued returneras.
FetchXML-exempelfråga
Följande är ett exempel på ett frågeuttryck för hur du filtrerar name och sorterar resultaten efter de poster som upphör att gälla 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" />
Information om frågestöd och referensdata
- Lista över frågeoperatorer som är tillgängliga för användning, inklusive operatorer som "on-or-before" (på datum eller före), "between" (mellan) och "last-month" (senaste månaden).
- Lista över attribut som är tillgängliga i tabellen med arbetsköobjekt.
Uppdatera arbetsköobjekt
Åtgärden Uppdatera arbetsköobjekt kan användare ändra status och bearbeta resultat för det valda arbetsköobjektet.
Updateworkqueueitemaction
För åtgärden Uppdatera arbetsköobjekt krävs följande argument.
| Argument | Valfri | Accepterar | Standardvärde | Beskrivning |
|---|---|---|---|---|
| Arbetsköobjekt | Nej | Text | Variabel för arbetsköobjekt som tidigare har returnerats av köorganisatören | |
| Status | Nej | Bearbetad, generiskt undantag | Bearbetat | Uppdatera arbetsköobjektet som bearbetas med hjälp av en status i listan med alternativ. |
| Bearbetningsanteckningar | Ja | Text | Anpassad bearbetning av anteckningar eller värde för att lägga till i köobjektet som bearbetas. | |
| Rensa bearbetningsanteckningar | Ja | Booleskt | Falsk | När funktionen aktiveras, döljs och rensas fältet med bearbetningsanteckningar på den här skärmen och alla bearbetningsanteckningar som tidigare registrerats för objektet tas bort från databasen. |
Undantag
| Argument | Description |
|---|---|
| Arbetsköobjektet hittades inte | Arbetsköobjektet som bearbetas har antingen tagits bort eller inte längre tillhör den kö som det anropades från. |
| Arbetsköobjekt har spärrats | Arbetsköobjektet som bearbetas innehåller statusen on hold i köorganisatören och kan inte längre uppdateras. |
| Det gick inte att uppdatera arbetsköobjektet | Ett arbetsköobjektet som uppdateras har påträffat ett oväntat fel. Kontrollera felmeddelandet för mer information. |
Lägg till arbetsköobjekt
Med åtgärden Lägg till arbetsköobjekt kan användare fylla i arbetsköobjekt som har ställts in i flödesportalen.
Enqueueworkqueueitemaction
För åtgärden Lägg till arbetsköobjekt krävs följande argument.
Indataparametrar
| Argument | Valfri | Accepterar | Standardvärde | Description |
|---|---|---|---|---|
| Arbetskö | Nej | Textvärde | Arbetsköobjektet som objektet ska läggas till i | |
| Prioritet | Nej | Hög, normal, låg | Normal | Prioritet att ange arbetsköobjektet till |
| Namn | Nej | Textvärde, Numeriskt värde | Anpassat namn eller ID för det nya arbetsköobjektet | |
| Indata | Nej. | Textvärde, Numeriskt värde | Data som hör till den värdekolumn som ska bearbetas | |
| Förfaller | Ja | Datetime | Det datetime-värde som angetts som förfaller köobjektet, annars används standardvärdet om ett är inställt för kön | |
| Bearbetningsanteckningar | Ja | Textvärde, Numeriskt värde | Anpassa bearbetningsanteckningar som ska läggas till i det nya köobjektet | |
| Har unikt ID eller referens | Ja | Textvärde, Numeriskt värde | När det är aktiverat ska ett värde tillhandahållas som är unikt i den här kön. Om det lämnas tomt, ett unikt värde i formatet system-<GUID> tillhandahålls automatiskt av systemet |
Producerade variabler
| Argument | Type | Description |
|---|---|---|
| WorkQueueItem | Nej | Information som lagras för det arbetsköobjekt som läggs till |
Undantag
| Argument | Beskrivning |
|---|---|
| Arbetskön hittades inte | Värdet som anges i arbetsköparametern är ogiltigt |
| Det gick inte att lägga till objekt i arbetskö | Arbetsköobjektet kunde inte läggas till i arbetskön. Felbegäran – fel i frågesyntaxen |
Lägg till flera arbetsköobjekt
Med åtgärden Lägg till flera arbetsköobjekt kan användare lägga till ett eller flera arbetsköobjekt i en arbetskö baserat på de data som finns i datatabellen för arbetsköobjekt.
Den här åtgärden kräver en anpassad datatabell som innehåller ett eller flera arbetsköobjekt. Datatabellen måste ha åtta kolumner och följa följande schema:
| Kolumnnamn | Description | Obligatoriskt | Tillåtna värden |
|---|---|---|---|
| Name | Namnet på objektet. | Nej. | Valfri alfanumerisk sträng |
| Indata | Information om indata eller objektets data. | Ja | Valfri alfanumerisk sträng |
| Förfaller om | Anger varaktigheten tills objektet upphör att gälla. | Nej. | Datum- och tidsvärde |
| Bearbetningsanteckningar | Bearbetar anteckningar som är relaterade till objektet. | Nej. | Valfri alfanumerisk sträng |
| Prioritet | Objektets prioritetsnivå. | Ja | Numeriskt värde för antingen 100 (hög), 200 (normal), 300 (låg) |
| Unik referens | En unik identifierare eller ett referensvärde för objektet. | Nej. | En unik alfanumerisk sträng eller referens |
| Tillstånd | Status för objektet vid inmatning. | Ja | Numeriskt värde antingen noll (i kö) eller ett (spärrat). |
| Senarelägg tills | Anger ett datum och en tid tills arbetsköobjekten ska ignoreras för bearbetning. | Nej. | Datum- och tidsvärde |
Robin-kodfragment för att skapa datatabellen
Följande exempel är ett robin-kodfragment (används i traditionella flöden) som du kan kopiera och klistra in direkt i fönstret i Power Automate-skrivbordsdesignern. Detta kodfragment lägger till en åtgärd av typen Skapa ny datatabell med den förväntade uppsättningen fält i flödet.
Variables.CreateNewDatatable InputTable: { ^['Name', 'Input', 'Expires in', 'Processing notes', 'Priority', 'Unique reference', 'Status', 'Delay until'], [$'''''', $'''''', $'''''', $'''''', $'''''', $'''''', $'''''', $''''''] } DataTable=> DataTable
PowerFx-kodfragment för att skapa datatabellen
Följande exempel är ett PowerFx-kodfragment som du kan kopiera och klistra in direkt i fönstret i Power Automate-skrivbordsdesignern. Detta kodfragment lägger till en åtgärd av typen Skapa ny datatabell med den förväntade uppsättningen fält i flödet.
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
Åtgärden Lägg till flera arbetsköobjekt kräver följande argument.
Indataparametrar
| Argument | Valfri | Accepterar | Standardvärde | Description |
|---|---|---|---|---|
| Arbetskö | Nej. | Textvärde | Arbetsköobjektet som objektet ska läggas till i | |
| Data för arbetsköobjekt | Ja | Datatabell | Den anpassade datatabell som innehåller arbetsköobjekt som ska läggas till i arbetskön |
Producerade variabler
| Argument | Type | Standardvärde | Description |
|---|---|---|---|
| FailedWorkQueueItems | Nej. | Aktiverat | Om det uppstår fel innehåller det här objektet indexet för objektet som inte kunde infogas, tillsammans med en felkod. Det index som returneras är objektets position (index) i den angivna arbetsködatatabellen för åtgärden Lägg till flera arbetsköobjekt. |
| HasFailedItems | Nej. | Aktiverat | En indikator för om åtgärderna påträffade inmatningsfel på grund av dataproblem med arbetsköobjekt. |
| SuccessfulWorkQueueItems | Inaktiverat | Nej. | Ett anpassat objekt som innehåller index- och arbetsköobjekt som har lagts till i arbetskön. |
Undantag
| Argument | Description |
|---|---|
| Arbetskön hittades inte | Värdet som anges i arbetsköparametern är ogiltigt |
| Arbetskön har pausats eller stoppats | Det gick inte att lägga till arbetsköobjektet i arbetskön eftersom kön antingen är pausad eller stoppad. |
| Det gick inte att sätta en lista med arbetsköobjekt i batchkö | Det gick inte att lägga till arbetsköobjekten i arbetskön på grund av ett begärande- eller kommunikationsfel. |
Köa om objekt med fördröjning
Med åtgärden Köa om objekt med fördröjning kan användare läsa ett köobjekt som bearbetas i datorflöde, tillbaka till den ursprungliga kön. Dessutom kan det köade objektet hållas kvar och släppas under en angiven tid.
Requeueworkqueueitemaction
För åtgärden Ställ objekt i kö med fördröjning krävs följande argument.
Indataparametrar
| Argument | Valfri | Accepterar | Standardvärde | Description |
|---|---|---|---|---|
| Arbetsköobjekt | Nej | Arbetsköobjekt | Arbetsköobjektet som objektet ska läggas till i | |
| Senarelägg tills | Nr | Datetime-värde | Normal | Det dateetime-värde som tillämpats för att skjuta upp köobjektet tills |
| Förfaller | Ja | Datetime-värde | Anpassad förfallotid för objektet som köas på nytt | |
| Bearbetningsanteckningar | Ja | Textvärde, Numeriskt värde | Anpassa bearbetningsanteckningar som ska läggas till i det nya köobjektet | |
| Rensa bearbetningsanteckningar | Ja | Booleskt | Falsk | När funktionen aktiveras, döljs och rensas fältet med bearbetningsanteckningar på den här skärmen och alla bearbetningsanteckningar som tidigare registrerats för objektet tas bort från databasen |
Undantag
| Argument | Description |
|---|---|
| Arbetskön hittades inte | Värdet som anges i arbetsköparametern är ogiltigt |
| Arbetsköobjektet hittades inte | Köobjektvärdet är ogiltigt |
| Det gick inte att köa arbetsköobjektet på nytt | Arbetsköobjektet kunde inte läggas till i arbetskön. Felbegäran – fel i frågesyntaxen |
Uppdatera bearbetningsanteckningar för arbetsköobjekt
Med åtgärden Uppdatera bearbetningsanteckningar för arbetsköobjekt kan användare uppdatera eller rensa anteckningar för arbetsköobjekt utan att ändra tillståndet eller någon annan egenskap.
updateprocessingnotesaction
Åtgärden Bearbetningsanteckningar för uppdatera arbetsköobjekt kräver följande argument.
| Argument | Valfri | Accepterar | Standardvärde | Description |
|---|---|---|---|---|
| Arbetsköobjekt | Nej. | Text | Variabel för arbetsköobjekt som tidigare returnerats av köinitieraren | |
| Bearbetningsanteckningar | Ja | Text | Anpassad bearbetning av resultat eller värde för att lägga till i köobjektet som bearbetas | |
| Rensa bearbetningsanteckningar | Ja | Booleskt | Falsk | När funktionen aktiveras, döljs och rensas fältet med bearbetningsanteckningar på den här skärmen och alla bearbetningsanteckningar som tidigare registrerats för objektet tas bort från databasen |
Undantag
| Argument | Description |
|---|---|
| Arbetskön hittades inte | De arbetskö som är associerad med objektet har antingen tagits bort eller är inte längre tillgänglig |
| Arbetsköobjektet hittades inte | Arbetsköobjektet är ogiltigt |
| Det gick inte att lägga till bearbetningsresultatet | Ett arbetsköobjektet som uppdateras har påträffat ett oväntat fel. Kontrollera felmeddelandet för mer information. |
Hämta arbetsköobjekt efter filter
Med åtgärden Hänta arbetsköobjekt efter filter kan användare hämta ett eller flera arbetsköobjekt baserat på ett FetchXML-filteruttryck.
Getworkqueueitemsaction
Åtgärden Hämta arbetsköobjekt efter filter kräver följande argument.
Indataparametrar
| Argument | Valfri | Accepterar | Standardvärde | Description |
|---|---|---|---|---|
| Arbetskö | Nej. | Text | Arbetskö för att hämta objekt från | |
| Filtrera rader | Nej. | Text | FetchXML-frågeuttrycket som används för att hämta objekt från arbetskön | |
| Rader att returnera | Nej. | Antal | 5000 | Det maximala antalet arbetsköobjekt som returneras av orkestreraren |
Producerade variabler
| Argument | Type | Standardvärde | Description |
|---|---|---|---|
| WorkQueueItems | Nej. | Aktiverat | Lista över arbetsköobjekt som matchar filteruttrycket. |
Undantag
| Argument | Description |
|---|---|
| Arbetskö | Arbetskön att hämta objekt från. |
| Filtrera rader | Frågeuttrycket FetchXML används för att hämta objekt från arbetskön. |
| Rader att returnera | Det maximala antalet arbetsköobjekt som returneras av initieraren (standardvärdet är 5 000). |
Vad är FetchXML-frågor?
Microsoft Dataverse FetchXML är ett språk som används för att hämta data från en Dataverse-databas. Det är utformat för att vara enkelt att skapa, använda och förstå. Du kanske till exempel vill be Dataverse om en lista över alla arbetsköobjekt som har tillståndet IT Exception.
För att begränsa stödet för FetchXml-frågor till att hämta arbetsköobjekt stöder vi bara en begränsad uppsättning FetchXml-termer och -uttryck. Dessa villkor och uttryck omfattar attribut, filter, villkor och ordningsuttryck, som alla är begränsade till tabellen för arbetsköobjekt (workqueueitem). Du måste uttryckligen ange vilka egenskaper som ska returneras från arbetsköobjekttabellen och önskad sorteringsordning.
FetchXML-exempelfråga
Följande exempel är ett frågeuttryck för hur du hämtar flera egenskaper, filtrerar bort felaktiga objekt som markerats som IT Exceptions och sorterar resultaten efter de poster som upphör att gälla 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" />
Information om frågestöd och referensdata
- Lista över frågeoperatorer som är tillgängliga för användning, inklusive operatorer som "on-or-before" (på datum eller före), "between" (mellan) och "last-month" (senaste månaden).
- Lista över attribut som är tillgängliga i tabellen med arbetsköobjekt.
Tillstånd (statecode)
| Tillstånd | Kod | Description |
|---|---|---|
| I kö | 0 | Objektet satt i kö |
| Bearbetas | 1 | Objektet bearbetas |
| Bearbetat | 2 | Objektet har bearbetats |
| Spärrat | 3 | Objektet har spärrats |
| Error | 4 | Objektet har drabbats av ett fel |
Tillståndorsak (statuscode)
| Tillståndorsak | Kod | Description |
|---|---|---|
| I kö | 0 | Objektet satt i kö |
| Bearbetas | 1 | Objektet bearbetas |
| Bearbetat | 2 | Objektet har bearbetats |
| OnHold (pausat) | 3 | Objektet har spärrats (pausats) |
| Allmänt undantag | 4 | Objektet påträffade ett allmänt undantag |
| IT-undantag | 5 | Objektet påträffade ett IT-undantag |
| Affärsundantag | 6 | Objektet påträffade ett företagsundantag |
| Felaktiga | 7 | Objektet har spärrats |
| ProcessingTimeout | 8 | Tidsgräns för objektbearbetning |