Procesarea cozilor de lucru

Procesarea cozii de lucru se referă la gestionarea unei liste de articole de lucru care trebuie finalizate într-o anumită ordine. Această listă conține informații despre fiecare articol, cum ar fi numele, prioritatea, data de expirare, starea și valoarea reală care trebuie procesată.

Modalități de procesare a cozilor de lucru:

Aflați mai multe despre instrumentele pro-code ale Dataverse: Dataverse documentația pentru dezvoltatori.

Procesarea explicațiilor

Pentru a prezenta unele dintre opțiunile de procesare disponibile, iată trei scenarii de procesare diferite.

Procesarea cozii de lucru bazată pe flux de desktop pe Power Automate desktop (PAD)

Procesați elementele din coada de lucru & Exemple de actualizare

Primul pas pentru utilizarea acțiunilor din coada de lucru pe desktop este să creați o coadă de lucru în mediul în care lucrați și să încărcați unele elemente din coadă cu date care urmează să fie consumate în aval. Power Automate Elementele din coadă pot fi încărcate într-o coadă de lucru printr-un flux desktop, flux cloud sau în vrac, așa cum este subliniat aici, care populează elementele în coadă. În acest exemplu, unele elemente din coadă au fost adăugate manual într-o coadă de lucru pentru a explica cum pot fi utilizate acțiunile de pe desktop. Power Automate

Elementele din coada de lucru au fost create, iar câmpul de valoare include text în format JSON care va fi folosit în aval în fluxul desktop.

Exemplul de flux pe care îl vom folosi pentru a demonstra utilizarea acțiunii în coada de lucru imită un proces care ar consuma un element din coada de lucru din cloud, ar procesa datele incluse în câmpul de valoare și le-ar converti într-un obiect personalizat pentru a fi procesat în aval. Rețineți că nu este obligatoriu să utilizați JSON sau obiecte personalizate ca valori pentru elementele din coada de lucru, dar poate fi o metodă utilă pentru organizarea valorilor care au mai multe proprietăți și urmează o anumită schemă.

1. Acțiunea Procesează articolele din coada de lucru este utilizată pentru a desemna din ce coadă de lucru se va consuma articole și să se proceseze în fluxul desktop. Acțiunea poate fi configurată pentru a selecta o coadă de lucru dintr-o listă folosind săgeata drop-down, transmite o variabilă care include numele cozii. Când este rulată, această acțiune funcționează prin introducerea primului (cel mai vechi) element din coada de lucru în fluxul dvs. care conține o stare de în coadă. Odată ce elementul din coadă începe procesarea în fluxul dvs., starea acestuia se schimbă automat în procesare.

1. Un punct de întrerupere (punct roșu) a fost setat făcând clic pe lângă acțiunea 3 din flux și apoi rulat prin consola PAD. Când procesul se întrerupe la punctul de întrerupere, variabila WorkQueueItem poate fi deschisă făcând dublu clic pe valoarea populată de sub Variabile flux și aceasta arată toate proprietățile asociate cu elementul din coada de lucru care este procesat.

1. În acțiunea 2 a fluxului, am convertit valoarea JSON returnată, care în acest caz este accesată prin %WorkQueueItem.Value% într-un obiect personalizat. Motivul pentru aceasta este că ajută la analiza JSON și la utilizarea proprietăților JSON în aval în fluxul dvs. În acest caz ipotetic, informațiile ar fi folosite pentru a face intrări în portalul financiar al Farbrikam.

   {
    "InvoiceId": "I-1006",
    "InvoiceDate": "06/04/2023",
    "AccountName": "Fabrikam",
    "ContactEmail": "invoicing@fabrikam.com",
    "Amount": 1253.78,
    "Status": "Paid",
    "WorkQueueKey": "Vendor Invoices",
    "ComponentState": 0,
    "OverwriteTime": "1900-01-01T00:00:00"
   }
   

   

   De exemplu, să presupunem că a existat o cerință de a introduce ID-ul facturii într-un câmp al unui sistem financiar ca parte a unui proces în care automatizați interfața de utilizare a unei aplicații web sau desktop – puteți apela acea valoare folosind %JsonAsCustomObject.InvoiceId% pentru a completa un câmp de text și apăsați un buton.

