Поиск торгового каталога

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

• Поиск торговых каталогов по идентификатору информационного блока;
• Поиск каталогов по типу информационного блока;
• Поиск каталогов по идентификатору каталога;
• Поиск каталогов по сайту (lid);
• Поиск каталогов по названию;
• Поиск каталогов по идентификатору родительского информационного блока товаров;
• Поиск каталогов по идентификатору свойства SKU;
• Фильтрация каталогов по параметрам продажи контента;
• Поиск каталогов по идентификатору НДС;
• Фильтрация каталогов по параметру экспорта в Яндекс.Маркет;
• Ограничение количества результатов поиска;
• Автоматизация процессов на основе найденных каталогов.

Как работает активити (робот):
- Активити (робот) автоматически получает список всех доступных полей торгового каталога из CRM вашего портала;
- Для каждого поля (кроме недоступных для поиска) создаётся параметр, который можно использовать для фильтрации;
- Поддерживается поиск по различным параметрам каталога (идентификатор блока, тип блока, название и т.д.);
- Можно указать ограничение на количество возвращаемых результатов;
- Результаты возвращаются в виде массива ID каталогов, строки с ID через запятую, первого и последнего ID, количества найденных каталогов;
- Активити (робот) работает через REST API Битрикс24 (catalog.catalog.list);
- Поддерживается обработка больших объёмов данных (более 50 каталогов) через batch-запросы.

Активити (робот) анализирует указанные параметры поиска и находит торговые каталоги, удовлетворяющие заданным условиям. Для поиска можно использовать любые доступные поля каталога. Результатом будет массив ID найденных каталогов и дополнительная информация о результатах поиска.

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

Название поля	Описание и примеры использования
Идентификатор информационного блока	В данном поле указывается идентификатор информационного блока для поиска каталогов. Это необязательный параметр типа "Число". Примеры: - 21 - найти каталоги с идентификатором информационного блока 21; - {=Variable:IBLOCK_ID} - использовать ID из переменной предыдущего активити (робота); - {=Document:IBLOCK_ID} - использовать ID из поля документа.
Тип информационного блока	В данном поле указывается тип информационного блока для поиска каталогов. Это необязательный параметр типа "Строка". Примеры: - CRM_PRODUCT_CATALOG - найти каталоги с типом "CRM_PRODUCT_CATALOG"; - {=Variable:IBLOCK_TYPE} - использовать тип из переменной предыдущего активити (робота).
Идентификатор каталога	В данном поле указывается идентификатор каталога для поиска. Это необязательный параметр типа "Число". Примеры: - 21 - найти каталог с идентификатором 21; - {=Variable:CATALOG_ID} - использовать ID из переменной предыдущего активити (робота).
Сайт	В данном поле указывается код сайта (lid) для поиска каталогов. Это необязательный параметр типа "Строка". Примеры: - s1 - найти каталоги для сайта s1; - {=Variable:SITE_ID} - использовать код сайта из переменной предыдущего активити (робота).
Название	В данном поле указывается название каталога для поиска. Это необязательный параметр типа "Строка". Примеры: - Товарный каталог CRM - найти каталоги с названием "Товарный каталог CRM"; - {=Variable:CATALOG_NAME} - использовать название из переменной предыдущего активити (робота).
Идентификатор родительского информационного блока товаров	В данном поле указывается идентификатор родительского информационного блока товаров. Это необязательный параметр типа "Число". Примеры: - 22 - найти каталоги с идентификатором родительского блока 22; - {=Variable:PARENT_IBLOCK_ID} - использовать ID из переменной предыдущего активити (робота).
Идентификатор свойства, в котором храниться ссылка на родительский элемент информационного блока Товаров	В данном поле указывается идентификатор свойства SKU. Это необязательный параметр типа "Число". Примеры: - 15 - найти каталоги с идентификатором свойства SKU 15; - {=Variable:SKU_PROPERTY_ID} - использовать ID из переменной предыдущего активити (робота).
Продажа контента	В данном поле указывается параметр продажи контента (Y/N). Это необязательный параметр типа "Да/Нет". Примеры: - Да (Y) - найти каталоги с включенной продажей контента; - Нет (N) - найти каталоги с отключенной продажей контента.
Идентификатор НДС	В данном поле указывается идентификатор НДС для поиска каталогов. Это необязательный параметр типа "Число". Примеры: - 5 - найти каталоги с идентификатором НДС 5; - {=Variable:VAT_ID} - использовать ID из переменной предыдущего активити (робота).
Экспортировать в Яндекс.Маркет	В данном поле указывается параметр экспорта в Яндекс.Маркет (Y/N). Это необязательный параметр типа "Да/Нет". Примеры: - Да (Y) - найти каталоги с включенным экспортом в Яндекс.Маркет; - Нет (N) - найти каталоги с отключенным экспортом в Яндекс.Маркет.
Ограничение количества результатов	В данном поле можно указать максимальное количество возвращаемых результатов поиска. Это необязательный параметр типа "Число". Если не указано, возвращаются все найденные каталоги. Примеры: - 10 - вернуть только первые 10 найденных каталогов; - 50 - вернуть только первые 50 найденных каталогов; - {=Variable:LIMIT} - использовать ограничение из переменной предыдущего активити (робота).

