Створення настроюваної дії процесу

Використовуйте настроювані дії процесів, коли потрібно автоматизувати послідовність команд у системі. Настроювані дії процесів можуть розширити словник, доступний розробникам для вираження бізнес-процесів. Настроювані дії процесів використовують основні дієслова, що надаються системою, такі як «Створити», «Оновити», «Видалити» або «Призначити», для створення більш виразних дієслів, таких як «Затвердити», «Підвищити», «Спрямувати» або «Запланувати». Якщо визначення бізнес-процесу змінюється, особа, яка не є розробником, може відредагувати настроювану дію процесу, і код не потрібно буде міняти.

Примітка

Якщо ви маєте намір написати плагін для реалізації вашої логіки для користувацької дії процесу замість використання конструктора робочих процесів, вам слід використовувати користувацький API. Додаткові відомості: Порівняйте дію користувацького процесу та користувацький API

Створення настроюваної дії процесу

Важливо

Якщо ви створюєте настроювану дію процесу як частину рішення для подальшого розповсюдження, створюйте її в контексті цього рішення. Перейдіть до меню Параметри > Рішення і знайдіть некероване рішення, частиною якого буде ця дія. Потім, у рядку меню виберіть Новий > Процес. Це дасть змогу переконатися, що префікс настроювання, пов’язаний з назвою дії, відповідатиме іншим компонентам у рішенні. Після того як дію створено, змінити префікс неможливо.

Так само як процеси робочого циклу, настроювані дії процесів мають перелічені нижче властивості в діалоговому вікні Створити процес.

• Ім’я процесу

  Після введення імені для процесу унікальне ім’я буде створено для нього шляхом видалення будь-яких пробілів або спеціальних символів з імені процесу.

• Категорія

  Дана властивість визначає, що це процес дій. Після збереження процесу внести зміни буде неможливо.

• Таблиця

  За допомогою процесів дій можна вибрати таблицю, яка забезпечуватиме робочий цикл контекстом так само, як інші види процесів. Але можна вибрати й пункт Жодних (глобальних). Виберіть цю можливість, якщо ваші дії не потребують контексту конкретної таблиці. Після збереження процесу внести зміни буде неможливо.

• Тип

  Використовуйте цю властивість для вибору, чи слід створити нову настроювану дію процесу з нуля, чи почати з наявного шаблону.

Коли про процеси робочого циклу не йдеться, не потрібно встановлювати такі параметри:

• Час запуску: дії починаються, коли код викликає згенероване для них повідомлення.

• Область застосування: дії завжди запускаються в контексті користувача, що здійснює виклик.

• Запустити у фоновому режимі: дії завжди є робочими циклами в режимі реального часу.

Настроювані дії процесів також передбачають те, чого немає у процесах робочого циклу, — аргументи вводу та виводу.

Примітка

Ви можете включити настроювану дію процесу в робочому циклі без написання коду. Додаткові відомості: Виклик настроюваних дій процесів із робочого циклу

Редагування настроюваної дії процесу

Перш ніж редагувати настроювані дії процесів, відключіть їх.

Ви можете редагувати настроювану дію процесу, створену як частину некерованого рішення або включену до рішення, інстальованого у вашій організації. Якщо рішення кероване, редагувати його не можна. Видавець рішення має можливість редагувати керовані властивості, тому дію, встановлену за допомогою керованого рішення, редагувати не можна.

Коли дію збережено, унікальне ім'я створюється на основі імені процесу. Це унікальне ім'я має префікс настроювання, доданий видавцем рішення. Це ім'я повідомлення розробник використовуватиме у своєму коді.

При редагуванні дії вам доступні зазначені нижче параметри.

• Ім’я процесу

  Після того як процес створено й унікальне ім'я згенеровано з імені процесу, останнє можна редагувати. За бажанням ви можете застосувати правило іменування для полегшення пошуку конкретних процесів.

• Унікальне ім’я

  Коли дію збережено, унікальне ім'я створюється на основі імені процесу. Це унікальне ім'я має префікс настроювання, доданий видавцем рішення. Це ім'я повідомлення розробник використовуватиме у своєму коді. Не змінюйте унікальне ім'я, якщо процес був активований і код перебуває у стані очікування на дії, що використовують це ім'я.

  Важливо

  Після того як дію активовано і код для унікального ім'я написано, це ім'я не можна буде змінювати без змінення коду, на який воно посилається.

• Увімкнути відкочування

  Зазвичай процеси, що підтримують транзакцію, – це «скасувати» (або відкотити) всю операцію, якщо не вдалося виконати якусь її частину. Є кілька винятків. Можливо, деякі дії, що виконуються розробниками у коді, запущеному настроюваною дією процесу, не підтримуватимуть транзакцій. Наприклад, якщо код виконання дій міститься в інших системах, поза межами області застосування транзакції. Дії, що не підпадають під відкочування, запускаються у програмі. Деякі повідомлення у платформі не підтримують транзакції. Але дії, виконані за допомогою інтерфейсу користувача, підтримуватимуть транзакції. Усі дії, які є частинами робочого циклу в режимі реального часу, передбачають можливість транзакції. Проте певні дії дають змогу відмовитися від неї.

  З питання, чи потрібна транзакція, порадьтеся з розробником, який використовуватиме це повідомлення. Загалом дія повинна передбачати транзакцію у випадку, якщо дії для бізнес-процесу не мають сенсу, доки всі з них не буде успішно завершено. Класичним прикладом є переказ коштів між двома банківськими рахунками. Знявши кошти з одного рахунку, ви маєте переказати їх на інший. Якщо якась з двох операцій відбулася невдало, обидві вони є невиконаними.

  Примітка

  Неможливо увімкнути відкочування, якщо настроювану дію процесу запускати безпосередньо з робочого циклу. Ви можете включити відкочування, якщо дія спрацьовує на повідомлення веб-служби Power Apps.

