Споделяне чрез


Създаване на действие на персонализиран процес

Използвайте действия на персонализиран процес, когато искате да автоматизирате поредица от команди в системата. Действията на персонализиран процес разширяват речника, наличен за разработчиците, за изразяване на бизнес процеси. Действието на персонализиран процес използва основни глаголи като Създай, Актуализирай, Изтрий и Присвои за създаване на по-изразителни глаголи като Одобри, Ескалирай, Маршрутизирай и Планирай. Ако дефиницията на бизнес процес се промени, някой, който не е разработчик, може да редактира действието на персонализиран процес, така че да не е необходимо кодът да се променя.

Бележка

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

Създаване на действие на персонализиран процес

Важно

Ако създавате действие на персонализиран процес, което да бъде включено като част от решение за разпространение, създайте го в контекста на решението. Отидете на Настройки > Решения и намерете незавършеното решение, част от което ще бъде това действие. След това в лентата с менюта изберете Ново > Процес. Това гарантира, че префиксът за персонализиране, свързан с името на действието, ще бъде съгласуван с другите компоненти в решението. След като създадете действието, не можете да променяте префикса.

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

  • Наименование на процес

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

  • Категория

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

  • Таблица

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

  • Тип

    Използвайте това свойство, за да изберете дали да създадете ново действие на персонализиран процес от нулата, или да започнете от съществуващ шаблон.

За разлика от процесите на работен поток не е необходимо да задавате следните опции:

  • Стартирай, когато: Действията се стартират, когато код извика съобщението, генерирано за тях.

  • Обхват: Действията винаги се изпълняват в контекста на извикващия потребител.

  • Изпълни във фонов режим: Действията винаги са работни потоци в реално време.

Действията на персонализиран процес също така имат нещо, което процесите в работния поток нямат – входни и изходни аргументи.

Бележка

Можете да разрешите действие на персонализиран процес от работен поток, без да пишете код. Повече информация: Извикване на действия на персонализиран процес от работен поток

Редактиране на действие на персонализиран процес

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

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

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

При редактиране действие имате следните опции:

  • Наименование на процес

    След като процесът е създаден и уникалното име е генерирано от името на процеса, можете да редактирате името на процеса. Може да поискате да приложите именна конвенция, за да улесните намирането на конкретни процеси.

  • Еднозначно име

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

    Важно

    След като действието се активира и е написан код, използващ уникално име, уникалното име не трябва да се променя, без да се промени и кодът, който препраща към него.

  • Разреши връщането към стабилно състояние

    Като цяло процесите, които поддържат транзакции, ще „отменят“ (или върнат) цялата операция, ако някоя част от тях не е успешна. Има някои изключения от това. Някои действия разработчиците може да извършат в код, иницииран от действието на персонализиран процес, което може да не поддържа транзакции. Ако например кодът изпълнява действия в други системи, които са извън обхвата на транзакцията. Тези действия не могат да бъдат върнати от действието, изпълнявано в приложение. Някои съобщения в платформата не поддържат транзакции. Но всичко, което може да правите само с потребителския интерфейс на действието, ще поддържа транзакции. Всички действия, които са част от работен поток в реално време, се разглеждат в транзакция, но с действията имате възможност да се откажете от това.

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

    Бележка

    Не можете да разрешите възстановяването, ако дадено действие на персонализиран процес се извиква директно от работен поток. Можете да разрешите възстановяването, ако дадено действие се активира от съобщение на уеб услугите на Power Apps.

  • Активиране като

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

  • Дефиниране на аргументите на процеса

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

  • Добавяне на етапи и стъпки

    Подобно на други процеси, трябва да укажете какви действия да се изпълняват и кога да се изпълняват. Още информация: Добавяне на етапи и стъпки

Дефиниране на аргументите на процеса

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

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

Както входните, така и изходните аргументи трябва да имат име, тип и информация за това дали аргументът е винаги задължителен. Можете също да предоставите описание.

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

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

Типове аргументи на процес на действие

Таблицата по-долу описва типовете аргументи на процес на действие.

Тип Описание
Булев Стойност true или false.
ДатаЧас Стойност, която съхранява информация за дата и час.
По десетичен знак Числова стойност с десетична точност. Използва се, когато прецизността е изключително важна.
Таблица Ред за посочената таблица. Когато изберете таблица, падащият списък се активира и ви позволява да изберете типа таблица.
entityCollection Колекция от редове на таблица.
entityReference Обект, който съдържа името, ИД и типа на ред на таблица и го идентифицира еднозначно. Когато изберете entityReference, падащият списък се активира и ви позволява да изберете типа таблица.
Float Числова стойност с десетична точност. Използва се, когато данните идват от измерване, което не е напълно точно.
Цяло число Цяло число.
Пари Стойност, която съхранява данни за сума пари.
Списък по избор Стойност, която представлява опция за атрибут OptionSet.
String Текстова стойност.

Бележка

Стойностите на аргумента entityCollection не могат да бъдат задавани за условия или действия в потребителския интерфейс. Те са предвидени за използване от разработчиците в код по избор. Повече информация: Създаване на собствени съобщения

Добавяне на етапи и стъпки

Действията на персонализиран процес са тип процеси, много подобни на работните потоци в реално време. Всички стъпки, които могат да се използват в работни потоци в реално време, могат да се използват и в действията. За информация относно стъпките, които могат да се използват както за работни потоци в реално време, така и за действия, вижте Етапи и стъпки на работен поток.

В допълнение към стъпките, които могат да се използва за потоци в реално време, действията имат също и стъпката Присвояване на стойност. При действията те могат да се използват само за определяне на изходни аргументи. Можете да използвате помощника за формуляри, за да зададете определени стойности за изходните аргументи или, по-вероятно, стойности от реда, за който се изпълнява действието, редове, свързани с този ред чрез релация от тип „много към едно“, редове, създадени на предишна стъпка, или стойности, които са част от самия процес.

Контролирани свойства

Действията на персонализиран процес имат две приложими управлявани свойства

Е „С възможност за конфигуриране”

Управляваното свойство Е с възможност за персонализиране контролира дали някой, който инсталира завършено решение, съдържащо действието на персонализиран процес, може да го редактира или изтрие. Ако желаете действието на персонализиран процес да бъде редактирано или изтрито, когато е включено в завършено решение, трябва да зададете това свойство на „вярно”.

Разрешена ли е стъпка за персонализирана обработка за други издатели

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

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

Извикване на действия на персонализиран процес от работен поток

Бележка

Можете ли да ни споделите повече за езиковите си предпочитания за документацията? Попълнете кратко проучване. (имайте предвид, че това проучване е на английски език)

Проучването ще отнеме около седем минути. Не се събират лични данни (декларация за поверителност).