Comment on page
Найти записи
Используется, чтобы найти записи в Бипиуме, установив ограничения на выборку в качестве видов или фильтров. Процессы имеют доступ к записям минуя правовую политику.
Указать каталог
Способ выбора каталога для поиска записи. Доступные варианты:
из списка
и через переменную
. Вариант «из списка» подойдет, когда вы знаете в каком каталога хотите найти запись. Вариант «через переменную» используется, если нужно искать запись в разных каталогах в зависимости от логики в сценарии.Каталог
Свойство доступно при выбранном значении
Указать каталог = Из списка
. Выбор каталога из числа доступных в системе для поиска записи. Формат: выбор из списка каталогов.ID каталога
Свойство доступно при выбранном значении
Указать каталог = Через переменную
. Идентификатор (ID) каталога, в котором нужно найти запись. Формат: значение/выражение.Фильтр
Фильтр предназначен для выборки записей. Формат значения: идентификатор поля = "значение"/выражение. Значения для разных типов полей:
- Для текстовых полей:
"текст"
(поиск идет не по точному совпадению, а по вхождению) - Для дат, чисел, прогресса — поиск по диапазону:
{ "at": '...', "to": '...' }
- Для поиска пустых дат можно использовать "NULL_DATE"
- Для категории, набора галочек, вопроса, звёзд — массив:
[1, 2, 3, 5]
- Для контактов:
"текст"
(поиск по вхождению + телефоны отчищаются от спецсимволов) - Для связанных объектов — массив объектов:
[ {"catalogId": 18, "recordId": 9}, {"catalogId": 18, "recordId": 10} ]
- Для сотрудников — массив идентификаторов сотрудников:
[21, 22]
В поле «Id поля» можно передать переменные при помощи вложенных шаблонов.
Синтаксис
${выражение} =
значениеВид
Список правовых видов выбранного каталога. Формат: список видов.
Сортировать по
Позволяет задать сортировку по выбранному полю. Формат: список полей в выбранном каталоге.
Поля
Способ указания какие поля записи должны вернуться в результате. Доступные варианты:
все поля
и заданные
. Вариант «все поля» вернет все поля каталога, включая расширенные поля связанных записей, которые заданы в настройках полей каталога. Вариант «заданные» позволяет указать какие именно поля вернуть, в том числе и расширенные поля у связанных записей.ID полей
Свойство доступно при выбранном значении
Поля = Заданные
. Массив идентификаторов (API ID) полей каталога, указанных через запятую. Ограничение списка полей уменьшает размер данных в сценарии, и увеличивает скорость их получения. Также компонент позволяет получить любые расширенные поля у связанных записей. Формат: значение/выражение.[
{
fieldId: IDполя1,
fields: {
IDкаталога1: [ IDрасширенногоПоля1, IDрасширенногоПоля2, ... ],
IDкаталога2: [ IDрасширенногоПоля3, IDрасширенногоПоля4, ... ],
...
}
},
{
fieldId: IDполя2,
...
}
]
IDполяX
— поле выбранного каталогаIDкаталогаХ
— Идентификатор каталога связанного каталога. Поле «связанные каталог» может иметь несколько источников. Для каждого каталога источника можно указать какие именно поля нужно получить.IDрасширенногоПоляХ
— идентификаторы полей связанного каталога, которые нужно получить.
Количество записей
Максимальное количество возвращаемых записей (максимум 1000, по умолчанию - 100). Формат: значение/выражение.
Начиная с
Используется в связке с параметром «Количество записей». Если записей много и для возврата записей используется цикл, то позволяет задать начальный порядковый номер записи (не ID), с которого будет отсчитан лимит возвращаемых записей. По умолчанию 0. Например, если указано 200, а количество записей = 100, то будет возвращены записи с 201 по 300. Формат: значение/выражение.
Сохранить в
Выходной параметр. Сохранит результат в указанную переменную. Формат: имя переменной. Компонент возвращает массив записей:
[
{
id: '11',
title: 'Название записи',
values: {
'field_id' : 'field_value',
...
}
},
{...}
]
В поле «Сохранить в» можно указать ключ объекта и данные сохранятся как значения этого ключа.
Пример
Если указать в поле «Сохранить в