Azure Logic Apps で SOAP カスタム コネクタを作成して登録します (プレビュー)

  • [アーティクル]

このトピックはプレリリース ドキュメントであり、変更される場合があります。

SOAP サービスを Azure Logic Apps ワークフローに統合するために、SOAP サービスを記述する Web サービス記述言語 (WSDL) を使用して、カスタム Simple Object Access Protocol (SOAP) コネクターを作成および登録できます。 SOAP コネクタはビルド済みのコネクタのように機能するため、ロジック アプリの他のコネクタと同じように使用できます。 現在、SOAP カスタム コネクタは一方向の操作をサポートしていません。

重要

  • これはプレビュー機能です。

  • プレビュー機能は運用環境での使用を想定しておらず、機能が制限されている可能性があります。 これらの機能を公式リリースの前に使用できるようにすることで、顧客が一足先にアクセスし、そこからフィードバックを得ることができます。

前提条件

SOAP コネクタを登録するには、次のものが必要です。

  • Azure のサブスクリプション ID。 サブスクリプションがない場合は、無料の Azure アカウント で開始できます。 別の方法として、従量課金制のサブスクリプション にサイン アップできます。

  • 次のいずれかが必要になります。

    • SOAP サービスと API を定義する WSDL ファイルの URL です。
    • SOAP サービスと API を定義する WSDL ファイルです。

    この手順では、例として SOAP サービスを注文 (http://fazioapisoap.azurewebsites.net/FazioService.svc?singleWsdl) を使用できます。

  • (オプション) カスタム コネクタのアイコンとして使用する画像です。

1. コネクタを作成する

  1. Azure メイン メニューの Azure ポータルで、新規を選択します。

  2. 検索ボックスで Logic Apps コネクタと入力し、Enter キーを選択します。

    「ロジック アプリ コネクタ」を検索するスクリーンショット。

  3. 結果リストから、Logic Apps コネクタ > 作成 を選択します。

    Logic Apps コネクタを作成するスクリーンショット。

  4. 表の説明に従って、コネクタを登録するための詳細を入力します。 終了したら、ダッシュボードにピン留めチェックボックスを選択し、作成を選択します。

    Logic App カスタム コネクタの詳細のスクリーンショット。

    Property 提案された値 Description
    件名 soap-connector-name コネクタの名前を入力します。
    サブスクリプション Azure-subscription-name Azure のサブスクリプションを選択します。
    リソース グループ Azure-resource-group-name Azure リソースを整理するための Azure グループを作成または選択します。
    場所 展開リージョン ロジック アプリと同じ Azure リージョンを選択します。

Azure がコネクタをデプロイすると、Logic Apps コネクタ メニューが開きます。 そうでない場合は、Azure ダッシュボードから SOAP コネクタを選択します。

2. コネクタを定義する

コネクタを作成するための WSDL ファイルまたは URL、コネクタが使用する認証、SOAP コネクタが提供するアクションとトリガーを指定します。

2a. コネクタの WSDL ファイルまたは URL を指定する

  1. コネクタのメニューで、まだ選択されていない場合は、Logic Apps コネクタを選択します。

  2. ツールバーで、編集を選択します。

    カスタム コネクタ編集のスクリーンショット

  3. 全般を選び、テーブルに SOAP コネクタのアクションとトリガーを作成、保護、および定義するための詳細を提供します。

    1. カスタム コネクタに、API エンドポイント用の SOAP を選び、自身の API を説明する WSDL ファイルを提供します。

      API に WSDL ファイルを提供するスクリーンショット

      オプション 形式 説明設定
      ファイルから WSDL をアップロードする WSDL ファイル WSDL ファイルの場所を参照し、そのファイルを選択します。
      URL から WSDL をアップロードする http://path-to-wsdl-file サービスの WSDL ファイルの URL を入力します。
      SOAP から REST まで 該当なし SOAP サービスの API を REST API に変換します。

    2. 一般情報に、コネクタのアイコンをアップロードします。

      通常、説明、ホスト、および基本 URL フィールドは、WSDL ファイルから自動的に入力されます。 そうでない場合は、表の説明に従ってこの情報を追加し、続行を選択します。

      コネクタ詳細のスクリーン ショット

      オプションまたは設定 形式 説明設定
      アイコンのアップロード png-or-jpg-file-under-1-MB コネクタを表すアイコン

      色: できれば、カラーの背景に白いロゴを使用してください。

      寸法: 230 × 230 ピクセルの正方形内に約 160 × 160 ピクセルのロゴ
      アイコンの背景色 icon-brand-color-hexadecimal-code アイコン ファイルの背景色と一致するアイコンの背後の色。

      形式: 16 進数。 たとえば、#007ee5 は青色を表します。
      Description connector-description コネクタの簡単な説明を入力します。
      Host connector-host SOAP サービスのホスト ドメインを入力します。
      ベース URL connector-base-URL SOAP サービスの基本 URL を入力します。

2b. コネクタが使用する認証について説明する

  1. セキュリティを選択し、コネクタが使用する認証について確認または説明します。 認証により、ユーザー ID がサービスとクライアントの間で適切に流れるようになります。

    既定では、コネクタの認証タイプは認証なしに設定されています。

    認証タイプのスクリーンショット

    認証タイプを変更するには、編集を選択します。 基本認証を選択できます。 既定値以外のパラメーター ラベルを使用するには、パラメーター ラベルで更新します。

    基本認証のスクリーンショット

  2. セキュリティ情報を入力した後にコネクタを保存するには、ページの上部にあるコネクタを更新から続行を選択します。

2c. コネクタのアクションとトリガーを確認、更新、または定義する

  1. 定義を選択し、ユーザーがワークフローに追加できる新しいアクションとトリガーの確認、編集、または定義を行います。

    アクションとトリガーは、WSDL ファイルで定義された操作に基づいており、定義ページに自動的に入力され、要求と応答の値を含めます。 必要な操作がすでに表示されている場合は、このページで変更を加えることなく、登録プロセスの次のステップに進むことができます。

    コネクタ定義のスクリーンショット。

  2. (オプション) 既存のアクションとトリガーを編集する場合、または新しいアクションとトリガーを追加する場合は、API 定義の編集例に進みます。

3. コネクタの作成を終了する

準備ができたら、コネクタをアップロードを選びコネクタを展開します。

おめでとうございます! これで、ロジック アプリを作成するときに、Logic Apps Designer でコネクタを見つけ、そのコネクタをロジック アプリに追加できます。

Logic Apps Designer でコネクタを見つけるスクリーンショット。

コネクタを他の Logic Apps ユーザーと共有する

登録されているが認定されていないカスタム コネクタは、1 つの例外を除いて、事前構築されたコネクタと同じように機能します。 アプリが展開されているリージョンの Logic Apps 用の同じ Microsoft Entra ID テナントと Azure サブスクリプションを持つコネクタの作成者とユーザー のみ に表示されます。 共有はオプションですが、コネクタを他のユーザーと共有したい場合があります。

重要

コネクタを共有すると、他のユーザーがそのコネクタに依存し始める可能性があります。 コネクタを削除すると、そのコネクタへのすべての接続が削除されます。

境界外の外部ユーザー — たとえばすべての Logic Apps ユーザー — とコネクタを共有するには、コネクタを認証します。 詳細については、コネクタを認証 に移動します。

よくあるご質問

Q: SOAP コネクタは一般提供されていますか?
A: SOAP コネクタはプレビュー段階にあり、まだ一般提供されているサービスではありません。

Q: SOAP コネクタに制限や既知の問題はありますか?
A: はい。 詳細については、SOAP コネクタの制限と既知の問題 へ移動します。

Q: カスタム コネクタに制限はありますか?
A: はい。 詳細については、カスタム コネクタの制限 に移動します。

サポートを受ける

  • 開発とオンボーディングのサポート、または登録ウィザードで利用できない機能をリクエストするには、condevhelp@microsoft.com にお問い合わせください。 Microsoft は、開発者の質問や問題についてこのアカウントを監視し、適切なチームにルーティングします。

  • 質問するまたは応答する、または他の Logic Apps ユーザーが何をしているかを確認するには、Azure Logic Apps フォーラム に移動します。

  • Logic Apps の改善するには、Logic Apps ユーザー フィードバック サイト で投票するか、アイデアを提出してください。

参照

自分のコネクタの認定
Azure Logic Apps、Power Automate、Power Apps のカスタム コネクタに関するよくあるご質問

フィードバックを提供する

コネクタ プラットフォームの問題点や新機能のアイデアなどのフィードバックをお待ちしています。 フィードバックを提供するには、「問題を送信するか、コネクタに関するヘルプを入手する」にアクセスし、フィードバックの種類を選択します。