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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ФИО	Должность	Дата рождения
Ольга Варенская	Менеджер по работе с клиентами	12.04.1991
Андрей Валевский	Менеджер по продажам	24.10.1985
Александра Ульяненко	Системный администратор	05.12.1989

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

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

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