Создать запись списка по ключу операции

Робот «Создать запись списка по ключу операции». Создаёт простую запись списка с защитой от повторной отправки и возвращает её ID.

Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.

Для кого и какую проблему решает

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

Что подготовить

Установите действие в каталоге приложения «CRM роботы 2.0 + AI», затем добавьте его в нужную точку автоматизации. Для чтения или изменения объектов нужен соответствующий доступ пользователя подключения. Идентификаторы берите из полей карточки или результатов предыдущих шагов: название объекта не заменяет его числовой ID.

Параметры и значения

Поле в настройке	Тип	Обязательность и исходное значение
Тип списка	Выбор из списка	Обязательное; по умолчанию lists
Варианты поля «Тип списка»		lists: Списки; lists_socnet: Списки группы; bitrix_processes: Процессы
ID списка	Целое число	Обязательное; значение по умолчанию не задано
NAME и все свойства: JSON	Текст	Обязательное; значение по умолчанию не задано
Уникальный ключ операции	Строка	Обязательное; значение по умолчанию не задано

Поля, обозначенные JSON, заполняйте корректными массивами или объектами с двойными кавычками в строках. Подставляйте одно значение через штатный выбор данных редактора; не копируйте служебный идентификатор шага из другого шаблона.

Как использовать пошагово

1. Выберите тип списка и его числовой ID. Убедитесь, что выбран именно нужный список, а не ID отдельной записи.
2. Передайте объект полей с NAME и всеми обычными свойствами списка. Для числовых и списочных свойств используйте их реальные коды PROPERTY_номер.
3. Например, для простого списка без свойств задайте {"NAME":"Учебная регистрация"}.
4. Закрепите ключ за событием регистрации и не меняйте данные при повторе того же ключа.
5. Сохраните возвращённый ID записи в поле процесса. Следующие чтение или правку выполняйте по этому ID.

Учебный пример и ожидаемый результат

В простом списке 50 без дополнительных свойств создаётся запись с полями {"NAME":"Учебная заявка 900"} и ключом request-900-register-v1. При успехе возвращаются ID записи и признак создания. Повтор с теми же данными возвращает сохранённую запись. Все номера объектов в примере условные; замените их данными своего портала. Пример объясняет настройку, а не подтверждает выполненный запуск.

Какие результаты передать дальше

• ID записи: целое число.
• Запись создана этим запросом: да/нет (Y/N).
• Получен сохранённый результат: да/нет (Y/N).

В следующем действии откройте выбор данных и выберите результат этого робота по названию. Сначала проверьте статус выполнения; при ошибке передайте её пояснение на разбор и не используйте пустые значения как подтверждённый результат. Успех шага и положительный ответ на бизнес-проверку: разные условия.

Ограничения и исправление ошибок

Поддерживаются обычные строковые, числовые и списочные свойства. Списки с файлами, нестандартными и закрытыми полями не поддерживаются. По ключу задаётся служебный код записи. Неоднозначное совпадение или тот же ключ с другими данными останавливают операцию.

Один ключ операции закрепляйте за одним событием и сохраняйте неизменным при его повторе вместе со всеми входными данными. Для другого события нужен другой ключ. Случайный новый ключ на каждом запуске допускает дубли. При неизвестном или частичном результате сначала сверяйте фактически созданный объект; не обходите остановку сменой ключа.

Если доступ изменился, сначала проверьте объект под пользователем подключения и актуальность ID. Повторяйте действие после устранения причины. Для действий с записью предварительно сверяйте фактическое состояние: сообщение об ошибке само по себе не доказывает, что ни одна правка не сохранилась.

Как заполнять JSON-поля

Каждый блок ниже вставляется целиком в своё поле. Не добавляйте внешние кавычки вокруг всего массива или объекта. Учебные ID и названия замените фактическими данными.

NAME и все свойства: JSON

{
  "NAME": "Учебная заявка 900"
}

Объект всех поддерживаемых полей новой записи. NAME содержит непустое название строкой; пример подходит простому списку без дополнительных свойств. Если в вашем списке есть свойства, передайте их реальными ключами PROPERTY_номер с типами, указанными в настройках списка, и всеми требуемыми значениями. Для списочного свойства нужны ID вариантов из получения вариантов поля, а не придуманные подписи. ID списка задаётся отдельно. {} не заменяет обязательное название, [] имеет неверную форму; файлы и нестандартные свойства не поддерживаются.