Как работать с множественными переменными в БП

Задача

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

Задача — как работать с множественными переменными в БП. В этой теме важны: Сотрудники, ID сделок, списки элементов, пустые значения.

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

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

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

для сотрудников обычно нужны значения user_1, user_25;
для сделок и элементов — массив ID;
для списков — ID значений, а не подписи;
пустые элементы лучше удалять до записи в переменную.

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

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

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

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

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

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

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

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

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

$user_ids = [1, 25, 25, null, ''];

$users = [];

foreach ($user_ids as $user_id) {
    $user_id = (int)$user_id;

    if ($user_id <= 0) {
        continue;
    }

    $users[] = 'user_' . $user_id;
}

$users = array_values(array_unique($users));

$this->SetVariable('Approvers', $users);