ワークフローで外部 API を使用する
重要
この機能は現在プレビューの段階です。 Microsoft Azure プレビューの補足使用条件には、ベータ版、プレビュー版、または一般公開されていない Azure 機能に適用される追加の法的条件が含まれています。
ワークフローを使用すると、Microsoft Purview を使用して一部のビジネス プロセスを自動化できます。HTTP コネクタと解析 JSON アクションを使用すると、ワークフローを外部アプリケーションと統合できます。
HTTP コネクタ
HTTP コネクタでは、表現状態転送 (REST) アーキテクチャを使用します。これにより、Microsoft Purview ワークフローは、Web 要求を使用して Microsoft 以外のアプリケーションと直接対話できます。
HTTP コネクタは、すべてのワークフロー テンプレートで使用できます。
注:
ワークフローを作成または編集するには、Microsoft Purview の ワークフロー管理者ロール が必要です。 また、コレクション内のワークフロー管理者に問い合わせるか、コレクション管理者にアクセス許可を求めることもできます。
HTTP コネクタを追加するには、追加するテンプレートの + アイコンを選択し、[HTTP コネクタ] を選択します。
HTTP コネクタを選択したら、次のパラメーターを入力します。
- ホスト - このコネクタの実行時に呼び出す URL を要求します。
- メソッド - 次のいずれかの方法を選択します。 GET、PUT、PATCH、POST、DELETE。 これらのメソッドは、作成、読み取り、更新、削除の各操作に対応します。
- パス - 必要に応じて、要求 URL パスを入力できます。 このパラメーターには動的コンテンツを使用できます。
- ヘッダー - 必要に応じて、HTTP ヘッダーを入力できます。 HTTP ヘッダーを使用すると、クライアントとサーバーは HTTP 要求または応答で追加情報を渡すことができます
- クエリ - 必要に応じて、クエリを渡すことができます。
- 本文 - 必要に応じて、URL の呼び出し中に HTTP 本文を渡すことができます
-
認証 - HTTP コネクタは 、Microsoft Purview 資格情報と統合されています。 URL に応じて、次の 3 種類のいずれかを呼び出すことができます。
- なし (認証なし)
- 基本認証 - 既に 作成した基本認証資格情報を使用します。
-
サービス プリンシパル - 既に 作成したサービス プリンシパル資格情報と対象ユーザーを使用します。
対象ユーザーは、アクセス トークンの対象コンシューマーになります。 たとえば、Microsoft Purview 対象ユーザー:
https://purview.azure.net/.defaultARM などの対応するサービスを呼び出すサービス プリンシパルが承認されていることを確認します。
既定では、HTTP コネクタのセキュリティで保護された設定が有効になっています。 安全な入力と出力をオフにするには、省略記号アイコン (...) を選択して設定に移動します。
HTTP コネクタの設定が表示され、セキュリティで保護された入力と出力をオフにすることができます。
JSON の解析アクション
ワークフローの JSON 解析アクションを使用すると、HTTP (またはその他のアクション/コネクタ) から受信 JSON を取得し、JSON を解析してワークフローで使用する値を抽出できます。
JSON 解析アクションは、すべてのワークフローで使用できます。
JSON の解析アクションには、次の 2 つのパラメーターがあります。
- コンテンツ - 解析する JSON を含む変数。
- スキーマ - ワークフローが受信情報を解析できるようにする受信 JSON のスキーマ。 独自のものを指定することも、[ サンプルから生成 ] ボタンを使用することもできます。 サンプルから生成する場合は、サンプル JSON ペイロードを入力すると、スキーマが自動的に生成されます。
JSON 解析アクションの後のワークフローのアクションとコネクタは、[任意のパラメーターに 動的コンテンツを追加 する] を選択することで、JSON から抽出された値を使用できます。
次の手順
ワークフローの詳細については、次の記事を参照してください。