Выбрать курс
140
/
259
Поиск Сделки (v.2)
Данное активити позволяет искать "Сделку" или "Сделки" по выбранным в настройках полям. Результатом работы является получение списка ID найденных сделок.
Активити динамически поддерживает все поля сделки, доступные в вашем портале Битрикс24, что позволяет искать сделки по любым критериям. Результатом работы является получение ID сделок в виде массива для итератора и строки, а также количество найденных элементов и их соответствие условиям поиска.
Активити "Поиск Сделки" предназначено для использования в роботах и бизнес-процессах и может быть полезно в следующих сценариях:
Основные параметры поиска:
Активити автоматически создаёт параметры для всех полей сделки. Ниже описаны основные и наиболее часто используемые поля. Обратите внимание, что названия полей могут отличаться в зависимости от настроек вашего портала.
Данные символы ставятся перед содержимым значения в фигурных скобках:
={%ваше значение} - содержит (можно искать буквы и цифры в выбранной вами строке).
Пример: ={%груша} - вернёт все ID сделок, в которых, в выбранном вами поле, содержится слово "груша".
Дополнительный пример: ={%договор} - найдёт все сделки с "договор" в заголовке, комментарии или другом текстовом поле.
={!%ваше значение} - не содержит.
Пример: ={!%123} - это значит, что значение в выбранном поле не содержит 123 (можно искать буквы и цифры в выбранной вами строке).
Дополнительный пример: ={!%архив} - найдёт все сделки, в которых нет слова "архив".
={ваше значение} - равно (точное совпадение).
Пример: ={123} - это значит, что значение в выбранном поле равно 123 (только для полей типа "строка" и "число").
Пример: ={Договор поставки} - найдёт только сделки с точно таким заголовком (регистр имеет значение).
={!ваше значение} - не равно.
Пример: ={!123} - это значит, что значение в выбранном поле не равно 123 (только для полей типа "строка" и "число").
Дополнительный пример: ={!0} - найдёт все сделки с ненулевой суммой.
={>ваше значение} - больше.
Пример: ={>123} - это значит, что значение в выбранном поле больше 123 (только для поля тип "число").
Дополнительный пример: ={>500000} - найдёт все сделки с суммой больше 500 000 рублей.
={<ваше значение} - меньше.
Пример: ={<123} - это значит, что значение в выбранном поле меньше 123 (только для поля тип "число").
Дополнительный пример: ={<10000} - найдёт все сделки с суммой меньше 10 000 рублей.
={>=ваше значение} - больше или равно.
Пример: ={>=123} - это значит, что значение в поле больше или равно 123 (только для поля тип "число").
Дополнительный пример: ={>=75} - найдёт все сделки с вероятностью 75% и выше.
={<=ваше значение} - меньше или равно.
Пример: ={<=123} - это значит, что значение в поле меньше или равно 123 (только для поля тип "число").
Дополнительный пример: ={<=10000} - найдёт все сделки с суммой не более 10 000 рублей.
={@массив значений} - IN (входит в список). В качестве значения передаётся массив значений, одно из которых должно совпадать с полем.
Пример: ={@{123,456,789}} - найдёт все сделки, у которых ID равен 123, 456 или 789.
Дополнительный пример: ={@{WEB,CALL,EMAIL}} - найдёт все сделки из источников "Веб-сайт", "Звонок" или "Email".
={!@массив значений} - NOT IN (не входит в список). В качестве значения передаётся массив значений, ни одно из которых не должно совпадать с полем.
Пример: ={!@{123,456}} - найдёт все сделки, у которых ID не равен 123 и не равен 456.
Дополнительный пример: ={!@{F}} - найдёт все сделки, которые не находятся в группе стадий "Провалена" (исключает проваленные сделки).
={%ваше значение} - LIKE (поиск по подстроке). Ищет значение в любой позиции строки. Символ % в значении фильтра передавать не нужно - он применяется автоматически.
Пример: ={%договор} - найдёт все сделки, в которых содержится слово "договор" в любой позиции строки.
Дополнительный пример: ={%123} - найдёт все сделки, в которых в любом месте встречается "123".
Важно: Этот оператор работает аналогично поиску "содержит", но является более явным указанием типа поиска LIKE.
={=значение с %} - LIKE (поиск по подстроке с явным указанием позиции). Символ % нужно передавать в значении для контроля позиции поиска.
Примеры:
- ={=мол%} - найдёт все значения, начинающиеся с "мол" (например: "молоко", "молния");
- ={=%мол} - найдёт все значения, заканчивающиеся на "мол" (например: "мол", "армол");
- ={=%мол%} - найдёт все значения, где "мол" может быть в любой позиции с любыми символами до и после (аналогично простому ={%мол}).
Важно: Используйте этот оператор, когда нужно точно контролировать позицию искомой подстроки в строке. Символ % означает "любые символы" в SQL-подобном синтаксисе LIKE. Помещайте % в нужное место значения: в начале для поиска окончания, в конце для поиска начала, с обеих сторон для поиска в любой позиции.
={%=значение с %} - LIKE (аналогично =%). Альтернативный синтаксис для поиска с явным указанием позиции.
Примеры:
- ={%=мол%} - найдёт все значения, начинающиеся с "мол";
- ={%=%мол} - найдёт все значения, заканчивающиеся на "мол";
- ={%=%мол%} - найдёт все значения, где "мол" может быть в любой позиции.
Примечание: Операторы =% и %= работают идентично, используйте тот, который вам удобнее. Оба требуют явного указания символа % в значении для контроля позиции поиска.
={=ваше значение} - равно (точное совпадение, используется по умолчанию). Явное указание оператора равенства.
Пример: ={=123} - найдёт только сделки с точным значением 123 (эквивалентно ={123}).
Примечание: Если оператор не указан, по умолчанию используется оператор равенства (=).
={!=ваше значение} - не равно. Альтернативный синтаксис для оператора "не равно".
Пример: ={!=123} - найдёт все сделки, значение которых не равно 123 (эквивалентно ={!123}).
Примечание: Операторы != и ! работают идентично, используйте тот, который вам удобнее.
Особенности для полей даты и времени:
Если поле не является строкой (число, дата, дата/время), то содержимое ячейки должно заполняться так: ={>=14.03.2020 15:10}, в фигурных скобках указывается необходимый оператор и значение.
Использование переменных:
В случае с переменной, содержимое ячейки должно заполняться так: ={>={=A1988_22222_92566_99999:search_results}} - сначала оператор, затем переменная в фигурных скобках.
Для полей тип "дата" и "дата/время", при необходимости поиска диапазона "от и до" содержимое ячейки должно заполняться так:
={{01.03.2015 14:55:22}}##{{07.05.2015 14:55:22}}
Первая дата в двойных фигурных скобках - начало диапазона, вторая - конец диапазона, разделённые символами ##.
Пример: ={{01.01.2025 00:00:00}}##{{31.01.2025 23:59:59}} - найдёт все сделки, созданные в январе 2025 года.
Активити динамически поддерживает все поля сделки, доступные в вашем портале Битрикс24, что позволяет искать сделки по любым критериям. Результатом работы является получение ID сделок в виде массива для итератора и строки, а также количество найденных элементов и их соответствие условиям поиска.
Активити "Поиск Сделки" предназначено для использования в роботах и бизнес-процессах и может быть полезно в следующих сценариях:
- Поиск сделок по определённым критериям для массовых операций (изменение стадии, назначение ответственного, обновление полей);
- Фильтрация сделок для создания отчётов и аналитики;
- Автоматический поиск связанных сделок при работе с другими сущностями CRM;
- Поиск дубликатов сделок для очистки базы данных;
- Поиск сделок по датам для автоматизации напоминаний и контроля сроков;
- Фильтрация сделок по ответственным для распределения нагрузки или отчётов;
- Поиск сделок по рекламным кампаниям для анализа эффективности маркетинга;
- Поиск сделок в определённых стадиях для автоматизации бизнес-процессов.
Как работает активити:
- Активити автоматически получает список всех доступных полей сделки из CRM вашего портала;
- Для каждого поля создаётся параметр поиска, который можно заполнить для фильтрации;
- Рядом с каждым полем создаётся дополнительное поле "Условие поиска" для выбора оператора сравнения;
- Можно комбинировать несколько полей для более точного поиска;
- Поиск выполняется по принципу "И" (AND) - все указанные условия должны выполняться одновременно.
- Активити автоматически получает список всех доступных полей сделки из CRM вашего портала;
- Для каждого поля создаётся параметр поиска, который можно заполнить для фильтрации;
- Рядом с каждым полем создаётся дополнительное поле "Условие поиска" для выбора оператора сравнения;
- Можно комбинировать несколько полей для более точного поиска;
- Поиск выполняется по принципу "И" (AND) - все указанные условия должны выполняться одновременно.
Сценарий работы активити бизнес-процесса
Описание параметров активити
Основные параметры поиска:
Активити автоматически создаёт параметры для всех полей сделки. Ниже описаны основные и наиболее часто используемые поля. Обратите внимание, что названия полей могут отличаться в зависимости от настроек вашего портала.
| Название поля | Описание и примеры использования |
|---|---|
| ID: |
В данном поле указывается числовой идентификатор искомой сделки. Примеры: - ={123} - найти сделку с ID равным 123; - ={={=Document:ID}} - найти сделку с ID из текущего документа; - ={!123} - найти все сделки, кроме сделки с ID 123. |
| Заголовок (TITLE): |
Позволяет указать заголовок искомой сделки. Поддерживает поиск по частичному совпадению. Примеры: - ={%договор} - найти все сделки, в заголовке которых содержится слово "договор"; - ={Договор поставки №123} - найти сделку с точным заголовком; - ={!%архив} - найти все сделки, в заголовке которых нет слова "архив". |
| Название: |
Позволяет указать название искомой сделки. Обычно совпадает с заголовком или является его синонимом в зависимости от настроек портала. Примеры: - ={%поставка} - найти сделки с "поставка" в названии; - ={Поставка оборудования} - точное совпадение названия. |
| Тип (TYPE_ID): |
В данном поле указывается тип сделки из настроек CRM. Типы сделок настраиваются администратором портала и могут быть различными для разных порталов. Примеры: - ={SALE} - найти сделки типа "Продажа"; - ={COMPLEX} - найти сделки типа "Комплексная сделка"; - Для поиска по типу необходимо знать символьный код типа сделки из настроек CRM. Как узнать символьный код типа сделки: - Перейдите в CRM → Настройки → Типы сделок; - Или используйте активити для получения типов сделок; - Символьный код обычно совпадает с символьным кодом в настройках портала. |
| Стадии сделки (STAGE_ID): |
В данных полях выбираются стадии для искомой сделки. Название этого поля может быть иным, т.к. оно привязывается к названию стадий сделок на вашем портале. Важно: - Можно выбрать несколько дополнительных стадий, зажав Ctrl + кликнув по нужным стадиям; - Таких полей может быть ровно столько, сколько основных стадий сделок вы создали; - Каждое поле соответствует одной основной стадии и позволяет выбрать подстадии этой стадии. Примеры: - Выберите стадию "Квалификация" - будут найдены все сделки на этой стадии или её подстадиях; - Выберите несколько стадий из группы "Сделка в работе" - найдутся сделки на любой из выбранных стадий. |
| Группа стадии (STAGE_SEMANTIC_ID): |
В данном поле указывается направление, в котором находится искомая сделка, с помощью символьного кода группы стадии. Основные группы стадий: - P - "Сделка в работе" (Process); - S - "Сделка заключена" (Success); - F - "Сделка провалена" (Failed). Как получить символьный код группы стадии:
Для поиска всех сделок в работе в поле "Группа стадии" укажите: P Для поиска успешно закрытых сделок укажите: S Для поиска проваленных сделок укажите: F |
| Вероятность (PROBABILITY): |
В данном поле указывается уровень вероятности успешной сделки (в процентах от 0 до 100). Примеры: - ={50} - найти сделки с вероятностью 50%; - ={>=75} - найти сделки с вероятностью 75% и выше; - ={={{20}}##{{60}}} - найти сделки с вероятностью от 20% до 60%; - Используйте операторы сравнения для поиска по диапазонам. |
| Сумма (OPPORTUNITY): |
В данном поле указывается сумма искомой сделки. Можно указывать как целые числа, так и десятичные дроби. Примеры: - ={100000} - найти сделки с суммой 100 000; - ={>500000} - найти сделки с суммой больше 500 000; - ={={{100000}}##{{500000}}} - найти сделки с суммой от 100 000 до 500 000; - ={<=10000} - найти сделки с суммой не более 10 000. |
| Ставка налога (TAX_VALUE): |
В данном поле указывается ставка налога для искомой сделки (в процентах). Примеры: - ={20} - найти сделки со ставкой налога 20%; - ={0} - найти сделки без налога (ставка 0%); - ={!0} - найти все сделки с ненулевой ставкой налога. |
| Комментарий (COMMENTS): |
В данном поле указывается текст комментария для искомой сделки. Поддерживает поиск по частичному совпадению. Примеры: - ={%срочно} - найти сделки, в комментариях которых содержится слово "срочно"; - ={!%архив} - найти сделки, в комментариях которых нет слова "архив". |
| Дата создания (DATE_CREATE): |
В данном поле указывается дата создания искомой сделки. Поддерживает поиск по точной дате и диапазонам дат. Примеры: - ={={{01.01.2025 00:00:00}}##{{31.01.2025 23:59:59}}} - найти сделки, созданные в январе 2025 года; - ={>={{01.01.2025 00:00:00}}} - найти сделки, созданные после 1 января 2025 года; - Для полей типа "дата" и "дата/время" при поиске диапазона используйте формат: ={{дата начала}}##{{дата окончания}}. |
| Дата изменения (DATE_MODIFY): |
В данном поле указывается дата изменения искомой сделки. Примеры: - ={={{01.03.2025 00:00:00}}##{{31.03.2025 23:59:59}}} - найти сделки, изменённые в марте 2025 года; - ={>={{15.03.2025 00:00:00}}} - найти сделки, изменённые после 15 марта 2025 года. |
| Ответственный (ASSIGNED_BY_ID): |
В данном поле указывается ответственный за сделку. Можно указать ID пользователя или использовать переменные. Примеры: - ={25} - найти сделки, за которые отвечает пользователь с ID 25; - ={[U25]} - альтернативный формат указания пользователя; - ={={=Document:ASSIGNED_BY_ID}} - найти сделки текущего ответственного из документа; - Для пользователей поддерживаются все стандартные операторы сравнения. |
| Дополнительно об источнике (SOURCE_DESCRIPTION): |
В данном поле указываются дополнительные сведения об источнике в искомой сделке. Примеры: - ={%реклама} - найти сделки, в источнике которых есть слово "реклама"; - Используйте поиск по частичному совпадению для текстовых полей. |
| Дата начала (BEGINDATE): |
В данном поле указывается дата начала искомой сделки. Поддерживает поиск по точной дате и диапазонам дат. Примеры: - ={={{01.01.2025 00:00:00}}##{{31.12.2025 23:59:59}}} - найти сделки с датой начала в 2025 году; - ={>={{01.01.2025 00:00:00}}} - найти сделки, которые начались после 1 января 2025 года; - Для полей типа "дата" и "дата/время" при поиске диапазона используйте формат: ={{дата начала}}##{{дата окончания}}. |
| Внешний источник (SOURCE_ID): |
В данном поле указывается внешний источник в искомой сделке (символьный код источника). Примеры: - ={WEB} - найти сделки из источника "Веб-сайт"; - ={CALL} - найти сделки из источника "Звонок"; - Необходимо знать символьные коды источников из настроек CRM. |
| Идентификатор элемента во внешнем источнике (ORIGIN_ID): |
В данном поле указывается идентификатор элемента во внешнем источнике искомой сделки. Используется для интеграций с внешними системами. Примеры: - ={EXT123456} - найти сделку по внешнему идентификатору; - Используется при синхронизации с внешними CRM или системами учёта. |
| Рекламная система (UTM_SOURCE): |
В данном поле указывается рекламная система в искомой сделке (из UTM-меток). Примеры: - ={%google} - найти сделки из рекламной системы Google; - ={%yandex} - найти сделки из рекламной системы Yandex; - Используется для анализа эффективности рекламных каналов. |
| Тип трафика (UTM_MEDIUM): |
В данном поле указывается тип трафика в искомой сделке (из UTM-меток). Примеры: - ={%cpc} - найти сделки с типом трафика "cost per click"; - ={%organic} - найти сделки с органическим трафиком; - Помогает анализировать источники привлечения клиентов. |
| Обозначение рекламной кампании (UTM_CAMPAIGN): |
В данном поле указываются обозначения рекламной кампании в искомой сделке (из UTM-меток). Примеры: - ={%летняя} - найти сделки из кампании "летняя распродажа"; - Используется для отслеживания эффективности конкретных рекламных кампаний. |
| Содержание кампании (UTM_CONTENT): |
В данном поле указывается содержание кампании в искомой сделке (из UTM-меток). Примеры: - ={%баннер} - найти сделки, пришедшие по баннерной рекламе; - Используется для детального анализа эффективности элементов рекламы. |
| Условие поиска кампании (UTM_TERM): |
В данном поле указывается условие поиска кампании в искомой сделке (из UTM-меток, обычно ключевое слово). Примеры: - ={%купить} - найти сделки по ключевому слову "купить"; - Помогает анализировать эффективность конкретных ключевых слов в рекламе. |
| Направление (CATEGORY_ID): |
В данном поле указывается идентификатор направления сделки. Направления настраиваются администратором портала. Если не указано, то сделка принадлежит к общему направлению. Примеры: - ={0} - найти сделки в общем направлении; - ={5} - найти сделки в направлении с ID 5; - ={!0} - найти все сделки, которые не в общем направлении. |
| Новая сделка (IS_NEW): |
В данном поле указывается флаг новой сделки (сделки в первой стадии). Примеры: - ={Y} - найти новые сделки; - ={N} - найти не новые сделки; - Используется для фильтрации по стадиям сделок. |
| Шаблон регулярной сделки (IS_RECURRING): |
В данном поле указывается флаг шаблона регулярной сделки. Если значение Y, то это шаблон, а не обычная сделка. Примеры: - ={Y} - найти шаблоны регулярных сделок; - ={N} - найти обычные сделки (исключить шаблоны). |
| Повторный лид (IS_RETURN_CUSTOMER): |
В данном поле указывается признак повторного лида. Примеры: - ={Y} - найти сделки с повторными лидами; - ={N} - найти сделки с первичными лидами. |
| Повторное обращение (IS_REPEATED_APPROACH): |
В данном поле указывается признак повторного обращения. Примеры: - ={Y} - найти сделки с повторными обращениями; - ={N} - найти сделки с первичными обращениями. |
| Валюта (CURRENCY_ID): |
В данном поле указывается идентификатор валюты сделки. Примеры: - ={RUB} - найти сделки в рублях; - ={USD} - найти сделки в долларах США; - ={EUR} - найти сделки в евро; - Для поиска по валюте необходимо знать символьный код валюты из настроек CRM. |
| Ручная сумма (IS_MANUAL_OPPORTUNITY): |
В данном поле указывается признак того, что сумма сделки установлена вручную. Примеры: - ={Y} - найти сделки с суммой, установленной вручную; - ={N} - найти сделки с автоматически рассчитанной суммой. |
| Компания (COMPANY_ID): |
В данном поле указывается идентификатор привязанной к сделке компании. Примеры: - ={123} - найти сделки, привязанные к компании с ID 123; - ={={=Document:COMPANY_ID}} - найти сделки текущей компании из документа; - ={!0} - найти все сделки, у которых привязана компания. |
| Контакт (CONTACT_ID): |
В данном поле указывается идентификатор привязанного к сделке контакта. Устаревшее поле, сохраняется для совместимости. Рекомендуется использовать связанные контакты через другие методы. Примеры: - ={456} - найти сделки, привязанные к контакту с ID 456; - ={={=Document:CONTACT_ID}} - найти сделки текущего контакта из документа. |
| Дата завершения (CLOSEDATE): |
В данном поле указывается дата завершения искомой сделки. Поддерживает поиск по точной дате и диапазонам дат. Примеры: - ={={{01.01.2025 00:00:00}}##{{31.01.2025 23:59:59}}} - найти сделки, завершённые в январе 2025 года; - ={<={=System:NowLocal}} - найти сделки с просроченной датой завершения; - ={>={{01.01.2025 00:00:00}}} - найти сделки, которые должны завершиться после 1 января 2025 года. |
| Доступен для всех (OPENED): |
В данном поле указывается доступность сделки для всех пользователей. Примеры: - ={Y} - найти сделки, доступные для всех; - ={N} - найти сделки с ограниченным доступом. |
| Завершена (CLOSED): |
В данном поле указывается статус завершённости сделки. Примеры: - ={Y} - найти завершённые сделки; - ={N} - найти незавершённые сделки. |
| Создано пользователем (CREATED_BY_ID): |
В данном поле указывается идентификатор пользователя, создавшего сделку. Примеры: - ={25} - найти сделки, созданные пользователем с ID 25; - ={={=User:ID}} - найти сделки, созданные текущим пользователем; - Используется для фильтрации по автору создания сделки. |
| Изменено пользователем (MODIFY_BY_ID): |
В данном поле указывается идентификатор пользователя, который последним изменял сделку. Примеры: - ={30} - найти сделки, изменённые пользователем с ID 30; - Используется для отслеживания последней активности по сделке. |
| Перемещено пользователем (MOVED_BY_ID): |
В данном поле указывается идентификатор пользователя, который переместил сделку на текущую стадию. Примеры: - ={35} - найти сделки, перемещённые на текущую стадию пользователем с ID 35; - Используется для анализа переходов между стадиями. |
| Дата перемещения (MOVED_TIME): |
В данном поле указывается дата перемещения сделки на текущую стадию. Примеры: - ={={{01.01.2025 00:00:00}}##{{31.01.2025 23:59:59}}} - найти сделки, перемещённые на текущую стадию в январе 2025 года; - ={>={{01.01.2025 00:00:00}}} - найти сделки, перемещённые после 1 января 2025 года. |
| Дополнительная информация (ADDITIONAL_INFO): |
В данном поле указывается дополнительная информация об искомой сделке. Текстовое поле. Примеры: - ={%важно} - найти сделки, в дополнительной информации которых содержится слово "важно"; - Используйте поиск по частичному совпадению для текстовых полей. |
| Лид (LEAD_ID): |
В данном поле указывается идентификатор привязанного к сделке лида. Примеры: - ={789} - найти сделки, привязанные к лиду с ID 789; - ={={=Document:LEAD_ID}} - найти сделки текущего лида из документа; - Используется для поиска сделок по связанным лидам. |
| Местоположение (LOCATION_ID): |
В данном поле указывается местоположение клиента. Служебное поле, не рекомендуется к использованию. Примеры: - ={1} - найти сделки с местоположением ID 1; - Используется редко, так как является служебным полем. |
| Источник данных (ORIGINATOR_ID): |
В данном поле указывается идентификатор источника данных. Используется только для привязки к внешнему источнику. Примеры: - ={EXT_SYSTEM} - найти сделки из внешней системы с идентификатором "EXT_SYSTEM"; - Используется при интеграциях с внешними CRM или системами учёта. |
| Последняя активность пользователем (LAST_ACTIVITY_BY): |
В данном поле указывается идентификатор пользователя, ответственного за последнюю активность в сделке. Примеры: - ={40} - найти сделки, где последняя активность была от пользователя с ID 40; - Используется для анализа активности по сделкам. |
| Время последней активности (LAST_ACTIVITY_TIME): |
В данном поле указывается время последней активности в сделке. Примеры: - ={={{01.01.2025 00:00:00}}##{{31.01.2025 23:59:59}}} - найти сделки с активностью в январе 2025 года; - ={<={=System:NowLocal}} - найти сделки, где активность была недавно. |
Важно о динамических полях:
Активити автоматически создаёт параметры для всех полей сделки, доступных в вашем портале. Помимо описанных выше, могут быть доступны:
- Пользовательские поля (UF_*), созданные администратором;
- Связанные сущности (контакты, компании, лиды);
- Дополнительные поля настроек CRM;
- Специальные поля интеграций.
Для каждого поля поиска рядом создаётся дополнительное поле "Условие поиска" (например, "Заголовок - условие поиска"), которое позволяет выбрать оператор сравнения:
- Равно (=) или = (по умолчанию)
- Не равно (!) или !=
- Больше или равно (>=)
- Меньше или равно (<=)
- Больше (>)
- Меньше (<)
- Содержит (%) - LIKE (поиск по подстроке)
- Не содержит (!%)
- IN (@) - входит в список значений
- NOT IN (!@) - не входит в список значений
- LIKE с позицией (=% или %=) - поиск с явным указанием позиции подстроки
Примечание: Доступность операторов зависит от типа поля. Некоторые операторы (например, LIKE) могут быть недоступны для полей типа перечисления (enumeration), стадий (crm_status) и связанных сущностей.
Активити автоматически создаёт параметры для всех полей сделки, доступных в вашем портале. Помимо описанных выше, могут быть доступны:
- Пользовательские поля (UF_*), созданные администратором;
- Связанные сущности (контакты, компании, лиды);
- Дополнительные поля настроек CRM;
- Специальные поля интеграций.
Для каждого поля поиска рядом создаётся дополнительное поле "Условие поиска" (например, "Заголовок - условие поиска"), которое позволяет выбрать оператор сравнения:
- Равно (=) или = (по умолчанию)
- Не равно (!) или !=
- Больше или равно (>=)
- Меньше или равно (<=)
- Больше (>)
- Меньше (<)
- Содержит (%) - LIKE (поиск по подстроке)
- Не содержит (!%)
- IN (@) - входит в список значений
- NOT IN (!@) - не входит в список значений
- LIKE с позицией (=% или %=) - поиск с явным указанием позиции подстроки
Примечание: Доступность операторов зависит от типа поля. Некоторые операторы (например, LIKE) могут быть недоступны для полей типа перечисления (enumeration), стадий (crm_status) и связанных сущностей.
Символы и операторы поиска
Данные символы ставятся перед содержимым значения в фигурных скобках:
={%ваше значение} - содержит (можно искать буквы и цифры в выбранной вами строке).
Пример: ={%груша} - вернёт все ID сделок, в которых, в выбранном вами поле, содержится слово "груша".
Дополнительный пример: ={%договор} - найдёт все сделки с "договор" в заголовке, комментарии или другом текстовом поле.
={!%ваше значение} - не содержит.
Пример: ={!%123} - это значит, что значение в выбранном поле не содержит 123 (можно искать буквы и цифры в выбранной вами строке).
Дополнительный пример: ={!%архив} - найдёт все сделки, в которых нет слова "архив".
={ваше значение} - равно (точное совпадение).
Пример: ={123} - это значит, что значение в выбранном поле равно 123 (только для полей типа "строка" и "число").
Пример: ={Договор поставки} - найдёт только сделки с точно таким заголовком (регистр имеет значение).
Важно: Если в поле используется текст, то этот текст должен совпадать символ в символ, иначе вы ничего не найдёте.
={!ваше значение} - не равно.
Пример: ={!123} - это значит, что значение в выбранном поле не равно 123 (только для полей типа "строка" и "число").
Дополнительный пример: ={!0} - найдёт все сделки с ненулевой суммой.
={>ваше значение} - больше.
Пример: ={>123} - это значит, что значение в выбранном поле больше 123 (только для поля тип "число").
Дополнительный пример: ={>500000} - найдёт все сделки с суммой больше 500 000 рублей.
={<ваше значение} - меньше.
Пример: ={<123} - это значит, что значение в выбранном поле меньше 123 (только для поля тип "число").
Дополнительный пример: ={<10000} - найдёт все сделки с суммой меньше 10 000 рублей.
={>=ваше значение} - больше или равно.
Пример: ={>=123} - это значит, что значение в поле больше или равно 123 (только для поля тип "число").
Дополнительный пример: ={>=75} - найдёт все сделки с вероятностью 75% и выше.
={<=ваше значение} - меньше или равно.
Пример: ={<=123} - это значит, что значение в поле меньше или равно 123 (только для поля тип "число").
Дополнительный пример: ={<=10000} - найдёт все сделки с суммой не более 10 000 рублей.
={@массив значений} - IN (входит в список). В качестве значения передаётся массив значений, одно из которых должно совпадать с полем.
Пример: ={@{123,456,789}} - найдёт все сделки, у которых ID равен 123, 456 или 789.
Дополнительный пример: ={@{WEB,CALL,EMAIL}} - найдёт все сделки из источников "Веб-сайт", "Звонок" или "Email".
Важно: Значения в массиве должны быть разделены запятыми и указаны в фигурных скобках без пробелов после запятых (или с пробелами, но согласованно).
={!@массив значений} - NOT IN (не входит в список). В качестве значения передаётся массив значений, ни одно из которых не должно совпадать с полем.
Пример: ={!@{123,456}} - найдёт все сделки, у которых ID не равен 123 и не равен 456.
Дополнительный пример: ={!@{F}} - найдёт все сделки, которые не находятся в группе стадий "Провалена" (исключает проваленные сделки).
={%ваше значение} - LIKE (поиск по подстроке). Ищет значение в любой позиции строки. Символ % в значении фильтра передавать не нужно - он применяется автоматически.
Пример: ={%договор} - найдёт все сделки, в которых содержится слово "договор" в любой позиции строки.
Дополнительный пример: ={%123} - найдёт все сделки, в которых в любом месте встречается "123".
Важно: Этот оператор работает аналогично поиску "содержит", но является более явным указанием типа поиска LIKE.
={=значение с %} - LIKE (поиск по подстроке с явным указанием позиции). Символ % нужно передавать в значении для контроля позиции поиска.
Примеры:
- ={=мол%} - найдёт все значения, начинающиеся с "мол" (например: "молоко", "молния");
- ={=%мол} - найдёт все значения, заканчивающиеся на "мол" (например: "мол", "армол");
- ={=%мол%} - найдёт все значения, где "мол" может быть в любой позиции с любыми символами до и после (аналогично простому ={%мол}).
Важно: Используйте этот оператор, когда нужно точно контролировать позицию искомой подстроки в строке. Символ % означает "любые символы" в SQL-подобном синтаксисе LIKE. Помещайте % в нужное место значения: в начале для поиска окончания, в конце для поиска начала, с обеих сторон для поиска в любой позиции.
={%=значение с %} - LIKE (аналогично =%). Альтернативный синтаксис для поиска с явным указанием позиции.
Примеры:
- ={%=мол%} - найдёт все значения, начинающиеся с "мол";
- ={%=%мол} - найдёт все значения, заканчивающиеся на "мол";
- ={%=%мол%} - найдёт все значения, где "мол" может быть в любой позиции.
Примечание: Операторы =% и %= работают идентично, используйте тот, который вам удобнее. Оба требуют явного указания символа % в значении для контроля позиции поиска.
={=ваше значение} - равно (точное совпадение, используется по умолчанию). Явное указание оператора равенства.
Пример: ={=123} - найдёт только сделки с точным значением 123 (эквивалентно ={123}).
Примечание: Если оператор не указан, по умолчанию используется оператор равенства (=).
={!=ваше значение} - не равно. Альтернативный синтаксис для оператора "не равно".
Пример: ={!=123} - найдёт все сделки, значение которых не равно 123 (эквивалентно ={!123}).
Примечание: Операторы != и ! работают идентично, используйте тот, который вам удобнее.
Важные ограничения для операторов LIKE:
Фильтр LIKE (операторы %, =%, %=) не работает с полями следующих типов:
- crm_status (стадии сделок, например поле STAGE_ID);
- crm_contact (связанные контакты);
- crm_company (связанные компании);
- TYPE_ID (тип сделки) и другие поля типа перечисления (enumeration).
Для этих полей используйте только операторы:
- = (равно) - для точного совпадения;
- != или ! (не равно) - для исключения значений;
- @ (IN) - для поиска по списку значений;
- !@ (NOT IN) - для исключения списка значений.
Особое ограничение - поле CONTACT_IDS:
Фильтр не поддерживает поле CONTACT_IDS (идентификаторы связанных контактов).
Для фильтрации сделок по контактам используйте альтернативные методы:
- Используйте активити для работы с контактами, а затем связывайте их со сделками;
- Используйте метод crm.item.list через другие активити для более сложных связей;
- Фильтруйте сделки по другим связанным полям (например, через поле "Контакт" если оно доступно).
Фильтр LIKE (операторы %, =%, %=) не работает с полями следующих типов:
- crm_status (стадии сделок, например поле STAGE_ID);
- crm_contact (связанные контакты);
- crm_company (связанные компании);
- TYPE_ID (тип сделки) и другие поля типа перечисления (enumeration).
Для этих полей используйте только операторы:
- = (равно) - для точного совпадения;
- != или ! (не равно) - для исключения значений;
- @ (IN) - для поиска по списку значений;
- !@ (NOT IN) - для исключения списка значений.
Особое ограничение - поле CONTACT_IDS:
Фильтр не поддерживает поле CONTACT_IDS (идентификаторы связанных контактов).
Для фильтрации сделок по контактам используйте альтернативные методы:
- Используйте активити для работы с контактами, а затем связывайте их со сделками;
- Используйте метод crm.item.list через другие активити для более сложных связей;
- Фильтруйте сделки по другим связанным полям (например, через поле "Контакт" если оно доступно).
Список доступных полей для фильтрации:
Полный список всех доступных полей для фильтрации сделок можно узнать с помощью метода crm.deal.fields.
Активити автоматически создаёт параметры для всех полей, доступных через этот метод в вашем портале.
Если поле не отображается в настройках активити, значит оно либо недоступно для фильтрации, либо имеет ограничения.
Полный список всех доступных полей для фильтрации сделок можно узнать с помощью метода crm.deal.fields.
Активити автоматически создаёт параметры для всех полей, доступных через этот метод в вашем портале.
Если поле не отображается в настройках активити, значит оно либо недоступно для фильтрации, либо имеет ограничения.
Особенности для полей даты и времени:
Если поле не является строкой (число, дата, дата/время), то содержимое ячейки должно заполняться так: ={>=14.03.2020 15:10}, в фигурных скобках указывается необходимый оператор и значение.
Использование переменных:
В случае с переменной, содержимое ячейки должно заполняться так: ={>={=A1988_22222_92566_99999:search_results}} - сначала оператор, затем переменная в фигурных скобках.
Для полей тип "дата" и "дата/время", при необходимости поиска диапазона "от и до" содержимое ячейки должно заполняться так:
={{01.03.2015 14:55:22}}##{{07.05.2015 14:55:22}}
Первая дата в двойных фигурных скобках - начало диапазона, вторая - конец диапазона, разделённые символами ##.
Пример: ={{01.01.2025 00:00:00}}##{{31.01.2025 23:59:59}} - найдёт все сделки, созданные в январе 2025 года.
Дополнительные параметры активити
| Название поля | Описание и примеры использования |
|---|---|
| Делать отладочные сообщения в журнал БП: |
Варианты: да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити. |
| Запускать от имени: | Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы. |
| Устанавливать текст статуса: | Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма. |
| Текст статуса: | В данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса. |
| Ожидать ответа: | Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. |
| Период ожидания. Время ожидания ответа от приложения: |
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается. |
Сценарий работы робота
Примеры использования активити
| Описание примера | Решение |
|---|---|
|
Пример использования №1 - Поиск крупных сделок в работе: Необходимо найти все сделки на стадии "В работе" с суммой больше 500 000 рублей. Результат можно использовать для отправки уведомлений менеджерам или автоматического повышения приоритета. |
Группа стадии: P (Сделка в работе) Сумма: ={>500000} |
|
Пример использования №2 - Поиск сделок за период: Найти все сделки, созданные в январе 2025 года с вероятностью выше 50%. Результат можно использовать для формирования отчёта или массовой рассылки. |
Дата создания: ={{01.01.2025 00:00:00}}##{{31.01.2025 23:59:59}} Вероятность: ={>50} |
|
Пример использования №3 - Поиск сделок конкретного менеджера: Найти все незакрытые сделки определённого менеджера. Можно использовать для контроля работы менеджера или распределения задач. |
Ответственный: ={25} (ID менеджера) Группа стадии: P (Сделка в работе) |
|
Пример использования №4 - Поиск сделок по рекламной кампании: Найти все сделки из конкретной рекламной кампании. Результат можно использовать для анализа эффективности кампании и ROI. |
Обозначение рекламной кампании: ={%летняя_распродажа} Рекламная система: ={%google} |
|
Пример использования №5 - Поиск сделок с просроченными сроками: Найти все сделки, которые должны были закрыться, но ещё не закрыты. Результат можно использовать для автоматического создания задач на контроль или напоминаний. |
Дата завершения (CLOSEDATE): ={<={=System:NowLocal}} Группа стадии: P (Сделка в работе) |
|
Пример использования №6 - Поиск сделок по списку источников (оператор IN @): Найти все сделки из определённых источников для анализа эффективности каналов привлечения. Дополнительный пример: Поиск сделок по списку ID. |
Внешний источник (SOURCE_ID): ={@{WEB,CALL,EMAIL,REFERRAL}} Группа стадии: P (Сделка в работе) ID: ={@{123,456,789,101112}} |
|
Пример использования №7 - Исключение проваленных сделок (оператор NOT IN !@): Найти все активные сделки, исключая проваленные и закрытые. Результат можно использовать для формирования отчётов только по активным сделкам. Дополнительный пример: Исключить сделки определённых типов. |
Группа стадии: ={!@{F}} (исключить группу "Провалена") Группа стадии: ={!@{S}} (исключить группу "Заключена") Или комбинированно: Группа стадии: ={P} (только "В работе") Тип: ={!@{SALE,COMPLEX}} |
|
Пример использования №8 - Поиск сделок с уточнением позиции подстроки (оператор =%): Найти все сделки, названия которых начинаются с определённого префикса. Используется для систематизации и организации сделок с определённой нумерацией или префиксами. Дополнительный пример: Поиск сделок с конкретным окончанием. |
Заголовок: ={=ДОГОВОР%} Найдёт все сделки, заголовок которых начинается с "ДОГОВОР" (например: "ДОГОВОР-123", "ДОГОВОР поставки") Комментарий: ={=%готово} Найдёт все сделки, в комментариях которых есть "готово" в конце строки. |
Возвращаемые параметры данного активити:
- Результат поиска (массив для итератора) (search_results_array) - массив ID найденных сделок, который можно использовать в итераторах для обработки каждой сделки отдельно;
- Результат поиска (строка) (search_results_string) - строка с ID найденных сделок, разделённых запятыми (например: "123,456,789");
- Количество найденных элементов (count_search) - числовое значение, указывающее сколько сделок было найдено;
- Соответствие условиям поиска (math_search_results) - значение "Y" (найдены результаты) или "N" (результатов не найдено), можно использовать для условий ветвления;
- Сообщение об ошибке (s_error_logs) - текст с описанием результатов поиска или ошибки выполнения.
- Результат поиска (массив для итератора) (search_results_array) - массив ID найденных сделок, который можно использовать в итераторах для обработки каждой сделки отдельно;
- Результат поиска (строка) (search_results_string) - строка с ID найденных сделок, разделённых запятыми (например: "123,456,789");
- Количество найденных элементов (count_search) - числовое значение, указывающее сколько сделок было найдено;
- Соответствие условиям поиска (math_search_results) - значение "Y" (найдены результаты) или "N" (результатов не найдено), можно использовать для условий ветвления;
- Сообщение об ошибке (s_error_logs) - текст с описанием результатов поиска или ошибки выполнения.
Важно о возвращаемых параметрах:
Если вы хотите использовать результат работы активити (возвращаемый параметр) в другом активити, в котором параметр - простое число, то несколько чисел разделённых запятыми работать не будут, так как параметр ждёт только одно число.
Если параметр простой - строка, то туда не нужно вставлять результат работы в виде массива для итератора, т.к. данный параметр предназначен для полей с типом заполнения "множественное".
Рекомендации:
- Для итераторов используйте параметр "Результат поиска (массив для итератора)";
- Для простых числовых полей используйте параметр "Результат поиска (строка)" и извлекайте первый ID через функции обработки строк;
- Используйте параметр "Количество найденных элементов" для проверки успешности поиска и условий ветвления.
Обработка ошибок:
Если при поиске возникла ошибка или не указаны параметры для поиска, активити вернёт ошибку с описанием проблемы.
Возможные причины ошибок:
- Не указаны параметры для поиска (все поля пустые);
- Ошибка при выполнении запроса к API Битрикс24;
- Недостаточно прав доступа у указанного пользователя;
- Технические ошибки подключения к серверу.
При успешном поиске, но отсутствии результатов, возвращается:
- Пустой массив и строку;
- Количество найденных элементов: 0;
- Соответствие условиям поиска: "N".
Если вы хотите использовать результат работы активити (возвращаемый параметр) в другом активити, в котором параметр - простое число, то несколько чисел разделённых запятыми работать не будут, так как параметр ждёт только одно число.
Если параметр простой - строка, то туда не нужно вставлять результат работы в виде массива для итератора, т.к. данный параметр предназначен для полей с типом заполнения "множественное".
Рекомендации:
- Для итераторов используйте параметр "Результат поиска (массив для итератора)";
- Для простых числовых полей используйте параметр "Результат поиска (строка)" и извлекайте первый ID через функции обработки строк;
- Используйте параметр "Количество найденных элементов" для проверки успешности поиска и условий ветвления.
Обработка ошибок:
Если при поиске возникла ошибка или не указаны параметры для поиска, активити вернёт ошибку с описанием проблемы.
Возможные причины ошибок:
- Не указаны параметры для поиска (все поля пустые);
- Ошибка при выполнении запроса к API Битрикс24;
- Недостаточно прав доступа у указанного пользователя;
- Технические ошибки подключения к серверу.
При успешном поиске, но отсутствии результатов, возвращается:
- Пустой массив и строку;
- Количество найденных элементов: 0;
- Соответствие условиям поиска: "N".