Создать проект с настройками образца и выбранной командой

Робот «Создать проект с настройками образца и выбранной командой». Создаёт новый проект по описанию, видимости и доступу образца, добавляя явно выбранных участников.

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

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

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

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

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

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

Поле в настройке	Тип	Обязательность и исходное значение
ID проекта-образца	Целое число	Обязательное; значение по умолчанию не задано
Новое название проекта	Строка	Обязательное; значение по умолчанию не задано
Выбранные участники образца: JSON ID→E/K	Текст	Обязательное; по умолчанию {}
Новое начало ISO с поясом	Строка	Необязательное; значение по умолчанию не задано
Новое окончание ISO с поясом	Строка	Необязательное; значение по умолчанию не задано
Уникальный ключ операции	Строка	Обязательное; значение по умолчанию не задано

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

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

1. Укажите ID проекта-образца и новое название.
2. Передайте выбранных действующих участников образца картой ID в роли E или K, например {"22":"E","23":"K"}. Роли должны совпадать с образцом. Пользователя подключения в эту карту не включайте: он станет владельцем проекта, а не участником E или K.
3. Укажите новые начало и окончание с часовым поясом либо оставьте оба поля пустыми для проекта без дат.
4. Задайте устойчивый ключ создания проекта; владельцем станет пользователь подключения.
5. Используйте ID нового проекта в дальнейших действиях создания задач. Не считайте их автоматически скопированными.

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

Из образца 50 создаётся «Учебное внедрение 900» с сотрудником 22 в роли E и сотрудником 23 в роли K, картой {"22":"E","23":"K"} и ключом deal-900-project-v1. Оба должны быть действующими участниками образца с теми же ролями. Пользователь подключения в этом примере имеет другой ID, например 11: его не добавляют в карту, владельцем он станет автоматически. Ожидается новый проект с описанием, видимостью, открытостью и ключевыми словами образца, владельцем 11 и выбранной командой 22/23. Все номера объектов в примере условные; замените их данными своего портала. Пример объясняет настройку, а не подтверждает выполненный запуск.

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

• ID нового проекта: целое число.
• Владелец нового проекта: целое число.
• Выбранные участники: целое число, список.
• Получен сохранённый результат: да/нет (Y/N).

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

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

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

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

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

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

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

Выбранные участники образца: JSON ID→E/K

{
  "22": "E",
  "23": "K"
}

Объект: ключами служат строковые ID сотрудников, значениями роли E модератор или K участник. В примере сотрудник 22 выбран модератором, а 23 участником; это совпадает с основным учебным сценарием. Оба должны быть действующими участниками образца с теми же ролями. ID и роли берите из актуального состава образца. Пользователя подключения нельзя включать в карту ни с E, ни с K: он автоматически получает роль владельца, а такая попытка остановит действие с ошибкой. {} допустим и означает отсутствие выбранных участников образца; [] имеет неверную форму.