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

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

• Поиск товаров по ID каталога;
• Поиск товаров по различным характеристикам (наименование, код, размеры, вес);
• Фильтрация товаров по параметрам активности и доступности;
• Поиск товаров по количеству на складе;
• Поиск товаров по ценам и валюте;
• Фильтрация товаров по режиму количественного учета;
• Поиск товаров с определёнными свойствами (размер, цвет, артикул);
• Массовый поиск товаров для обработки в итераторе;
• Поиск активных или неактивных товаров;
• Автоматизация процессов на основе найденных товаров.

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

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

Название поля	Описание и примеры использования
Каталог	В данном поле указывается каталог товаров, в котором необходимо выполнить поиск. Это обязательный параметр. Выбирается из выпадающего списка доступных каталогов. Примеры использования: - Выбрать каталог из списка - выбрать нужный каталог из выпадающего списка; - {=Variable:CATALOG_ID} - использовать ID каталога из переменной предыдущего активити (робота); - {=Document:CATALOG_ID} - использовать ID каталога из поля документа. Важно: Убедитесь, что выбранный каталог существует в системе. Если каталог с указанным ID не существует, активити (робот) завершится с ошибкой.
Наименование	В данном поле указывается наименование товара для поиска. Это необязательный параметр. Примеры использования: - Тест товара - найти товары с точным наименованием; - {=Variable:PRODUCT_NAME} - использовать наименование из переменной; - Можно использовать операторы поиска для частичного совпадения (зависит от настроек поиска).
Активность	В данном поле указывается статус активности товара для поиска. Это необязательный параметр. Примеры использования: - Y - найти только активные товары; - N - найти только неактивные товары; - {=Variable:ACTIVE_STATUS} - использовать статус из переменной.
Доступность к покупке	В данном поле указывается статус доступности товара для покупки. Это необязательный параметр. Примеры использования: - Y - найти только доступные для покупки товары; - N - найти только недоступные для покупки товары.
Доступное количество	В данном поле указывается количество товара на складе для поиска. Это необязательный параметр. Примеры использования: - 0 - найти товары с нулевым количеством; - {=Variable:QUANTITY} - найти товары с указанным количеством; - Можно использовать операторы сравнения (>, <, >=, <=) для поиска по диапазону.

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

Описание примера	Решение
Поиск всех товаров в каталоге	Параметры: Каталог - {=Variable:CATALOG_ID}, Наименование - не указывать. Активити (робот) вернёт массив ID всех товаров указанного каталога в параметре search_results_array.
Поиск активных товаров с наличием на складе	Параметры: Каталог - {=Variable:CATALOG_ID}, Активность - Y, Доступность к покупке - Y, Доступное количество - >0. Активити (робот) вернёт только активные и доступные товары с наличием на складе.
Поиск товаров по наименованию	Параметры: Каталог - {=Variable:CATALOG_ID}, Наименование - {=Variable:PRODUCT_NAME}. Активити (робот) вернёт все товары с указанным наименованием в параметре search_results_array.
Поиск неактивных товаров	Параметры: Каталог - {=Variable:CATALOG_ID}, Активность - N. Активити (робот) вернёт все неактивные товары указанного каталога.
Поиск товаров с нулевым количеством	Параметры: Каталог - {=Variable:CATALOG_ID}, Доступное количество - 0. Активити (робот) вернёт все товары с нулевым количеством на складе.
Поиск товаров с ограничением результатов	Параметры: Каталог - {=Variable:CATALOG_ID}, Ограничение количества результатов - 10. Активити (робот) вернёт только первые 10 найденных товаров.
Поиск товаров для массовой обработки	Параметры: Каталог - {=Variable:CATALOG_ID}, Активность - Y. Активити (робот) вернёт активные товары для каждого каталога из итератора в параметре search_results_array.
Поиск доступных для покупки товаров	Параметры: Каталог - {=Variable:CATALOG_ID}, Доступность к покупке - Y, Доступное количество - >0. Активити (робот) вернёт только товары, доступные для покупки и имеющие товар на складе.
Поиск товаров по нескольким критериям	Параметры: Каталог - {=Variable:CATALOG_ID}, Активность - Y, Доступность к покупке - Y, Доступное количество - >5. Активити (робот) вернёт активные и доступные товары с количеством больше 5.
Поиск первого товара	Параметры: Каталог - {=Variable:CATALOG_ID}, Ограничение количества результатов - 1. Активити (робот) вернёт первый найденный товар в параметре search_result_first_string.

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

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

Важно о возвращаемых параметрах: Если товары не найдены, параметр math_search_results будет равен "N", а count_search будет равен 0. Всегда проверяйте значение math_search_results перед использованием результатов поиска в дальнейших шагах бизнес-процесса.


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

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

Проверка существования товаров:
Активити (робот) проверяет существование товаров по указанным критериям. Если товары не найдены, активити (робот) вернёт math_search_results = "N" и count_search = 0.

Обработка больших объёмов данных:
При поиске большого количества товаров (более 50) активити (робот) автоматически обрабатывает результаты через batch-запросы для оптимизации производительности.

Ограничение количества результатов:
Рекомендуется использовать параметр "Ограничение количества результатов" при больших объёмах данных для оптимизации производительности и уменьшения времени выполнения активити (робота).

Порядок параметров:
Параметр "Каталог" всегда отображается первым в списке параметров активити (робота) для удобства использования.

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

Производительность:
При массовом поиске товаров через итератор рекомендуется ограничивать количество результатов поиска. Для массового поиска используйте модуль "Массовый запуск Бизнес-процессов".