Выбрать курс
36
/
284
Поиск дел
Активити (робот) "Поиск дел" предназначено для использования в роботах и может быть полезно в следующих сценариях:
Тип дела: В данном поле указывается тип дела (провайдера), который нужно найти. Это обязательный параметр. Выбирается из выпадающего списка.
Варианты выбора:
- Универсальное (CRM_TODO) - универсальные дела;
- Встреча (CRM_MEETING) - дела типа "Встреча";
- Звонок (VOXIMPLANT_CALL) - дела типа "Звонок" (поддерживается поиск с альтернативными провайдерами);
- Письмо (CRM_EMAIL) - дела типа "Письмо";
- Задачи (TASKS) - задачи (старые дела для обратной совместимости);
- Задача (новая) (CRM_TASKS_TASK) - задачи в новой реализации;
- Чат (IMOPENLINES_SESSION) - дела типа "Чат";
- Обзвон (CALL_LIST) - дела типа "Обзвон";
- SMS (CRM_SMS) - дела типа "SMS";
- CRM форма (CRM_WEBFORM) - дела типа "CRM форма";
- Визит (VISIT_TRACKER) - дела типа "Визит";
- Слоты (CRM_CALENDAR_SHARING) - дела типа "Слоты";
- Доставка (CRM_DELIVERY) - дела типа "Доставка";
- Документ подписания (CRM_SIGN_DOCUMENT) - дела типа "Документ подписания";
- Сообщение в WhatsApp через ЕЦУ (CRM_NOTIFICATION) - дела типа "Сообщение в WhatsApp";
- Оплата (CRM_PAYMENT) - дела типа "Оплата";
- Дело бизнес-процесса (CRM_BIZPROC_WORKFLOW) - дела типа "Дело бизнес-процесса";
- И другие типы дел.
Примеры:
- Звонок - найти все дела типа "Звонок";
- Письмо - найти все дела типа "Письмо";
- Встреча - найти все дела типа "Встреча".
Важно: Параметр "Тип дела" является обязательным. Без указания типа дела поиск не будет выполнен. Для звонков активити (робот) автоматически ищет дела с альтернативными провайдерами (CALL_LIST, CRM_CALL, TELEPHONY, PHONE) для более полного результата.
Тип сущности: В данном поле указывается тип сущности CRM, в которой нужно искать дела. Это необязательный параметр, поддерживается множественный выбор. Выбирается из выпадающего списка.
Варианты выбора:
- Лид (L) - для поиска дел, привязанных к лидам;
- Сделка (D) - для поиска дел, привязанных к сделкам;
- Контакт (C) - для поиска дел, привязанных к контактам;
- Компания (CO) - для поиска дел, привязанных к компаниям;
- Предложение (Q) - для поиска дел, привязанных к предложениям;
- Заказ (O) - для поиска дел, привязанных к заказам;
- Счёт (SI) - для поиска дел, привязанных к счетам;
- СМАРТ: [название смарт-процесса] - для поиска дел, привязанных к смарт-процессам (список формируется автоматически на основе настроек вашего портала).
Примеры:
- Сделка (D) - найти все дела, привязанные к сделкам;
- Контакт (C) - найти все дела, привязанные к контактам;
- Сделка (D), Контакт (C) - найти дела, привязанные к сделкам или контактам (множественный выбор);
- СМАРТ: Заявки - найти дела, привязанные к смарт-процессу "Заявки".
Особенности работы:
- Если тип сущности не указан, но указан ID сущности, активити (робот) автоматически определит тип сущности по ID;
- Поддерживается множественный выбор для поиска дел в нескольких типах сущностей одновременно;
- Для смарт-процессов список формируется автоматически на основе настроек вашего портала.
ID сущности: В данном поле указывается идентификатор сущности CRM, в которой нужно искать дела. Это необязательный параметр. Если указан без указания типа сущности, активити (робот) автоматически определит тип сущности по ID.
Примеры:
- {=Document:ID} - искать дела в текущей сущности из документа (сделка, лид, контакт, компания);
- 123 - искать дела в сущности с ID 123;
- {=Variable:DEAL_ID} - использовать ID из переменной предыдущего активити (робота);
- {=A1988_22222_92566_99999:search_results} - использовать ID из результата поиска (первый элемент массива);
- {=Iterator:Value} - использовать ID для каждого элемента в итераторе.
Особенности работы:
- Если тип сущности не указан, активити (робот) автоматически определит тип сущности по ID (проверяет лид, сделку, контакт, компанию, смарт-процессы);
- Если указан тип сущности, используется указанный тип;
- Можно использовать вместе с типом сущности для более точного поиска.
Ответственный: В данном поле указывается сотрудник, дела которого нужно найти. Это необязательный параметр, используется как дополнительный фильтр при поиске дел.
Примеры:
- {=Document:ASSIGNED_BY_ID} - искать дела ответственного из текущей сущности;
- {=User:ID} - искать дела текущего пользователя;
- [U1] - искать дела пользователя с ID 1;
- user_25 - искать дела пользователя с ID 25;
- {=Variable:RESPONSIBLE_ID} - использовать ID из переменной предыдущего активити (робота).
Дата создания: В данном поле можно указать дату создания дела для фильтрации результатов. Это необязательный параметр. Поддерживаются различные операторы сравнения (=, !, >=, <=, >, <, %, !%).
Примеры:
- ={{=dateadd({=System:Now}, "-7d")}} - найти дела, созданные 7 дней назад;
- >={{=dateadd({=System:Now}, "-30d")}} - найти дела, созданные за последние 30 дней;
- <={{=dateadd({=System:Now}, "-1d")}} - найти дела, созданные до вчерашнего дня;
- {=Variable:START_DATE} - использовать дату из переменной предыдущего активити (робота).
Операторы сравнения:
- = - точное совпадение;
- ! - не равно;
- >= - больше или равно;
- <= - меньше или равно;
- > - больше;
- < - меньше;
- % - содержит (для строк);
- !% - не содержит (для строк).
Делать отладочные сообщения в журнал БП: в данном поле указывается делать отладочные сообщения в журнал БП или нет.
Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
- Поиск дел по типу (звонок, письмо, встреча, задача и т.д.);
- Поиск дел, привязанных к конкретной сущности CRM (сделка, лид, контакт, компания);
- Фильтрация дел по различным параметрам (ответственный, дата создания, статус и т.д.);
- Поиск дел за определённый период времени;
- Поиск дел по ответственному за дело;
- Поиск дел в смарт-процессах;
- Автоматическое определение типа сущности по ID;
- Поиск дел с поддержкой множественных сущностей;
- Аналитика и отчётность по делам;
- Автоматизация процессов на основе найденных дел
Тип дела: В данном поле указывается тип дела (провайдера), который нужно найти. Это обязательный параметр. Выбирается из выпадающего списка.
Варианты выбора:
- Универсальное (CRM_TODO) - универсальные дела;
- Встреча (CRM_MEETING) - дела типа "Встреча";
- Звонок (VOXIMPLANT_CALL) - дела типа "Звонок" (поддерживается поиск с альтернативными провайдерами);
- Письмо (CRM_EMAIL) - дела типа "Письмо";
- Задачи (TASKS) - задачи (старые дела для обратной совместимости);
- Задача (новая) (CRM_TASKS_TASK) - задачи в новой реализации;
- Чат (IMOPENLINES_SESSION) - дела типа "Чат";
- Обзвон (CALL_LIST) - дела типа "Обзвон";
- SMS (CRM_SMS) - дела типа "SMS";
- CRM форма (CRM_WEBFORM) - дела типа "CRM форма";
- Визит (VISIT_TRACKER) - дела типа "Визит";
- Слоты (CRM_CALENDAR_SHARING) - дела типа "Слоты";
- Доставка (CRM_DELIVERY) - дела типа "Доставка";
- Документ подписания (CRM_SIGN_DOCUMENT) - дела типа "Документ подписания";
- Сообщение в WhatsApp через ЕЦУ (CRM_NOTIFICATION) - дела типа "Сообщение в WhatsApp";
- Оплата (CRM_PAYMENT) - дела типа "Оплата";
- Дело бизнес-процесса (CRM_BIZPROC_WORKFLOW) - дела типа "Дело бизнес-процесса";
- И другие типы дел.
Примеры:
- Звонок - найти все дела типа "Звонок";
- Письмо - найти все дела типа "Письмо";
- Встреча - найти все дела типа "Встреча".
Важно: Параметр "Тип дела" является обязательным. Без указания типа дела поиск не будет выполнен. Для звонков активити (робот) автоматически ищет дела с альтернативными провайдерами (CALL_LIST, CRM_CALL, TELEPHONY, PHONE) для более полного результата.
Тип сущности: В данном поле указывается тип сущности CRM, в которой нужно искать дела. Это необязательный параметр, поддерживается множественный выбор. Выбирается из выпадающего списка.
Варианты выбора:
- Лид (L) - для поиска дел, привязанных к лидам;
- Сделка (D) - для поиска дел, привязанных к сделкам;
- Контакт (C) - для поиска дел, привязанных к контактам;
- Компания (CO) - для поиска дел, привязанных к компаниям;
- Предложение (Q) - для поиска дел, привязанных к предложениям;
- Заказ (O) - для поиска дел, привязанных к заказам;
- Счёт (SI) - для поиска дел, привязанных к счетам;
- СМАРТ: [название смарт-процесса] - для поиска дел, привязанных к смарт-процессам (список формируется автоматически на основе настроек вашего портала).
Примеры:
- Сделка (D) - найти все дела, привязанные к сделкам;
- Контакт (C) - найти все дела, привязанные к контактам;
- Сделка (D), Контакт (C) - найти дела, привязанные к сделкам или контактам (множественный выбор);
- СМАРТ: Заявки - найти дела, привязанные к смарт-процессу "Заявки".
Особенности работы:
- Если тип сущности не указан, но указан ID сущности, активити (робот) автоматически определит тип сущности по ID;
- Поддерживается множественный выбор для поиска дел в нескольких типах сущностей одновременно;
- Для смарт-процессов список формируется автоматически на основе настроек вашего портала.
ID сущности: В данном поле указывается идентификатор сущности CRM, в которой нужно искать дела. Это необязательный параметр. Если указан без указания типа сущности, активити (робот) автоматически определит тип сущности по ID.
Примеры:
- {=Document:ID} - искать дела в текущей сущности из документа (сделка, лид, контакт, компания);
- 123 - искать дела в сущности с ID 123;
- {=Variable:DEAL_ID} - использовать ID из переменной предыдущего активити (робота);
- {=A1988_22222_92566_99999:search_results} - использовать ID из результата поиска (первый элемент массива);
- {=Iterator:Value} - использовать ID для каждого элемента в итераторе.
Особенности работы:
- Если тип сущности не указан, активити (робот) автоматически определит тип сущности по ID (проверяет лид, сделку, контакт, компанию, смарт-процессы);
- Если указан тип сущности, используется указанный тип;
- Можно использовать вместе с типом сущности для более точного поиска.
Ответственный: В данном поле указывается сотрудник, дела которого нужно найти. Это необязательный параметр, используется как дополнительный фильтр при поиске дел.
Примеры:
- {=Document:ASSIGNED_BY_ID} - искать дела ответственного из текущей сущности;
- {=User:ID} - искать дела текущего пользователя;
- [U1] - искать дела пользователя с ID 1;
- user_25 - искать дела пользователя с ID 25;
- {=Variable:RESPONSIBLE_ID} - использовать ID из переменной предыдущего активити (робота).
Дата создания: В данном поле можно указать дату создания дела для фильтрации результатов. Это необязательный параметр. Поддерживаются различные операторы сравнения (=, !, >=, <=, >, <, %, !%).
Примеры:
- ={{=dateadd({=System:Now}, "-7d")}} - найти дела, созданные 7 дней назад;
- >={{=dateadd({=System:Now}, "-30d")}} - найти дела, созданные за последние 30 дней;
- <={{=dateadd({=System:Now}, "-1d")}} - найти дела, созданные до вчерашнего дня;
- {=Variable:START_DATE} - использовать дату из переменной предыдущего активити (робота).
Операторы сравнения:
- = - точное совпадение;
- ! - не равно;
- >= - больше или равно;
- <= - меньше или равно;
- > - больше;
- < - меньше;
- % - содержит (для строк);
- !% - не содержит (для строк).
Делать отладочные сообщения в журнал БП: в данном поле указывается делать отладочные сообщения в журнал БП или нет.
Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.
Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.
Если вы хотите использовать результат работы активити (возвращаемый параметр) в другом активити, в котором параметр - простое число, то несколько чисел разделенных запятыми работать не будут, так как параметр ждет только одно число.
Если параметр простой - строка, то туда не нужно вставлять результат работы в виде массива для итератора, так как данный параметр предназначен для полей с типом заполнения "множественное".
Если параметр простой - строка, то туда не нужно вставлять результат работы в виде массива для итератора, так как данный параметр предназначен для полей с типом заполнения "множественное".
Сценарий работы робота
Возвращаемые параметры для данного активити:
- Результат поиска (массив для итератора) (search_results_array) - массив чисел с ID найденных дел (например, [123, 456, 789]). Используется для итерации по результатам в бизнес-процессе.
- Результат поиска (строка) (search_results_string) - строка со всеми результатами поиска, разделёнными запятыми (например, "123,456,789"). Удобно для передачи в другие активити (роботы) или для отображения в отчётах.
- Первый результат поиска (search_result_first_string) - строка с первым результатом поиска (например, "123"). Полезно, когда нужно получить только первое найденное дело.
- Последний результат поиска (search_result_last_string) - строка с последним результатом поиска (например, "789"). Полезно для получения последнего дела из списка.
- Количество найденных элементов (count_search) - числовое значение, указывающее количество найденных дел. Используется для проверки наличия дел и для аналитики.
- Соответствует условиям (math_search_results) - строка, указывающая результат поиска. Возможные значения: Y (найдены дела) или N (дела не найдены). Используется в условиях для проверки успешности поиска.
- Логи ошибок (s_error_logs) - строка с описанием ошибки или сообщением об успешном выполнении. При успешном выполнении содержит сообщение "activity_search_error_2: [количество найденных дел]".
- Результат поиска (массив для итератора) (search_results_array) - массив чисел с ID найденных дел (например, [123, 456, 789]). Используется для итерации по результатам в бизнес-процессе.
- Результат поиска (строка) (search_results_string) - строка со всеми результатами поиска, разделёнными запятыми (например, "123,456,789"). Удобно для передачи в другие активити (роботы) или для отображения в отчётах.
- Первый результат поиска (search_result_first_string) - строка с первым результатом поиска (например, "123"). Полезно, когда нужно получить только первое найденное дело.
- Последний результат поиска (search_result_last_string) - строка с последним результатом поиска (например, "789"). Полезно для получения последнего дела из списка.
- Количество найденных элементов (count_search) - числовое значение, указывающее количество найденных дел. Используется для проверки наличия дел и для аналитики.
- Соответствует условиям (math_search_results) - строка, указывающая результат поиска. Возможные значения: Y (найдены дела) или N (дела не найдены). Используется в условиях для проверки успешности поиска.
- Логи ошибок (s_error_logs) - строка с описанием ошибки или сообщением об успешном выполнении. При успешном выполнении содержит сообщение "activity_search_error_2: [количество найденных дел]".