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