Получить запись
Last updated
Last updated
Используется для получения значений полей конкретной записи из Бипиума по её идентификатору. Процессы имеют доступ к записям минуя правовую политику.
Указать каталог
Способ выбора каталога для получения записи. Доступные варианты: из списка
и через переменную
. Вариант «из списка» подойдет, когда вы знаете из какого каталога хотите получить запись. Вариант «через переменную» используется, если нужно получить запись из разных каталогов в зависимости от логики в сценарии.
Каталог
Свойство доступно при выбранном значении Указать каталог = Из списка
. Выбор каталога из числа доступных в системе для получения записи. Формат: выбор из списка каталогов.
ID каталога
Свойство доступно при выбранном значении Указать каталог = Через переменную
. Идентификатор (ID) каталога, из которого нужно получить запись. Формат: значение/выражение.
ID записи Идентификатор (ID) записи, которую нужно получить. Формат: значение/выражение.
Поля
Способ указания какие поля записи должны вернуться в результате. Доступные варианты: все поля
и заданные
. Вариант «все поля» вернет все поля каталога, включая расширенные поля связанных записей, которые заданы в настройках полей каталога. Вариант «заданные» позволяет указать какие именно поля вернуть, в том числе и расширенные поля у связанных записей.
ID полей
Свойство доступно при выбранном значении Поля = Заданные
. Массив идентификаторов (API ID) полей каталога, указанных через запятую. Ограничение списка полей уменьшает размер данных в сценарии, и увеличивает скорость их получения. Также компонент позволяет получить любые расширенные поля у связанных записей. Формат: значение/выражение.
Формат указания :
IDполяX
— поле выбранного каталога
IDрасширенногоПоляХ
— идентификаторы полей связанного каталога, которые нужно получить.
[ 4, {fieldId: 5, fields: { 27: [2,6]} }, 8, {fieldId: 9, fields: { 19: [3,4]} } ]
Получает 4, 5, 8 и 9 поля. Для 5 поля дополнительно возвращаются 2 и 6 поле у связанных записей из каталога 27, а для 9 поля — 3 и 4 поле у записей из каталога 19.
Сохранить в Выходной параметр. Сохранит результат в указанную переменную. Формат: имя переменной.
Переменная с результатом («сохранить в») содержит объект values — значения полей записи. Ключи объекта — идентификаторы полей. Формат значений для разных типов полей разный:
Однострочный текст = "Однострочный текст"
Многострочный текст = "Многострочный текст"
Дата = "2015-11-06T21:00:00.000Z"
Категория / набор галочек = [2]
или несколько значений [2,3,4]
, без значения []
Вопрос = 2
Число = 3.2
Прогресс = 28
(допустимо от 0 до 100)
Звезды = 5
(допустимо от 0 до 5)
Контакт = массив объектов [{"contact": "8-901-234-56-78", comment: "Секретарь"}, {...}]
Адрес = объект предоставляемый из DaData
Связанная запись = массив объектов[ {catalogId: '11',recordId: '91', catalogTitle: 'Название каталога', recordTitle: 'Название записи', isRemoved: false}, {...} ]
Сотрудник = массив объектов
[{id: '21', title: 'Имя', isRemoved: false}, {...}]
Файл = массив объектов
Компонент поддерживает 2 типа пограничных событий:
Ошибка — выход из компонента, если произошла какая-либо ошибка
Таймаут — выход из компонента, спустя заданное ограничение по времени
Если компонент завершился с ошибкой, но на нем не было пограничного события, то процесс завершается. Сообщение ошибки возвращается в результатах процесса.
IDкаталогаХ
— Идентификатор каталога связанного каталога. Поле «» может иметь несколько источников. Например каталог «Договор» в поле контрагент может ссылаться на каталоги «Клиентов», «Партнеров» и «Подрядчиков». Для каждого каталога источника можно указать какие именно поля требуется получить.
[ {title: "имя", url: "http://путь", size: 45654, mimeType: "image/png"}, {...} ]
где mimeType
—
Чтобы получить значение, например, 4-го поля записи, используйте компонент и укажите выражение r.values['4']
.