Azure Logic Apps の組み込みコネクタ
組み込みコネクタにより、ワークフローのスケジュールと構造の制御、独自のコードの実行、データの管理または操作、ワークフロー内の他のタスクの実行を行う手段が提供されます。 マネージド コネクタとは異なり、一部の組み込みコネクタは、特定のサービス、システム、またはプロトコルに関連付けられていません。 たとえば、繰り返しトリガーを使用すると、ほぼどのようなワークフローでもスケジュールに従って開始できます。 または、要求トリガーを使用することで、呼び出されるまでワークフローを待機させることもできます。 すべての組み込みコネクタは、Azure Logic Apps ランタイムでネイティブに実行されます。 一部では、その使用前に接続を作成する必要はありません。
サービス、システム、プロトコルの数が少ない場合向けに、Azure Logic Apps ではマネージド バージョンと共に組み込みバージョンが提供されます。 組み込みコネクタの数と範囲は、マルチテナントの Azure Logic Apps で実行される従量課金ロジック アプリ ワークフローを作成するか、シングル テナントの Azure Logic Apps で実行される Standard ロジック アプリ ワークフローを作成するかによって異なります。 ほとんどの場合、組み込みのバージョンの方がパフォーマンス、機能、価格などに優れています。 場合によっては、一部の組み込みコネクタは、あるロジック アプリ ワークフローの種類でのみ使用でき、他の種類では使用できません。
たとえば、Standard ワークフローでは、Azure Blob Storage、Azure Cosmos DB、Azure Event Hubs、Azure Service Bus、FTP、IBM DB2、IBM MQ、SFTP、SQL Server 用のマネージド コネクタと組み込みコネクタの両方を使用できます。 従量課金ワークフローには組み込みバージョンがありません。 従量課金ワークフローでは、Azure API Management、Azure App Services 用の組み込みコネクタが使用できますが、Standard ワークフローにはこれらの組み込みコネクタがありません。
また、Standard ワークフローでは、特定の属性を備えた一部の組み込みコネクタが、非公式には "サービス プロバイダー" と呼ばれています。 組み込みコネクタによっては、基盤となるサービスへの接続を認証する単一の方法のみがサポートされています。 その他の組み込みコネクタでは、接続文字列、Microsoft Entra ID、マネージド ID の使用など、選択肢を提供できます。 すべての組み込みコネクタは、Azure Logic Apps ランタイムと同じプロセスで実行されます。 詳細については、Azure Logic Apps でのシングルテナントとマルチテナントに関するページを参照してください。
この記事では、従量課金ワークフローと Standard ワークフローの組み込みコネクタの概要について説明します。
従量課金と Standard の組み込みコネクタの比較
次の表は、従量課金ワークフローと Standard ワークフローで使用できる組み込みコネクタの最新の一覧です。ギャラリーの内容は今後拡充されていく予定です。 Standard ワークフローの場合、アスタリスク (*) は "サービス プロバイダー" モデルに基づく組み込みコネクタを示します。これについては、後で詳しく説明します。
| 従量課金プラン | Standard |
|---|---|
| Azure API Management Azure App Service Azure Functions Azure Logic Apps Batch コントロール データ操作 Date Time フラット ファイル HTTP インライン コード 統合アカウント Liquid 要求の 。 スケジュール 変数 XML |
AS2 (v2) Azure AI Search* Azure Automation* Azure Blob Storage* Azure Cosmos DB* Azure Event Grid Publisher* Azure Event Hubs* Azure File Storage* Azure Functions Azure Key Vault* Azure OpenAI* Azure Queue Storage* Azure Service Bus* Azure Table Storage* バッチ操作 コントロール データ マッパー操作 データ操作 Date Time EDIFACT ファイル システム フラット ファイル FTP* HTTP IBM 3270* IBM CICS* IBM DB2* IBM ホスト ファイル* IBM IMS* IBM MQ* インライン コード 統合アカウント JDBC* Liquid 操作 要求の 。 RosettaNet SAP* スケジュール SFTP* SMTP* SQL Server* SWIFT 変数 ワークフロー操作 X12 XML 操作 |
サービス プロバイダーベースの組み込みコネクタ
Standard ワークフローでは、次の属性を持つ組み込みコネクタは、非公式に "サービス プロバイダー" と呼ばれます。
Azure Functions 拡張性モデルに基づいています。
Standard ワークフローからサービス (Azure Blob Storage、Azure Service Bus、Azure Event Hubs、SFTP、SQL Server など) へのアクセスを提供します。
組み込みコネクタによっては、基盤となるサービスへの接続を認証する単一の方法のみがサポートされています。 その他の組み込みコネクタでは、接続文字列、Microsoft Entra ID、マネージド ID の使用など、選択肢を提供できます。
再設計された Azure Logic Apps ランタイムと同じプロセスで実行されます。
サービス プロバイダーベースの組み込みコネクタは、マネージド コネクタのバージョンと共に使用できます。
一方、"サービス プロバイダーではない" 組み込みコネクタには、次の属性があります。
Azure Functions 拡張性モデルに基づいていません。
スケジュール、HTTP、要求、XML 操作など、Azure Logic Apps ランタイム内のジョブとして直接実装されます。
カスタム組み込みコネクタ
Standard ワークフローの場合は、Azure Blob Storage、Azure Event Hubs、Azure Service Bus、SQL Server など、サービス プロバイダーベースの組み込みコネクタで使用されるのと同じ組み込みコネクタ拡張性モデルを使用して、独自の組み込みコネクタを作成できます。 このインターフェイス実装は、Azure Functions 機能拡張モデルに基づいており、Standard ワークフローで誰でも使用できるカスタム組み込みコネクタを作成する機能を提供します。
従量課金ワークフローの場合、独自の組み込みコネクタを作成することはできませんが、独自のマネージド コネクタを作成します。
詳細については、次のドキュメントを確認してください。
一般組み込みコネクタ
次の組み込みコネクタを使用して、一般的なタスクを実行できます。
カスタムおよび詳細なスケジュールを使用してワークフローを実行します。 スケジュール設定の詳細については、Azure Logic Apps のコネクタの繰り返しの動作に関する記事を参照してください。
ワークフローの構造を、たとえばループと条件を使用して、整理および制御します。
変数、日付、データ操作、コンテンツ変換、バッチ操作を処理します。
HTTP トリガーとアクションを使用して、他のエンドポイントと通信します。
要求を受信して応答します。
独自の関数 (Azure Functions) または要求を受け取ることができる他の Azure Logic Apps ワークフローなどを呼び出します。
[スケジュール]
繰り返し: 指定された繰り返しに基づいてワークフローをトリガーします。
スライディング ウィンドウ
(従量課金ワークフローのみ)
連続したチャンクのデータを処理する必要があるワークフローをトリガーします。
遅延: 指定された期間、ワークフローを一時停止します。
延期期限: 指定された日時までワークフローを一時停止します。
HTTP
HTTP トリガーまたはアクションを使用して、HTTP または HTTPS エンドポイントを呼び出します。
こちらの他の組み込みの HTTP トリガーとアクションを使用することもできます。
Request
HTTP 要求の受信時: 別のワークフロー、アプリ、またはサービスからの要求を待機します。 このトリガーによって、スケジュールに基づいてチェックしたりポーリングしたりしなくても、ワークフローを呼び出すことができます。
応答: 同じワークフローで [HTTP 要求の受信時] トリガーによって受信された要求に応答します。
Batch
メッセージのバッチ処理: バッチ内のメッセージを処理するワークフローをトリガーします。
バッチ処理するメッセージの送信: [メッセージのバッチ処理] トリガーで現在開始されている既存のワークフローを呼び出します。
ファイル システム
(Standard ワークフローのみ)
ネットワーク マシン上のファイル システムに接続して、ファイルを作成および管理します。
FTP
(Standard ワークフローのみ)
Azure 仮想ネットワーク内の FTP または FTPS サーバーに接続して、ファイルとフォルダーを操作できるようにします。
SFTP
(Standard ワークフローのみ)
ファイルとフォルダーを操作できるように、Azure 仮想ネットワーク内の SFTP サーバーに接続します。
SMTP
(Standard ワークフローのみ)
メールを送信できるように、SMTP サーバーに接続します。
特定のサービスとシステム用の組み込みコネクタ
次の組み込みコネクタを使用して、特定のサービスやシステムにアクセスできます。 Standard ワークフローでは、これらの組み込みコネクタの一部は非公式に "サービス プロバイダー" とも呼ばれ、マネージド コネクタとは一部の点で異なる場合があります。
Azure AI Search
(Standard ワークフローのみ)
ワークフローでドキュメントのインデックス作成と検索操作を実行できるように、AI Search に接続します。
Azure API Management
(従量課金ワークフローのみ)
Azure API Management を使用して、定義、管理、発行する API で独自のトリガーとアクションを呼び出します。
注: API Management で従量課金レベルを使用している場合はサポートされません。
Azure App Service
(従量課金ワークフローのみ)
Azure App Service で作成してホストするアプリ (API Apps や Web Apps など) を呼び出します。
Swagger が含まれている場合、Azure Logic Apps では、これらのアプリで定義されているトリガーとアクションは、他のファースト クラスのトリガーとアクションのように表示されます。
Azure Automation
(Standard ワークフローのみ)
Azure Automation ジョブを作成および管理できるように、Azure Automation アカウントに接続します。
Azure Blob Storage
(Standard ワークフローのみ)
Azure Blob Storage アカウントに接続して、BLOB コンテンツの作成と管理ができるようにします。
Azure Cosmos DB
(Standard ワークフローのみ)
Azure Cosmos DB に接続して、Azure Cosmos DB ドキュメントにアクセスして管理できるようにします。
Azure Event Grid Publisher
(Standard ワークフローのみ)
pub-sub セマンティクスを使用してイベントベースのプログラミングを行うために Azure Event Grid に接続します。
Azure Event Hubs
(Standard ワークフローのみ)
イベント ハブを通じてイベントを使用したり、発行したりします。 たとえば、ワークフローから Event Hubs を使用して出力を取得し、リアルタイム分析プロバイダーに送信できます。
Azure File Storage
(Standard ワークフローのみ)
Azure Storage アカウントに接続して、ファイルの作成、更新、管理ができるようにします。
Azure Functions
Azure でホストされている関数を呼び出して、ワークフロー内で独自の "コード スニペット" (C# または Node.js) を実行します。
Azure Key Vault
(Standard ワークフローのみ)
Azure Key Vault に接続して、シークレットの格納、アクセス、管理を行います。
Azure Logic Apps
(従量課金ワークフロー)
または
ワークフロー操作
(Standard ワークフロー)
[HTTP 要求の受信時] という名前の要求トリガーで始まる他のワークフローを呼び出します。
Azure OpenAI
(Standard ワークフローのみ)
Azure OpenAI に接続して、大規模言語モデルの操作を実行します。
Azure Service Bus
(Standard ワークフローのみ)
非同期メッセージ、キュー、セッション、トピック、トピック サブスクリプションを管理します。
Azure Table Storage
(Standard ワークフローのみ)
Azure Storage アカウントに接続して、テーブルの作成、更新、クエリ実行、管理ができるようにします。
Azure Queue Storage
(Standard ワークフローのみ)
Azure Storage アカウントに接続して、キューの作成、更新、管理ができるようにします。
IBM 3270
(Standard ワークフローのみ)
ワークフローから IBM メインフレーム上の 3270 画面駆動型アプリを呼び出します。
IBM CICS
(Standard ワークフローのみ)
ワークフローから IBM メインフレーム上の CICS プログラムを呼び出します。
IBM DB2
(Standard ワークフローのみ)
クラウドまたはオンプレミスの IBM DB2 に接続します。 行の更新、テーブルの取得などを行います。
IBM ホスト ファイル
(Standard ワークフローのみ)
IBM ホスト・ファイルに接続し、内容を生成または解析します。
IBM IMS
(Standard ワークフローのみ)
ワークフローから IBM メインフレーム上の IMS プログラムを呼び出します。
IBM MQ
(Standard ワークフローのみ)
オンプレミスまたは Azure 内の IBM MQ に接続し、メッセージを送受信します。
JDBC
(Standard ワークフローのみ)
JDBC ドライバーを使用してリレーショナル データベースに接続します。
SAP
(Standard ワークフローのみ)
SAP に接続して、メッセージの送受信とアクションの呼び出しを行うことができます。
SQL Server
(Standard ワークフローのみ)
オンプレミスの SQL Server、またはクラウド内の Azure SQL Database に接続して、レコードの管理、ストアド プロシージャの実行、クエリの実行を行えるようにします。
ワークフローからコードを実行する
Azure Logic Apps には、ワークフローで独自のコードを実行するために次の組み込みアクションが用意されています。
Azure Functions
Azure でホストされている関数を呼び出して、ワークフロー内で独自の "コード スニペット" (C# または Node.js) を実行します。
ローカル関数の操作
(Standard ワークフローのみ)
ワークフローから .NET Framework コードを作成して実行します。
ワークフローを制御する
Azure Logic Apps には、ワークフローでアクションを構成および制御するための次の組み込みアクションが用意されています。
Condition
条件を評価し、条件が true と false のいずれであるかに基づいて、さまざまなアクションを実行します。
For Each
配列内のすべての項目に対して同じアクションを実行します。
スコープ
アクションをスコープにグループ化します。スコープ内のアクションが実行を完了すると、スコープ独自のステータスが取得されます。
Switch
アクションをケースにグループ化します。既定のケースを除き、ケースには、一意の値が割り当てられます。 割り当てられた値が式、オブジェクト、またはトークンの結果に一致するケースのみを実行します。 一致が存在しない場合は、既定のケースを実行します。
Terminate
アクティブに実行中のワークフローを停止します。
Until
指定された条件が true になるまで、または特定の状態が変化するまで、アクションを繰り返します。
データを管理または操作する
Azure Logic Apps には、データ出力とその形式を操作するための次の組み込みアクションが用意されています。
データ操作
データの操作を実行します。
[作成]: さまざまな型の複数の入力から単一の出力を作成します。
[CSV テーブルの作成]: JSON オブジェクトを使用して、配列からコンマ区切り値 (CSV) テーブルを作成します。
[HTML テーブルの作成]: JSON オブジェクトを使用して、配列から HTML テーブルを作成します。
[配列のフィルター処理]: 別の配列内にある、条件を満たす項目から配列を作成します。
[結合]: 配列内のすべての項目から 1 つの文字列を作成します。なお、これらの項目は、指定の区切り記号で区切ります。
JSONの解析: ワークフローでこれらのプロパティを使用できるように、JSON コンテンツのプロパティとその値からわかりやすいトークンを作成します。
[選択]: 別の配列内の項目または値を変換し、それらの項目を指定のプロパティにマッピングすることにより、JSON オブジェクトで配列を作成します。
日付と時刻
タイムスタンプの操作を実行します。
[時間への追加]: 指定された数の単位をタイムスタンプに追加します。
[タイム ゾーンの変換]: ソース タイムゾーンからターゲット タイムゾーンにタイムスタンプを変換します。
[現在の時刻]: 現在のタイムスタンプを文字列として返します。
[未来の時間の取得]: 現在のタイムスタンプに、指定された時間単位を加えたものを返します。
[過去の時間を取得]: 現在のタイムスタンプから、指定された時間単位を取り除いたものを返します。
[Subtract from time]\(時間から減算\): タイムスタンプから時間単位数を減算します。
変数
変数の操作を実行します。
[Append to array variable]\(配列変数に追加\): 変数によって保管される配列内に、値を最後の項目として挿入します。
[Append to string variable]\(文字列変数に追加\): 変数によって保管される文字列内に、値を最後の文字として挿入します。
[変数の値を減らす]: 変数の値を一定値だけ減らします。
[変数の値を増やす]: 変数の値を一定値だけ増やします。
[変数を初期化する]: 変数を作成し、そのデータ型と初期値を宣言します。
[変数の設定]: 既存の変数に異なる値を代入します。
企業間 (B2B) の組み込み操作
Azure Logic Apps は、さまざまな B2B 組み込み操作を通じて、企業間 (B2B) 通信シナリオをサポートします。 ワークフローが従量課金か Standard か、および使用したい B2B 操作に基づいて、統合アカウントを作成してロジック アプリ リソースにリンクする必要がある場合があります。 次に、この統合アカウントを使用して、取引先、契約、マップ、スキーマ、証明書などの B2B 成果物を定義します。
従量課金ワークフロー
ワークフローで B2B 操作を使用する前に、統合アカウントを作成してロジック アプリ リソースにリンクする必要があります。 統合アカウントを作成したら、取引先、契約、マップ、スキーマ、証明書などの B2B 成果物を定義する必要があります。 その後、B2B 操作を使用して、メッセージのエンコードとデコード、コンテンツの変換などを行うことができます。
Standard ワークフロー
一部の B2B 操作では、 ロジック アプリ リソースに統合アカウントを作成してリンクする必要があります。 リンクを使用すると、複数の Standard ワークフローとその子ワークフロー間で成果物を共有できます。 使用したい B2B 操作に基づいて、操作を使用する前に、次のいずれかの手順を実行してください。
マップまたはスキーマを必要とする操作の場合は、次のいずれかを実行できます。
Azure portal または Visual Studio Code を使用して、これらの成果物をロジック アプリ リソースにアップロードします。 その後、"同じ" ロジック アプリ リソース内のすべての子ワークフローで、これらの成果物を使用できます。 詳細については、「Azure Logic Apps でワークフローに変換用のマップを追加する」と「Azure Logic Apps でワークフローと共に使用するマップを追加する」を参照してください。
統合アカウントとの接続が必要な操作の場合、ワークフローに操作を追加するときに接続を作成します。
詳細については、次のドキュメントを確認してください。
AS2 (v2)
(Standard ワークフローのみ)
AS2 プロトコルを使用するメッセージをエンコードおよびデコードします。
EDIFACT
EDIFACT プロトコルを使用するメッセージをエンコードおよびデコードします。
フラット ファイル
取引先間の XML メッセージをエンコードおよびデコードします。
統合アカウントのアーティファクトの検索
統合アカウントの取引先、契約、スキーマなどの成果物のカスタム メタデータを取得します。
Liquid 操作
Liquid のテンプレートを使用して次の形式を変換します。
- JSON から JSON へ
- JSON からテキストへ
- XML から JSON へ
- XML からテキストへ
RosettaNet
RosettaNet プロトコルを使用するメッセージをエンコードおよびデコードします。
SWIFT
(Standard ワークフローのみ)
国際銀行間通信協会 (SWIFT) トランザクションをフラット ファイル XML メッセージ形式でエンコードおよびデコードします。
XML の変換
ソースの XML 形式を別の XML 形式に変換します。
X12
X12 プロトコルを使用するメッセージをエンコードおよびデコードします。
XML 検証
指定されたスキーマに対して XML ドキュメントを検証します。