Munkavárólisták feldolgozása

A munkasor feldolgozása egy adott sorrendben elvégzendő munkaelemek listájának kezelését jelenti. Ez a lista az egyes tételekkel kapcsolatos információkat tartalmazza, például a nevét, prioritását, lejárati dátumát, állapotát és a feldolgozandó tényleges értéket.

A munkasorok feldolgozásának módjai:

További információ a Dataverse pro-code eszközről: Dataverse fejlesztői dokumentáció.

Útmutatók feldolgozása

A rendelkezésre álló feldolgozási lehetőségek bemutatásához három különböző feldolgozási forgatókönyvet mutatunk be.

Asztali folyamatalapú munkasor feldolgozása Power Automate asztali számítógépen (PAD)

Munkasorelemek feldolgozása és frissítési példák

A munkavárólista-műveletek asztali Power Automate számítógépen való használatának első lépése egy munkavárólista létrehozása abban a környezetben, amelyben dolgozik, és néhány várólistaelem betöltése a későbbi felhasználásra szánt adatokkal. A várólistaelemek betölthetők egy munkavárólistába asztali folyamaton, felhőfolyamaton vagy tömegesen az itt leírtakszerint, amely feltölti a várólistaelemeket. Ebben a példában néhány várólista-elemet manuálisan adtak hozzá egy munkavárólistához, hogy elmagyarázzák az asztali műveletek Power Automate használatát.

Létrejöttek a munkavárólista-elemek, és az érték mező JSON formátumú szöveget tartalmaz, amely az asztali folyamatban lesz használva.

A munkavárólista-művelet használatának bemutatására használt példafolyamat egy olyan folyamatot utánoz, amely a felhőből használ egy munkasor-elemet, feldolgozza az érték mezőben szereplő adatokat, és átalakítja azokat egy későbbi feldolgozásra szánt egyéni objektummá. Vegye figyelembe, hogy nem kötelező JSON-t vagy egyéni objektumokat használni a munkavárólista-elemek értékeként, de hasznos módszer lehet a több tulajdonsággal rendelkező és egy adott sémát követő értékek rendszerezésére.

1. A Munkasor elemeinek feldolgozása művelet annak meghatározására szolgál, hogy melyik munkasorból használja fel és dolgozza fel az elemeket az asztali folyamatban. A művelet beállítható úgy, hogy a legördülő nyíl segítségével válasszon ki egy munkasort egy listából, és adjon át egy változót, amely tartalmazza a várólista nevét. Futtatáskor ez a művelet úgy működik, hogy a munkavárólistából az első (legrégebbi) elemet hozza be a folyamatba, amely a várólistán állapotot tartalmazza. Amint az üzenetsor-elem feldolgozása megkezdődik a folyamatban, az állapota automatikusan feldolgozásra változik.

1. A töréspontot (piros pontot) a folyamat 3. művelete melletti kattintással állítottuk be, majd futtattuk a PAD-konzolon. Amikor a folyamat szünetel a töréspontnál, a WorkQueueItem változó megnyitható úgy, hogy duplán kattint a Folyamatváltozók alatti kitöltött értékre, és ez megjeleníti a feldolgozott munkasor-elemhez társított összes tulajdonságot.

1. A folyamat 2. műveletében a visszaadott JSON-értéket, amely ebben az esetben a %WorkQueueItem.Value% használatával érhető el, egyéni objektummá alakítottam. Ennek az az oka, hogy segít a JSON elemzésében és a JSON-tulajdonságok lefelé történő használatában a folyamatban. Ebben a hipotetikus esetben az információkat a Farbrikam pénzügyi portáljára történő bejegyzésekhez használnák fel.

   {
    "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"
   }
   

   

   Tegyük fel például, hogy a számlaazonosítót be kell írni egy pénzügyi rendszer mezőjébe egy olyan folyamat részeként, ahol automatizálja egy webes vagy asztali alkalmazás felhasználói felületét – ezt az értéket hívhatja meg a következővel: using% JsonAsCustomObject.InvoiceId%szövegmező feltöltéséhez és egy gomb megnyomásához.

