Выбрать курс
- Приложение для Битрикс24 "Лаборатория роботов"
- Приложение для Битрикс24 "Сквозная аналитика 2.0"
- Приложение для Битрикс24 "Уничтожитель дубликатов"
- Приложение для Битрикс24 "Межпортальные задачи"
- Приложение для Битрикс24 "Немой чат-бот"
- Приложение для Битрикс24 "Доходы и расходы CRM"
- Приложение для Битрикс24 "Продуктивный Jivosite"
99
/
307
Поиск Компаний (v.2)
Активити (робот) "Поиск Компаний (v.2)" предназначено для использования в роботах и бизнес-процессах и может быть полезно в следующих сценариях:
- Поиск компаний по различным полям (название, тип, отрасль, ответственный и т.д.);
- Фильтрация компаний по множеству критериев одновременно;
- Поиск компаний по частичному совпадению названия;
- Поиск компаний за определённый период (по дате создания или изменения);
- Поиск компаний по пользовательским полям;
- Проверка наличия компании перед созданием дубликата;
- Получение списка ID компаний для массовых операций.
Как работает активити (робот):
- Активити (робот) автоматически получает список всех доступных полей компании из CRM вашего портала;
- Для каждого поля создаётся параметр поиска, который можно заполнить для фильтрации;
- Поддерживается поиск по частичному совпадению для текстовых полей (оператор
- Поддерживается поиск по диапазонам для числовых и датовых полей;
- Можно комбинировать несколько полей для более точного поиска;
- Поиск выполняется по принципу "И" (AND) - все указанные условия должны выполняться одновременно;
- Результаты возвращаются в виде массива ID компаний, строки с ID через запятую, первого и последнего ID, количества найденных компаний;
- Активити (робот) работает через REST API Битрикс24 (crm.company.list, crm.company.fields).
- Активити (робот) автоматически получает список всех доступных полей компании из CRM вашего портала;
- Для каждого поля создаётся параметр поиска, который можно заполнить для фильтрации;
- Поддерживается поиск по частичному совпадению для текстовых полей (оператор
={%...});- Поддерживается поиск по диапазонам для числовых и датовых полей;
- Можно комбинировать несколько полей для более точного поиска;
- Поиск выполняется по принципу "И" (AND) - все указанные условия должны выполняться одновременно;
- Результаты возвращаются в виде массива ID компаний, строки с ID через запятую, первого и последнего ID, количества найденных компаний;
- Активити (робот) работает через REST API Битрикс24 (crm.company.list, crm.company.fields).
Описание параметров активити (робота)
| Название поля | Описание и примеры использования |
|---|---|
| Название компании |
Поиск по названию компании. Поддерживается частичное совпадение. Примеры: - ООО "Ромашка" - точное совпадение;- ={%Ромашка%} - частичное совпадение (содержит "Ромашка");- ={%ООО%} - все компании, содержащие "ООО".
|
| Тип компании |
Поиск по типу компании. Указывается символьный код типа из справочника CRM. Примеры: - CLIENT - клиенты;- SUPPLIER - поставщики;- PARTNER - партнёры.
|
| Ответственный |
Поиск по ответственному за компанию. Примеры: - {=Document:ASSIGNED_BY_ID} - ответственный из текущего документа;- user_25 - конкретный пользователь;- {=User:ID} - текущий пользователь.
|
| Сфера деятельности | Поиск по сфере деятельности компании. Указывается символьный код. |
| Дата создания |
Поиск по дате создания компании. Поддерживаются операторы сравнения. Примеры: - >={{=dateadd({=System:Now}, "-30d")}} - созданные за последние 30 дней;- <={{=dateadd({=System:Now}, "-1d")}} - созданные до вчерашнего дня.
|
| Пользовательские поля | Активити (робот) автоматически создаёт параметры для всех пользовательских полей (UF_*) вашего портала. |
| Делать отладочные сообщения в журнал БП |
Варианты: да/нет.
Используйте только по необходимости из-за большого расхода запросов.
|
| Запускать от имени | Сотрудник, с правами которого выполняется активити. Рекомендуется выбирать администратора. |
Операторы сравнения для поиска:
| Оператор | Описание | Пример |
|---|---|---|
=
|
Точное совпадение |
={123}
|
!
|
Не равно |
={!123}
|
>=
|
Больше или равно |
>={100}
|
<=
|
Меньше или равно |
<={100}
|
>
|
Больше |
>{100}
|
<
|
Меньше |
<{100}
|
%
|
Содержит (для строк) |
={%текст%}
|
!%
|
Не содержит (для строк) |
={!%текст%}
|
Примеры использования:
| № | Сценарий | Параметры поиска |
|---|---|---|
| 1 | Поиск по названию |
Название: ={%Ромашка%}
|
| 2 | Поиск по типу |
Тип: CLIENT
|
| 3 | Поиск по ответственному |
Ответственный: {=Document:ASSIGNED_BY_ID}
|
| 4 | Поиск за последний месяц |
Дата создания: >={{=dateadd({=System:Now}, "-30d")}}
|
| 5 | Поиск по отрасли |
Сфера деятельности: IT
|
| 6 | Поиск по нескольким критериям |
Тип: CLIENT, Ответственный: user_1
|
| 7 | Проверка дубликата |
Название: ={ООО "Точное название"}
|
| 8 | Поиск по пользовательскому полю |
UF_CRM_*: {=Variable:VALUE}
|
| 9 | Поиск активных компаний |
Статус: ACTIVE
|
| 10 | Поиск по городу |
Город: Москва
|
Важно: Если вы хотите использовать результат работы активити (возвращаемый параметр) в другом активити, в котором параметр - простое число, то несколько чисел, разделённых запятыми, работать не будут, так как параметр ждёт только одно число.
Возвращаемые параметры для данного активити:
- Результат поиска (массив для итератора) (search_results_array) - массив чисел с ID найденных компаний;
- Результат поиска (строка) (search_results_string) - строка со всеми результатами поиска через запятую;
- Первый результат поиска (search_result_first_string) - строка с первым результатом;
- Последний результат поиска (search_result_last_string) - строка с последним результатом;
- Количество найденных элементов (count_search) - числовое значение;
- Соответствует условиям (math_search_results) -
Y(найдены) илиN(не найдены); - Логи ошибок (s_error_logs) - описание ошибки или сообщение об успехе.