2. Continuând, acest exemplu conține câteva instrucțiuni condiționale odată ce termină procesarea pașilor și utilizează datele din obiectul personalizat din subfluxul Fabrikam Data Entry. Dacă procesul rulează de la capăt la capăt, fără a întâmpina excepții legate de sistemul de introducere, acțiunea Actualizați elementul în coada de lucru este utilizată pentru a schimba starea articolului în coada de lucru în Procesat iar procesarea rezultatului poate fi folosită opțional pentru introducerea unor note de câmp . Dacă câmpul expires este lăsat necompletat, noul element din coadă păstrează Elementele expiră după valoarea definită în proprietățile cozii de lucru.

   Notă

   Dacă elementele din coada de lucru sunt blocate în starea de procesare, deoarece un flux desktop nu se finalizează, utilizați un flux cloud pentru a prelua și actualiza elementele în coada de lucru.

   

   Opțiunile de gestionare a excepțiilor pot fi configurate făcând clic pe pe eroare în fereastra de configurare a acțiunii actualizați elementul cozii de lucru . Trei opțiuni sunt disponibile pentru personalizare în fila avansată. Elementul din coada de lucru nu a fost găsit ar putea să apară dacă elementul din coada de lucru este eliminat din coadă, fie manual, fie printr-un alt proces sistematic, înainte de a termina procesarea în PAD. Elementul din coada de lucru în așteptare ar putea să apară dacă un proces automat sau cineva schimbă starea elementului din coada de lucru care este procesat în în așteptare în portalul fluxului în timp ce elementul în coadă este procesat. Eșuarea actualizării elementului din coada de lucru ar putea să apară dacă elementul din coadă nu mai există în coadă sau a fost plasat în starea în așteptare. Toate cele de mai sus sunt cazuri marginale, care pot apărea - aflați mai multe despre gestionarea erorilor în fluxurile desktop aici.

   

3. Dacă a fost determinată o problemă în timpul procesării datelor articolului din coada de lucru în sistemul de introducere a datelor, elementului i-ar putea fi atribuit, alternativ, o stare de excepție generică, excepție IT sau excepție de afaceri. Aceste stări de excepție sunt disponibile pentru a fi utilizate atunci când sau dacă cazul dvs. de utilizare automatizat îndeplinește criterii, care s-ar putea aplica.

   

   Să presupunem că în timpul procesării unui articol din coadă, scenariul 2 a fost îndeplinit. În acest caz, elementul din coadă este marcat ca excepție generică în coada de origine. În funcție de scenariu, ați putea decide să modificați starea elementelor din coadă, care nu au putut fi procesate cu succes ca una dintre opțiunile alternative de stare. De acolo, puteți decide dacă este necesară intervenția umană sau puteți construi un proces ulterior cu logica necesară pentru a gestiona fiecare stare de excepție.

   

Model de reîncercare automată

Acțiunea Procesează elementele din coada de lucru în Power Automate Desktop include o opțiune avansată pentru a configura sau a înlocui un mecanism de reîncercare automată. Această caracteristică vă permite să specificați numărul maxim de reîncercări automate pentru fiecare articol din coada de lucru, ceea ce este util pentru gestionarea excepțiilor IT, cum ar fi erorile tranzitorii de rețea sau indisponibilitatea temporară a sistemului. Acesta permite mașinii să rețină articolul și să efectueze reîncercări controlate fără a pune din nou în coadă articolul, asigurând o procesare mai eficientă și mai rezistentă la coada de lucru.

Puteți seta și controla central numărul maxim de reîncercări în înregistrarea în coada de lucru în Dataverse. Această valoare implicită se aplică tuturor fluxurilor desktop care procesează această coadă de lucru prin acțiunea Procesează elementele din coada de lucru .