2. Ez a példa néhány feltételes utasítást tartalmaz, miután befejezte a lépések feldolgozását, és az egyéni objektum adatait használja a Fabrikam-adatbevitelben. Ha a folyamat végpontok között fut anélkül, hogy a bemeneti rendszerrel kapcsolatos kivételekkel találkozna, a Munkasor elemének frissítése művelet a munkasor elem állapotát Feldolgozva értékre módosíthatja, a feldolgozási eredmény mező pedig néhány választható megjegyzés bevitelére használható. Ha a lejárat mező üresen marad, az új várólistaelem megtartja a Cikkek lejárata a munkasor tulajdonságaiban meghatározott érték után .

   Feljegyzés

   Ha a munkavárólista-elemek feldolgozási állapotban ragadtak, mert egy asztali folyamat nem fejeződik be, használjon felhőfolyamatot a munkavárólista elemeinek lekéréséhez és frissítéséhez.

   

   A kivételkezelési beállítások a munkasor-elem frissítése művelet konfigurációs ablakában a hiba gombra kattintva konfigurálhatók. Három lehetőség áll rendelkezésre a testreszabáshoz a speciális lapon. A nem található munkasor-elem akkor fordulhat elő, ha a munkasor-elemet manuálisan vagy más szisztematikus folyamaton keresztül eltávolítják a várólistából, mielőtt befejeznék a feldolgozást a PAD-ban. Várakoztatott munkasor-elem akkor fordulhat elő, ha egy automatizált folyamat, vagy valaki a folyamatportálon a feldolgozás alatt álló munkasor-elem állapotát várakoztatottra módosítja a folyamatportálon a várólistaelem feldolgozása közben. A munkavárista-elem frissítése sikertelen lehet, ha a várólistaelem már nem létezik a várólistában, vagy várakoztatott állapotbakerült. A fentiek mind peremhálózati esetek, amelyek előfordulhatnak – az asztali folyamatok hibáinak kezeléséről itt olvashat bővebben.

   

3. Ha valamilyen problémát állapítottak meg a munkasor-elem adatainak adatbeviteli rendszerbe történő feldolgozása során, az elemhez általános kivétel, informatikai kivétel vagy üzleti kivétel állapototrendelhet. Ezek a kivételállapotok akkor használhatók, ha az automatizált használati eset megfelel az esetlegesen alkalmazandó feltételeknek.

   

   Tegyük fel, hogy egy üzenetsor-elem feldolgozása során a 2. forgatókönyv teljesült. Ebben az esetben az üzenetsor-elem általános kivételként van megjelölve az eredeti üzenetsorban. A forgatókönyvtől függően dönthet úgy, hogy módosítja a várólistaelemek állapotát, amelyeket nem lehetett sikeresen feldolgozni az alternatív állapotbeállítások egyikeként. Innen eldöntheti, hogy szükség van-e emberi beavatkozásra, vagy létrehozhat egy későbbi folyamatot az egyes kivételállapotok kezeléséhez szükséges logikával.

   

Automatikus újrapróbálkozási minta

Az Asztal Munkasor elemeinek feldolgozása művelet Power Automate speciális beállítást tartalmaz az automatikus újrapróbálkozási mechanizmus konfigurálásához vagy felülbírálásához. Ez a szolgáltatás lehetővé teszi az automatikus újrapróbálkozások maximális számának megadását munkasor-elemenként, ami hasznos az informatikai kivételek, például az átmeneti hálózati hibák vagy a rendszer ideiglenes elérhetetlenségének kezeléséhez. Lehetővé teszi a gép számára, hogy megőrizze az elemet, és ellenőrzött újrapróbálkozásokat hajtson végre anélkül, hogy sorba állna, így hatékonyabb és rugalmasabb munkasor-feldolgozást biztosít.

Beállíthatja és központilag szabályozhatja a munkasor rekordjának Dataverse maximális újrapróbálkozási számát. Ez az alapértelmezett érték minden olyan asztali folyamatra vonatkozik, amely a Munkavárólista elemeinek feldolgozása művelettel dolgozza fel ezt a munkasort.

