Пошук сутностей у фабриці даних (Search for entities in data factory)

🌐 Цей документ доступний українською та англійською мовами. Використовуйте перемикач у правому верхньому куті, щоб змінити версію.
Таблиця 1. Короткі відомості про делегат
Назва Пояснення

Бізнес-назва інтеграційного розширення

Search for entities in data factory

Службова назва інтеграційного розширення

${dataFactoryConnectorSearchDelegate}

Назва файлу у бібліотеці розширень

dataFactoryConnectorSearchDelegate.json

1. Загальний опис

Розширення використовується для пошуку сутностей у фабриці даних.

Розгляньмо приклад використання делегата в рамках референтного бізнес-процесу (див. детальніше — Вибір та виконання дій з одного чи декількох рядків у таблиці).

На основі створеної моделі даних, делегат виконуватиме пошук та вибірку ліцензій з таблиці licenses. Таблиця licenses містить наступні стовпці:

  • license_id — унікальний ідентифікатор ліцензії (UUID).

  • number — номер ліцензії (TEXT).

  • date_received — дата отримання ліцензії (DATE).

  • date_terminated — дата припинення ліцензії (DATE).

  • full_name — повне ім’я органу ліцензування (TEXT).

  • licensing_status — статус ліцензії (тип даних license_status).

Тип даних license_status є переліком з двома можливими значеннями:

  • active (чинна) — ліцензія є дійсною.

  • canceled (анульована) — ліцензія скасована.

Делегат використовує умову пошуку (Search Condition) search_licenses_by_status, яка дозволяє фільтрувати ліцензії в таблиці licenses за статусом ліцензування. У цьому випадку, задача шукає ліцензії зі статусом active (чинні).

Таким чином, делегат виконує пошук активних ліцензій у таблиці licenses на основі визначених умов пошуку, передаючи системний токен доступу для авторизації запиту до бази даних.

2. Налаштування шаблону у бізнес-процесі

Змоделюйте сервісну задача (Service Task) та використайте делегат Search for entities in data factory.

Параметри які використовуються для налаштування та отримання результатів пошуку:

  1. У секції Inputs встановіть вхідний параметр resource як search-licenses-by-status для визначення ресурсу/API-ендпоінту, який слід використати для пошуку.

    Тут — ендпоінт search-licenses-by-status генерується на базі критерію пошуку search_licenses_by_status, визначеного у моделі даних.

  2. У секції Inputs > Search variables передайте параметри пошуку, які необхідно застосувати, як ключі-значення (Map):

    • Key: licensingStatus

    • Value: active

      У цьому випадку, ми шукаємо ліцензії зі статусом active.

  3. У секції Inputs > X-Access-Token передайте системний токен доступу для авторизації запита:

    ${system_user().accessToken}

  4. У секції Outputs > Result variable встановіть вихідний параметр як змінну licensesResponse, до якої зберігатиметься відповідь від бази даних для подальшого використання.

edit grid rows action 1