前提条件
OpenAPI 経由で接続する前に、以下の準備が必要です。- Connect AI アカウントにデータソースを接続します。詳細については、ソース を参照してください。
- 仮想スキーマに仮想スキーマを追加します。
- 仮想スキーマにアセットを追加します。
- 設定ページでパーソナルアクセストークン(PAT)を生成します。認証時のパスワードとして使用するため、コピーして保管してください。
- Azure サブスクリプションでカスタムコネクタを作成するアクセス権があることを確認します。
Connect AI への接続
OpenAPI を介してAzure Logic Apps からConnect AI への接続を確立するには、以下の手順に従ってください。1
Connect AI のVirtual Schemas で仮想スキーマを選択し、仮想スキーマのOpenAPI 仕様をダウンロードします。詳細については、OpenAPI を参照してください。
OpenAPI バージョン 2.0 を使用し、Convert array types to strings を選択する必要があります。

2
Azure ポータルにログインします。
3
Microsoft Azure のAzure services でCreate a resource をクリックします。
4
検索バーにLogic Apps Custom Connector と入力します。Create > Logic Apps Custom Connector をクリックします。

5
6
作成したLogic Apps カスタムコネクタでEdit をクリックします。OpenAPI 定義をカスタムコネクタにインポートします。以下の手順に従うか、Microsoft のドキュメントを参照してください。
7
1. General で、Import mode としてOpenAPI file を選択します。次に、作成したOpenAPI 定義を指定します。

8
説明を含むコネクタの全般情報を入力します。Host とBase URL はすでに入力されています。
9
2. Security ステップで、Authentication type としてBasic authentication を選択します。ユーザーはこのAPI を使用する前にユーザー名とパスワードを入力する必要があります。ユーザーに表示されるパラメータラベルを入力します。
カスタムコネクタを使用する際、ユーザー名はConnect AI のユーザー名、パスワードは前提条件で作成したPAT になります。
10
コネクタの 3. Definition ステップでは、OpenAPI 仕様ファイルに含まれるコネクタのすべてのアクションを定義します。アクションには、レコードの一覧表示、取得、作成、更新、削除など、テーブルに必要なすべての機能が含まれます。
3. Definition ステップでは、OpenAPI 仕様からインポートされたActions とReferences を編集できます。
リクエストには
- Actions—カスタムコネクタの各アクションにはGeneral 情報と、レスポンスのRequest、Response、Validation があります。 たとえば、以下のリクエストはドライブを一覧表示するGET リクエストです。

$top、$filter、$orderby などのURL に追加されるクエリパラメータが含まれます。ここでクエリパラメータを編集・削除できます。パラメータはOData プロトコルに基づいています。
完全なリファレンスについては、API Operations を参照してください。
同様に、新しいレコードを作成するPOST リクエストもあります。リクエストにはレコードのすべてのフィールドが含まれており、定義でこれらのフィールドを編集できます。- References—アクションとトリガーの両方で使用される再利用可能なパラメータです。各リファレンスにはDefinition とValidation があります。
11
Update connector をクリックして変更を保存します。
12
カスタムコネクタを使用してLogic Apps を構築できるようになりました。カスタムコネクタを使用したLogic Apps の構築の詳細については、Microsoft のドキュメントを参照してください。
