Werkwachtrijacties
Werkwachtrijen in Power Automate kunnen worden gebruikt om procesrelevante gegevens op te slaan en een manier te bieden om complexe processen en automatiseringen los te koppelen, zodat ze asynchroon kunnen communiceren.
Werkwachtrijen kunnen een cruciale rol spelen bij het verbeteren van de efficiëntie, schaalbaarheid en veerkracht van automatiseringen en helpen bij het prioriteren van werk. Met werkwachtrijen kunt u items met de hoogste prioriteit eerst voltooien, ongeacht of ze worden verwerkt door digitale medewerkers, menselijke medewerkers of via integraties.
Notitie
- Ondersteuning op productieniveau voor de eerste reeks werkwachtrijgerelateerde acties vereist Power Automate Desktop, versie 2.37 of hoger.
- Werkwachtrijacties in Power Automate voor bureaublad is een premiumfunctie waarvoor een Power Automate abonnement is vereist.
- Momenteel kunnen alleen de acties Items uit werkwachtrij verwerken en Item uit werkwachtrij bijwerken worden geclassificeerd en toegestaan of beperkt op basis van DLP-beleid (beleid ter voorkoming van gegevensverlies). Binnenkort komen er andere acties. Houd er rekening mee dat op de cloudstroom gebaseerd gebruik van werkwachtrijen niet kan worden beperkt door DLP-beleid.
Werkwachtrij-items verwerken
De actie Items uit werkwachtrij verwerken geeft aan de wachtrij-orkestrator aan dat de machine gereed is voor het verwerken van een of meer werkwachtrij-items. De gebruikerscontext die om een nieuw item vraagt, moet voldoende rechten hebben op de werkwachtrij en de tabel met werkwachtrij-items om werkwachtrijen te kunnen verwerken.
De werkwachtrij waarnaar in de vorige actie wordt verwezen, wordt door de orchestrator voor wachtrijen gebruikt om de volgende beschikbare items in die werkwachtrij te bepalen die de status In wachtrij hebben. Terwijl de bureaubladstroom de acties doorloopt in de lus Werkwachtrij-items verwerken die door deze actie wordt gegenereerd, kunt u de waarde aanroepen door de variabele te gebruiken die u voor de actie hebt aangewezen, samen met de eigenschap .Value. In dit geval kunt u de waarde van het werkwachtrij-item aanroepen met de variabele %WorkQueueItem.Value%
Belangrijk
Door een FetchXML-expressie op te geven in het veld 'Rijen filteren', omzeilt u de FIFO-logica van de standaardwerkwachtrij-orchestrator voor wachtrij-items. Hiermee kunt u een aangepaste volgorde voor het verwijderen van items in de wachtrij instellen en de vervaldatums van items en andere instellingen negeren die automatisch worden toegepast wanneer er geen filterexpressie is opgegeven.
Processworkqueueitemaction
De actie Werkwachtrij-item verwerken vereist de volgende argumenten.
Invoerparameters
| Argument | Optioneel | Accepteert | Standaardwaarde | Omschrijving |
|---|---|---|---|---|
| Werkwachtrij | Nee | Sms verzenden | De werkwachtrij-id van de werkwachtrij die items bevat die moeten worden verwerkt. | |
| Rijen filteren | Ja | Sms verzenden | De FetchXML-query-expressie die wordt gebruikt om items uit de werkwachtrij op te halen. | |
| Configuratie voor automatische herinschakeling van werkwachtrijniveau overschrijven | Ja | Booleaans | False | Wanneer deze optie is ingeschakeld, verschijnt er een veld waarin u het maximale aantal nieuwe pogingen kunt instellen of overschrijven voor IT Exceptions. |
| Maximumaantal nieuwe pogingen | No | Tekstwaarde, Numerieke waarde | Als het niet wordt overschreven, wordt het standaard maximumaantal nieuwe pogingen gebruikt dat is gedefinieerd in het werkwachtrijrecord. | Het maximumaantal toegestane nieuwe pogingen voor IT Exceptions Met deze parameter kunt u het aantal pogingen verhogen of verlagen, of zelfs het herhaalmechanisme uitschakelen door het aantal op 0 te zetten. |
Geproduceerde variabelen
| Argument | Type | Omschrijving |
|---|---|---|
| WorkQueueItem | Nee | Informatie die is opgeslagen in het werkwachtrij-item dat wordt verwerkt |
Uitzonderingen
| Uitzondering | Omschrijving |
|---|---|
| Werkwachtrij niet gevonden | De ingevoerde waarde in de werkwachtrijparameter is ongeldig. |
| De werkwachtrij is onderbroken of gestopt | De werkwachtrij is gepauzeerd of gestopt. Dit is geen geldige status bij het verwerken van items. |
| Ongeldige FetchXML | Er is een ongeldige FetchXML-expressie opgegeven. |
| Kan werkwachtrij niet verwerken | Ongeldige aanvraag - fout in query-syntaxis. |
Wat zijn FetchXML-query's?
Microsoft Dataverse FetchXML is een taal die wordt gebruikt voor het ophalen van gegevens uit een Dataverse database. Het is zo ontworpen dat het eenvoudig te maken, te gebruiken en te begrijpen is. U kunt de orchestrator bijvoorbeeld vragen om items in een andere volgorde dan first-in-first-out (FIFO) en binnen een specifieke vervaltermijn te verwerken.
Om de FetchXML-queryondersteuning te beperken tot het verwerken van werkwachtrij-items, wordt een beperkte set FetchXML-termen en -expressies ondersteund. Deze termen omvatten filters, voorwaarden en ordeningsuitdrukkingen, die allemaal beperkt zijn tot de tabel met werkwachtrij-items (workqueueitem). Alleen items met de status Queued worden geretourneerd.
FetchXML-voorbeeldquery
Hieronder ziet u een voorbeeld van een query-expressie voor het filteren op name en het ordenen van de resultaten op basis van de records die het eerst verlopen (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" />
Ondersteuningsdetails en referentiegegevens opvragen
- Lijst met queryoperators die beschikbaar zijn voor gebruik, inclusief operatoren zoals op-of-voor, tussen en vorige-maand.
- Lijst met kenmerken die beschikbaar zijn in de tabel werkwachtrij-items .
Item uit werkwachtrij bijwerken
Met de actie Item uit werkwachtrij bijwerken kunnen gebruikers de status en verwerkingsresultaten van het geselecteerde werkwachtrij-item wijzigen.
Updateworkqueueitemaction
De actie Werkwachtrij-item bijwerken vereist de volgende argumenten.
| Argument | Optioneel | Accepteert | Standaardwaarde | Omschrijving |
|---|---|---|---|---|
| Werkwachtrij-item | Nee | Sms verzenden | Variabele voor werkwachtrij-items die eerder is geretourneerd door de wachtrij-orkestrator | |
| -Status | Nee | Verwerkt, generieke fout | Verwerkt | Werk het werkwachtrij-item dat wordt verwerkt bij met behulp van een status uit de lijst met opties. |
| Verwerkingsnotities | Ja | Sms verzenden | Aangepaste verwerkingsnotities of waarde om toe te voegen aan het wachtrij-item dat wordt verwerkt. | |
| Verwerkingsnotities wissen | Ja | Booleaans | False | Indien ingeschakeld, wordt het veld verwerkingsnotities op dit scherm verborgen en gewist en worden alle verwerkingsnotities uit de database verwijderd die eerder voor dit item zijn vastgelegd. |
Uitzonderingen
| Argument | Omschrijving |
|---|---|
| Werkwachtrij-item niet gevonden | Het werkwachtrij-item dat wordt verwerkt, is verwijderd of behoort niet langer tot de wachtrij van waaruit het is aangeroepen. |
| Item uit werkwachtrij in de wacht | Het werkwachtrij-item dat wordt verwerkt, heeft de status on hold in de wachtrij-orkestrator en kan niet meer worden bijgewerkt. |
| Kan item uit werkwachtrij niet bijwerken | Er is een onverwachte fout opgetreden voor het werkwachtrij-item dat wordt bijgewerkt. Controleer het foutbericht voor meer informatie. |
Item uit werkwachtrij toevoegen
De actie Item uit werkwachtrij toevoegen stelt gebruikers in staat om werkwachtrij-items in te vullen in een werkwachtrij die is ingesteld in de stroomportal.
Enqueueworkqueueitemaction
De actie Item uit werkwachtrij toevoegen vereist de volgende argumenten.
Invoerparameters
| Argument | Optioneel | Accepteert | Standaardwaarde | Omschrijving |
|---|---|---|---|---|
| Werkwachtrij | Nee | Tekstwaarde | Het werkwachtrij-item waaraan het item moet worden toegevoegd | |
| Prioriteit | Nee | Hoog, normaal, laag | Normaal | De prioriteit waarop het werkwachtrij-item moet worden ingesteld |
| Meetcriterium | Nee | Tekstwaarde, Numerieke waarde | Aangepaste naam of id voor het nieuwe item uit de werkwachtrij | |
| Invoer | Nee | Tekstwaarde, Numerieke waarde | De gegevens, die behoren tot de waardekolom die moet worden verwerkt | |
| Vervalt | Ja | Datetime | De datum/tijd-waarde die is ingesteld om het wachtrij-item te laten verlopen, neemt anders de standaardwaarde aan als er een is ingesteld voor de wachtrij | |
| Verwerkingsnotities | Ja | Tekstwaarde, Numerieke waarde | Aangepaste verwerkingsnotities die moeten worden toegevoegd aan het nieuwe wachtrij-item | |
| Heeft unieke id of verwijzing | Ja | Tekstwaarde, Numerieke waarde | Indien ingeschakeld, moet een waarde worden opgegeven die uniek is binnen deze wachtrij. Als u dit leeg laat, wordt automatisch een unieke waarde met de notatie system-<GUID> door het systeem ingevoerd |
Geproduceerde variabelen
| Argument | Type | Omschrijving |
|---|---|---|
| WorkQueueItem | Nee | Informatie die is opgeslagen voor het werkwachtrij-item dat wordt toegevoegd |
Uitzonderingen
| Argument | Omschrijving |
|---|---|
| Werkwachtrij niet gevonden | De ingevoerde waarde in de werkwachtrijparameter is ongeldig |
| Kan werkwachtrij-item niet toevoegen | Het werkwachtrij-item kon niet worden toegevoegd aan de werkwachtrij. Ongeldige aanvraag - fout in query-syntaxis |
Meerdere werkwachtrij-items toevoegen
Met de actie Meerdere werkwachtrij-items toevoegen kunnen gebruikers een of meer werkwachtrij-items toevoegen aan een werkwachtrij op basis van de gegevens die worden verstrekt als werkwachtrij-itemgegevenstabel.
Voor deze actie is een aangepaste gegevenstabel nodig die een of meer werkwachtrij-items bevat. De gegevenstabel moet acht kolommen bevatten en voldoen aan het volgende schema:
| Kolomnaam | Omschrijving | Vereist | Toegestane waarden |
|---|---|---|---|
| Meting | De naam van het item. | No | Een willekeurige alfanumerieke tekenreeks |
| Invoer | Voer details of gegevens van het item in. | Ja | Een willekeurige alfanumerieke tekenreeks |
| Verloopt over | Geeft de duur op totdat het item verloopt. | No | Datum- en tijdwaarde |
| Verwerkingsnotities | Het verwerken van aantekeningen die betrekking hebben op het item. | No | Een willekeurige alfanumerieke tekenreeks |
| Prioriteit | Het prioriteitsniveau van het item. | Ja | Numerieke waarde van 100 (Hoog), 200 (Normaal) of 300 (Laag) |
| Unieke referentie | Een unieke identificatie of referentiewaarde voor het item. | No | Elke unieke alfanumerieke tekenreeks of referentie |
| Status | Status van het item bij inname. | Ja | Numerieke waarde van nul (in wachtrij) of één (in behandeling). |
| Vertragen tot | Geeft een datum en tijd op tot de items in de werkwachtrij genegeerd moeten worden voor verwerking. | No | Datum- en tijdwaarde |
Robin-codefragment voor het maken van de gegevenstabel
Het volgende voorbeeld is een Robin-codefragment (gebruikt in traditionele stromen) dat u rechtstreeks in het Desktop Designer-venster van Power Automate kunt kopiëren en plakken. Met dit fragment voegt u de actie Nieuwe gegevenstabel maken met de verwachte set velden toe aan uw stroom.
Variables.CreateNewDatatable InputTable: { ^['Name', 'Input', 'Expires in', 'Processing notes', 'Priority', 'Unique reference', 'Status', 'Delay until'], [$'''''', $'''''', $'''''', $'''''', $'''''', $'''''', $'''''', $''''''] } DataTable=> DataTable
PowerFx-codefragment voor het maken van de gegevenstabel
Het volgende voorbeeld is een PowerFx-codefragment dat u kunt kopiëren en rechtstreeks in het Power Automate-bureaubladontwerpervenster kunt plakken. Met dit fragment voegt u de actie Nieuwe gegevenstabel maken met de verwachte set velden toe aan uw stroom.
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
Voor de actie Meerdere werkwachtrij-items toevoegen zijn de volgende argumenten vereist.
Invoerparameters
| Argument | Optioneel | Accepteert | Standaardwaarde | Omschrijving |
|---|---|---|---|---|
| Werkwachtrij | No | Tekstwaarde | Het werkwachtrij-item waaraan het item moet worden toegevoegd | |
| Werkwachtrij-itemgegevens | Ja | Gegevenstabel | De aangepaste gegevenstabel met werkwachtrij-items die aan de werkwachtrij moeten worden toegevoegd |
Geproduceerde variabelen
| Argument | Type | Standaardwaarde | Omschrijving |
|---|---|---|---|
| FailedWorkQueueItems | No | Ingeschakeld | Als er fouten optreden, bevat dit object de index van het item dat niet kon worden ingevoegd, samen met een foutcode. De geretourneerde index is de positie (index) van het item in de opgegeven tabel met werkrijgegevens van de actie Meerdere werkrij-items toevoegen . |
| HasFailedItems | No | Ingeschakeld | Een indicator voor de vraag of er bij de acties opnamefouten zijn opgetreden vanwege problemen met gegevens van werkrij-items. |
| SuccessfulWorkQueueItems | Disabled | No | Een aangepast object dat de index en de werkwachtrij-items bevat die succesvol aan de werkwachtrij zijn toegevoegd. |
Uitzonderingen
| Argument | Omschrijving |
|---|---|
| Werkwachtrij niet gevonden | De ingevoerde waarde in de werkwachtrijparameter is ongeldig |
| De werkwachtrij is onderbroken of gestopt | Het werkwachtrijitem kon niet aan de werkwachtrij worden toegevoegd omdat de werkwachtrij is gepauzeerd of gestopt. |
| Er kan geen lijst met werkwachtrij-items in de batchwachtrij worden geplaatst | De werkwachtrijitems konden niet aan de werkwachtrij worden toegevoegd vanwege een aanvraag- of communicatiefout. |
Item opnieuw in wachtrij plaatsen met vertraging
Met de actie Item opnieuw in wachtrij plaatsen met vertraging kunnen gebruikers een wachtrij-item dat in de opnieuw in wachtrij plaatsen wordt verwerkt, terugplaatsen naar de oorspronkelijke wachtrij. Bovendien kan het item in de wachtrij tot een bepaalde tijd worden vastgehouden en vrijgegeven.
Requeueworkqueueitemaction
De actie Artikel opnieuw in de wachtrij plaatsen met vertraging vereist de volgende argumenten.
Invoerparameters
| Argument | Optioneel | Accepteert | Standaardwaarde | Omschrijving |
|---|---|---|---|---|
| Werkwachtrij-item | Nee | Werkwachtrij-item | Het werkwachtrij-item waaraan het item moet worden toegevoegd | |
| Vertragen tot | Nee | Waarde datum/tijd | Normaal | De datetime-waarde is toegepast om het wachtrij-item uit te stellen tot |
| Vervalt | Ja | Waarde datum/tijd | Aangepaste vervaltijd voor het item dat opnieuw in de wachtrij wordt geplaatst | |
| Verwerkingsnotities | Ja | Tekstwaarde, Numerieke waarde | Aangepaste verwerkingsnotities die moeten worden toegevoegd aan het nieuwe wachtrij-item | |
| Verwerkingsnotities wissen | Ja | Booleaans | False | Indien ingeschakeld, wordt het veld verwerkingsnotities op dit scherm verborgen en gewist en worden alle verwerkingsnotities uit de database verwijderd die eerder voor dit item zijn vastgelegd |
Uitzonderingen
| Argument | Omschrijving |
|---|---|
| Werkwachtrij niet gevonden | De ingevoerde waarde in de werkwachtrijparameter is ongeldig |
| Werkwachtrij-item niet gevonden | De waarde van het wachtrij-item is ongeldig |
| Kan item uit werkwachtrij niet opnieuw in wachtrij plaatsen | Het werkwachtrij-item kon niet worden toegevoegd aan de werkwachtrij. Ongeldige aanvraag - fout in query-syntaxis |
Verwerkingsnotities van item uit werkwachtrij bijwerken
Met de actie Verwerkingsnotities van item uit werkwachtrij bijwerken kunnen gebruikers verwerkingsnotities van het geselecteerde werkwachtrij-item bijwerken of wissen zonder de status of enige andere eigenschap ervan te wijzigen.
updateprocessingnotesaction
De actie Verwerkingsnotities van item uit werkwachtrij bijwerken vereist de volgende argumenten.
| Argument | Optioneel | Accepteert | Standaardwaarde | Omschrijving |
|---|---|---|---|---|
| Werkwachtrij-item | Nee | Sms verzenden | Variabele voor werkwachtrij-item die eerder is geretourneerd door de orchestrator voor wachtrijen | |
| Verwerkingsnotities | Ja | Sms verzenden | Aangepast verwerkingsresultaat of -waarde die moet worden toegevoegd aan het verwerkte wachtrij-item | |
| Verwerkingsnotities wissen | Ja | Booleaans | False | Indien ingeschakeld, wordt het veld verwerkingsnotities op dit scherm verborgen en gewist en worden alle verwerkingsnotities uit de database verwijderd die eerder voor dit item zijn vastgelegd |
Uitzonderingen
| Argument | Omschrijving |
|---|---|
| Werkwachtrij niet gevonden | De werkwachtrij die aan het item is gekoppeld, is verwijderd of is niet langer toegankelijk |
| Werkwachtrij-item niet gevonden | Het werkwachtrij-item is ongeldig |
| Kan de verwerkingsresultaten niet toevoegen | Er is een onverwachte fout opgetreden voor het werkwachtrij-item dat wordt bijgewerkt. Controleer het foutbericht voor meer informatie. |
Werkwachtrij-items ophalen per filter
Met de actie Werkwachtrij-items ophalen op basis van filter kunnen gebruikers een of meer werkwachtrij-items ophalen op basis van een FetchXML filterexpressie.
Getworkqueueitemsaction
Voor de actie Werkwachtrij-items ophalen op basis van filter zijn de volgende argumenten vereist.
Invoerparameters
| Argument | Optioneel | Accepteert | Standaardwaarde | Omschrijving |
|---|---|---|---|---|
| Werkwachtrij | No | Sms verzenden | Werkwachtrij om items uit op te halen | |
| Rijen filteren | No | Sms verzenden | FetchXML query-expressie die wordt gebruikt om items uit de werkwachtrij op te halen | |
| Te retourneren rijen | No | Aantal | 5000 | Het maximale aantal werkwachtrij-items dat door de orchestrator wordt geretourneerd |
Geproduceerde variabelen
| Argument | Type | Standaardwaarde | Omschrijving |
|---|---|---|---|
| WorkQueueItems | No | Ingeschakeld | Lijst met werkwachtrij-items die voldoen aan de filterexpressie. |
Uitzonderingen
| Argument | Omschrijving |
|---|---|
| Werkwachtrij | De werkwachtrij om items uit op te halen. |
| Rijen filteren | De FetchXML-query-expressie die wordt gebruikt om items uit de werkwachtrij op te halen. |
| Te retourneren rijen | Het maximale aantal werkwachtrij-items dat door de orchestrator wordt geretourneerd (standaard is 5000). |
Wat zijn FetchXML-query's?
Microsoft Dataverse FetchXML is een taal die wordt gebruikt voor het ophalen van gegevens uit een Dataverse database. Het is zo ontworpen dat het eenvoudig te maken, te gebruiken en te begrijpen is. U kunt bijvoorbeeld Dataverse vragen om een lijst met alle werkwachtrij-items die zich in de status IT Exception bevinden.
Om de ondersteuning van FetchXml-query's te beperken tot het ophalen van items in de werkwachtrij, ondersteunen we slechts een beperkte set FetchXml-termen en -expressies. Deze termen en expressies omvatten kenmerken, filters, voorwaarden en sorteerexpressies, die allemaal beperkt zijn tot de tabel met werkwachtrij-items (workqueueitem). U moet expliciet opgeven welke eigenschappen u uit de tabel met werkwachtrij-items wilt retourneren en wat de gewenste sorteervolgorde is.
FetchXML-voorbeeldquery
Het volgende voorbeeld is een query-expressie voor het ophalen van verschillende eigenschappen, het filteren van foutieve items die zijn gemarkeerd als IT Exceptions en het sorteren van de resultaten op basis van de records die het eerst verlopen (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" />
Ondersteuningsdetails en referentiegegevens opvragen
- Lijst met queryoperators die beschikbaar zijn voor gebruik, inclusief operatoren zoals op-of-voor, tussen en vorige-maand.
- Lijst met kenmerken die beschikbaar zijn in de tabel werkwachtrij-items .
Status (statecode)
| Status | Code | Omschrijving |
|---|---|---|
| In wachtrij geplaatst | 0 | Item staat in de wachtrij |
| Verwerking | 0 | Item wordt verwerkt |
| Verwerkt | 2 | Item is verwerkt |
| Uitgesteld | 5 | Item staat in de wacht |
| Error | 4 | Er is een fout opgetreden bij het item |
Statusreden (statuscode)
| Reden van status | Code | Omschrijving |
|---|---|---|
| In wachtrij geplaatst | 0 | Item staat in de wachtrij |
| Verwerking | 0 | Item wordt verwerkt |
| Verwerkt | 2 | Item is verwerkt |
| In de wachtstand (gepauzeerd) | 5 | Item staat in de wacht (gepauzeerd) |
| Algemene uitzondering | 4 | Item heeft een generieke uitzondering ondervonden |
| IT-uitzondering | 5 | Item heeft een IT-uitzondering aangetroffen |
| Zakelijke uitzondering | 6 | Item heeft een zakelijke uitzondering aangetroffen |
| Dead Letter | 7 | Item staat in de wacht |
| ProcessingTimeout | 8 | Itemverwerking is verlopen |