Обработка на работни опашки

Обработката на работната опашка се отнася до управлението на списък с работни елементи, които трябва да бъдат завършени в определен ред. Този списък съдържа информация за всеки елемент, като например неговото име, приоритет, дата на изтичане, състояние и действителната стойност, която трябва да бъде обработена.

Начини за обработка на работни опашки:

Научете повече за Dataverse инструментите за професионален код: Dataverse документация за разработчици.

Инструкции за обработка

За да покажете някои от наличните опции за обработка, ето три различни сценария за обработка.

Обработка на работната опашка, базирана на работен поток на Power Automate работния плот (PAD)

Обработка на елементи от работната опашка и примери за актуализиране

Първата стъпка към използването на действия на работната опашка на Power Automate работния плот е да създадете работна опашка в средата, в която работите, и да заредите някои елементи на опашката с данни, които да се консумират надолу по веригата. Елементите на опашката могат да бъдат заредени в работна опашка чрез поток на работния плот, поток в облака или групово, както е описано тук, което попълва елементите на опашката. В този пример някои елементи на опашката са добавени ръчно в работна опашка, за да обяснят как могат да се използват действията в Power Automate работния плот.

Елементите на работната опашка са създадени и полето за стойност включва текст във формат JSON, който ще се използва надолу по веригата в потока на работния плот.

Примерният поток, който ще използваме, за да демонстрираме използването на действие на работната опашка, имитира процес, който ще използва елемент от работната опашка от облака, ще обработи данните, включени в полето за стойност, и ще ги преобразува в персонализиран обект, който да бъде обработен надолу по веригата. Имайте предвид, че не е задължително да използвате JSON или персонализирани обекти като стойности за елементите на вашата работна опашка, но може да бъде полезен метод за организиране на стойности, които имат множество свойства и следват конкретна схема.

1. Действието Обработка на елементи на работната опашка се използва за определяне на коя работна опашка да се консумират и обработват елементи във вашия поток на работния плот. Действието може да бъде конфигурирано да избира работна опашка от списък с помощта на стрелката на падащото меню, да предаде променлива, включваща името на опашката. Когато се изпълнява, това действие работи, като въвежда първия (най-старият) елемент от работната опашка във вашия поток, който съдържа състояние на опашка. След като елементът от опашката започне да се обработва във вашия поток, състоянието му автоматично се променя на обработка.

1. Точка на прекъсване (червена точка) беше зададена чрез щракване до действие 3 в потока и след това преминаване през PAD конзолата. Когато процесът спре в точката на прекъсване, променливата WorkQueueItem може да се отвори чрез двукратно щракване върху попълнената стойност под Променливи на потока и това показва всички свойства, свързани с елемента на работната опашка, който се обработва.

1. В действие 2 на потока преобразувах върнатата JSON стойност, която в този случай е достъпна чрез %WorkQueueItem.Value% в персонализиран обект. Причината за това е, че помага за анализиране на JSON и използване на свойствата на JSON надолу по веригата във вашия поток. В този хипотетичен случай информацията ще бъде използвана за въвеждане на записи във финансовия портал на 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"
   }
   

   

   Например, да кажем, че е имало изискване за въвеждане на идентификатора на фактурата в поле на финансова система като част от процес, при който автоматизирате потребителския интерфейс на уеб или настолно приложение – можете да извикате тази стойност, като използвате %JsonAsCustomObject.InvoiceId% за попълване на текстово поле и натискане на бутон.