• Активувати як

  Як і всі процеси, даний процес можна активувати як шаблон і використовувати його як розширений зразок для процесів, що відбуваються за тим самим принципом.

• Визначити аргументи процесу

  У цій області зазначено будь-які дані, заплановані для початку дії, а також дані, які залишаться після її виконання. Додаткові відомості: Визначення аргументів процесу

• Додати стадії та кроки

  Щодо інших процесів потрібно зазначити, які дії слід виконувати і коли. Додаткові відомості: Додавання етапів і кроків

Визначити аргументи процесу

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

Коли повідомлення завершено, розробнику може знадобитися передати дані, змінені або створені за допомогою повідомлення, до іншої операції у своєму коді. Ці дані є вихідним аргументом.

І вхідний, і вихідний аргументи повинні мати ім'я, тип і містити деяку інформацію про те, чи завжди потрібні такі аргументи. Ви також можете надати опис.

Ім'я повідомлення та інформація про всі аргументи процесу – це своєрідний підпис повідомлення. Після того, як настроювана дія процесу активована і використовується в коді, підпис неможливо змінити. У разі зміни підпису, будь-який код, що використовує повідомлення, буде помилковим. Єдиний виняток – змінення одного з параметрів, тож це не завжди є обов'язковим.

Ви можете змінити послідовність аргументів шляхом сортування або переміщення на початок чи в кінець переліку, оскільки визначальним для аргументів є ім'я, а не порядок. Крім того, зміна опису не зламає код, який використовує повідомлення.

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

У наведеній нижче таблиці описано типи аргументів для процесів дій.

Тип	Опис
Логічне значення	Значення true або false.
Дата та час	Значення, яке містить відомості про дату і час.
Десятковий	Числове значення з десятковою точністю. Його використовують, коли точність є надзвичайно важливою.
Таблиця	Рядок для вказаної таблиці. Якщо вибрати таблицю, активується розкривний список і можна буде вибрати тип таблиці.
entityCollection	Колекцію рядків таблиці.
entityReference	Об’єкт, який містить ім’я, ідентифікатор і тип запису рядка таблиці та однозначно його визначає. Якщо вибрати entityReference, активується розкривний список і можна буде вибрати тип таблиці.
Float	Числове значення з десятковою точністю. Це використовується, коли дані вимірювання не є абсолютно точними.
Цілий	Ціле число.
Гроші	Значення, яке зберігає дані про грошову суму.
Розкривний список	Значення, яке відповідає параметру для атрибуту OptionSet.
String	Текстове значення.

Примітка

Значення аргументу entityCollection не можна встановлювати в інтерфейсі користувача для умов або дій. Це використовують розробники в настроюваному коді. Додаткові відомості: Створення власних повідомлень

Додати стадії та кроки

Настроювані дії процесів є одним із видів процесу, дуже схожого на робочі цикли в режимі реального часу. Усі кроки робочих циклів у режимі реального часу можна застосувати до дій. Детальнішу інформацію про кроки, якими можна скористатись для робочих циклів та дій у режимі реального часу, див. у Стадії робочого циклу та кроки.

Окрім кроків, які можуть бути використані для робочих процесів у реальному часі, дій також мають крок Призначити значення. Щодо дій , то вони потрібні лише для того, щоб установити вихідні аргументи. Скориставшись помічником зі створення форм, можна встановити для вихідних аргументів конкретні значення або, більш ймовірно, значення з рядка, для якого виконується дія, рядків, пов'язаних із цим рядком зв’язком «багато до одного», рядків, створених на попередньому кроці, або значення, які є частиною самого процесу.

Керовані властивості

Настроювані дії процесу мають дві важливі керовані властивості

Настроюване значення

Керована властивість Настроюване значення визначає, чи може той, хто інсталює кероване рішення, що містить настроювану дію процесу, змінити або видалити її. Якщо потрібно, щоб настроювану дію процесу можна було редагувати або видалити у складі керованого рішення, слід вказати для цієї властивості значення true (істина).

Чи дозволено використовувати настроюваний крок обробки для інших видавців

Керована властивість Чи дозволено використовувати настроюваний крок обробки для інших видавців визначає, чи можуть сторонні розробники компонентів plug-in реєструвати кроки компонентів plug-in для повідомлень, створених у настроюваній дії процесу. Якщо це значення – true (істина), компоненти plug-in, зареєстровані будь-ким для цього повідомлення, запускатимуться та зможуть змінювати поведінку настроюваної дії процесу. Якщо значення – false (хибність), виконуватимуться тільки кроки компонентів plug-in, зареєстрованих у рішенні видавцем самого рішення.

Наступні кроки

Виклик настроюваних дій процесів з робочого циклу

Примітка

Розкажіть нам про свої уподобання щодо мови документації? Візьміть участь в короткому опитуванні. (зверніть увагу, що це опитування англійською мовою)

Проходження опитування займе близько семи хвилин. Персональні дані не збиратимуться (декларація про конфіденційність).