Åtgärder för arbetsköer

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.

Skärmbild av åtgärden Bearbeta arbetsköobjekt.

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.

Skärmbild av åtgärden Uppdatera arbetsköobjekt.

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.

Skärmbild av åtgärden Lägg till arbetsköobjekt.

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.

Skärmbild av åtgärden Lägg till flera 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.

Skärmbild av åtgärden för att köa om ett objekt i arbetskön.

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.

Skärmbild av åtgärden Bearbetningsanteckningar för uppdatera arbetsköobjekt.

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.

Skärmbild av åtgärden Hänta arbetsköobjekt efter filter.

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