Pentru a anula valoarea prestabilită la nivel de coadă în fluxul dvs., navigați la secțiunea Avansat a acțiunii Procesați elementele din coada de lucru și comutați Înlocuire coadă de lucru Opțiunea de modificare a cozii de lucru42>auto-option. Această setare vă permite să ajustați numărul maxim de reîncercări la o valoare mai mare sau mai mică sau chiar să dezactivați mecanismul de reîncercare setând numărul maxim de reîncercări la 0.

Când utilizați acțiunea Actualizați elementul cozii de lucru cu starea setată la IT exception și un număr maxim de reîncercări automate mai mare de 0, sistemul nu trimite imediat actualizarea orchestratorului cozii de lucru. În schimb, reîncearcă operația până când atinge numărul maxim de reîncercări specificat. Singura valoare actualizată în elementul din coada de lucru este retrycount. Această valoare crește de la a doua încercare de actualizare până când este atins numărul maxim de reîncercări automate. În plus, o variabilă locală de articol din coada de lucru numită CurrentRetryCount crește cu fiecare reîncercare. Această variabilă vă permite să implementați logica personalizată pe baza valorii acesteia, dacă este necesar.

Fluxul nu va solicita un element nou atunci când se întoarce în partea de sus a Procesați articolele din coada de lucru acțiune dacă sunt îndeplinite următoarele condiții:

• Numărul maxim de reîncercări nu a fost atins.
• Nu au loc alte actualizări, cu excepția excepțiilor IT.

Când este atins numărul maxim de reîncercări, acțiunea de actualizare trimite actualizarea orchestratorului, schimbând starea articolului în Excepție IT și incluzând orice note de procesare furnizate.

Adăugarea și repunerea în coadă de exemple de articole din coada de lucru din PAD

The Adăugați un element în coada de lucru permite utilizatorilor fluxului de desktop să completeze elementele din coada de lucru într-o coadă de lucru, care a fost configurată în portalul fluxului. Crearea articolelor în loturi este acceptată prin utilizarea acțiunii Adăugați elemente în coada de lucru .

În acest exemplu, un fișier Excel în .csv este aruncat într-un director zilnic și fiecare rând trebuie adăugat la o coadă de lucru.

Primele două acțiuni din acest exemplu de proces mapează un folder în care este aruncat fișierul zilnic Contoso Invoices.csv - când procesul rulează, începe prin citirea tabelului de date din fișierul CSV. Variabila CSVTable conține datele, care au fost importate și vor fi procesate în noi elemente din coadă.

Acțiunile 3 și 4 generează momentul la care alegem noile elemente din coadă să expire după ce au fost adăugate într-o coadă de lucru. Acțiunea 3 captează datele actuale ale sistemului și ora, apoi pentru acest exemplu sunt adăugate 7 zile utilizând acțiunea %Add to datetime% . Ieșirea este stocată într-o variabilă numită ExpiryDatetime care va fi folosită în acțiunea Adăugați un element în coada de lucru .

Acțiunea 5 introduce bucla For each , care este folosită pentru a itera prin fiecare rând de date din CSVTable importat - această acțiune redă un rând de date pentru elementul curent care este procesat.

Toate acțiunile anterioare din acest exemplu de flux desktop sunt acum încorporate în setarea valorilor pentru acțiunea Adăugați un element în coada de lucru .

Parametrul coadă de lucru este setat la coada în care dorim să adăugăm elemente noi în coada de lucru - în acest caz Coadă Demo PAD a fost selectată prin alegerea acesteia din meniul drop-down.

Parametrul Prioritate este lăsat implicit, Normal, dar opțiunile pentru Scăzut și Ridicat sunt, de asemenea, opționale. Elementele din coada de lucru cu prioritate mai mare sunt procesate mai întâi, apoi normale și ultimele când sunt amestecate în aceeași coadă de lucru.