A folyamat várólistaszintű alapértelmezett értékének felülbírálásához lépjen a Munkasor elemeinek feldolgozása művelet Speciálisszakaszára, és váltsa be a Munkasor automatikus újrapróbálkozási konfigurációjának felülbírálása beállítást. Ezzel a beállítással magasabb vagy alacsonyabb értékre állíthatja az újrapróbálkozások maximális számát, vagy akár letilthatja az újrapróbálkozási mechanizmust a maximális újrapróbálkozási szám 0-ra állításával.

Ha a Munkavárista-elem frissítése műveletet 0-nál nagyobb állapottal IT exception és maximális automatikus újrapróbálkozási számmal használja, a rendszer nem küldi el azonnal a frissítést a munkasor vezénylésére. Ehelyett addig próbálkozik újra a művelettel, amíg el nem éri a megadott maximális újrapróbálkozási számot. A munkasor elemében csak a retrycount. Ez az érték a második frissítési kísérlettől kezdve növekszik, amíg el nem éri az automatikus újrapróbálkozások maximális számát. Ezenkívül egy helyi munkasor elemváltozó, amelyet minden újrapróbálkozáskor növekmények hívnak CurrentRetryCount . Ez a változó lehetővé teszi egyéni logika implementálását az értéke alapján, ha szükséges.

A folyamat nem kér új elemet, amikor visszakerül a Munkasor elemeinek feldolgozása művelet tetejére , ha az alábbi feltételek teljesülnek:

• Az újrapróbálkozások maximális száma nem érhető el.
• Az informatikai kivételeken kívül más frissítés nem történik.

Az újrapróbálkozások maximális számának elérésekor a frissítési művelet elküldi a frissítést a vezénylésnek, és az elem állapotát informatikai kivételre módosítja, és tartalmazza a megadott feldolgozási megjegyzéseket.

Példák munkasorelemek hozzáadására és sorba állítására a PAD-ból

A Munkasor hozzáadása elem lehetővé teszi az asztali folyamat felhasználói számára, hogy a munkavárólista-elemeket egy munkafolyamat-portálon beállított munkavárólistába töltsék fel. A kötegcikkek létrehozása a Munkavára-elemek hozzáadása művelettel támogatott.

Ebben a példában a .csv egy Excel-fájlt naponta egy könyvtárba dobnak, és minden sort hozzá kell adni egy munkavárólistához.

A mintafolyamat első néhány művelete egy mappát képez le, ahol a napi Contoso Invoices.csv fájl el van dobva – a folyamat futtatásakor az adattábla CSV-fájlból való beolvasásával kezdődik. A CSVTable változó tartalmazza az importált adatokat, amelyek új üzenetsor-elemekké lesznek feldolgozva.

A 3. és 4. művelet létrehozza azt az időpontot, amikor kiválasztjuk az új várólistaelemeket, amelyek lejárnak a munkavárólistához való hozzáadás után. A 3. művelet rögzíti az aktuális rendszeradatokat és időt, majd ebben a példában 7 napot ad hozzá a következővel : %Hozzáadás a datetime%művelethez . A kimenetet a rendszer egy ExpiryDatetime nevű változóban tárolja, amely a Munkasor elem hozzáadása műveletben lesz használva.

Az 5. művelet bevezeti az Egyes ciklusokat, amelyek az importált CSVTable egyes adatsorainak iterálására szolgálnak – ez a művelet egy adatsort jelenít meg az aktuálisan feldolgozott elemhez.

A példa asztali folyamatának összes fenti művelete beépült a Munkasor-elem hozzáadása művelet értékeinek beállításába.

A munkasor paraméter arra a várólistára van beállítva, amelyhez új munkasorelemeket szeretnénk hozzáadni - ebben az esetben a Demo PAD sor lett kiválasztva a legördülő menüből.

A Prioritás paraméter az alapértelmezett,Normál értéken marad, de az Alacsonyés a Magas beállítás is megadható . A magasabb prioritású munkavárólista-elemek kerülnek feldolgozásra először, majd a normál és az utolsó, ha ugyanabba a munkasorba keverik őket.

A Name paraméter statikus előtaggal van beállítva a változóértékkel CurrentItem['ID']- együtt, amely a feldolgozott adatsor azonosító cellájának értékét tartalmazza. Ez nem kötelező, de a használati esettől függően hasznos lehet.