2. Този пример съдържа някои условни конструкции, след като завърши обработката на стъпките и използва данните от персонализирания обект в подпотока Fabrikam Data Entry. Ако процесът се изпълнява от край до край, без да срещне изключения, свързани със системата за въвеждане, действието Актуализиране на елемента на работната опашка се използва за промяна на състоянието на елемента на работната опашка на Обработен , а полето за резултат от обработката може да се използва за въвеждане на някои незадължителни бележки. Ако полето за изтичане е оставено празно, новият елемент на опашката запазва стойността Елементите изтичат след стойност, дефинирана в свойствата на работната опашка.

   Бележка

   Ако елементите на работната опашка са блокирани в състояние на обработка, тъй като потокът на работния плот не успява да завърши, използвайте облачен поток, за да извлечете и актуализирате елементите на работната опашка.

   

   Опциите за обработка на изключения могат да бъдат конфигурирани чрез щракване върху грешка в прозореца за конфигуриране на действие на елемента на работната опашка за актуализиране. Налични са три опции за персонализиране в раздела за разширени. Елементът на работната опашка не е намерен , може да възникне, ако елементът на работната опашка бъде премахнат от опашката, ръчно или чрез друг систематичен процес, преди да завърши обработката в PAD. Елементът на работната опашка на изчакване може да възникне, ако автоматизиран процес или някой промени състоянието на елемента на работната опашка, който се обработва, на задържане в портала на потока, докато елементът на опашката се обработва. Неуспешно актуализиране на елемента на работната опашка може да възникне, ако елементът на опашката вече не съществува в опашката или е поставен в състояние на задържане. Всичко по-горе са крайни случаи, които могат да възникнат - научете повече за обработката на грешки в потоци на работния плот тук.

   

3. Ако по време на обработката на данните на елемента на работната опашка в системата за въвеждане на данни е определен някакъв проблем, елементът може да получи статус на общо изключение, ИТ изключение или бизнес изключение. Тези състояния на изключения са налични за използване, когато или ако вашият автоматизиран случай на използване отговаря на критериите, които може да се прилагат.

   

   Да кажем, че при обработката на елемент от опашката е изпълнен сценарий 2. В този случай елементът на опашката е маркиран като общо изключение в изходната опашка. В зависимост от сценария може да решите да промените състоянието на елементите на опашката, които не могат да бъдат обработени успешно като една от алтернативните опции за състояние. Оттам можете да решите дали е необходима човешка намеса или да изградите последващ процес с логиката, необходима за управление на всяко състояние на изключение.

   

Шаблон за автоматично повторяване

Действието Обработка на елементи от работната опашка в Power Automate работния плот включва разширена опция за конфигуриране или заместване на механизъм за автоматично повторение. Тази функция ви позволява да зададете максималния брой автоматични повторения на елемент от работната опашка, което е полезно за обработка на ИТ изключения като преходни мрежови грешки или временна недостъпност на системата. Той позволява на машината да запази артикула и да извършва контролирани повторни опити, без да го реди, осигурявайки по-ефективна и устойчива обработка на работната опашка.

Можете да зададете и централно да контролирате максималния брой повторения опит в записа Dataverse на работната опашка. Тази стойност по подразбиране се прилага за всички потоци на работния плот, които обработват тази работна опашка чрез действието Елементи на работната опашка за обработка.

За да заместите настройката по подразбиране на ниво опашка във вашия поток, отидете до секцията Разширени на действието Обработка на елементи на работната опашка и превключете опцията за автоматично повторно конфигуриране на работната опашка. Тази настройка ви позволява да регулирате максималния брой повторения опит на по-висока или по-ниска стойност или дори да деактивирате механизма за повторни опити, като зададете максималния брой повторни опити на 0.

Когато използвате действието Актуализиране на елемента на работната опашка със състояние, зададено на IT exception и максимален брой автоматични повторения, по-голям от 0, системата не изпраща веднага актуализацията до оркестратора на работната опашка. Вместо това той опитва операцията отново, докато достигне зададения максимален брой повторни опити. Единствената стойност, актуализирана в елемента на работната опашка, е. retrycount Тази стойност се увеличава от втория опит за актуализиране нататък до достигане на максималния брой автоматични повторения. Освен това променлива на елемента на локалната работна опашка, наречена CurrentRetryCount стъпки с всеки повторен опит. Тази променлива ви позволява да внедрите персонализирана логика въз основа на нейната стойност, ако е необходимо.

Потокът няма да поиска нов елемент, когато се върне обратно в горната част на действието Обработка на елементи на работната опашка, ако са изпълнени следните условия:

• Максималният брой повторни опити не е достигнат.
• Не се извършват други актуализации, освен ИТ изключения.

Когато се достигне максималният брой повторни опити, действието за актуализиране изпраща актуализацията до оркестратора, променяйки състоянието на елемента на ИТ изключение и включвайки всички предоставени бележки за обработка.

