Lookup reference#
Основные сведения#
Шаг “Lookup Reference” используется для поиска ссылок на экземпляры (instances) компонента по внешним ключам. Этот процесс требует, чтобы в компоненте, в которой производится поиск, было настроено как минимум одно поле (property) с флагом “Primary key”.
Поиск осуществляется по этому полю, и результат поиска в виде Id (integer) найденной записи будет записан в переменную, указанную в поле “Field name”. Если экземпляр компонента с таким ключом не найден, переменная будет иметь значение null.
Параметры#
Настройки Шага:
Поле настройки |
Варианты значений |
Назначение |
|---|---|---|
Step name |
- |
Наименование шага |
Source step |
- |
Выбор предыдущего шага |
Component |
- |
Компонент, в котором осуществляется поиск |
Field name |
- |
Имя поля, куда будет записан результат поиска |
Кейсы#
Поиск по первичным ключам: Используется для определения наличия и идентификации экземпляров компонент по уникальным идентификаторам.
Связывание данных компонентов: Подходит для сценариев, где требуется связать данные из разных компонентов на основе уникальных ключей.
Исключения#
Требование наличия первичного ключа: Необходимо, чтобы в компоненте был настроен первичный ключ для успешного поиска.
Обработка отсутствующих записей: В случае отсутствия экземпляра с указанным ключом, значение переменной будет null, что может потребовать дополнительной обработки.
Вариант применения#
Этот компонент использует шаг Lookup Reference для поиска идентификатора записи в таблице “Задание на сортировку” по введенному номеру сортировки. После ввода номера сортировки и выполнения датафлоу, на фронт-энде отображается соответствующий идентификатор записи.
Вы можете скачать конфигурацию компонента здесь