A változó adatsorának értékeit használva CurrentItem a bemeneti paramétert JSON formátumban adta meg. Vegye figyelembe, hogy minden fejlécnevet hozzáfűztek a currentitem változóhoz a jelölés használatával['name of header']

A Lejárat mező az előző lépésekben 7 napot hozzáadó datetime változóval van feltöltve. Ha üresen hagyja, a hozzáadandó munkasor elem tartalmazza a Cikkek lejárnak a munkasorhoz beállított érték után .

A feljegyzések feldolgozása nem kötelező - szükség szerint használja.

A folyamat futtatásakor az importált CSV minden adatsora létrehoz egy Várólista-állapotot tartalmazó munkavára-elemet, ami azt jelenti, hogy feldolgozásra elérhető.

Ez csak néhány a sok közül, amellyel a munkasor-műveletek használhatók a PAD-ban. Szánjon egy kis időt a felfedezésre és a kreatív felhasználási módok megtalálására, hogy beépítse a munkasorokat a Power Automate folyamatokba!

Elem újrasorba állítása késleltetési példával

Az Elem újrasorba állítása késleltetéssel művelet lehetővé teszi az asztali folyamat felhasználói számára, hogy újra sorba állítsák az elemeket, és beállítsanak egy késleltetési időszakot, amikor az elem újra kiadható feldolgozásra.

Ebben a példában egy olyan elemekkel betöltött munkasor van, amelyek 24 órán belül lejárnak, de nem dolgozhatók fel időben, mert az informatikai részleg folyamatban lévő rutinszerű rendszerkarbantartást végez, és az elemeket újra sorba kell helyezni. A karbantartás egyik napról a másikra befejeződik, ezért az egyes üzenetsor-elemeket 24 órával késleltetjük, majd a kiadási időszak után 24 órával lejárnak.

A példafolyamat első három művelete dátum-idő műveletek. Az "Aktuális dátum és idő lekérése" művelet rögzíti a rendszer dátumát és idejét a művelet futtatásának pillanatában. Ezután a "Hozzáadás a dátumhoz" művelettel két követelményt fedünk le, először meg kell határoznunk a késleltetési időt úgy, hogy 24 órát adunk hozzá az aktuális dátumhoz – majd 48 órát kell hozzáadnunk az aktuális datetime-hoz lejáratként.

A példában a "Munkasor elemeinek feldolgozása" művelet úgy van beállítva, hogy a betöltött munkavárólistára mutasson, és az "Elem késleltetéssel történő várólistára állítása" a hurkon belül legyen.

A késleltetéshez és a lejárathoz generált értékek mostantól átadhatók az "Elem várólistára állítása késleltetéssel" műveletnek. A "munkasor-elem" mezőt a ciklus által előállított változó tölti fel - ez utasítja, hogy melyik sorelemet kell újra sorba állítani. Ezután bedugtuk a datetime műveletekkel létrehozott értékeket a "késleltetés végé" és a "lejárat" mezőkhöz. A "késleltetés vége" kötelező, de a "lejárat" és a "feldolgozási eredmény" lehetőségeket saját belátása szerint használhatja.

Ezzel az egyszerű eljárással újra sorba állíthatja az összes elérhető elemet egy sorban, késleltetheti őket egy bizonyos ideig, és beállíthatja a lejárati dátumot és a feldolgozási eredményt is.

Felhőfolyamat és összekötőalapú feldolgozás

A munkasor-elem várólistáról való eltávolításának és feldolgozásának legegyszerűbb módja a következő:

1. Menjen ide, Power Automate és jelentkezzen be hitelesítő adataival.

2. A bal oldali menüben válassza a Saját folyamatok lehetőséget .

3. Az eszköztáron válassza az + Új folyamat lehetőséget , majd válassza az Azonnali felhőfolyamat lehetőséget .

4. Adja meg a folyamat nevét, például az Első munkasor folyamata, majd válassza a Folyamat manuális aktiválása lehetőséget.

5. Válassza a Létrehozás parancsot.

6. Miután megnyílik a folyamattervező, válassza a lehetőséget + Új lépés, majd válassza ki az Microsoft Dataverse összekötőt.

