Элемент Читать данные (Рис. 1) получает из базы данных значения полей необходимых записей для дальнейшего использования в ходе бизнес-процесса.
Всякий раз, когда процессу необходимо работать с базой данных Creatio, должны быть получены (“вычитаны”) значения соответствующих полей. Полученные данные хранятся в исходящих параметрах элемента Читать данные.
Элемент может вычитать данные из любого объекта независимо от прав доступа пользователя, который запускает процесс.
Есть четыре режима чтения данных (Рис. 2).
Читать первую запись из выборки
Элемент Читать данные получает список записей, которые соответствуют фильтру, сортирует их и читает значения полей первой записи из отфильтрованного и отсортированного списка. Например, можно вычитать заголовок, тип определенной активности или ответственного по ней.
Считать функцию
Элемент Читать данные получает список записей, которые соответствуют фильтру, и подсчитывает указанную функцию (сумму, среднее, минимальное или максимальное значение). Например, можно подсчитать длительность всех активностей определенного пользователя за период. Возможные варианты функций:
-
Сумма (только по числовым полям) — элемент вычисляет сумму значений в определенных полях записей, соответствующих условиям фильтрации.
-
Среднее (только по числовым полям) — элемент вычисляет среднее арифметическое значений определенного поля в записях, соответствующих условиям фильтрации.
-
Минимальное (по датам и числовым полям) — элемент анализирует соответствующие условиям фильтра записи и определяет минимальное значение в указанном поле.
-
Максимальное (по датам и числовым полям) — элемент анализирует соответствующие условиям фильтра записи и определяет максимальное значение в указанном поле.
Результат функции передается в исходящий параметр элемента.
Считать количество записей
Элемент Читать данные получает список записей, которые соответствуют фильтру, а затем подсчитывает количество записей в списке и передает результат в свой исходящий параметр. Например, можно подсчитать количество контрагентов определенного менеджера по работе с клиентами. Также этот режим используется для проверки наличия отдельных записей в системе, например, есть ли в базе данных контакт с определенным ФИО или номером телефона.
Читать коллекцию записей
Элемент Читать данные получает список записей, которые соответствуют фильтру, сортирует их и вычитывает значения полей указанного количества записей (например, первые 50 записей из отфильтрованного и отсортированного списка).
Данные, полученные из множества записей, передаются в специальный параметр типа “Коллекция”. Параметры типа “коллекция” содержат вложенные параметры (Рис. 3), которые представляют собой колонки вычитанных записей. Например, если вычитать имена, даты рождения и должности всех контактов определенного контрагента, то результирующий параметр коллекции будет содержать вложенные параметры “ФИО”, “Дата рождения” и “Название должности”.
Коллекция вычитанных записей будет выглядеть так:
|
ФИО |
Должность |
Дата рождения |
|---|---|---|
|
Ольга Варенская |
Менеджер по работе с клиентами |
12.04.1991 |
|
Андрей Валевский |
Менеджер по продажам |
24.10.1985 |
|
Александра Ульяненко |
Системный администратор |
05.12.1989 |
Коллекцию записей можно передать в другой параметр типа “коллекция”. Например, коллекцию записей можно передать в элемент Вызвать веб-сервис, в параметрах вызова которого есть параметр с типом “коллекция”. Также обработать параметры типа “коллекция” можно с помощью элемента Задание-сценарий. Например, можно использовать сценарий для преобразования коллекций записей в отдельные записи, которые можно передать в другие элементы процесса.