Parametrul Name a fost setat cu un prefix static împreună cu valoarea variabilei CurrentItem['ID'] - care conține valoarea din celula ID a rândului de date procesat. Acest lucru este opțional, dar poate fi util în funcție de cazul dvs. de utilizare.

Folosind valorile din rândul de date din variabila CurrentItem parametrul Input a fost introdus în format JSON. Rețineți că fiecare nume de antet a fost adăugat la variabila currentitem , folosind notația ['numele antetului']

Câmpul Expiră este completat cu variabila dată și oră la care am adăugat 7 zile în pașii anteriori. Când este lăsat necompletat, elementul din coada de lucru adăugat va conține Elementele expiră după valoarea setată pentru coada de lucru.

Notele de procesare sunt opționale - utilizați după cum se consideră necesar.

Când procesul este rulat, fiecare rând de date din fișierul CSV importat creează un element de coadă de lucru care conține o stare În coadă , ceea ce înseamnă că este disponibil pentru procesare.

Acestea sunt doar câteva dintre multele moduri prin care acțiunile din coada de lucru pot fi utilizate în PAD. Acordați-vă timp pentru a explora și a găsi utilizări creative pentru a încorpora cozile de lucru în fluxurile dvs. Power Automate !

Exemplu de repunere în coadă a articolului cu întârziere

Acțiunea Repunerea în coadă a articolului cu întârziere permite utilizatorilor fluxului de desktop să pună din nou în coadă articolele și să stabilească o perioadă de întârziere, moment în care articolul poate fi eliberat din nou pentru procesare.

În acest exemplu, există o coadă de lucru încărcată cu articole, care sunt setate să expire în 24 de ore, dar nu pot fi procesate la timp, deoarece există o întreținere continuă a sistemului de rutină efectuată de IT și articolele trebuie repuse în coadă. Întreținerea se va finaliza peste noapte, așa că vom continua să amânăm fiecare articol din coadă cu 24 de ore și apoi vom seta să expire la 24 de ore după perioada de lansare.

Primele trei acțiuni ale acestui proces exemplu sunt acțiuni date și oră. Acțiunea „Obține data și ora curentă” captează data și ora sistemului în momentul în care acțiunea este executată. Apoi am folosit acțiunea „Adăugați la data și oră” pentru a acoperi două cerințe, mai întâi trebuie să definim timpul de întârziere adăugând 24 de ore la data și ora curentă - apoi trebuie să adăugăm 48 de ore la data și ora curentă ca expirare.

În continuare, în exemplu, acțiunea „Procesează elementele din coada de lucru” este configurată pentru a indica coada de lucru încărcată, iar „Elementul din coada de lucru cu întârziere” este plasat în buclă.

Valorile generate pentru întârziere și expirare pot fi acum trecute în acțiunea „Pune în coadă element cu întârziere”. Câmpul „articol din coada de lucru” este populat de variabila produsă de buclă - aceasta indică ce element din coadă să se reia în coadă. Apoi am introdus valorile create folosind acțiunile datetime pentru câmpurile „întârziere până la” și „expiră”. „Întârzierea până la” este obligatorie, dar puteți utiliza „expire” și „rezultat procesare” la discreția dvs.

Cu acest proces simplu, puteți pune din nou în coadă toate articolele disponibile într-o coadă, le puteți întârzia pentru un anumit timp, cu opțiuni pentru a seta și o dată de expirare și rezultatul procesării.

Flux în cloud și procesare bazată pe conector

Cea mai simplă modalitate de a scoate din coadă un articol din coada de lucru și de a-l procesa este după cum urmează:

1. Accesați Power Automate și conectați-vă cu datele de conectare.

2. În meniul din stânga, selectați Fluxurile mele.

3. Pe bara de instrumente, selectați + Flux nou și apoi selectați Flux cloud instantaneu.

4. Furnizați un Nume flux, cum ar fi Primul meu flux de coadă de lucru, apoi selectați Declanșați manual un flux.

5. Selectați Creați.

