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

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

Нотатка

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

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

Важливо

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

Як і процеси робочого процесу, настроювані дії процесу мають такі властивості в діалоговому вікні «Створення процесу »:

• Назва процесу

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

• Категорія

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

• Стіл

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

• Тип

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

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

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

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

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

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

Нотатка

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

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

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

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

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

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

• Назва процесу

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

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

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

  Важливо

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

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

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

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

  Нотатка

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

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

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

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

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

• Додавання етапів та кроків

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

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

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

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

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

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

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

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

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

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

Нотатка

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

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

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

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

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

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

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

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

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

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

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

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