← К документации

Пользовательские действия

Пользовательское действие БП

Когда выносить PHP из шаблона и из каких частей состоит действие для коробки.

Одна операция с понятным результатом

Собственное действие полезно, когда одна и та же операция повторяется в нескольких шаблонах. Её входы настраиваются в дизайнере, код хранится в файлах, а выходы доступны следующим действиям процесса.

В этом разделе используется небольшой учебный пример NormalizeTextActivity: он убирает пробелы по краям строки. Он не ищет CRM-элементы, не обращается к сети и не выдаётся за отдельный проект внедрения.

Контракт примера

СвойствоНазначение
SourceTextВходная строка.
ResultTextСтрока после trim; пустая строка допустима.

Синхронное действие завершается в Execute со статусом Closed. Для ожидания внешнего ответа нужна другая модель: подписка, восстановление состояния и доставка события.

Три файла

.description.php описывает действие для конструктора, normalizetextactivity.php содержит класс, а properties_dialog.php — форму настроек. Имя каталога и основного файла совпадает в нижнем регистре.

Описание и класс · Методы формы

Этот файловый механизм предназначен для коробки. Облачное действие регистрируется через REST и выполняется приложением; загрузить этот PHP-класс в облако нельзя.

Источники