Встроенные соединители в Azure Logic Apps

Статья
04/15/2024

Встроенные соединители предоставляют возможности для управления расписанием и структурой для рабочего процесса, запуска собственного кода, управления данными и выполнения других задач в рабочих процессах. В отличие от управляемых соединителей, многие встроенные соединители не привязаны к определенной службе, системе или протоколу. Например, с помощью триггера "Повторение" можно запустить практически любой рабочий процесс по расписанию. А с помощью триггера "Запрос" вы можете сделать так, чтобы рабочий процесс ожидал вызова. Все встроенные соединители выполняются в среде выполнения Azure Logic Apps. Для использования некоторых из них даже не нужно создавать подключения.

Для меньшего количества служб, систем и протоколов Azure Logic Apps предоставляет встроенную версию вместе с управляемой версией. Количество и диапазон встроенных соединителей зависят от того, создаете ли рабочий процесс приложения логики потребления, который выполняется в мультитенантных приложениях логики Azure Logic Apps или рабочий процесс приложения логики уровня "Стандартный", работающий в однотенантных Azure Logic Apps. Как правило, производительность, набор возможностей, стоимость и остальные характеристики лучше у встроенной версии. В некоторых случаях некоторые встроенные соединители доступны только в одном типе рабочего процесса приложения логики, а не в другом.

Например, рабочий процесс уровня "Стандартный" может использовать управляемые соединители и встроенные соединители для Хранилище BLOB-объектов Azure, Azure Cosmos DB, Центры событий Azure, Служебная шина Azure, FTP, IBM DB2, IBM MQ, SFTP и SQL Server. Рабочий процесс потребления не имеет встроенных версий. Рабочий процесс потребления может использовать встроенные соединители для Azure Управление API и службы приложение Azure, а рабочий процесс уровня "Стандартный" не имеет встроенных соединителей.

Кроме того, в рабочих процессах уровня "Стандартный" некоторые встроенные соединители с определенными атрибутами называются поставщиками услуг. Некоторые встроенные соединители поддерживают только один способ проверки подлинности подключения в основной службе. Другие встроенные соединители могут предложить выбор, например использование строка подключения, идентификатора Microsoft Entra или управляемого удостоверения. Все встроенные соединители выполняются в том же процессе, что и среда выполнения Azure Logic Apps. Дополнительные сведения см. в разделе "Один клиент" и "Мультитенантная" и среда службы интеграции (ISE).

В этой статье представлен общий обзор встроенных соединителей в рабочих процессах потребления и стандартных рабочих процессах.

Сравнение встроенных соединителей для категорий "Потребление" и "Стандартный"

В следующей таблице перечислены текущие и расширяющиеся коллекции встроенных соединителей, доступных для рабочих процессов "Потребление" и "Стандартный". Для стандартных рабочих процессов звездочка (*) помечает встроенные соединители на основе модели поставщика услуг, которая подробно описана далее.

Потребление	Стандартные
Управление API Azure службы приложение Azure Функции Azure Azure Logic Apps Пакета Управления Операции с данными Время даты Неструктурированный файл HTTP Встроенный код Учетная запись интеграции Жидкости (запрос). Расписание Переменные XML	AS2 (версия 2) Поиск по искусственному интеллекту Azure* служба автоматизации Azure* Хранилище BLOB-объектов Azure* Azure Cosmos DB* издатель Сетка событий Azure* Центры событий Azure* Служба хранилища файлов Azure* Функции Azure Azure Key Vault* Azure OpenAI* Служба хранилища очереди Azure* Служебная шина Azure* Таблица Azure служба хранилища* Пакетные операции Управления Операции сопоставления данных Операции с данными Время даты EDIFACT Файловая система* Неструктурированный файл FTP* HTTP IBM 3270* IBM CICS* IBM DB2* Файл узла IBM* IBM IMS* IBM MQ* Встроенный код Учетная запись интеграции JDBC* Операции с жидкостью (запрос). RosettaNet SAP* Расписание SFTP* SMTP* SQL Server* SWIFT Переменные Операции рабочего процесса X12 Операции XML

Потребление

Стандартные

