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

Продукты
Все продукты

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

Рис. 1 —  Элемент процесса Читать данные
scr_process_designer_read_data00017.png

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ФИО

Должность

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

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

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

12.04.1991

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

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

24.10.1985

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

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

05.12.1989

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

Примеры использования