演習 - カスタム コネクタを作成して Azure Logic Apps のワークフローから呼び出す

  • 10 分

送信した寸法に基づいて写真フレームの費用を計算する、Print Framer API という Web API があります。 会社中の開発者がこの API を Azure Logic Apps のワークフローで使いたいと考えていますが、現在、その接続を実行する方法がありません。

この演習では、Print Framer API 用のカスタム コネクタを作成し、それを使ってロジック アプリ ワークフローと Web API の間でデータを送受信します。 まず、ロジック アプリ ワークフローが必要です。

ロジック アプリ ワークフローを作成する

  1. Azure portal のメニューまたは [ホーム] ページの [Azure サービス] で、[リソースの作成] を選択します。 [リソースの作成] ウィンドウが表示されます。

  2. 左側のメニュー ペインで、[統合] を選び、[Logic App] を見つけて選びます。

  3. [ロジック アプリの作成] ペインの [基本] で、各設定に次の値を入力します。

    設定 値
    プロジェクトの詳細
    サブスクリプション コンシェルジェ サブスクリプション
    リソース グループ [サンドボックス リソース グループ] を選択します
    インスタンスの詳細
    ロジック アプリ名 一意の名前を指定します。 後で使うので名前を覚えておいてください。
    公開 ワークフロー
    リージョン 近くのリージョンを選択します。
    Log Analytics を有効にする いいえ
    プラン
    プランの種類 従量課金
    ゾーン冗長性
    ゾーン冗長性 既定値 (無効) のままにします

    無料のサンドボックスを使用すると、Azure グローバル リージョンのサブセットにリソースを作成できます。 リソースを作成するときは、次のリストからリージョンを選択します。

    • 米国西部 2
    • 米国中南部
    • 米国中部
    • 米国東部
    • 西ヨーロッパ
    • 東南アジア
    • 東日本
    • ブラジル南部
    • オーストラリア南東部
    • インド中部

  4. [確認および作成] を選択し、検証が完了したら [作成] を選択します。

  5. ポータルによってロジック アプリ リソースが作成されたら、[リソースに移動] を選びます。

    Azure portal には、頻繁に使われるトリガーとワークフロー パターンを含むギャラリーが表示されます。

  6. 左側のメニューで [ロジック アプリ デザイナー] を選択し、[トリガーの追加] を選択します。

  7. [HTTP 要求の受信時] を検索して選択します。

    ワークフロー デザイナーに、選んだトリガーが表示されます。

  8. [高度なパラメーター] セクションで [すべて表示] を選択します。

  9. [メソッド] ドロップダウンで、[GET] を選択します。

  10. [相対パス] フィールドに、リテラル文字列として「{height}/{width}」を入力します。

    Request トリガーの情報を示すスクリーンショット。

  11. デザイナーのツール バーで、 [保存] を選択します。

これで基本的なロジック アプリ ワークフローができました。 ワークフローからカスタム Print Framer API を呼び出すことができるように、カスタム コネクタを追加しましょう。

Azure portal で新しい Azure Logic Apps カスタム コネクタを作成する

  1. Azure portal のメニューまたは [ホーム] ページの [Azure サービス] で、[リソースの作成] を選択します。 [リソースの作成] ウィンドウが表示されます。

  2. 検索ボックスで、「Logic Apps カスタム コネクタ」を検索して選びます。

  3. [Logic Apps カスタム コネクタ] ペインで、[作成] を選びます。

  4. [ロジック アプリ カスタム コネクタの作成] ペインの [基本] で、各設定に次の値を入力します。

    設定 値
    プロジェクトの詳細
    サブスクリプション コンシェルジェ サブスクリプション
    リソース グループ [サンドボックス リソース グループ] を選択します
    インスタンスの詳細
    カスタム コネクタ名 PrintFramerConnector
    リージョン 自分に近く、サンドボックスでサポートされているリージョンを選びます。
    統合サービス環境に関連付ける オフのままにします

  5. [Review + create](レビュー + 作成) を選択します。 検証が成功した後、[作成] を選択します。

  6. デプロイが完了したら、[リソースに移動] を選択します。

OpenAPI 定義をインポートする