Управление API Azure
службы приложение Azure
Функции Azure
Azure Logic Apps
Пакета
Управления
Операции с данными
Время даты
Неструктурированный файл
HTTP
Встроенный код
Учетная запись интеграции
Жидкости
(запрос).
Расписание
Переменные
XML

AS2 (версия 2)
Поиск по искусственному интеллекту Azure*
служба автоматизации Azure*
Хранилище BLOB-объектов Azure*
Azure Cosmos DB*
издатель Сетка событий Azure*
Центры событий Azure*
Служба хранилища файлов Azure*
Функции Azure
Azure Key Vault*
Azure OpenAI*
Служба хранилища очереди Azure*
Служебная шина Azure*
Таблица Azure служба хранилища*
Пакетные операции
Управления
Операции сопоставления данных
Операции с данными
Время даты
EDIFACT
Файловая система*
Неструктурированный файл
FTP*
HTTP
IBM 3270*
IBM CICS*
IBM DB2*
Файл узла IBM*
IBM IMS*
IBM MQ*
Встроенный код
Учетная запись интеграции
JDBC*
Операции с жидкостью
(запрос).
RosettaNet
SAP*
Расписание
SFTP*
SMTP*
SQL Server*
SWIFT
Переменные
Операции рабочего процесса
X12
Операции XML

Встроенные соединители на основе поставщика службы

В стандартных рабочих процессах встроенный соединитель, имеющий следующие атрибуты, неофициально называется поставщиком услуг:

Основан на модели расширяемости Функций Azure.
Предоставляет доступ к службе из стандартного рабочего процесса, например Хранилище BLOB-объектов Azure, Служебная шина Azure, Центры событий Azure, SFTP и SQL Server.

Некоторые встроенные соединители поддерживают только один способ проверки подлинности подключения в основной службе. Другие встроенные соединители могут предложить выбор, например использование строка подключения, идентификатора Microsoft Entra или управляемого удостоверения.
Запускается в том же процессе, что и усовершенствованная среда выполнения Azure Logic Apps.

Встроенные соединители на основе поставщика услуг доступны вместе с версиями управляемых соединителей.

Напротив, встроенный соединитель, который не является поставщиком услуг, имеет следующие атрибуты:

Не основан на модели расширяемости Функций Azure.
Напрямую реализуется как задание в среде выполнения Azure Logic Apps, например как операции расписания, HTTP, запросов или XML.

Пользовательские встроенные соединители

Для стандартных рабочих процессов можно создать собственный встроенный соединитель с той же встроенной моделью расширения соединителя, которая используется встроенными соединителями на основе поставщика услуг, такими как Хранилище BLOB-объектов Azure, Центры событий Azure, Служебная шина Azure, SQL Server и многое другое. Эта реализация интерфейса основана на модели расширяемости Функции Azure и предоставляет возможность создания настраиваемых встроенных соединителей, которые могут использовать любой пользователь в стандартных рабочих процессах.

Для рабочих процессов потребления нельзя создавать собственные встроенные соединители, но создавать собственные управляемые соединители.

Дополнительные сведения см. в следующей документации:

Универсальные встроенные соединители

Для выполнения стандартных задач можно использовать следующие встроенные соединители.

Выполнение рабочих процессов по настраиваемым и расширенным расписаниям. Дополнительные сведения о планировании см . в описании поведения повторения соединителей в Azure Logic Apps.
Создание структуры рабочих процессов и управление ею, например с помощью циклов и условий.
Работа с переменными, датами, операциями с данными, преобразованиями содержимого и пакетными операциями.
Взаимодействие с другими конечными точками с использованием триггеров и действий HTTP.
Отправка запросов и ответов на запросы.
Вызов собственных функций (Функции Azure) и других рабочих процессов Azure Logic Apps, способных принимать запросы и выполнять другие задачи.

Запланировать

Повторение — запуск рабочего процесса с определенной периодичностью.

Скользящее окно
(только рабочий процесс потребления):
запуск рабочего процесса, которому нужно обрабатывать постоянно поступающие блоки данных.

Задержка — приостановка выполнения рабочего процесса на определенный срок.

Задержка до — приостановка выполнения рабочего процесса до указанного сочетания даты и времени.

