Kommentar
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
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.
- Åtgärder för arbetsköer i Power Automate för dator är en premiumfunktion 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 klassificeras och tillåtas eller begränsas via principer för skydd mot dataförlust (DLP), och fler åtgärder kommer snart. Observera att molnbaserad användning av arbetsköer inte kan begränsas av DLP-principer.
Bearbeta objekt i arbetskön
Å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 för arbetskön och tabellen för arbetsköobjekt för att kunna bearbeta arbetsköer.
Den arbetskö som refereras till i den föregående åtgärden används av köorkestreraren för att avgöra vilka nästa tillgängliga objekt i den arbetskön som är i tillståndet Köad. 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 uttagsordning i kön och ignorera objektens utgångsdatum 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 | Beskrivning |
|---|---|---|---|---|
| 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. | |
| Skriv över konfigurationen för automatiska återförsök för arbetskön | Ja | Boolesk | 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 | Typ | Beskrivning |
|---|---|---|
| WorkQueueItem | Arbetsköobjekt | 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 | Ogiltig begäran - fel i frågans syntax. |
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 orkestreraren att bearbeta objekt i en annan ordning än först in, först ut (FIFO) och inom en viss giltighetstid.
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 termer omfattar filter, villkorsuttryck och sorteringsuttryck, och 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 kan användas, inklusive operatorer såsom on-or-before, between och last-month.
- Lista över attribut som finns i tabellen för arbetsköobjekt.
Uppdatera objekt i arbetskön
Å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 |
|---|---|---|---|---|
| Objekt i arbetskön | 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 | Anpassade bearbetningsanteckningar eller värde att lägga till i köobjektet som bearbetas. | |
| Rensa bearbetningsanteckningar | Ja | Boolesk | 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 | Beskrivning |
|---|---|
| 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 | Arbetsköobjektet som uppdateras har stött på ett oväntat fel. Kontrollera felmeddelandet för mer information. |
Lägg till post i arbetskö
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 | Beskrivning |
|---|---|---|---|---|
| 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 | |
| Upphör att gälla | Ja | Datum och tid | Det datum-/tidsvärde som angetts för att köobjektet ska upphöra att gälla, annars används standardvärdet om ett sådant har angetts för kön | |
| Bearbetningsanteckningar | Ja | Textvärde, Numeriskt värde | Anpassade bearbetningsanteckningar som ska läggas till i den nya köposten | |
| 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 | Typ | Beskrivning |
|---|---|---|
| WorkQueueItem | Arbetsköobjekt | Information som lagras för objektet i arbetskön 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. Felaktig begäran – fel i frågesyntax |
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 objekt i arbetskön. Datatabellen måste ha åtta kolumner och följa följande schema:
| Kolumnnamn | Beskrivning | Obligatoriskt | Tillåtna värden |
|---|---|---|---|
| Name | Namnet på objektet. | Nej | Valfri alfanumerisk sträng |
| Indata | Indatadetaljer eller data för objektet. | 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). |
| Fördröj till | Anger ett datum och en tid fram till vilket objekten i arbetskön ska ignoreras vid 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 | Beskrivning |
|---|---|---|---|---|
| Arbetskö | Nej | Textvärde | Arbetsköobjektet som objektet ska läggas till i | |
| Data för objekt i arbetskön | Ja | Datatabell | Den anpassade datatabellen som innehåller objekt i arbetskön som ska läggas till i arbetskön |
Producerade variabler
| Argument | Typ | Standardvärde | Beskrivning |
|---|---|---|---|
| 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 | Beskrivning |
|---|---|
| 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 massköa en lista med arbetsköobjekt | Det gick inte att lägga till arbetsköobjekten i arbetskön på grund av ett begärande- eller kommunikationsfel. |
Köa objektet på nytt 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 | Beskrivning |
|---|---|---|---|---|
| Objekt i arbetskön | Nej | Arbetsköobjekt | Arbetsköobjektet som objektet ska läggas till i | |
| Senarelägg tills | Nej | Datetime-värde | Det datum-/tidsvärde som används för att fördröja köobjektet tills | |
| Upphör att gälla | Ja | Datum-/tidsvärde | Anpassad förfallotid för objektet som köas på nytt | |
| Bearbetningsanteckningar | Ja | Textvärde, Numeriskt värde | Anpassade bearbetningsanteckningar som ska läggas till i den nya köposten | |
| Rensa bearbetningsanteckningar | Ja | Boolesk | 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 | Beskrivning |
|---|---|
| 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. Felaktig begäran – fel i frågesyntax |
Uppdatera bearbetningsanteckningar för arbetsköpost
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 | Beskrivning |
|---|---|---|---|---|
| Objekt i arbetskön | 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 | Beskrivning |
|---|---|
| Arbetskön hittades inte | Arbetskön som är kopplad till posten har antingen tagits bort eller är inte längre åtkomlig |
| 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 objekt i arbetskön utifrån 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 | Beskrivning |
|---|---|---|---|---|
| Arbetskö | Nej | Text | Arbetskö för hämtning av 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 | Nummer | 5000 | Det maximala antalet arbetsköobjekt som returneras av orkestreraren |
Producerade variabler
| Argument | Typ | Standardvärde | Beskrivning |
|---|---|---|---|
| WorkQueueItems | Nej | Aktiverat | Lista över arbetsköobjekt som matchar filteruttrycket. |
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 att ge dig en lista över alla arbetsköobjekt som är i 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 termer och uttryck omfattar attribut, filter, villkor och sorteringsuttryck, samtliga 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 kan användas, inklusive operatorer som on-or-before, between och last-month.
- Lista över attribut som är tillgängliga i tabellen med arbetsköobjekt.
Tillstånd (statecode)
| Tillstånd | Kod | Beskrivning |
|---|---|---|
| I kö | 0 | Objektet är i kö |
| Bearbetas | 1 | Objektet bearbetas |
| Bearbetat | 2 | Objektet har bearbetats |
| Spärrat | 3 | Objektet har spärrats |
| Fel | 4 | Objektet har drabbats av ett fel |
Tillståndorsak (statuscode)
| Tillståndorsak | Kod | Beskrivning |
|---|---|---|
| I kö | 0 | Objektet är i kö |
| Bearbetas | 1 | Objektet bearbetas |
| Bearbetat | 2 | Objektet har bearbetats |
| Pausat | 3 | Objektet har pausats eller är vilande |
| Allmänt undantag | 4 | Objektet påträffade ett allmänt undantag |
| ITException | 5 | Objektet påträffade ett IT-undantag |
| Affärsundantag | 6 | Objektet stötte på ett affärsundantag |
| Felaktiga | 7 | Objektet har spärrats |
| Tidsgräns för bearbetning | 8 | Objektbearbetningen överskred tidsgränsen |