Поиск вариаций товара

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

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

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

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

Название поля	Описание и примеры использования
ID главного товара	В данном поле указывается числовой идентификатор (ID) главного товара, вариации которого нужно найти. Это необязательный параметр. Примеры использования: - 30287 - найти все вариации товара с ID 30287; - {=Document:PRODUCT_ID} - использовать ID товара из поля документа (сделки); - {=Variable:PRODUCT_ID} - использовать ID товара из переменной предыдущего активити (робота); - {=A1988_22222_92566_99999:product_id} - использовать ID товара из результата поиска; - {=Iterator:Value} - использовать ID товара для каждого элемента в итераторе. Важно: Если указан ID главного товара, будут найдены только вариации, принадлежащие этому товару. Можно комбинировать с другими параметрами поиска для более точной фильтрации.
Наименование	В данном поле указывается наименование вариации товара для поиска. Это необязательный параметр. Примеры использования: - Тест вариации - найти вариации с точным наименованием; - {=Variable:VARIANT_NAME} - использовать наименование из переменной; - Можно использовать операторы поиска для частичного совпадения (зависит от настроек поиска).
Активность	В данном поле указывается статус активности вариации товара для поиска. Это необязательный параметр. Примеры использования: - Y - найти только активные вариации; - N - найти только неактивные вариации; - {=Variable:ACTIVE_STATUS} - использовать статус из переменной.
Доступность к покупке	В данном поле указывается статус доступности вариации товара для покупки. Это необязательный параметр. Примеры использования: - Y - найти только доступные для покупки вариации; - N - найти только недоступные для покупки вариации.
Доступное количество	В данном поле указывается количество товара на складе для поиска. Это необязательный параметр. Примеры использования: - 0 - найти вариации с нулевым количеством; - {=Variable:QUANTITY} - найти вариации с указанным количеством; - Можно использовать операторы сравнения (>, <, >=, <=) для поиска по диапазону.
Ограничение количества результатов	В данном поле указывается максимальное количество результатов поиска, которые нужно вернуть. Это необязательный параметр. Примеры использования: - 10 - вернуть только первые 10 результатов; - 50 - вернуть только первые 50 результатов; - {=Variable:LIMIT} - использовать ограничение из переменной. Важно: Если параметр не указан, будут возвращены все найденные результаты. Рекомендуется использовать ограничение при больших объёмах данных для оптимизации производительности.

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

Описание примера	Решение
Поиск всех вариаций товара по ID главного товара	Параметры: ID главного товара - {=Document:PRODUCT_ID}. Активити (робот) вернёт массив ID всех вариаций указанного товара в параметре search_results_array.
Поиск активных вариаций товара с наличием на складе	Параметры: ID главного товара - {=Variable:PRODUCT_ID}, Активность - Y, Доступность к покупке - Y, Доступное количество - >0. Активити (робот) вернёт только активные и доступные вариации с наличием на складе.
Поиск вариаций товара по наименованию	Параметры: Наименование - {=Variable:VARIANT_NAME}. Активити (робот) вернёт все вариации с указанным наименованием в параметре search_results_array.
Поиск неактивных вариаций товара	Параметры: ID главного товара - {=Document:PRODUCT_ID}, Активность - N. Активити (робот) вернёт все неактивные вариации указанного товара.
Поиск вариаций товара с нулевым количеством	Параметры: ID главного товара - {=Variable:PRODUCT_ID}, Доступное количество - 0. Активити (робот) вернёт все вариации с нулевым количеством на складе.
Поиск вариаций товара с ограничением результатов	Параметры: ID главного товара - {=Document:PRODUCT_ID}, Ограничение количества результатов - 10. Активити (робот) вернёт только первые 10 найденных вариаций.
Поиск вариаций товара для массовой обработки	Параметры: ID главного товара - {=Iterator:Value}, Активность - Y. Активити (робот) вернёт активные вариации для каждого товара из итератора в параметре search_results_array.
Поиск доступных для покупки вариаций товара	Параметры: ID главного товара - {=Variable:PRODUCT_ID}, Доступность к покупке - Y, Доступное количество - >0. Активити (робот) вернёт только вариации, доступные для покупки и имеющие товар на складе.
Поиск вариаций товара по нескольким критериям	Параметры: ID главного товара - {=Document:PRODUCT_ID}, Активность - Y, Доступность к покупке - Y, Доступное количество - >5. Активити (робот) вернёт активные и доступные вариации с количеством больше 5.
Поиск первой вариации товара	Параметры: ID главного товара - {=Variable:PRODUCT_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-запросы для оптимизации производительности.

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

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

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

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

Ваша корзина пуста

Поиск вариаций товара