Обновить строковые подстановки сформированного документа
Робот «Обновить строковые подстановки сформированного документа». Меняет выбранные подстановки после проверки ожидаемых значений и сохраняет остальные данные документа.
Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.
Для кого и какую проблему решает
Для координатора, который исправляет конкретные строковые подстановки сформированного документа. Позволяет внести согласованную правку без намеренной замены остальных данных и заметить устаревшее ожидание.
Что подготовить
Установите действие в каталоге приложения «CRM роботы 2.0 + AI», затем добавьте его в нужную точку автоматизации. Для чтения или изменения объектов нужен соответствующий доступ пользователя подключения. Идентификаторы берите из полей карточки или результатов предыдущих шагов: название объекта не заменяет его числовой ID.
Параметры и значения
| Поле в настройке | Тип | Обязательность и исходное значение |
|---|---|---|
| ID документа | Целое число | Обязательное; значение по умолчанию не задано |
| Новые строковые подстановки JSON | Текст | Обязательное; значение по умолчанию не задано |
| Ожидаемые текущие значения JSON | Текст | Обязательное; значение по умолчанию не задано |
| Ожидаемое время изменения с часовым поясом | Строка | Обязательное; значение по умолчанию не задано |
Поля, обозначенные JSON, заполняйте корректными массивами или объектами с двойными кавычками в строках. Подставляйте одно значение через штатный выбор данных редактора; не копируйте служебный идентификатор шага из другого шаблона.
Как использовать пошагово
- Укажите ID документа и его ожидаемое время изменения с часовым поясом.
- Передайте от 1 до 50 новых строковых подстановок объектом JSON по реальным именам полей.
- В ожидании укажите текущие значения точно тех же полей.
- Например, для предусмотренного поля номера задайте новые
{"DocumentNumber":"УЧ-16"}и ожидаемые{"DocumentNumber":"УЧ-15"}. - После выполнения проверьте число изменённых полей и признак изменения; при неподтверждённом итоге сверяйте документ до следующей правки.
Учебный пример и ожидаемый результат
Документ 500 содержит строковый номер «УЧ-15». Переданы согласованная замена на «УЧ-16» и актуальное время изменения. При совпадении ожиданий робот проверяет сохранённое и отображаемое значение после записи. Все номера объектов в примере условные; замените их данными своего портала. Пример объясняет настройку, а не подтверждает выполненный запуск.
Какие результаты передать дальше
- ID документа: целое число.
- Подстановки изменены: да/нет (Y/N).
- Изменено полей: целое число.
В следующем действии откройте выбор данных и выберите результат этого робота по названию. Сначала проверьте статус выполнения; при ошибке передайте её пояснение на разбор и не используйте пустые значения как подтверждённый результат. Успех шага и положительный ответ на бизнес-проверку: разные условия.
Ограничения и исправление ошибок
Строки до 10 000 символов, пустая строка допустима. Служебные флаги печатей и QR-кода не меняются. Нужны полный доступный словарь прежних подстановок и состояние печатей. Файл не разбирается, внешние изменения не блокируются.
Если доступ изменился, сначала проверьте объект под пользователем подключения и актуальность ID. Повторяйте действие после устранения причины. Для действий с записью предварительно сверяйте фактическое состояние: сообщение об ошибке само по себе не доказывает, что ни одна правка не сохранилась.
Как заполнять JSON-поля
Каждый блок ниже вставляется целиком в своё поле. Не добавляйте внешние кавычки вокруг всего массива или объекта. Учебные ID и названия замените фактическими данными.
Новые строковые подстановки JSON
{
"DocumentNumber": "УЧ-16"
}
Объект от 1 до 50 новых строковых подстановок. Ключом служит реальное имя поля, значением строка до 10 000 символов; пустая строка допустима как явная подстановка. Имя DocumentNumber условно применимо только при наличии в вашем документе. Пустой объект {} не задаёт правку, [] неверен. Служебные флаги печатей и QR-кода в этот объект не включайте.
Ожидаемые текущие значения JSON
{
"DocumentNumber": "УЧ-15"
}
Объект прежних значений точно тех же полей, что переданы в новых подстановках. Берите значения из актуального чтения документа; сохраняйте тип и точный текст. В примере меняется номер УЧ-15 на УЧ-16. Пустой {} не соответствует непустой правке, [] неверен. Отдельно обязательно передайте ожидаемое время изменения документа с поясом.