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

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

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

• Що робить ця дія?

• За яких умов повинна виконуватися дія?

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

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

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

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

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

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

Важливо

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

Примітка

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

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

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

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

• Категорія

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

• Сутність

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

• Тип

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

Редагування дії

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

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

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

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

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

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

• Унікальна назва

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

  Важливо

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

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

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

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

  Примітка

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

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

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

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

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

• Додати етапи, умови та дії

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

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

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

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

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

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

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

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

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

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

Примітка

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

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

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

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

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

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

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

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

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

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

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

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

Примітка

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

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