7. A műveletek listájában válassza a Kötött művelet végrehajtása lehetőséget.

1. A folyamatnak most ehhez hasonlóan kell kinéznie.

1. Válassza a Mentés, majd a Folyamat tesztelése lehetőséget .

2. A tesztelés oldalablakában válassza a Manuális, Teszt, Folyamatfuttatása, majd a Kész lehetőséget .

3. Ha a folyamat sikeresen futott, hasonló eredményt kell kapnia (de más azonosítókkal).

1. Ezután másolja ki a teljes JSON-tartalmat a törzsmezőben , majd válassza a Szerkesztés lehetőséget a folyamat jobb felső sarkában.

1. Adjon hozzá egy új lépést a + Új lépés kiválasztásával , és keressen rá egy JSON elemzése nevű műveletre, és válassza ki.

1. Vigye az egeret a Tartalom mezőbe, és válassza ki a törzstulajdonságot az előző műveletből.

1. Ezután válassza a Létrehozás mintából lehetőséget , illessze be a korábban másolt JSON-sztringet a párbeszédpanelre, majd válassza a Kész lehetőséget.

2. Válassza az + Új lépés lehetőséget , majd válassza ki az Microsoft Dataverse összekötőt.

3. A műveletek listájából válassza a Sor frissítése lehetőséget.

4. A Tábla neve mezőben válassza ki a Munkasorelemek táblát, és vigye a kurzort a Sorazonosító mezőbe.

5. A Dinamikus tartalom listában most már minden olyan mező megtalálható, amely elérhető a munkasor elemtáblájában.

6. Válassza a Speciális beállítások megjelenítése lehetőséget , majd állítsa a Sorazonosító, a Feldolgozási eredmény , az Állapot ésaz Állapot oka mezőket a következő értékekre.

1. Válassza a Mentés lehetőséget, és tesztelje még egyszer a folyamatot.

2. Ha a folyamat sikeresen lefutott, az alábbihoz hasonló eredményt kell kapnia.

   

3. Most lépjen a munkasor részleteinek oldalára, és a munkasor elemeinek listájában válassza az Összes megtekintése lehetőséget.

4. Szűrje az Állapot mezőt úgy, hogy csak a Feldolgozás és a Feldolgozott elemek jelenjenek meg , hogy megbizonyosodjon arról, hogy a várt módon működött-e a sorból való törlés és a frissítési műveletek.

   

   

   

   Gratulálunk, most fejezte be az első munkasor-feldolgozási forgatókönyvet!

Felhőfolyamat-alapú feldolgozás asztali folyamatok támogatásával

Ebben a forgatókönyvben az előzőt egy asztali folyamat feldolgozási lépésének hozzáadásával is kibővítjük.

1. Vissza és szerkessze az Első munkasor folyamatát.

2. Adjon hozzá egy új műveletet közvetlenül a JSON-elemzés művelet után, és keressen rá az Asztali folyamatok összekötőjére és az Asztali Power Automate folyamatra építettfolyamat futtatására.

3. Az asztali folyamat legördülő menüjében válasszon ki és szerkesszen egy meglévő asztali folyamatot, vagy válassza a + Új asztali folyamat létrehozása lehetőséget, és kövesse a képernyőn megjelenő utasításokat az asztali folyamat létrehozásához és az asztali indításhoz Power Automate . Ha még nem ismeri az asztali folyamatokat, itt talál további információt.

4. Az asztali tervező megnyitása után Power Automate hozzon létre két bemeneti változót WorkQueueItemValue és WorkQueueItemNamenéven , majd adjon hozzá két kimeneti változót ProcessingNotes és ProcessingStatus néven , amelyek mindegyikének Text adattípusúnak kell lennie .