ここで、前に保存した OpenAPI ファイルを使って、カスタム コネクタを定義します。

  1. Azure portal または [ホーム] ページで、[すべてのリソース] を選択し、[PrintFramerConnector] を選択します。

  2. [概要] ページで、[編集] を選択します。

    カスタム コネクタのエディターを示すスクリーンショット。

  3. [カスタム コネクタ] セクションで、[OpenAPI ファイル] を選択し、[インポート] を選択します。 前の演習で保存した JSON ファイルを開きます。

カスタム コネクタを構成する

OpenAPI ファイルは、Web API で使用できる操作についてカスタム コネクタに指示するものです。 カスタム コネクタに設定する必要があるその他のプロパティがいくつかあります。

  1. [一般情報] セクションの [説明] ボックスに、「写真フレームの見積もりを取得する」と入力します。 必要に応じて、構成ウィンドウのこの部分まで下にスクロールしてください。

  2. [ホスト] テキスト ボックスに、前に記録した URL の例を入力します。

  3. [セキュリティ] ペインで、[認証なし] が選ばれていることを確認します。

    重要

    このデモでは、認証なしで API にアクセスすることを許可します。 実際の API では、機密データが含まれていたり、有料サブスクリプションが必要であったりするため、認証は不可欠です。

  4. [定義] ウィンドウの [概要] テキストボックスに、「写真フレームの費用を見積もる」と入力します。

  5. [表示] の下で、[重要] を選択します。

  6. ウィンドウの上部で、[コネクタの更新] を選択します。

カスタム コネクタをロジック アプリ ワークフローに追加する

これで、カスタム コネクタをロジック アプリ ワークフローで使えるようになりました。

  1. Azure portal または [ホーム] ページの [Azure リソース] で、[すべてのリソース] を選んで、ユニット 3 で作成したロジック アプリ リソースを選びます。

  2. ロジック アプリのリソース メニューで、[概要] を選びます。 [概要] ペインのツール バーで、[編集] を選びます。

  3. デザイナーで、[新しいステップ]>[アクションの追加] を選択します。

  4. [操作を選択してください] 検索ボックスの下で [カスタム] を選び、[PrintFramerConnector] を選びます。

  5. [アクション] で、[写真フレームの費用を見積もる] を選択します。

  6. [写真フレームの費用を見積もる] ボックスの [高さ] フィールドにカーソルを置きます。 開いた動的コンテンツの一覧から、[高さ] を選びます。

    次のスクリーンショットはこの選択を示したものです。

    カスタム コネクタと、動的コンテンツ リストで選ばれた [高さ] パラメーターのスクリーンショット。

  7. カスタム コネクタに戻り、[幅] フィールドにカーソルを置きます。 動的コンテンツの一覧で [幅] を選びます。

    これで、ワークフローをトリガーする各 HTTP 要求から受け取る高さと幅パラメーターが、PrintFramerConnector に渡す高さと幅のパラメーターにバインドされます。

ワークフローを完了する

最後に、ワークフローには結果を表示する方法が必要です。 応答アクションを使って、見積もりを表示できます。

  1. ワークフロー デザイナーで、[新しいステップ] を選びます。

  2. [操作を選択してください] 検索ボックスに「応答」と入力し、[応答] という名前のアクションを選びます。

  3. [本文] フィールドに、「フレームの概算費用: $」と入力します。

  4. 開く動的コンテンツの一覧で、[写真フレームの費用を見積もる] セクションから [本文] を選びます。

    次のスクリーンショットは、この選択を示しています。

    スクリーンショットは、

  5. 完了したら、[保存] を選択して、変更を保存します。

ワークフローをテストする

ワークフローが完成し、カスタム コネクタを使って Web API を呼び出します。 ワークフローをトリガーする要求を送信することだけが必要で、それはブラウザーを使って実行できます。

  1. ワークフロー デザイナーで、[HTTP 要求の受信時] アクションを展開します。

  2. [HTTP GET URL] フィールドの横にある [URL のコピー] を選びます。

  3. 新しいブラウザー タブを開いて、この URL をアドレス バーに貼り付けます。

  4. 貼り付けた URL で、{height} パラメーターを 10 に置き換えます。 {width} パラメーターを 4 に置き換えます。 Enter キーを押します。

    ブラウザーのウィンドウに概算費用が表示されます。

  5. 他の高さと幅を入力して試してみてください。

お疲れさまでした。 カスタム コネクタを使って社内の Print Framer API を呼び出すことができるロジック アプリ ワークフローを作成しました。