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

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

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

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

Если в выпадающем списке нет списка, в котором расположен искомый элемент, то причин может быть 3:

Вы создали список уже после установки активити, и чтобы активити "увидело" этот список, его (активити) нужно переустановить.
Количество списков более 100, либо у списков слишком большая вложенность. У Б24 есть ограничение по размеру файла, в котором описан перечень списков и элементов, которые они содержат. Если размер файла превышает лимит, то активити попросту не увидит некоторые списки.
У меню с выпадающим списком есть ограничение на отображение не более 50 элементов.

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

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

По какому полю выполнять поиск: позволяет выбрать тип поля, по которому будет выполняться поиск.
Доступно 4 варианта типов полей:

Вид поля "Код" (Код пользовательского поля);
Тип "Детальное описание";
Тип "Анонс" (Предварительное описание);
Тип "Название элемента";
Тип "Код штатного поля". Узнать тип поля можно в редакторе полей (действия>настроить поля).

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

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

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

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

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

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

Если поиск элементов осуществляется по "Код штатного поля", то коды штатных полей Б24 можно узнать перейдя в справку.
В случае, когда осуществляется поиск по штатному полю с кодом "DATE_CREATE" (Дата создания элемента), правильное заполнение поля выглядит так: #DTДата.Месяц.Год.

Пример: #DT23.06.2022.

Пример: NAIMENOVANIE_MATERIALA

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

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

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

Данные символы ставятся перед содержимым ячейки:
={%ваше значение} - содержит (можно искать буквы и цифры в выбранной вами строке).
Пример заполнения: ={%груша}, вернет все ID сущностей, в которых, в выбранном вами поле, содержится слово "груша".

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

={ваше значение} - равно.
Пример заполнения: ={123} , это значит, что значение в выбранном поле равно 123. (только для поля тип "строка" и "число").
Если в поле используется текст, то этот текст должен совпадать символ в символ, иначе вы ничего не найдете.

={!ваше значение} - не равно.
Пример заполнения: ={!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}}
Вид пользовательского поля: это тип пользовательского поля (строка, число и прочее смотря какой у вас) заполняется на английском.
Код поля: берется в настройках поля из адресной строки.
Пример заполнения:
datetime##UF_CRM_1611588337##{{01.03.2015 14:55:22}}##{{07.05.2015 14:55:22}}

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

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

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

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

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

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

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

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

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

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

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

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