Документация по настройке процессов

Элемент процесса [Читать данные]

Элемент [Читать данные] (Рис. 92) получает из базы данных значения полей необходимых записей для дальнейшего использования в ходе бизнес-процесса.

Рис. 92 — Элемент процесса [Читать данные]

scr_process_designer_read_data00017.png 

Всякий раз, когда процессу необходимо работать с базой данных bpm’online, должны быть получены (“вычитаны”) значения соответствующих полей. Полученные данные хранятся в исходящих параметрах элемента [Читать данные].

Элемент может вычитать данные из любого объекта независимо от прав доступа пользователя, который запускает процесс.

Есть четыре режима чтения данных (Рис. 93).

Рис. 93 — Выбор режима чтения данных

scr_chapter_bpms_data_read_mode.png 

[Читать первую запись из выборки]

Элемент [Читать данные] получает список записей, которые соответствуют фильтру, сортирует их и читает значения полей первой записи из отфильтрованного и отсортированного списка. Например, можно вычитать заголовок, тип определенной активности или ответственного по ней.

[Считать функцию]

Элемент [Читать данные] получает список записей, которые соответствуют фильтру, и подсчитывает указанную функцию (сумму, среднее, минимальное или максимальное значение). Например, можно подсчитать длительность всех активностей определенного пользователя за период. Возможные варианты функций:

  • Сумма (только по числовым полям) — элемент вычисляет сумму значений в определенных полях записей, соответствующих условиям фильтрации.

  • Среднее (только по числовым полям) — элемент вычисляет среднее арифметическое значений определенного поля в записях, соответствующих условиям фильтрации.

  • Минимальное (по датам и числовым полям) — элемент анализирует соответствующие условиям фильтра записи и определяет минимальное значение в указанном поле.

  • Максимальное (по датам и числовым полям) — элемент анализирует соответствующие условиям фильтра записи и определяет максимальное значение в указанном поле.

Результат функции передается в исходящий параметр элемента.

[Считать количество записей]

Элемент [Читать данные] получает список записей, которые соответствуют фильтру, а затем подсчитывает количество записей в списке и передает результат в свой исходящий параметр. Например, можно подсчитать количество контрагентов определенного менеджера по работе с клиентами. Также этот режим используется для проверки наличия отдельных записей в системе, например, есть ли в базе данных контакт с определенным ФИО или номером телефона.

[Читать коллекцию записей]

Элемент [Читать данные] получает список записей, которые соответствуют фильтру, сортирует их и вычитывает значения полей указанного количества записей (например, первые 50 записей из отфильтрованного и отсортированного списка).

Данные, полученные из множества записей, передаются в специальный параметр типа “Коллекция”. Параметры типа “коллекция” содержат вложенные параметры (Рис. 94), которые представляют собой колонки вычитанных записей. Например, если вычитать имена, даты рождения и должности всех контактов определенного контрагента, то результирующий параметр коллекции будет содержать вложенные параметры “ФИО”, “Дата рождения” и “Название должности”.

Рис. 94 — Пример параметра коллекции

scr_chapter_bpms_data_array_params.png 

Коллекция вычитанных записей будет выглядеть так:

ФИО

Должность

Дата рождения

Ольга Варенская

Менеджер по работе с клиентами

12.04.1991

Андрей Валевский

Менеджер по продажам

24.10.1985

Александра Ульяненко

Системный администратор

05.12.1989

Коллекцию записей можно передать в другой параметр типа “коллекция”. Например, коллекцию записей можно передать в элемент [Вызвать веб-сервис], в параметрах вызова которого есть параметр с типом “коллекция”. Также обработать параметры типа “коллекция” можно с помощью элемента [Задание-сценарий]. Например, можно использовать сценарий для преобразования коллекций записей в отдельные записи, которые можно передать в другие элементы процесса.

Примеры использования элемента [Читать данные]

Информация об использовании элемента доступна ниже:

Смотрите далее

Элемент процесса [Добавить данные]

Элемент процесса [Изменить данные]

Элемент процесса [Удалить данные]

Элемент процесса [Формула]

Элемент процесса [Изменить права доступа]

Элемент процесса [Задание-сценарий]

Элемент процесса [Привязать процесс к объекту]

Элемент процесса [Выполнить действие процесса]

Был ли данный материал полезен?

Как можно улучшить эту статью?