Поиск элемента списка

Данное активити позволяет находить элементы списков, указав содержимое данного элемента и место, где стоит искать данный элемент. Поиск может быть осуществлен по любым полям, и результат поиска выводится в массив.
Результатом работы является получение ID элемента списка.

Сценарий работы активити бизнес-процесса

Где искать элемент: из выпадающего списка выбирается месторасположение искомого элемента, путем выбора списка, в котором элемент может находится.
Если поле является списком, то нужно искать ID элемента, а не его значение.
Для этого нужно:
1. Перейти в режим редактирования элемента списка
2. Нажать F12 и выбрать селектор элементов страницы.
3. Выбрать поле со списком.
4. Внизу появится список с ID.
Если осуществляется поиск списка групп, то поле "Где искать элемент" не заполняется.

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

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

По какому полю выполнять поиск: позволяет выбрать тип поля, по которому будет выполняться поиск.
Доступно 4 варианта типов полей: Вид поля "Код"; Тип "Детальное описание"; Тип "Анонс"; Тип "Имя". Узнать тип поля можно в редакторе полей (действия>настроить поля).

1. Если выбран тип "Привязка к элементам CRM" и указана только одна сущность (любая), то осуществлять поиск нужно по ID.

2. Если установлен тип "Код" и указанно несколько сущностей(любых), то поиск нужно осуществлять по ID с префиксом.

Префиксы(Содержимое искомого поля):
L_26635 - Лид
C_843 - Контакт
CO_709 - Компания
D_839 - Сделка

Тип поля "код" устанавливается при создании поля в редакторе полей.
Поиск элемента по типу поля "код" не будет работать, если не указать данный тип поля при создании его в редакторе полей.
Это же правило распространяется на тип поля "Строка" или "Число"

CODE - это обозначение вида пользовательских полей при вводе параметров поиска. Оно относится к любым пользовательским полям, вне зависимости от того, какого ого типа (Например: Число, строка, дата и.т.д)
NAME, DETAIL_TEXT, PREVIEW_TEXT - это системные виды полей.

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

Пример: NAIMENOVANIE_MATERIALA

Тип условия поиска: в данном поле указывается условие для поиска элемента.
Доступны варианты: равно, не равно, больше или равно, меньше или равно, больше, меньше, содержит, не содержит.

ВАЖНО!
Для полей тип "Список" нельзя использовать числовые значения, например "Содержит 283".

Содержимое искомого элемента: в данном пункте указывается название искомого элемента списка.
Пример: Трос

Данные символы ставятся перед содержимым ячейки:
% содержит, поиск в строке выглядит так (без пробелов):"%123", это значит, что мы ищем 123. (можно искать буквы и цифры в выбранной вами строке).

!% не содержит, Пример заполнения !%123 , это значит, что значение в поле не содержит 123 (можно искать буквы и цифры в выбранной вами строке).

= равно, Пример заполнения: =123 , это значит, что значение в поле равно 123. (только для поля тип "строка" и "число").
Если в поле используется текст, то этот текст должен совпадать символ в символ, иначе вы ничего не найдете.
Для полей тип "список", работает только условие "=" и сравнивается с ID элемента (эти ID можно найти в свойствах товара, либо через F12+просмотр элементов).

! не равно, Пример заполнения !123 , это значит, что значение в поле не равно 123 (только для поля тип "строка" и "число").

> больше, Пример заполнения >123 , это значит, что значение в поле больше 123 (только для поля тип "число").

< меньше, Пример заполнения <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}}

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

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

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.

Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Если вы хотите использовать результат работы активити (возвращаемый параметр) в другом активити, в котором параметр - простое число, то несколько чисел разделенных запятыми работать не будут, так как параметр ждет только одно число.
Если параметр простой - строка, то туда не нужно вставлять результат работы в виде массива для итератора, так как данный параметр предназначен для полей с типом заполнения "множественное".

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Сообщение об ошибке
- Соответствует условиям
- ID элемента списка (первый, если больше 1)
- Результат поиска (массив для итератора)

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

Поиск элемента списка