HTTP

Вызов конечной точки HTTP или HTTPS через триггер или действие HTTP.

Также вы можете использовать следующие встроенные действия и триггеры HTTP:

Запросить

При получении HTTP-запроса — ожидание запроса от другого рабочего процесса, приложения или службы. Этот триггер позволяет вызывать рабочий процесс без проверки или опроса по расписанию.

Ответ — ответ на запрос, полученный триггером При получении HTTP-запроса в том же рабочем процессе.

Пакетная обработка

Пакетная обработка сообщений — запуск рабочего процесса, который обрабатывает пакеты сообщений.

Отправка сообщений на пакетную обработку — вызов существующего рабочего процесса, для которого уже настроен триггер Пакетная обработка сообщений.

Файловая система
(Только стандартный рабочий процесс)

Подключение файловой системе на сетевом компьютере для создания файлов и управления ими.

FTP
(Только стандартный рабочий процесс)

Подключение на FTP-сервер или FTPS в виртуальной сети Azure, чтобы вы могли работать с файлами и папками.

SFTP
(Только стандартный рабочий процесс)

Подключение на сервер SFTP в виртуальной сети Azure, чтобы вы могли работать с файлами и папками.

SMTP
(Только стандартный рабочий процесс)

Подключение на SMTP-сервер, чтобы отправить сообщение электронной почты.

Встроенные соединители для определенных служб и систем

Для доступа к определенным службам и системам можно использовать следующие встроенные соединители. В рабочих процессах уровня "Стандартный" некоторые из этих встроенных соединителей также называются поставщиками услуг, которые могут отличаться от своих коллег управляемых соединителей в некотором смысле.

Поиск по искусственному интеллекту Azure
(Только стандартный рабочий процесс)

Подключение в поиск ИИ, чтобы можно было выполнять индексирование документов и операции поиска в рабочем процессе.

Управление API Azure
(только рабочий процесс потребления)

Вызов собственных триггеров и действий через API, которые вы определяете, администрируете и публикуете, используя Управление API Azure.

Примечание. Не поддерживается при использовании уровня "Потребление" Управления API.

Службы приложений Azure
(только рабочий процесс потребления)

Вызов приложений, которые вы создаете и размещаете в Службе приложений Azure, например приложения API или веб-приложения.

Если добавлена платформа Swagger, определенные этими приложениями триггеры и действия отображаются в Azure Logic Apps как любые другие триггеры и действия первого класса.

Служба автоматизации Azure
(Только стандартный рабочий процесс)

Подключение учетные записи служба автоматизации Azure, чтобы создавать задания служба автоматизации Azure и управлять ими.

Хранилище BLOB-объектов Azure
(Только стандартный рабочий процесс)

Подключитесь к учетной записи службы Хранилища BLOB-объектов, чтобы создавать содержимое больших двоичных объектов и управлять им.

Azure Cosmos DB
(Только стандартный рабочий процесс)

подключение к Azure Cosmos DB, чтобы получать доступ к документам Azure Cosmos DB и управлять ими.

Издатель Сетка событий Azure
(Только стандартный рабочий процесс)

Подключение Сетка событий Azure для программирования на основе событий с помощью семантики pub-sub.

Центры событий Azure
(Только стандартный рабочий процесс)

Использование событий и их публикация в концентраторе событий. Например, получите выходные данные из рабочего процесса с помощью Центров событий, а затем отправьте их поставщику аналитики в режиме реального времени.

Хранилище файлов Azure
(Только стандартный рабочий процесс)

Подключение в учетную запись служба хранилища Azure, чтобы можно было создавать, обновлять и управлять файлами.

Функции Azure

