Как в БП создать задачу и дождаться её завершения

Задача

Сначала нужно отделить бизнес-сценарий от технического механизма.

Задача — как в БП создать задачу и дождаться её завершения. В этой теме важны: Ожидание, задания БП, статусы задачи, ограничения роботов.

Перед правкой лучше воспроизвести сценарий на тестовой карточке и записать фактические ID, типы полей, пользователя запуска и текст ошибки.

Как это устроено

Большинство ошибок появляется из-за неверного формата данных или точки запуска.

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

Рабочий подход

Начинайте со штатного API и добавляйте обходы только там, где штатный сценарий не покрывает задачу.

Для облака используйте REST и проверяйте права приложения. Для коробки, если код выполняется внутри портала, чаще удобнее PHP/D7 и штатные классы модуля.

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

Частые ошибки

Ошибки лучше ловить на минимальном примере, а не в большом процессе.

не проверили права пользователя или приложения;
перепутали ID, текстовое значение и XML_ID;
передали строку вместо массива для множественного поля;
запустили процесс повторно и получили дубли;
обошли штатную операцию CRM и не запустили роботов или события.

Минимальный пример

Пример показывает только базовую форму. На реальном портале замените ID, поля и права на свои.

BX24.callMethod(
    'tasks.task.add',
    {
        fields: {
            TITLE: 'Проверить документы',
            RESPONSIBLE_ID: 25,
            CREATED_BY: 1,
        },
    },
    function (result) {
        console.log(result.data());
    }
);