Выгрузить снимок выбранных полей CRM
Возвращает переносимый JSON для последующего сравнения состояния доступной карточки.
Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.
Для кого и какую проблему решает
Робот полезен для администратора согласований, сохраняющего исходное состояние важных полей. После ручных правок трудно выяснить, какие именно согласованные сведения поменялись. Робот сохраняет выбранные поля в снимок, который можно позже сравнить с актуальной карточкой.
Что делает и когда применять
Возвращает переносимый JSON для последующего сравнения состояния доступной карточки.
Принимает тип и ID карточки, 1–20 точных имён полей. Возвращает JSON до 64 КБ с датой, значениями, неизвестными полями и контрольной суммой. Отсутствующее поле не считается пустым или нулевым. Сохраните JSON средствами своего процесса; приложение его отдельно не хранит. Снимок содержит выбранные бизнес-данные. Контрольная сумма обнаруживает повреждение, но не подтверждает автора или портал. Файлы, связи и полное резервное копирование не входят; восстановление и изменение карточки не выполняются.
Что подготовить
Нужен установленный робот из приложения «CRM роботы 2.0 + AI» и право на настройку автоматизации нужной CRM-воронки или шаблона бизнес-процесса. Пользователю, от имени которого работает приложение, должны быть доступны выбранные CRM-элементы и нужное действие с ними.
Выберите тип и ID карточки и ограниченный набор исходных кодов полей. Сохраняйте результат целиком в доступном только нужным сотрудникам месте; снимок содержит значения выбранных полей.
Как настроить и использовать
- Откройте автоматизацию нужной сущности и выберите стадию, на которой нужен робот «Выгрузить снимок выбранных полей CRM». В шаблоне бизнес-процесса добавьте одноимённое действие.
- Выберите тип и ID карточки и ограниченный набор исходных кодов полей. Сохраняйте результат целиком в доступном только нужным сотрудникам месте; снимок содержит значения выбранных полей.
- Заполните Тип CRM, ID карточки, Имена выбранных полей (JSON). Для рабочего сценария подставьте значения полей документа или результаты предыдущих действий вместо учебных данных ниже.
- Проверьте обязательные поля и варианты выбора в таблице настроек. Сохраните действие и свяжите его результаты с дальнейшими условиями процесса.
- Выполните пробный запуск на отдельном учебном элементе. Сначала проверьте статус и пояснение ошибки, затем содержательный результат и ветку, выбранную следующим действием.
Параметры робота
Имена полей ниже совпадают с настройками действия. Значения из таблицы относятся к самому роботу; результаты предыдущих шагов выбирайте через подстановку значения в редакторе.
| Поле в настройках | Что передать | Обязательность и исходное значение |
|---|---|---|
Тип CRM (ENTITY_TYPE_ID) |
Формат: целое число. | Обязательно. Значение по умолчанию в настройках не задано |
ID карточки (ENTITY_ID) |
Формат: целое число. | Обязательно. Значение по умолчанию в настройках не задано |
Имена выбранных полей (JSON) (FIELDS) |
Формат: текст. | Обязательно. Значение по умолчанию в настройках не задано |
Учебный пример
Пример показывает способ настройки на вымышленных данных и ожидаемый смысл результата; это не отчёт о запуске на вашем портале.
- Тип CRM (
ENTITY_TYPE_ID):2. - ID карточки (
ENTITY_ID):501. - Имена выбранных полей (JSON) (
FIELDS):["title","opportunity"].
Имена выбранных полей (JSON) (FIELDS)
Копируйте в это поле только содержимое блока, без названия поля и внешней обёртки со всеми настройками. Здесь нужен JSON-массив в квадратных скобках. Пустой массив [] означает отсутствие элементов; объект {} его не заменяет. Учебные ID замените реальными ID выбранных карточек, дел, шаблонов или сотрудников; их можно передать из результатов предыдущего поиска. Коды полей берите из настроек вашей CRM. Элементы массива являются строками с кодами полей. title и opportunity относятся к имени и сумме в показанном примере. Пользовательские коды получите из настроек нужной сущности; подпись поля в интерфейсе не заменяет код. Пустой список не задаёт набор для проверки или снимка.
[
"title",
"opportunity"
]
Снимок содержит выбранные название и сумму учебной сделки, сведения о полноте и контрольную сумму. Если часть полей неизвестна, неполный результат нельзя считать полной копией согласованных данных. Снимок не заменяет резервное копирование карточки.
Какие данные возвращает и что делать дальше
| Результат | Какое значение получает следующий шаг |
|---|---|
Снимок выбранных полей (JSON) (snapshot) |
текст |
Контрольная сумма (sha256) |
строка |
Все выбранные поля получены (complete) |
да/нет |
Неизвестные поля (unknownFields) |
строка, несколько значений |
Статус выполнения (status) |
да/нет |
Пояснение ошибки (error) |
строка |
Сохраните «Снимок выбранных полей» для робота сравнения вместе с типом и ID карточки. Не редактируйте JSON между сохранением и сравнением; контрольная сумма не доказывает авторство или принадлежность тому же порталу.
Ошибки и ограничения
Проверяйте результат действия до следующего изменения карточки. Ошибка доступа, неверный идентификатор и отсутствие найденного элемента требуют разных веток процесса. Не подставляйте нулевой или пустой результат как идентификатор существующего документа.