Получить список CRM сущностей, привязанных к делу

Активити (робот) "Список привязок дела" предназначено для использования в роботах и может быть полезно в следующих сценариях:

Получение списка всех сущностей, к которым привязано дело;
Проверка наличия привязок дела к определённым типам сущностей;
Анализ структуры связей дел с сущностями CRM;
Получение ID сущностей для дальнейшей обработки в бизнес-процессе;
Проверка привязок перед удалением или изменением связей;
Получение списка привязок для массовой обработки дел;
Аналитика и отчётность по связям дел с сущностями;
Валидация данных перед выполнением операций с привязками;
Получение информации о привязках для интеграции с внешними системами;
Автоматизация процессов на основе информации о привязках дел.

Как работает активити (робот):
- Активити (робот) получает список всех сущностей CRM, к которым привязано указанное дело;
- Результаты возвращаются в специальном формате с префиксами типов сущностей (L_ для лида, D_ для сделки, C_ для контакта, CO_ для компании и т.д.);
- Поддерживается ограничение количества результатов через параметр "Ограничить количество результатов до";
- Результаты возвращаются в нескольких форматах: массив для итератора, строка с разделителями, первый и последний результат;
- Поддерживается работа со смарт-процессами (автоматически определяются и добавляются в список);
- Формат результата: префикс типа сущности + ID сущности (например, D_123 для сделки с ID 123).

Сценарий работы активити (робота) бизнес-процесса

Описание параметров активити (робота)

Название поля	Описание и примеры использования
ID дела	В данном поле указывается идентификатор дела, для которого нужно получить список привязок к сущностям CRM. Это обязательный параметр. Примеры: - {=Variable:ACTIVITY_ID} - получить список привязок дела с ID из переменной предыдущего активити (робота); - 123 - получить список привязок дела с ID 123; - {=A1988_22222_92566_99999:new_id_activity} - использовать ID дела из результата активити (робота) "Создание своего дела в CRM"; - {=Document:ID} - получить список привязок дела, связанного с текущим документом (если ID дела совпадает с ID документа); - {=Iterator:Value} - получить список привязок для каждого ID дела из итератора. Как получить ID дела: - Из результата активити (робота) "Создание своего дела в CRM" (параметр new_id_activity); - Из результата активити (робота) "Поиск дел" (параметр search_results); - Из переменной, созданной в предыдущих шагах бизнес-процесса; - Из поля документа, если дело связано с документом. Важно: Если дело с указанным ID не существует или не имеет привязок, активити (робот) завершится с ошибкой "Не найдены привязки для данного дела".
Ограничить количество результатов до	В данном поле можно указать максимальное количество результатов, которое будет возвращено. Это необязательный параметр. Если не указан, будут возвращены все найденные привязки. Примеры: - 5 - вернуть только первые 5 привязок; - 10 - вернуть только первые 10 привязок; - {=Variable:LIMIT} - использовать значение из переменной предыдущего активити (робота); - Если не указано - вернуть все найденные привязки. Когда использовать: - Когда нужно получить только первую привязку (указать 1); - Для ограничения количества результатов при большом количестве привязок; - Для оптимизации производительности при работе с большими массивами данных. Рекомендации: - Используйте этот параметр, если дело может иметь много привязок и вам нужны только первые N результатов; - Для получения только первой привязки используйте также параметр search_result_first_string из возвращаемых значений.
Делать отладочные сообщения в журнал БП	Варианты: да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити (робота).
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити (робота). Если у сотрудника не будет прав на выполнение действия, то активити (робот) не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити (робота) информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять. Используется только при включённом параметре "Устанавливать текст статуса".
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити (робота) после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити (робота), и если ответ не получен в течении того количества времени, то активити (робот) завершается.

Примеры использования активити (робота)

Описание примера	Решение
Получение списка всех привязок дела	Параметры: ID дела - {=Variable:ACTIVITY_ID}, Ограничить количество результатов до - не указывается. Активити (робот) вернёт все привязки дела в формате массива и строки (например, D_123,C_456,CO_789).
Получение только первой привязки дела	Параметры: ID дела - {=Variable:ACTIVITY_ID}, Ограничить количество результатов до - 1. Активити (робот) вернёт только первую привязку. Также можно использовать параметр search_result_first_string из возвращаемых значений.
Проверка привязок дела перед удалением	Параметры: ID дела - {=Variable:ACTIVITY_ID}, Ограничить количество результатов до - не указывается. Используйте результат для проверки количества привязок (параметр count_search) перед удалением привязок через активити (робот) "Удаление привязки дела".
Получение ID сделки из привязок дела	Параметры: ID дела - {=Variable:ACTIVITY_ID}, Ограничить количество результатов до - не указывается. Используйте параметр search_results_array для поиска элементов с префиксом D_ (сделка) и извлечения ID сделки.
Получение списка привязок для массовой обработки	Параметры: ID дела - {=Iterator:Value}, Ограничить количество результатов до - не указывается. Для каждого ID дела из итератора будет получен список привязок для дальнейшей обработки.
Проверка наличия привязки к определённой сущности	Параметры: ID дела - {=Variable:ACTIVITY_ID}, Ограничить количество результатов до - не указывается. Используйте параметр search_results_string для проверки наличия определённого префикса и ID (например, проверка наличия D_{=Document:ID}).
Получение всех контактов, привязанных к делу	Параметры: ID дела - {=Variable:ACTIVITY_ID}, Ограничить количество результатов до - не указывается. Используйте параметр search_results_array для фильтрации элементов с префиксом C_ (контакт) и извлечения ID контактов.
Ограничение результатов для оптимизации	Параметры: ID дела - {=Variable:ACTIVITY_ID}, Ограничить количество результатов до - 10. Активити (робот) вернёт только первые 10 привязок, что полезно при большом количестве привязок.
Получение последней привязки дела	Параметры: ID дела - {=Variable:ACTIVITY_ID}, Ограничить количество результатов до - не указывается. Используйте параметр search_result_last_string из возвращаемых значений для получения последней привязки.
Анализ структуры привязок для отчётности	Параметры: ID дела - {=Variable:ACTIVITY_ID}, Ограничить количество результатов до - не указывается. Используйте параметр count_search для подсчёта количества привязок и search_results_array для анализа типов привязанных сущностей.