Добавяне и повторно оформяне на примери за елементи от работната опашка от PAD

Елементът Добавяне на работна опашка позволява на потребителите на работния поток да попълват елементите на работната опашка в работна опашка, която е настроена в портала на потока. Създаването на пакетни елементи се поддържа с помощта на действието Добавяне на елементи от работната опашка.

В този пример Excel файл в .csv се пуска в директория ежедневно и всеки ред трябва да бъде добавен към работна опашка.

Първите няколко действия в този примерен процес картографират папка, в която се пуска ежедневният файл Contoso Invoices.csv - когато процесът се изпълни, той започва с четене на таблицата с данни от CSV файла. Променливата CSVTable съдържа данните, които са импортирани и ще бъдат обработени в нови елементи на опашката.

Действия 3 и 4 генерират времето, в което избираме новите елементи на опашката, които да изтекат, след като бъдат добавени в работна опашка. Действие 3 улавя текущите системни данни и време, след което за този пример към него се добавят 7 дни с помощта на %Добавяне към дата-час% действие. Изходът се съхранява в променлива, наречена ExpiryDatetime , която ще се използва в действието Добавяне на елемент от работната опашка.

Действие 5 въвежда цикъла За всеки цикъл, който се използва за обхождане на всеки ред данни в импортирания CSVTable - това действие изобразява ред с данни за текущия елемент, който се обработва.

Всички предишни действия в този примерен поток на работния плот вече са включени в задаването на стойностите за действието Добавяне на елемент от работната опашка.

Параметърът на работната опашка е зададен на опашката, в която искаме да добавим нови елементи от работната опашка - в този случай Demo PAD опашката е избрана, като я изберем от падащото меню.

Параметърът Priority е оставен по подразбиране, Normal, но опциите за Low и High също не са задължителни. Елементите на работната опашка с по-висок приоритет се обработват първо, след това нормално и последно, когато се смесват в една и съща работна опашка.

Параметърът Name е зададен със статичен префикс заедно със стойността на променливата CurrentItem['ID'] - която съдържа стойността от клетката ID на обработвания ред с данни. Това не е задължително, но може да бъде полезно в зависимост от вашия случай на употреба.

Използвайки стойностите от реда с данни в променливата CurrentItem , параметърът Input е въведен във формат JSON. Забележка: всяко име на заглавката е добавено към променливата currentitem с помощта на нотацията ['име на заглавката']

Полето Изтича се попълва с променливата datetime, към която добавихме 7 дни в предишните стъпки. Когато се остави празен, елементът на работната опашка, който се добавя, ще съдържа стойността Елементите изтичат след зададена за работната опашка.

Бележките за обработка не са задължителни - използвайте се според необходимостта.

Когато процесът се изпълнява, всеки ред с данни в импортирания CSV файл създава елемент от работната опашка, съдържащ състояние Опашка , което означава, че е наличен за обработка.

Това са само някои от многото начини, по които действията на работната опашка могат да се използват в PAD. Отделете малко време, за да проучите и намерите креативни приложения, за да включите работните опашки във вашите Power Automate потоци!

Пример за повторно подреждане на елемент със закъснение

Елементът за повторно опашване с действие за забавяне позволява на потребителите на потока на работния плот да поставят отново елементите в опашката и да задават период на забавяне, в който елементът може да бъде освободен отново за обработка.

В този пример има работна опашка, заредена с елементи, които са настроени да изтекат след 24 часа, но не могат да бъдат обработени навреме, тъй като има текуща рутинна поддръжка на системата, която се извършва от ИТ и елементите трябва да бъдат поставени отново в опашка. Поддръжката ще приключи през нощта, така че ще продължим да отлагаме всеки елемент от опашката с 24 часа и след това ще ги настроим да изтекат 24 часа след периода на пускане.

Първите три действия от този примерен процес са действия за дата и час. Действието "Получаване на текущата дата и час" улавя системната дата и час в момента на изпълнение на действието. След това използвахме действието "Добавяне към дата и час", за да покрием две изисквания, първо трябва да определим времето на забавяне, като добавим 24 часа към текущата дата и час - след това трябва да добавим 48 часа към текущата дата и час като изтичане.

