Как открыть элемент смарт-процесса в слайдере

Задача

Разбираем практический сценарий для смарт-процессов.

Задача — как открыть элемент смарт-процесса в слайдере. В этой заметке важно не смешивать похожие сущности и сначала определить, с каким типом CRM-данных работает код.

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

Основная проверка — понять, какие данные реально участвуют в сценарии.

URL карточки — отдельный участок проверки. Его лучше подтвердить на тестовом элементе, а не переносить логику со сделки или другого смарт-процесса вслепую.

SidePanel — отдельный участок проверки. Его лучше подтвердить на тестовом элементе, а не переносить логику со сделки или другого смарт-процесса вслепую.

iframe. — отдельный участок проверки. Его лучше подтвердить на тестовом элементе, а не переносить логику со сделки или другого смарт-процесса вслепую.

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

Начинайте с штатного API и проверяйте фактический ответ.

Для облака используйте REST. Для коробки, если код выполняется внутри портала, чаще удобнее D7 и фабрика CRM.

Не переносите пример со сделки без адаптации: у смарт-процесса свой entityTypeId, свои настройки типа и свои ограничения.

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

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

Если метод возвращает пусто, сначала проверьте ID типа, ID элемента, права текущего пользователя и включена ли нужная возможность в настройках смарт-процесса.

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

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

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

const entityTypeId = 178;
const itemId = 45;
const url = `/crm/type/${entityTypeId}/details/${itemId}/`;

BX.SidePanel.Instance.open(url, {
    width: 1200,
    cacheable: false,
});