Функции обработки данных¶
Закладка “Функции” доступна в обоих режимах: простом и расширенном.
Общие сведения¶
Функции обработки данных используются в правилах качества и предназначены для выполнения с данными заданных действий. Для работы функции необходимы входные данные, которые реализуются входящими портами. Результаты работы (обработанные данные или значения проверки) направляются в исходящие порты.
Различаются виды функций:
Стандартные. Доступны по умолчанию. Представляют собой простые действия, например, удаление лишних пробелов.
Композитные. Создаются в пользовательском интерфейсе при помощи специального редактора. Композитная функция может использовать одну или несколько простых функций, а также специальные блоки, такие как условие.
Кастомные. Реализуются на языке Java и загружаются в систему в виде JAR-файлов.
В закладке «Функции» доступны следующие действия:
Тестовый запуск¶
Чтобы протестировать функцию:
Найдите требуемую функцию в списке функций, расположенном в левой части экрана.
Выделите функцию.
В результате действия отроется описание функции.
Укажите тестовое значение для входящих портов функции.
Нажмите кнопку «Тестировать».
В результате действия в исходящих портах будет отображен результат работы функции. Например, если во входящих портах функции сложения будут указаны числа, то исходящий порт отобразит сумму чисел.
Рисунок 1 – Свойства функции и кнопка тестирования
Композитные функции¶
Для создания композитной функции:
Убедитесь, что включен режим черновика.
Нажмите кнопку «Создать», расположенную в нижней части списка функций.
В результате действия над кнопкой откроется список вариантов создания.
Выберите пункт «Композитная».
В результате действия отроется окно настройки новой функции.
Нажмите кнопку «Редактировать», расположенную в верхнем правом углу окна настройки функции.
Укажите основные настройки функции:
Имя.
Отображаемое имя.
Установите необходимые режимы обработки функции: глобальный и/или локальный. Подробнее о режимах: см. Режимы обработки функции.
Настройте композитную функцию в визуальном редакторе:
Добавьте входящие порты, нажав кнопку «Добавить» на соответствующем блоке.
Добавьте исходящие порты, нажав кнопку «Добавить» на соответствующем блоке.
При необходимости перетащите блоки функций, расположенные в списке слева.
Установите связи между блоками.
Сохраните изменения. Нажмите кнопку «Сохранить», расположенную в верхнем правом углу окна настройки функции.
После того как все данные введены и сохранены, опубликуйте черновик.
Для клонирования композитной функции:
Убедитесь, что включен режим черновика.
Наведите курсор на строку необходимой композитной функции и нажмите на кнопку “Клонировать” в правом конце строки.
В открывшемся окне заполните Имя и Отображаемое имя новой функции.
Нажмите “Сохранить”. В результате действия функция будет клонирована, и откроется окно с параметрами функции.
После того как все данные введены и сохранены, опубликуйте черновик.
Режимы обработки функции¶
Глобальный (GLOBAL). Режим обработки, при котором функция обрабатывает порт единожды, вне зависимости от объема коллекции атрибутов, которые в него попадают.
Локальный (LOCAL). Режим обработки, при котором функция обрабатывает порт столько раз, сколько атрибутов было собрано в коллекцию.
Особенности контекста выполнения:
В режиме GLOBAL функция обрабатывает порт единожды, вне зависимости от объема коллекции;
GLOBAL является режимом по умолчанию;
Режим LOCAL позволяет исключать из обработки те атрибуты, которые могут привести к ошибкам выполнения функции в процессе сбора коллекции атрибутов.
В режиме LOCAL функция обрабатывает порт столько раз, сколько атрибутов было собрано в коллекцию;
В режиме LOCAL могут быть выбраны порты либо выше по структуре, либо 1 уровень ниже от указанного комплексного атрибута;
Атрибуты, выбранные выше контекста, являются прямыми предками атрибутов (родители и прародители), указанных в контексте;
Каждая стандартная функция обработки данных поддерживает один из режимов. Для отдельных стандартных функций доступен выбор между режимами. Информация о режиме обработки указана в разделе «Функции» при выборе стандартной функции из списка;
При создании композитной функции доступен выбор возможных режимов обработки;
При реализации сторонней функции также необходимо указание значения параметра, который указывает доступные режимы обработки;
Upath-выражение, указанное в поле «Контекст выполнения» должно совпадать с выражениями входящих и исходящих портов.
Добавление кастомной функции¶
Для добавления кастомной функции:
Убедитесь, что включен режим черновика.
Убедитесь, что кастомная функция была добавлена в систему как библиотека.
Нажмите кнопку «Создать», расположенную в нижней части списка функций.
В результате действия над кнопкой откроется список вариантов создания.
Выберите пункт «Java».
В результате действия откроется мастер добавления функций.
На первом шаге выделите требуемую библиотеку.
На втором шаге добавьте одну или несколько функций, содержащихся в библиотеке.
На третьем шаге укажите для каждой функции группу, логическое и отображаемое имя. При необходимости, добавьте описание.
Нажмите «Добавить».
После того как все данные введены и сохранены, опубликуйте черновик.
Настройка групп функций¶
Для создания новой группы:
Наведите курсор на строку корневой группы и нажмите кнопку “Добавить вложенную группу”.
Введите имя новой группы и нажмите Enter.
Для редактирования имени группы:
Для удаления группы наведите курсор на строку необходимой группы, нажмите и подтвердите действие.
По окончании настройки групп опубликуйте черновик