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