Важно: Для выполнения поиска необходимо указать хотя бы один параметр поиска. Если все параметры пусты, активити (робот) вернёт ошибку "Ни один параметр для поиска не был заполнен".

Возвращаемые параметры

После успешного выполнения поиска активити (робот) возвращает следующие параметры:

math_search_results - результат поиска (Y - найдены каталоги, N - каталоги не найдены);
count_search - количество найденных каталогов (число);
search_results_array - массив ID найденных каталогов (множественное поле типа "Число");
search_results_string - строка с ID найденных каталогов через запятую (например: "21,22,23");
search_result_first_string - ID первого найденного каталога (строка);
search_result_last_string - ID последнего найденного каталога (строка);
s_error_logs - сообщение об ошибке или информационное сообщение (строка).

Важно о возвращаемых параметрах: Если поиск не дал результатов, параметр math_search_results будет равен "N", а параметр s_error_logs будет содержать сообщение об ошибке "Каталоги не найдены". Массив search_results_array будет пустым.

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

Описание примера	Решение
Найти каталог по идентификатору информационного блока 21	Идентификатор информационного блока — 21. Результат: search_results_array содержит [21], search_results_string = "21", search_result_first_string = "21", search_result_last_string = "21", count_search = 1.
Найти каталоги с типом "CRM_PRODUCT_CATALOG" и ограничить результат до 5 каталогов	Тип информационного блока — CRM_PRODUCT_CATALOG; Ограничение количества результатов — 5. Результат: search_results_array содержит массив ID (максимум 5 элементов), count_search показывает количество найденных каталогов.
Найти каталог по названию "Товарный каталог CRM"	Название — Товарный каталог CRM. Результат: search_results_array содержит ID найденного каталога, search_results_string содержит строку с ID.
Найти каталоги с включенным экспортом в Яндекс.Маркет	Экспортировать в Яндекс.Маркет — Да (Y). Результат: search_results_array содержит массив ID всех каталогов с включенным экспортом.
Найти каталоги по идентификатору НДС из переменной	Идентификатор НДС — {=Variable:VAT_ID}. Результат: search_results_array содержит ID каталогов с указанным НДС.
Найти каталоги для конкретного сайта с ограничением результатов	Сайт — s1; Ограничение количества результатов — 10. Результат: search_results_array содержит максимум 10 ID каталогов для сайта s1.
Найти каталоги по нескольким параметрам одновременно	Идентификатор информационного блока — 21; Тип информационного блока — CRM_PRODUCT_CATALOG; Название — Товарный каталог CRM. Результат: search_results_array содержит ID каталогов, удовлетворяющих всем условиям.
Найти каталоги с отключенной продажей контента	Продажа контента — Нет (N). Результат: search_results_array содержит ID всех каталогов с отключенной продажей контента.
Использовать результат поиска в итераторе для обработки каждого каталога	Идентификатор информационного блока — {=Variable:IBLOCK_ID}. Результат: search_results_array передаётся в итератор, который обрабатывает каждый найденный каталог. В итераторе используется {=Iterator:Value} для получения ID текущего каталога.
Найти первый каталог и использовать его ID в следующем активити	Идентификатор информационного блока — 21. Результат: search_result_first_string содержит ID первого найденного каталога, который можно использовать в следующем активити как {=A1988_22222_92566_99999:search_result_first_string}.

Пример возвращаемых данных

При успешном выполнении поиска активити (робот) возвращает данные в следующем формате:

Пример данных каталога:
"iblockId": "21"
"iblockTypeId": "CRM_PRODUCT_CATALOG"
"id": "21"
"lid": "s1"
"name": "Товарный каталог CRM"
"productIblockId": null
"skuPropertyId": null
"subscription": "N"
"vatId": "5"
"yandexExport": "N"

Возвращаемые параметры активити:
math_search_results = "Y"
count_search = 1
search_results_array = ["21"]
search_results_string = "21"
search_result_first_string = "21"
search_result_last_string = "21"
s_error_logs = "catalog_catalog_search_error_2: 1"

Примечание: Если найдено несколько каталогов, массив search_results_array будет содержать все ID найденных каталогов, а search_results_string будет содержать строку с ID через запятую (например: "21,22,23"). Параметр search_result_first_string содержит ID первого элемента массива, а search_result_last_string - ID последнего элемента массива.