5. Adja meg a WorkQueueItem változó alapértelmezett értékét, hogy később helyileg tesztelhesse a szkriptet. Ha követte a tömeges importálási oktatóanyagot , akkor a szállítói számla várólistában olyan munkasor-elemeknek kell lenniük, amelyek értékei JSON formátumban vannak. Íme egy példa az egyik használt értékre.

   {
    "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. Most,Mentse el az áramlást.

7. A műveletpanelen nyissa meg a Változók műveletcsoportot, és kattintson duplán a JSON konvertálása egyéni objektummá műveletre, hogy hozzáadja a tervezési vászonhoz, amely megnyitja a tulajdonságablakot.

8. Válassza ki a változó ikont a JSON mezőben, majd válassza a WorkQueueItemValue változót .

9. Nevezze át az előállított kimeneti változót JsonAsCustomObject értékről VendorInvoice értékre , és válassza a Mentés lehetőséget .

10. Ezután adjon hozzá egy If műveletet a Feltételes csoportból, és konfigurálja a tulajdonságait az alábbiak szerint:

    First operand	Operator	Second operand
    %Szállítói számla['Összeg']%	Kevesebb, mint (<)	5000

11. Válassza a Mentés parancsot.

12. Adjon hozzá egy másik műveletet a Feltételes csoportokból Else néven , és adja hozzá az If és a End művelet közé.

13. Most adjon hozzá további két műveletet a Változók csoportból Változó beállítása néven , és adja hozzá őket az If és Elseműveletekhez, és állítsa be a ProcessingNotes és a ProcessingStatus változókat a következő értékekre:

    Változó	Érték
    %ProcessingNotes%	A számla feldolgozása megtörtént
    %ProcessingStatus%	Feldolgozva

14. Másolja ki a két Változó beállítása műveletet, illessze be őket az Else és az End művelet közé, és módosítsa az értékeiket a következőknek megfelelően:

    Változó	Érték
    %ProcessingNotes%	Üzleti kivétel: A számla összege nagyobb, mint $5000, ami vezetői jóváhagyást igényel.
    %ProcessingStatus%	Kivétel

15. A folyamatnak most ehhez hasonlóan kell kinéznie.

    

16. Mentse a folyamatot, és futtassa annak ellenőrzéséhez, hogy a folyamatlogika a várt módon működik-e.

17. Vissza az Első munkasor folyamatának szerkesztéséhez.

18. Válassza ki az újonnan létrehozott (vagy szerkesztett) asztali folyamatot a listából, majd válassza a Attended lehetőséget futtatási módként.

19. Töltse ki a Munkasor elemének értéke és a Munkasor elemneve paramétereket az alábbi módon:

    

20. Adjon hozzá egy Feltétel műveletet a Sor frissítése művelet előtt.

21. Vigye az egeret az Érték kiválasztása mezőbe, és válassza a Feldolgozási állapot lehetőséget a dinamikus tartalomlista párbeszédpanelen.

22. Vigye az egeret a másik Érték kiválasztása mezőbe, és írja be a Feldolgozott szöveges értéket.

23. Húzza át a Sor frissítése műveletet a feltétel művelet Ha igen szakaszába.

24. Nyissa meg a Sor frissítése művelet részleteit, és cserélje le az értékeket a következőkre:

    

25. A piros Ha nem mezőben adjon hozzá egy másik Sor frissítése műveletet, és válassza a Munkasor elemei lehetőséget a Tábla neveként .

26. Ezután válassza a workqueueitemid lehetőséget sorazonosítóként , és nyissa meg a Speciális beállítások megjelenítése szakaszt, válassza a Feldolgozási jegyzetek lehetőséget a Feldolgozási eredmények értékként.

27. Válassza a Hiba lehetőséget állapotként és GenericException az Állapot oka mezőben.

    

28. Válassza a Mentés és teszteléslehetőséget a teljes automatizálás teszteléséhez és az asztali folyamat művelet kimenetének megfigyeléséhez.

    

29. A munkasor elem feldolgozásának ellenőrzéséhez lépjen a munkasor részletei oldalra, válassza az Összes megtekintése lehetőséget a munkasor elemei szakaszban, és szűrje az elemeket a Feldolgozott állapot szerint .

    

Szép munka, most fejezte be a fejlettebb forgatókönyvet, amely hibrid munkasor-feldolgozást tartalmazott!

További lépések

További tudnivalók

• Munkasor áttekintése
• Munkavárólisták kezelése
• Munkasor adatainak tömeges importálása
• Munkasorok aktiválása
• Ismert problémák és korlátozások