След това в примера действието "Обработка на елементите на работната опашка" е конфигурирано да сочи към заредената работна опашка, а "Повторно опашване на елемента със закъснение" се поставя в цикъла.

Стойностите, генерирани за закъснението и изтичането, вече могат да бъдат предадени в действието "Повторна опашка на елемента със закъснение". Полето "елемент на работната опашка" се попълва от променливата, създадена от цикъла - това инструктира кой елемент от опашката да се опашва отново. След това включихме стойностите, създадени с помощта на действията за дата и час за полетата "забавяне до" и "изтичане". "Отлагане до" е задължително, но можете да използвате "изтича" и "резултат от обработката" по ваша преценка.

С този прост процес можете да поставите отново на опашка всички налични елементи в опашка, да ги забавите за определено време, с опции за задаване на дата на изтичане и резултат от обработката.

Облачен поток и обработка, базирана на конектори

Най-простият начин да извадите от опашка елемент от работната опашка и да го обработите е следният:

1. Отидете и Power Automate влезте с идентификационните си данни.

2. В менюто вляво изберете Моите потоци.

3. В лентата с инструменти изберете + Нов поток и след това изберете Незабавен облачен поток.

4. Предоставете име на поток, като напримерМоят първи поток на работната опашка, и след това изберетеРъчно задействане на поток .

5. Изберете Създаване.

6. След като се отвори дизайнерът на потока, изберете + Нова стъпка и след това изберете конектора Microsoft Dataverse .

7. В списъка с действия изберете Извършване на обвързано действие.

1. Вашият поток трябва да изглежда подобно на този сега.

1. Изберете Записване и след това Тестване на потока.

2. В страничния панел за тестване изберете Ръчно, Тест, Изпълнение на потоки след това Готово.

3. Ако потокът е работил успешно, трябва да получите подобен резултат (но с различни идентификатори).

1. След това копирайте цялото JSON съдържание от полето на тялото и след това изберете Редактиране в горния десен ъгъл на потока.

1. Добавете нова стъпка, като изберете + Нова стъпка и потърсете действие, наречено Анализиране на JSON и го изберете.

1. Позиционирайте мишката в полето Съдържание и изберете свойството тяло от предишното действие.

1. След това изберете Генериране от примера и поставете предварително копирания JSON низ в диалоговия прозорец и изберете Готово.

2. Изберете + Нова стъпка и след това изберете конектора Microsoft Dataverse .

3. От списъка с действия изберете Актуализиране на ред.

4. В полето Име на таблица изберете таблицата Елементи от работна опашка и позиционирайте курсора в полето ID на ред .

5. В списъка Динамично съдържание вече ще имате всички полета, които са налични в таблицата с елементи на работната опашка.

6. Изберете Показване на разширени опции и след това задайте ID на ред, Резултат от обработка, Състояниеи Състояние Reason полета със следните стойности.

1. Изберете Запазване и Тест потока още веднъж.

2. Ако потокът се изпълни успешно, трябва да получите подобен резултат като следния.

   

3. Сега отворете страницата с подробности за работната опашка и в секцията със списък с елементи на работната опашка изберете Виж всички.

4. Филтрирайте полето Състояние , за да показвате само Обработване и Обработени елементи, за да потвърдите, че нашите действия за изваждане от опашка и актуализиране са работили според очакванията.

   

   

   

   Поздравления, току-що завършихте първия си сценарий за обработка на работна опашка!

Обработка, базирана на облачен поток, с поддръжка на десктоп поток

За този сценарий разширяваме предишния, като добавяме и стъпка за обработка на потока на работния плот.

1. Върнете се и редактирайте потока Моята първа работна опашка.

2. Добавете ново действие директно след действието Parse JSON и потърсете Desktop flows конектор и Run a flow created with Power Automate for desktop.

3. В падащото меню на потока на работния плот или изберете и редактирайте съществуващ поток на работния плот, или изберете + Създайте нов поток на работния плот и следвайте инструкциите на екрана, за да създадете потока на работния плот и стартирайте Power Automate за работния плот. Ако не сте запознати с потоците на работния плот, можете да научите повече тук.