Вызов в рабочем процессе функций, размещенных в Azure, для выполнения собственных фрагментов кода (на C# или Node.js).

Azure Key Vault
(Только стандартный рабочий процесс)

Подключение в Azure Key Vault для хранения, доступа к секретам и управления ими.

Приложения логики Azure
(рабочий процесс потребления)

–или–

Операции рабочего процесса
(Стандартный рабочий процесс)

Вызов других рабочих процессов, которые запускаются с помощью триггера "Запрос" типа При получении HTTP-запроса.

Azure OpenAI
(Только стандартный рабочий процесс)

Подключение в Azure OpenAI для выполнения операций с большими языковыми моделями.

Служебная шина Azure
(Только стандартный рабочий процесс)

Позволяет управлять асинхронными сообщениями, очередями, сеансами, разделами и подписками разделов.

Хранилище таблиц Azure
(Только стандартный рабочий процесс)

Подключение к учетной записи хранения Azure для создания, обновления, администрирования таблиц и запросов по ним.

Хранилище очередей Azure
(Только стандартный рабочий процесс)

Подключение в учетную запись служба хранилища Azure, чтобы можно было создавать, обновлять и управлять очередями.

IBM 3270
(Только стандартный рабочий процесс)

Вызовите приложения на основе экрана 3270 в мейнфреймах IBM из рабочего процесса.

IBM CICS
(Только стандартный рабочий процесс)

Вызов программ CICS на мейнфреймы IBM из рабочего процесса.

IBM DB2
(Только стандартный рабочий процесс)

Подключение к IBM DB2 в облаке или локальной среде. Обновление строки, получение таблицы и другие действия.

Файл узла IBM
(Только стандартный рабочий процесс)

Подключение к файлу узла IBM для создания или анализа его содержимого.

IBM IMS
(Только стандартный рабочий процесс)

Вызов программ IMS в мейнфреймах IBM из рабочего процесса.

IBM MQ
(Только стандартный рабочий процесс)

Подключение к IBM MQ в локальной среде или в Azure для отправки и получения сообщений

JDBC
(Только стандартный рабочий процесс)

Подключение реляционной базе данных с помощью драйверов JDBC.

SAP
(Только стандартный рабочий процесс)

Подключение в SAP, чтобы отправлять или получать сообщения и вызывать действия.

SQL Server
(Только стандартный рабочий процесс)

Подключение к SQL Server локально или в Базе данных SQL Azure в облаке для управления записями, запуска хранимых процедур или выполнения запросов.

Выполнение кода из рабочих процессов

Azure Logic Apps предоставляет следующие встроенные действия для выполнения собственного кода в рабочем процессе.

Встроенный код

Добавьте и запустите встроенные фрагменты кода JavaScript из рабочего процесса.

Локальные операции функции
(Только стандартный рабочий процесс)

Создайте и запустите код платформа .NET Framework из рабочего процесса.

Рабочий процесс управления

Azure Logic Apps предоставляет следующие встроенные действия для структурирования и контроля действий в рабочем процессе.

Условие

Оценка условия и выполнение различных действий на основе значения условия: True или False.

Для каждого

Выполнение одинаковых действий для каждого элемента в массиве.

Область применения

Группировка действий в области, которые получают свое состояние после завершения действий в области.

Switch

Группируйте действия в варианты, которым присваиваются уникальные значения, за исключением варианта по умолчанию. Запускайте только тот вариант, присвоенное значение которого соответствует результату выражения, объекта или токена. Если совпадений не существует, запустите вариант по умолчанию.

Завершение

Остановите активный рабочий процесс.

До условия

Повторяйте действия до тех пор, пока значение указанного условия не будет равно True или какое-нибудь из состояний не изменится.

Управление данными или их обработка

Azure Logic Apps предоставляет следующие встроенные действия для работы с выходными данными и их форматами.

Операции с данными

Выполнение операций с данными.

Создание. Создает один вывод из нескольких входных данных с различными типами.

Создание таблицы CSV. Создает таблицу с разделителями-запятыми (CSV) из массива с объектами JSON.

Создание таблицы HTML. Создает таблицу HTML из массива с объектами JSON.

Фильтрация массива. Создает массив из элементов другого массива, соответствующих вашим критериям.

Объединение. Создает строку из всех элементов массива и разделяет эти элементы указанным разделителем.

Анализ JSON. Создает понятные токены из свойств и их значений в содержимом JSON, чтобы эти свойства можно было использовать в рабочем процессе.

Выбор. Создает массив с объектами JSON, преобразуя элементы или значения в другой массив и сопоставив эти элементы с указанными свойствами.

Значок действия

Дата и время

Выполнение операций с метками времени.

Добавление интервала к указанному времени. Добавляет указанное количество единиц в метку времени.

Преобразование часового пояса. Преобразовывает метку времени из исходного часового пояса в целевой.

Текущее время. Возвращает текущую метку времени в виде строки.

Получение будущего времени. Возвращает текущую метку времени, а также указанные единицы времени.

Получение времени в прошлом. Возвращает текущую метку времени, вычитая указанные единицы времени.

Вычитание из указанного времени. Вычитает количество единиц времени из метки времени.

Переменные

Выполнение операций с переменными.

Добавление значения в переменную массива. Вставляет значение в качестве последнего элемента в массив, хранящийся в переменной.

Добавление в переменную строки. Вставляет значение в качестве последнего символа в строку, хранящуюся в переменной.

Переменная декремента. Уменьшает переменную на фиксированное значение.

Увеличение переменной. Увеличивает переменную на фиксированное значение.

Инициализация переменной. Создает переменную и объявляет ее тип данных и начальное значение.

Задание переменной. Назначает другое значение имеющейся переменной.

Встроенные операции бизнес-бизнеса (B2B)

Azure Logic Apps поддерживает сценарии взаимодействия между бизнесами (B2B) с помощью различных встроенных операций B2B. В зависимости от того, есть ли рабочий процесс потребления или стандартный и операции B2B, которые вы хотите использовать, может потребоваться создать и связать учетную запись интеграции с ресурсом приложения логики. Затем вы используете эту учетную запись интеграции для определения артефактов B2B, таких как торговые партнеры, соглашения, карты, схемы, сертификаты и т. д.

Рабочие процессы уровня "Потребление"

Прежде чем использовать любые операции B2B в рабочем процессе, необходимо создать и связать учетную запись интеграции с ресурсом приложения логики. После создания учетной записи интеграции необходимо определить артефакты B2B, такие как торговые партнеры, соглашения, карты, схемы, сертификаты и т. д. Затем можно использовать операции B2B для кодирования и декодировки сообщений, преобразования содержимого и многого другого.
Стандартные рабочие процессы

Для некоторых операций B2B требуется создать и связать учетную запись интеграции с ресурсом приложения логики. Связывание позволяет совместно использовать артефакты в нескольких стандартных рабочих процессах и дочерних рабочих процессах. На основе операции B2B, которую вы хотите использовать, выполните одно из следующих действий перед использованием операции:
- Для операций, требующих карт или схем, можно выполнить следующие действия:
  - Отправьте эти артефакты в ресурс приложения логики с помощью портал Azure или Visual Studio Code. Затем эти артефакты можно использовать во всех дочерних рабочих процессах в одном ресурсе приложения логики. Дополнительные сведения см. в статье "Добавление схем для использования с рабочими процессами в Azure Logic Apps" и добавление схем для использования с рабочими процессами в Azure Logic Apps.
  - Связывание ресурса приложения логики с учетной записью интеграции.
- Для операций, требующих подключения к учетной записи интеграции, создайте подключение при добавлении операции в рабочий процесс.

Дополнительные сведения см. в следующей документации:

AS2 (версия 2)
(Только стандартный рабочий процесс)

Кодирование и декодирование сообщений, использующих протокол AS2.

EDIFACT

Кодирование и декодирование сообщений, использующих протокол EDIFACT.

Неструктурированный файл

Кодирование и декодирование XML-сообщений между торговыми партнерами.

Поиск артефактов учетной записи интеграции

Получите пользовательские метаданные для артефактов, такие как торговые партнеры, соглашения, схемы и т. д., в вашей учетной записи интеграции.

Операции с жидкостью

Преобразуйте следующие форматы с помощью шаблонов Liquid:

— JSON в JSON
— JSON в TEXT
— XML в JSON
— XML в TEXT

RosettaNet

Кодирование и декодирование сообщений, использующих протокол RosettaNet.

SWIFT
(Только стандартный рабочий процесс)

Кодирование и декодирование транзакций Общества для всемирного межбанковского финансового телекоммуникационного взаимодействия (SIWFT) в формате XML-сообщения неструктурированного файла.