Сценарий работы робота

Возвращаемые параметры данного активити (робота):
- Результат поиска (массив для итератора) (search_results_array) - массив строк с результатами поиска в формате "префикс_ID" (например, ["D_123", "C_456", "CO_789"]). Каждый элемент массива содержит префикс типа сущности и ID сущности, разделённые подчёркиванием. Используется для итерации по результатам в бизнес-процессе.
- Результат поиска (строка) (search_results_string) - строка со всеми результатами поиска, разделёнными запятыми (например, "D_123,C_456,CO_789"). Удобно для передачи в другие активити (роботы) или для отображения в отчётах.
- Первый результат поиска (search_result_first_string) - строка с первым результатом поиска (например, "D_123"). Полезно, когда нужно получить только первую привязку.
- Последний результат поиска (search_result_last_string) - строка с последним результатом поиска (например, "CO_789"). Полезно для получения последней привязки из списка.
- Количество найденных элементов (count_search) - числовое значение, указывающее количество найденных привязок. Используется для проверки наличия привязок и для аналитики.
- Соответствует условиям (math_search_results) - строка, указывающая результат поиска. Возможные значения: Y (найдены привязки) или N (привязки не найдены). Используется в условиях для проверки успешности поиска.
- Сообщение об ошибке (s_error_logs) - строка с описанием ошибки, если поиск завершился неудачно. Обычно пустая строка при успешном выполнении.

Формат результатов:
Результаты возвращаются в формате "префикс_ID", где префикс указывает тип сущности:
- L_ - Лид (CRM_LEAD);
- D_ - Сделка (CRM_DEAL);
- C_ - Контакт (CRM_CONTACT);
- CO_ - Компания (CRM_COMPANY);
- Q_ - Предложение (CRM_QUOTE);
- O_ - Заказ (CRM_ORDER);
- SI_ - Счёт (новый, CRM_SMART_INVOICE);
- [SYMBOL_CODE_SHORT]_ - Смарт-процессы (префикс формируется автоматически на основе настроек портала).

Примеры использования возвращаемых параметров:
- Использовать search_results_array в итераторе для обработки каждой привязки отдельно;
- Использовать search_result_first_string для получения первой привязки без итерации;
- Проверить count_search для определения количества привязок перед выполнением операций;
- Использовать math_search_results в условиях для проверки наличия привязок;
- Передать search_results_string в следующее активити (робот) для дальнейшей обработки.

Важно! Ограничения и рекомендации:

Обязательные параметры:
Для успешного получения списка привязок обязательно должен быть указан параметр "ID дела". Если ID дела не указан или указан неверно, активити (робот) завершится с ошибкой.

Формат результатов:
Результаты возвращаются в специальном формате с префиксами типов сущностей. Это позволяет легко определить тип сущности по префиксу. Например, D_123 означает сделку с ID 123, C_456 означает контакт с ID 456.

Ограничение количества результатов:
Параметр "Ограничить количество результатов до" ограничивает количество возвращаемых результатов. Если указано значение 5, будут возвращены только первые 5 привязок. Остальные привязки будут проигнорированы. Это полезно для оптимизации производительности при большом количестве привязок.

Работа со смарт-процессами:
Активити (робот) автоматически определяет смарт-процессы, привязанные к делу, и добавляет их в список результатов. Префикс для смарт-процессов формируется автоматически на основе символьного кода смарт-процесса из настроек портала.

Обработка ошибок:
Если дело с указанным ID не существует или не имеет привязок, активити (робот) завершится с ошибкой "Не найдены привязки для данного дела". Параметр math_search_results будет равен N. Всегда проверяйте значение этого параметра перед использованием результатов в дальнейших шагах бизнес-процесса.

Использование результатов в итераторе:
Параметр search_results_array специально предназначен для использования в итераторе бизнес-процесса. Каждый элемент массива можно обработать отдельно в цикле. Это позволяет выполнять операции с каждой привязкой индивидуально.

Извлечение ID из результатов:
Для извлечения числового ID из результата в формате "префикс_ID" можно использовать функции работы со строками (например, explode или substr) или регулярные выражения. Например, из "D_123" можно извлечь "123" для дальнейшего использования.

Права доступа:
Убедитесь, что пользователь, указанный в поле "Запускать от имени", имеет права на просмотр привязок дел. Рекомендуется использовать пользователя с правами администратора системы.

Ваша корзина пуста

Получить список CRM сущностей, привязанных к делу