4. След като се отвори дизайнерът Power Automate за настолен компютър, създайте две входни променливи, наречени WorkQueueItemValue и WorkQueueItemName и след това добавете две изходни променливи, наречени ProcessingNotes и ProcessingStatus съответно, всички от които трябва да имат Text като тип данни.

5. Осигурете стойност по подразбиране за променливата WorkQueueItem , така че по-късно да можете да тествате скрипта локално. В случай, че сте следвали урока за групово импортиране трябва да имате елементи от работната опашка в опашката Vendor invoice, които имат своите стойности във формат JSON. Ето пример за една от използваните стойности.

   {
    "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. Сега, Спасете потока.

7. В панела за действия отворете групата действия Променливи и щракнете двукратно върху действието Конвертиране на JSON към потребителски обект , за да го добавите към платното за дизайн, което отваря прозореца на свойствата му.

8. Изберете иконата на променливата в полето JSON и изберете променливата WorkQueueItemValue .

9. Преименувайте произведената изходна променлива от JsonAsCustomObject на VendorInvoice и изберете Save.

10. След това добавете действие If от групата Conditionals и конфигурирайте свойствата му, както следва:

    Първи операнд	Оператор	Втори операнд
    %VendorInvoice['Amount']%	По-малко от (<)	5000

11. Изберете Запиши.

12. Добавете друго действие от групата Условни наречено Else и го добавете между действието If и End .

13. Сега добавете още две действия от групата Променливи наречена Задаване на променлива и ги добавете в действията Ако и Друго и задайте променливите ProcessingNotes и ProcessingStatus на следните стойности:

    Променлива	Стойност
    %ProcessingNotes%	Фактурата е обработена
    %ProcessingStatus%	Обработени

14. Копирайте двете действия Set variable и ги поставете между действието Else и End и променете стойностите им, за да съответстват на тези:

    Променлива	Стойност
    %ProcessingNotes%	Бизнес изключение: Сумата на фактурата е по-голяма от $5000, което изисква одобрение от мениджъра.
    %ProcessingStatus%	Изключение

15. Вашият поток трябва да изглежда подобно на този сега.

    

16. Запазете потока и го стартирайте, за да потвърдите, че логиката на потока работи според очакванията.

17. Върнете се, за да редактирате потока на първата ми работна опашка.

18. Изберете новосъздадения (или редактиран) поток на работния плот от списъка и след това изберете Attended като негов Run Mode.

19. Попълнете параметрите Стойност на елемент от работна опашка и Име на елемент от работна опашка както е показано тук:

    

20. Добавете действие Условие преди действието Актуализиране на ред .

21. Позиционирайте мишката си в полето Изберете стойност и изберете Статус на обработка от диалоговия прозорец на списъка с динамично съдържание.

22. Позиционирайте мишката си в другото поле Choose a value и въведете Processed като текстова стойност.

23. Плъзнете и пуснете действието Актуализиране на ред в секцията Ако да на действието за условие.

24. Отворете подробностите за действието Актуализиране на ред и заменете стойностите, за да съответстват на следното:

    

25. В червеното Ако не кутия, добавете друго Актуализиране на ред действие и изберете Елементи от работна опашка като Име на таблица.

26. След това изберете workqueueitemid като ИД на ред и отворете Показване на разширени опции секция изберете Бележки за обработка като стойността Обработване на резултати .

27. Изберете Грешка като Състояние и GenericException за Причина за състояние.

    

28. Изберете Запазване и Тест за да тествате цялостната автоматизация и да наблюдавате резултата от действието на потока на работния плот.

    

29. За да потвърдите, че елементът от работната опашка е обработен, можете да отидете на страницата с подробности за работната опашка, да изберете Виж всички в секцията с елементи от работната опашка и да филтрирате елементите по Обработен статус.

    

Браво, току-що завършихте по-напреднал сценарий, който включваше хибридна обработка на работна опашка!

Следващи стъпки

Научете повече

• Общ преглед на работната опашка
• Управление на работни опашки
• Групово импортиране на данни от работната опашка
• Задействане на работни опашки
• Известни проблеми и ограничения