6. Odată ce designerul de flux se deschide, selectați + Pas nou, și apoi selectați conectorul Microsoft Dataverse .

7. În lista de acțiuni, selectați Efectuați o acțiune legată.

1. Fluxul dvs. ar trebui să arate asemănător cu acesta acum.

1. Selectați Salvați și apoi Testați fluxul dvs.

2. În panoul lateral de testare, selectați Manual, Test, Run flow și apoi Efectuat.

3. Dacă fluxul a rulat cu succes, ar trebui să obțineți un rezultat similar (dar cu ID-uri diferite).

1. Apoi, copiați întregul conținut JSON din câmpul body și apoi selectați Editare în colțul din dreapta sus al fluxului.

1. Adăugați un pas nou selectând + Pas nou și căutați o acțiune numită Parse JSON și selectați-o.

1. Poziționați mouse-ul în câmpul Conținut și selectați proprietatea body din acțiunea anterioară.

1. Apoi, selectați Generare din eșantion și inserați șirul JSON copiat anterior în caseta de dialog și selectați Terminat.

2. Selectați + Pas nou și apoi selectați conectorul Microsoft Dataverse .

3. Din lista de acțiuni, selectați Actualizați un rând.

4. În câmpul Nume tabel , selectați tabelul Elemente coadă de lucru și poziționați cursorul în câmpul ID rând .

5. În lista Conținut dinamic , veți avea acum toate câmpurile care sunt disponibile în tabelul de articole din coada de lucru.

6. Selectați Afișați opțiunile avansate și apoi setați RowID, Rezultat procesare, Starestatus Motiv câmpurile la următoarele valori.

1. Selectați Salvați și Testați încă o dată debitul.

2. Dacă fluxul a rulat cu succes, ar trebui să obțineți un rezultat similar cu următorul.

   

3. Acum, navigați la pagina cu detaliile cozii de lucru și, în secțiunea cu lista de articole din coada de lucru, selectați Vedeți tot.

4. Filtrați câmpul Stare pentru a afișa numai elementele Procesate și Procesate pentru a confirma că acțiunile noastre de scoatere din coadă și de actualizare au funcționat conform așteptărilor.

   

   

   

   Felicitări, tocmai ați finalizat primul scenariu de procesare a cozii de lucru!

Procesare bazată pe flux în cloud cu suport pentru flux desktop

Pentru acest scenariu, îl extindem pe cel anterior adăugând și o etapă de procesare a fluxului desktop.

1. Reveniți și editați Primul meu flux de coadă de lucru.

2. Adăugați o acțiune nouă direct după acțiunea Parse JSON și căutați Fluxuri de desktop conector și Rulați un flux creat cu Power Automate pentru desktop.

3. În meniul derulant al fluxului desktop, fie alegeți și editați un flux desktop existent, fie selectați + Creați un flux nou desktop și urmați instrucțiunile de pe ecran pentru a crea fluxul desktop și lansați Power Automate pentru desktop. Dacă sunteți nou în ceea ce privește fluxurile desktop, puteți afla mai multe aici.

4. Odată ce se deschide Power Automate pentru desktop designer, creați două variabile de intrare numite WorkQueueItemValue și WorkQueueItemName și apoi > două ieșire variabile numite ProcessingNotes și ProcessingStatus respectiv, toate acestea ar trebui să aibă ca tipul lor de date Text .

5. Furnizați o valoare implicită pentru variabila WorkQueueItem , astfel încât să puteți testa ulterior scriptul la nivel local. În cazul în care ați urmat tutorialul de import în bloc , ar trebui să aveți elemente în coada de lucru în coada de facturi Vendor care au valorile în format JSON. Iată un exemplu de una dintre valorile utilizate.

   {
    "InvoiceId": "I-1006",
    "InvoiceDate": "06/04/2023",
    "AccountName": "Fabrikam",
    "ContactEmail": "invoicing@fabrikam.com",
    "Amount": 1253.78,
    "Status": "Paid",
    "WorkQueueKey": "Vendor Invoices",
    "ComponentState": 0,
    "OverwriteTime": "1900-01-01T00:00:00"
   }
   

   

