Работа с банком данных
Этот раздел содержит описание шагов, отвечающих за этапы работы с банком данных.
Запись объекта
Шаг предназначен для записи выбранного объекта в банк данных. Успешная запись объекта гарантирована только в случае если записываемый объект является типом, данных принадлежащим к банку данных.
Для записи объекта необходимо произвести следующие настройки на вкладке Основные шага:
В поле Описание указывается текст, который будет отображаться в названии шага на схеме.
В поле Комментарий указывается подробная информация об использовании шага при настройке процесса.
В поле Объекты указывается объект для записи.
В поле Время ожидания указывается время ожидания ответа в миллисекундах.
Флажок Проверять версию устанавливается для сравнения версий при совместной работе нескольких пользователей с одним объектом и предотвращения перезаписи данных при одновременном внесении изменений.
Из шага возможны следующие выходы:
Выход + : если запись прошла успешно и за указанный во времени ожидания период от банка получен идентификатор объекта.
Выход — : если за указанный период запись не завершена, идентификатор объекта не получен.
Выход ↓ : клонирование процесса вне зависимости от результатов записи (параллельное выполнение).
Выход О из левой части шага: исключение, срабатывает при возникновении ошибки.
Примечание
Если указать простую переменную для записи, при применении схемы система вернет ошибку. Если указать тип данных, не принадлежащих к банку данных, то при выполнении шага система вернет ошибку с сообщением о том, что тип данных не принадлежит ни одному банку.
Если запись в банк данных произведена успешно и ответ от банка получен, можно получить ссылку (guid записи, сделанной в банке), выполнив маппинг из переменной EntityID на вкладке Результат выполнения.
Запись объектов
Шаг предназначен для записи массива объектов.
Для записи массива объектов необходимо произвести следующие настройки на вкладке Основные шага:
В поле Описание указывается текст, который будет отображаться в названии шага на схеме.
В поле Комментарий указывается подробная информация об использовании шага при настройке процесса.
В поле Объекты указывается перечень объектов для записи. Также доступен выбор переменной типа данных, являющегося сохраняемым (объект банка данных) из выпадающего меню при нажатии на кнопку ….
В поле Время ожидания указывается время ожидания ответа от банка данных в мс.
Флажок Проверять версию устанавливается для сравнения версий при совместной работе нескольких пользователей с одним объектом и предотвращения перезаписи данных при одновременном внесении изменений.
Из шага возможны следующие выходы:
Выход + : если запись прошла успешно и за указанный во времени ожидания период от банка получен идентификатор объекта.
Выход — : если за указанный период запись не завершена, идентификатор объекта не получен.
Выход ↓ : клонирование процесса вне зависимости от результатов записи (параллельное выполнение).
Выход О из левой части шага: исключение, срабатывает при возникновении ошибки.
Поиск
Шаг предназначен для поиска записей в банке данных. Условия поиска задаются на вкладке Основные:
В поле Описание указывается текст, который будет отображаться в названии шага на схеме.
В поле Комментарий указывается подробная информация об использовании шага при настройке процесса.
В поле Тип данных указывается тип данных для поиска. Также доступен выбор значения переменной из выпадающего меню при нажатии на кнопку ….
В поле Размер страницы указывается количество записей, среди которых будет происходить поиск. Также доступен выбор значения переменной из выпадающего меню при нажатии на кнопку ….
Флажок Ручная пагинация включает опцию постраничного поиска (по умолчанию не установлен). При установке флажка будет отображено поле Номер страницы для указания номера страницы, на которой будет происходить поиск. Например, если всего записей в банке 10, размер страницы = 5 и номер страницы = 0, то поиск будет запущен только по первым 5 записям. Если размер страницы = 15, номер страницы = 1, то поиск гарантировано не даст результата, так как поиск будет запущен на 16-30 записи. Также доступен выбор значения переменной из выпадающего меню при нажатии на кнопку ….
В поле Условия сортировки указывается условие для определения вида сортировки результатов поиска. По умолчанию происходит сортировка по возрастанию. Есть возможность отсортировать результаты поиска по значениям конкретного поля; для этого укажите путь к соответствующему полю. При необходимости сортировки по убыванию добавьте в конце условия DESC.
В поле Условие поиска: указывается поле и его значение, по которым будет происходить поиск.
В результате поиска создается массив записей указанного типа данных. Для массива можно выполнить маппинг на вкладке Результат выполнения.
Из шага возможны следующие выходы:
Выход + : если записи найдены в соответствии с условиями поиска.
Выход О из нижней части шага: если записи не найдены.
Выход О из левой части шага: исключение, срабатывает при возникновении ошибки.
Удаление
Шаг предназначен для удаления выбранного объекта или массива объектов из банка данных.
В выпадающем меню Объекты необходимо выбрать системную переменную необходимого типа данных с заполненным полем EntityId. Из банка будет удалена запись или массив записей с указанным в переменной EntityId (остальные поля переменной не принимаются во внимание).
Примечание
Если при удалении передавать объект, то он целиком передается в банк данных. Достаточно передать только ссылку на объект, так как для удаления не обязательно требуется весь объект. Для этого при выборе переменной можно выбрать не объект, а переменную типа LinkType или OwnList<LinkType>.
Для удаления объекта необходимо произвести следующие настройки на вкладке Основные шага:
В поле Описание указывается текст, который будет отображаться в названии шага на схеме.
В поле Комментарий указывается подробная информация об использовании шага при настройке процесса.
В поле Объекты указывается объект или массив объектов для удаления. Также доступен выбор переменной типа данных, являющегося сохраняемым (объект банка данных) из выпадающего меню при нажатии на кнопку ….
В поле Время ожидания указывается время ожидания ответа от банка данных в мс.
Флажок Проверять версию устанавливается для сравнения версий при совместной работе нескольких пользователей с одним объектом и предотвращения перезаписи данных при одновременном внесении изменений.
Из шага возможны следующие выходы:
Выход + : если запись прошла успешно удалена за указанный период времени.
Выход — : если за указанный период времени запись не удалена.
Выход ↓ : клонирование процесса.
Выход О из левой части шага: исключение, срабатывает при возникновении ошибки.
Получение объекта
Шаг предназначен для получения записи из банка по ее EntityId. При настройке необходимо заполнить EntityId записи или выбрать переменную, в которой она содержится, а также выбрать тип данных искомой записи. В результате будет получена запись указанного типа.
Примечание
Для использования результата получения в схеме необходимо выполнить маппинг на вкладке Результат выполнения.
Для получения объекта необходимо произвести следующие настройки на вкладке Основные шага:
В поле Описание указывается текст, который будет отображаться в названии шага на схеме.
В поле Комментарий указывается подробная информация об использовании шага при настройке процесса.
В поле Идентификатор указывается тип EntityId объекта, который необходимо получить из банка данных. Также доступен выбор значения переменной из выпадающего меню при нажатии на кнопку ….
В выпадающем меню Тип данных выбирается тип данных объекта. Также доступен выбор значения переменной из выпадающего меню при нажатии на кнопку ….
Из шага возможны следующие выходы:
Выход + : если объект получен.
Выход О из нижней части шага: если объект не найден.
Выход О из левой части шага: исключение, срабатывает при возникновении ошибки.
Шаги из папки Источники
Шаги из папки Источники используются для получения сообщения от выбранной системы. При необходимости можно указать обработчик системы, время ожидания и выполнить маппинг полученного от системы сообщения в какую-либо переменную на вкладке Результат выполнения.
Получение объектов
Применение и настройка шага аналогичны шагу Получение объекта. При этом на входе задается массив идентификаторов объектов одного типа и сам тип искомых данных. Шаг считается успешно выполненным (уходит по пути +), если был найден хотя бы один объект из запрошенных. На вкладке Результат выполнения для маппинга доступны следующие массивы:
Объекты: массив найденных объектов указанного типа данных.
НеНайдено: массив ссылок на ненайденные объекты.
Для получения объектов необходимо произвести следующие настройки на вкладке Основные шага:
В поле Описание указывается текст, который будет отображаться в названии шага на схеме.
В поле Комментарий указывается подробная информация об использовании шага при настройке процесса.
В поле Идентификатор указывается массив EntityId объектов, которые необходимо получить из банка данных. Также доступен выбор значения переменной из выпадающего меню при нажатии на кнопку ….
В выпадающем меню Тип данных выбирается тип данных объектов. Также доступен выбор значения переменной из выпадающего меню при нажатии на кнопку ….
Из шага возможны следующие выходы:
Выход + : если объекты получены.
Выход О из нижней части шага: если объекты не найдены.
Выход О из левой части шага: исключение, срабатывает при возникновении ошибки.
Запрос, Запрос значений, Запрос объектов
Шаги предназначены для получения информации из банка данных.
На вкладке Основные доступны следующие настройки шагов:
В поле Описание указывается текст, который будет отображаться в названии шага на схеме.
В поле Комментарий указывается подробная информация об использовании шага при настройке процесса.
В поле Тип данных указывается тип данных искомого объекта или значения. Также доступен выбор значения переменной из выпадающего меню при нажатии на кнопку ….
Поле текстового редактора, в котором помещается запрос получения информации из банка данных.
Из шага возможны следующие выходы:
Выход + : если результаты успешно получены в ходе запроса.
Выход О из нижней части шага: если результаты не получены.
Выход О из левой части шага: исключение, срабатывает при возникновении ошибки.
Для настройки шага нужно указать тип данных, являющийся объектом банка данных, и ввести SQL-запрос в поле. Результатом успешного выполнения запроса является ответ банка. Ответ находится в переменных Результаты и Количество на вкладке Результат выполнения. Результат выполнения запроса можно получить путем выполнения маппинга переменной Результаты в переменную процесса.