Akcije radnih redova čekanja
Radni redovi čekanja mogu Power Automate se koristiti za pohranu podataka relevantnih za proces i pružaju način za razdvajanje složenih procesa i automatizacija, omogućujući im asinkronu komunikaciju.
Redovi čekanja rada mogu igrati ključnu ulogu u poboljšanju učinkovitosti, skalabilnosti i otpornosti automatizacije te pomoći u određivanju prioriteta rada. Radni redovi čekanja omogućuju vam da prvo dovršite stavke najvišeg prioriteta, bez obzira na to obrađuju li ih digitalni radnici, ljudski radnici ili putem integracija.
Napomena
- Podrška na razini produkcije za prvi skup akcija povezanih s radnim redom čekanja zahtijeva Power Automate desktop verziju 2.37 ili noviju.
- Radnje red čekanja posla u aplikaciji Power Automate za stolna računala premium su značajka za koju je potrebna pretplata Power Automate .
- Trenutačno se samo stavke red čekanja posla obrade i akcije stavka red čekanja posla mogu klasificirati i dopustiti ili ograničiti putem pravila za sprječavanje gubitka podataka (DLP), a uskoro će uslijediti i druge akcije. Imajte na umu da korištenje radnih redova čekanja temeljeno na tijeku u oblaku ne može biti ograničeno pravilima DLP-a.
Obrada stavki reda čekanja posla
Akcija Obradi stavke red čekanja posla pokazuje orkestratoru reda čekanja da je računalo spremno za obradu jedne ili više stavki red čekanja posla. Korisnički kontekst koji zahtijeva novu stavku mora imati dovoljne privilegije u tablici red čekanja posla i stavke red čekanja posla da bi mogao obraditi radne redove čekanja.
Orkestrator reda čekanja koristi red čekanja posla na koji se upućuje u prethodnoj radnji za određivanje sljedećih dostupnih stavki u tom red čekanja posla koje su u stanju čekanja . Dok tok radne površine prolazi kroz radnje unutar petlje stavki red čekanja posla obrade koju ova radnja prikazuje, možete pozvati vrijednost korištenjem varijable koju ste odredili za radnju zajedno sa svojstvom .Value. U tom slučaju možete pozvati vrijednost stavke red čekanja posla pomoću varijable %WorkQueueItem.Value%
Važno
Unosom izraza FetchXML u polje "Filtriraj retke" zaobilazite FIFO logiku red čekanja posla za stavke u redu čekanja. To vam omogućuje postavljanje prilagođenog redoslijeda uklanjanja iz reda čekanja i zanemarivanje datuma isteka stavke i drugih postavki koje se automatski primjenjuju kada nije naveden izraz filtra.
Processworkqueueitemaction
Akcija Obrada stavke red čekanja posla zahtijeva sljedeće argumente.
Ulazni parametri
| Argument | Neobavezno | Prihvaća | Zadana vrijednost | Opis |
|---|---|---|---|---|
| red čekanja posla | No | SMS | ID red čekanja posla red čekanja posla koji sadrži stavke za obradu. | |
| Filtriranje redaka | Jest | SMS | Izraz FetchXML upita koji se koristi za dohvaćanje stavki iz red čekanja posla. | |
| Prebriši konfiguraciju automatskog ponovnog pokušaja red čekanja posla | Jest | Booleov | Pogrešno | Kada je omogućeno, pojavit će se polje koje vam omogućuje postavljanje ili prebrisivanje maksimalnog broja ponovnih pokušaja IT Exceptions. |
| Maksimalan broj ponovljenih pokušaja | No | Tekstualna vrijednost, Numerička vrijednost | Kada se ne prebriše, koristi zadani maksimalni broj ponovljenih pokušaja definiran u zapisu red čekanja posla. | Maksimalan dopušteni broj ponovnih pokušaja za IT Exceptions. Ovaj parametar omogućuje podešavanje broja ponovnih pokušaja na višu ili nižu vrijednost ili čak onemogućavanje mehanizma ponovnog pokušaja postavljanjem broja na 0. |
Varijable proizvedene
| Argument | Tip | Opis |
|---|---|---|
| WorkQueueItem | No | Podaci pohranjeni u stavci red čekanja posla koja se obrađuje |
Iznimke
| Iznimka | Opis |
|---|---|
| red čekanja posla nije pronađen | Vrijednost unesena u parametar red čekanja posla nije valjana. |
| red čekanja posla pauziran ili zaustavljen | Tred čekanja posla je pauziran ili zaustavljen, što nije valjano stanje prilikom obrade stavki. |
| Nevažeći FetchXML | Naveden je nevažeći FetchXML izraz. |
| Obrada red čekanja posla nije uspjela | Loš zahtjev - pogreška u sintaksi upita. |
Što su FetchXML upiti?
Microsoft Dataverse FetchXML je jezik koji se koristi za dohvaćanje podataka iz baze Dataverse podataka. Dizajniran je tako da ga je lako stvoriti, koristiti i razumjeti. Na primjer, možda ćete htjeti zatražiti od orkestratera da obradi stavke drugačijim redoslijedom od FIFO i unutar određenog vremenskog okvira isteka.
Da bi se podrška za upite ograničila FetchXML na obradu stavki red čekanja posla, podržan je ograničeni skup pojmova FetchXML i izraza. Ti uvjeti obuhvaćaju filtre, uvjete i izraze redoslijeda, a sve je ograničeno na tablicu stavki red čekanja posla (workqueueitem). Vraćaju se samo stavke koje su u Queued stanju.
Primjer FetchXML upita
Slijedi primjer izraza upita za filtriranje name i redoslijed rezultata prema zapisima koji prvi istječu (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" />
Pojedinosti o podršci i referentni podaci za upit
- Popis operatora upita dostupnih za korištenje, uključujući operatore kao što su on-or-before, between i last month.
- Popis atributa dostupnih u tablici stavki red čekanja posla.
Ažuriraj stavku reda čekanja posla
Akcija Ažuriraj stavku red čekanja posla omogućuje korisnicima promjenu statusa i rezultata obrade odabrane stavke red čekanja posla.
Updateworkqueueitemaction
Akcija Ažuriraj stavku red čekanja posla zahtijeva sljedeće argumente.
| Argument | Neobavezno | Prihvaća | Zadana vrijednost | Opis |
|---|---|---|---|---|
| stavka red čekanja posla | No | SMS | Varijabla stavke red čekanja posla koju je orkestrator reda čekanja prethodno vratio | |
| Status | No | Obrađeno, generička iznimka | Obrađeno | Ažurirajte stavku red čekanja posla koja se obrađuje pomoću statusa s popisa mogućnosti. |
| Napomene o obradi | Jest | SMS | Prilagođene bilješke o obradi ili vrijednost za dodavanje stavci reda čekanja koja se obrađuje. | |
| Jasne bilješke o obradi | Jest | Booleov | Pogrešno | Kada je omogućeno, skriva i briše polje bilješki o obradi na ovom zaslonu i uklanja sve bilješke o obradi iz baze podataka koje su prethodno snimljene za ovu stavku. |
Iznimke
| Argument | Opis |
|---|---|
| Stavka red čekanja posla nije pronađena | Stavka red čekanja posla koja se obrađuje izbrisana je ili više ne pripada redu čekanja iz kojeg je pozvana. |
| stavka red čekanja posla na čekanju | Stavka red čekanja posla koja se obrađuje sadrži status on hold u orkestratoru reda čekanja i više se ne može ažurirati. |
| Ažuriranje stavke red čekanja posla nije uspjelo | Stavka red čekanja posla koja se ažurira naišla je na neočekivanu pogrešku. Dodatne pojedinosti potražite u poruci o pogrešci. |
Dodaj stavku reda čekanja posla
Akcija Dodaj stavku red čekanja posla omogućuje korisnicima popunjavanje stavki red čekanja posla u red čekanja posla, koji je postavljen na portalu tijeka.
Enqueueworkqueueitemaction
Akcija Dodaj stavku red čekanja posla zahtijeva sljedeće argumente.
Ulazni parametri
| Argument | Neobavezno | Prihvaća | Zadana vrijednost | Opis |
|---|---|---|---|---|
| red čekanja posla | No | Tekstna vrijednost | Stavka red čekanja posla u koju želite dodati stavku | |
| Prioritet | No | Visoka, normalna, niska | Obično | Prioritet za postavljanje stavke red čekanja posla na |
| Ime | No | Tekstualna vrijednost, Numerička vrijednost | Prilagođeni naziv ili ID za novu stavku reda čekanja posla | |
| Ulaz | No | Tekstualna vrijednost, Numerička vrijednost | Podaci koji pripadaju stupcu vrijednosti koji treba obraditi | |
| Istekne | Jest | Datum i vrijeme | Vrijednost datuma i vremena postavljena za istek stavke reda čekanja, u suprotnom usvaja zadanu vrijednost ako je postavljena za red čekanja | |
| Napomene o obradi | Jest | Tekstualna vrijednost, Numerička vrijednost | Prilagođene bilješke o obradi koje će se dodati novoj stavci reda čekanja | |
| Ima jedinstveni ID ili referencu | Jest | Tekstualna vrijednost, Numerička vrijednost | Kada je omogućeno, treba navesti vrijednost koja je jedinstvena unutar ovog reda čekanja. Ako ostane prazna, sustav automatski daje jedinstvenu vrijednost u formatu system-<GUID> |
Varijable proizvedene
| Argument | Tip | Opis |
|---|---|---|
| WorkQueueItem | No | Podaci pohranjeni za stavku red čekanja posla koja se dodaje |
Iznimke
| Argument | Opis |
|---|---|
| red čekanja posla nije pronađen | Vrijednost unesena u parametar red čekanja posla nije valjana |
| Dodavanje stavke u red čekanja posla nije uspjelo | Stavka red čekanja posla nije se mogla dodati u red čekanja posla. Loš zahtjev - pogreška u sintaksi upita |
Dodaj više stavki redu čekanja posla
Akcija Dodaj više stavki red čekanja posla omogućuje korisnicima dodavanje jedne ili više stavki red čekanja posla u red čekanja posla na temelju podataka koji su navedeni kao tablica s podacima stavke red čekanja posla.
Ova akcija zahtijeva prilagođenu tablicu podataka koja sadrži jednu ili više stavki red čekanja posla. Tablica podataka mora imati osam stupaca i biti u skladu sa sljedećom shemom:
| Naziv stupca | Opis | Obvezno | Dopuštene vrijednosti |
|---|---|---|---|
| Ime/naziv | Naziv stavke. | No | Bilo koji alfanumerički niz |
| Unos | Unesite pojedinosti ili podatke o stavci. | Jest | Bilo koji alfanumerički niz |
| Istječe za | Određuje trajanje do isteka stavke. | No | Vrijednost datuma i vremena |
| Bilješke o obradi | Napomene o obradi vezane uz stavku. | No | Bilo koji alfanumerički niz |
| Prioritet | Razina prioriteta stavke. | Jest | Brojčana vrijednost od 100 (visoka), 200 (normalna), 300 (niska) |
| Jedinstvena referenca | Jedinstveni identifikator ili referentna vrijednost za stavku. | No | Bilo koji jedinstveni alfanumerički niz ili referenca |
| Stanje | Status stavke pri unosu. | Jest | Brojčana vrijednost nula (u redu čekanja), jedan (na čekanju). |
| Odgodi do | Određuje datum i vrijeme dok se stavke red čekanja posla ne zanemaruju za obradu. | No | Vrijednost datuma i vremena |
Robin isječak koda za stvaranje tablice podataka
Sljedeći primjer je isječak robin koda (koji se koristi u tradicionalnim tijekovima) koji možete kopirati i zalijepiti izravno u prozor dizajnera Power Automate radne površine. Ovaj isječak dodaje radnju Stvori novu tablicu podataka s očekivanim skupom polja u vaš tijek.
Variables.CreateNewDatatable InputTable: { ^['Name', 'Input', 'Expires in', 'Processing notes', 'Priority', 'Unique reference', 'Status', 'Delay until'], [$'''''', $'''''', $'''''', $'''''', $'''''', $'''''', $'''''', $''''''] } DataTable=> DataTable
PowerFx isječak koda za stvaranje tablice podataka
Sljedeći je primjer PowerFx isječak koda koji možete kopirati i zalijepiti izravno u prozor dizajnera Power Automate radne površine. Ovaj isječak dodaje radnju Stvori novu tablicu podataka s očekivanim skupom polja u vaš tijek.
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
Akcija Dodaj više stavki red čekanja posla zahtijeva sljedeće argumente.
Ulazni parametri
| Argument | Neobavezno | Prihvaća | Zadana vrijednost | Opis |
|---|---|---|---|---|
| red čekanja posla | No | Tekstna vrijednost | Stavka red čekanja posla u koju želite dodati stavku | |
| Podaci o stavci red čekanja posla | Jest | Podatkovna tablica | Prilagođena tablica podataka koja sadrži stavke red čekanja posla koje treba dodati u red čekanja posla |
Varijable proizvedene
| Argument | Tip | Zadana vrijednost | Opis |
|---|---|---|---|
| FailedWorkQueueItems | No | Omogućeno | Ako postoje pogreške, ovaj objekt sadrži indeks stavke koja se nije uspjela umetnuti zajedno s kodom pogreške. Vraćeni indeks je položaj (indeks) stavke u dostavljenoj tablici podataka red čekanja posla akcije Dodaj više stavki red čekanja posla. |
| HasFailedItems | No | Omogućeno | Pokazatelj jesu li akcije naišle na pogreške unosa zbog problema s podacima stavke red čekanja posla. |
| Uspješne stavke reda čekanja | Disabled | No | Prilagođeni objekt koji sadrži stavke indeksa i red čekanja posla koje su uspješno dodane u red čekanja posla. |
Iznimke
| Argument | Opis |
|---|---|
| red čekanja posla nije pronađen | Vrijednost unesena u parametar red čekanja posla nije valjana |
| red čekanja posla pauziran ili zaustavljen | Stavka red čekanja posla nije se mogla dodati u red čekanja posla jer je red čekanja posla pauziran ili zaustavljen. |
| Nije uspjelo skupno staviti u red čekanja popis stavki red čekanja posla | Stavke red čekanja posla nisu se mogle dodati u red čekanja posla zbog zahtjeva ili pogreške u komunikaciji. |
Vrati u red čekanja stavku s odgodom
Akcija vratiti u red čekanja stavke s odgodom omogućuje korisnicima da ponovno dodaju stavku reda čekanja koja se obrađuje u tok radne površine, natrag u izvorni red čekanja. Osim toga, stavka u redu čekanja može se zadržati i otpustiti do određenog vremena.
Requeueworkqueueitemaction
Za radnju stavka vratiti u red čekanja s odgodom potrebni su sljedeći argumenti.
Ulazni parametri
| Argument | Neobavezno | Prihvaća | Zadana vrijednost | Opis |
|---|---|---|---|---|
| stavka red čekanja posla | No | Stavka reda čekanja posla | Stavka red čekanja posla u koju želite dodati stavku | |
| Odgoda do | No | Vrijednost datuma i vremena | Obično | Vrijednost datuma i vremena primijenjena za odgodu stavke reda čekanja do |
| Istekne | Jest | Vrijednost datuma i vremena | Prilagođeno vrijeme isteka za stavku koja se ponovno stavlja u red čekanja | |
| Napomene o obradi | Jest | Tekstualna vrijednost, Numerička vrijednost | Prilagođene bilješke o obradi koje će se dodati novoj stavci reda čekanja | |
| Jasne bilješke o obradi | Jest | Booleov | Pogrešno | Kada je omogućeno, skriva i briše polje bilješki o obradi na ovom zaslonu i uklanja sve bilješke o obradi iz baze podataka koje su prethodno snimljene za ovu stavku |
Iznimke
| Argument | Opis |
|---|---|
| red čekanja posla nije pronađen | Vrijednost unesena u parametar red čekanja posla nije valjana |
| Stavka red čekanja posla nije pronađena | Vrijednost stavke reda čekanja nije valjana |
| Stavka nije uspjela vratiti u red čekanja red čekanja posla | Stavka red čekanja posla nije se mogla dodati u red čekanja posla. Loš zahtjev - pogreška u sintaksi upita |
Ažuriranje bilješki obrade stavke reda čekanja posla
Akcija Ažuriraj bilješke za obradu stavke red čekanja posla omogućuje korisnicima ažuriranje ili brisanje bilješki o obradi odabrane stavke red čekanja posla bez promjene njezina stanja ili bilo kojeg drugog svojstva.
updateprocessingnotesaction
Akcija Ažuriranje red čekanja posla za obradu bilješki zahtijeva sljedeće argumente.
| Argument | Neobavezno | Prihvaća | Zadana vrijednost | Opis |
|---|---|---|---|---|
| stavka red čekanja posla | No | SMS | Varijabla stavke red čekanja posla koju je orkestrator reda čekanja prethodno vratio | |
| Napomene o obradi | Jest | SMS | Prilagođeni rezultat obrade ili vrijednost za dodavanje obrađenoj stavci reda čekanja | |
| Jasne bilješke o obradi | Jest | Booleov | Pogrešno | Kada je omogućeno, skriva i briše polje bilješki o obradi na ovom zaslonu i uklanja sve bilješke o obradi iz baze podataka koje su prethodno snimljene za ovu stavku |
Iznimke
| Argument | Opis |
|---|---|
| red čekanja posla nije pronađen | Red čekanja posla povezan sa stavkom izbrisan je ili više nije dostupan |
| Stavka red čekanja posla nije pronađena | Stavka red čekanja posla nije valjana |
| Dodavanje rezultata obrade nije uspjelo | Stavka red čekanja posla koja se ažurira naišla je na neočekivanu pogrešku. Dodatne pojedinosti potražite u poruci o pogrešci. |
Dobij stavke reda čekanja posla po filtru
Akcija Dohvati stavke red čekanja posla filtrom omogućuje korisnicima dohvaćanje jedne ili više stavki red čekanja posla na temelju izraza filtra FetchXML .
Getworkqueueitemsaction
Akcija Dohvati stavke red čekanja posla filtrom zahtijeva sljedeće argumente.
Ulazni parametri
| Argument | Neobavezno | Prihvaća | Zadana vrijednost | Opis |
|---|---|---|---|---|
| red čekanja posla | No | SMS | Red čekanja posla za dohvaćanje stavki | |
| Filtriranje redaka | No | SMS | FetchXML izraz upita koji se koristi za dohvaćanje stavki iz red čekanja posla | |
| Redovi za povratak | No | Broj | 5000 | Maksimalan broj stavki red čekanja posla koje je orkestrator vratio |
Varijable proizvedene
| Argument | Tip | Zadana vrijednost | Opis |
|---|---|---|---|
| WorkQueueItems | No | Omogućeno | Popis stavki red čekanja posla koje odgovaraju izrazu filtra. |
Iznimke
| Argument | Opis |
|---|---|
| red čekanja posla | Red čekanja posla za dohvaćanje stavki. |
| Filtriranje redaka | Izraz FetchXML upita koji se koristi za dohvaćanje stavki iz red čekanja posla. |
| Redovi za povratak | Maksimalan broj stavki red čekanja posla koje vraća orkestrator (zadana vrijednost je 5000). |
Što su FetchXML upiti?
Microsoft Dataverse FetchXML je jezik koji se koristi za dohvaćanje podataka iz baze Dataverse podataka. Dizajniran je tako da ga je lako stvoriti, koristiti i razumjeti. Na primjer, možda ćete htjeti zatražiti Dataverse popis svih stavki red čekanja posla koje su u IT Exception stanju.
Da bismo ograničili podršku za upite FetchXml na dohvaćanje stavki red čekanja posla, podržavamo samo ograničeni skup pojmova i izraza FetchXml. Ti pojmovi i izrazi obuhvaćaju atribute, filtre, uvjete i izraze redoslijeda, a svi su ograničeni na tablicu stavki red čekanja posla (workqueueitem). Morate izričito navesti koja svojstva vratiti iz tablice stavki red čekanja posla i željeni redoslijed sortiranja.
Primjer FetchXML upita
Sljedeći primjer je izraz upita za dohvaćanje nekoliko svojstava, filtriranje pogrešnih stavki označenih kao IT Exceptions i redoslijed rezultata prema onim zapisima koji prvi istječu (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" />
Pojedinosti o podršci i referentni podaci za upit
- Popis operatora upita dostupnih za korištenje, uključujući operatore kao što su on-or-before, between i last month.
- Popis atributa dostupnih u tablici stavki red čekanja posla.
Stanje (statecode)
| Stanje | Kôd | Opis |
|---|---|---|
| U redu čekanja | 0 | Stavka je u redu čekanja |
| Obrada | 1 | Artikl je u obradi |
| Obrađeno | 2 | Stavka je obrađena |
| Na čekanju | 3 | Stavka je na čekanju |
| Pogreška | 4 | Stavka je naišla na pogrešku |
Razlog stanja (statuscode)
| Razlog statusa | Kôd | Opis |
|---|---|---|
| U redu čekanja | 0 | Stavka je u redu čekanja |
| Obrada | 1 | Artikl je u obradi |
| Obrađeno | 2 | Stavka je obrađena |
| Na čekanju (pauzirano) | 3 | Stavka je na čekanju (pauzirana) |
| Generička iznimka | 4 | Stavka je naišla na generičku iznimku |
| IT iznimka | 5 | Stavka je naišla na IT iznimku |
| Poslovna iznimka | 6 | Stavka je naišla na poslovnu iznimku |
| Neisporučeno pismo | 7 | Stavka je na čekanju |
| ProcessingTimeout | 8 | Isteklo je vrijeme obrade artikla |