6. Acum, Salvați fluxul.

7. În panoul de acțiuni, deschideți grupul de acțiuni Variabile și faceți dublu clic pe acțiunea Conversie JSON în obiect personalizat pentru a-l adăuga la panza de proiectare, care deschide fereastra de proprietăți.

8. Selectați pictograma variabilă din câmpul JSON și alegeți variabila WorkQueueItemValue .

9. Redenumiți variabila de ieșire produsă din JsonAsCustomObject în VendorInvoice și selectați Salvați.

10. Apoi, adăugați o acțiune If din grupul Condiționale și configurați proprietățile acestuia după cum urmează:

    Primul operand	Operator	Al doilea operand
    %VendorInvoice['Suma']%	Mai puțin de (<)	5000

11. Selectați Salvați.

12. Adăugați o altă acțiune din grupul Condiționale numit Else și adăugați-o între acțiunea If și End .

13. Acum, adăugați alte două acțiuni din grupul Variabile numit Setare variabilă și adăugați-le în Dacă și Else acțiuni și setați variabilele ProcessingNotes și ProcessingStatus la următoarele valori:

    Variabilă	Valoare
    %ProcessingNotes%	Factura a fost procesată
    %ProcessingStatus%	Procesate

14. Copiați cele două acțiuni Setare variabilă și inserați-le între acțiunea Else și End și modificați-le valorile pentru a se potrivi cu acestea:

    Variabilă	Valoare
    %ProcessingNotes%	Excepție comercială: suma facturii este mai mare decât $5000, care necesită aprobarea managerului.
    %ProcessingStatus%	Excepție

15. Fluxul dvs. ar trebui să arate asemănător cu acesta acum.

    

16. Salvați fluxul și rulați-l pentru a confirma că logica fluxului funcționează conform așteptărilor.

17. Reveniți pentru a edita Primul meu flux de coadă de lucru.

18. Selectați fluxul desktop nou creat (sau editat) din listă, apoi selectați Participat ca Mod de rulare.

19. Completați parametrii Valoare element din coada de lucru și Nume articol din coadă de lucru așa cum se arată aici:

    

20. Adăugați o Condiție acțiune înainte de acțiunea Actualizați un rând .

21. Poziționați mouse-ul în câmpul Alegeți o valoare și selectați Starea procesării din caseta de dialog a listei de conținut dinamic.

22. Poziționați mouse-ul în celălalt câmp Alegeți o valoare și introduceți Processed ca valoare text.

23. Trageți și plasați acțiunea de actualizare a rândului în secțiunea Dacă da a acțiunii de condiție.

24. Deschideți Actualizați un rând detaliile acțiunii și înlocuiți valorile astfel încât să corespundă următoarelor:

    

25. În caseta roșie Dacă nu, adăugați o altă acțiune Actualizați un rând și selectați Elemente din coada de lucru ca Nume tabel.

26. Apoi, selectați workqueueitemid as Row ID și deschideți Afișați opțiuni avansate secțiunea select Note de procesareprocessingsecțiunea Rezultate valoare.

27. Selectați Eroare ca Stare și GenericException pentru Motivul stării.

    

28. Selectați Salvați și Testați pentru a testa automatizarea generală și pentru a observa rezultatul acțiunii fluxului desktop.

    

29. Pentru a confirma că elementul din coada de lucru a fost procesat, puteți accesa pagina cu detaliile cozii de lucru, selectați Vedeți tot în secțiunea articole din coada de lucru și filtrați articolele după starea Procesate .

    

Bravo, tocmai ați finalizat un scenariu mai avansat care includea procesarea hibridă a cozii de lucru!

Pașii următori

Aflaţi mai multe

• Prezentare generală la coada de lucru
• Gestionați cozile de lucru
• Importați în bloc datele din coada de lucru
• Declanșează cozile de lucru
• Probleme și limitări cunoscute