アダプティブフォームと Microsoft® Power Automate の接続 connect-adaptive-form-with-power-automate

GovCloud を使用中に GCC (Government Cloud Computing)テナントに接続する必要がある場合は、公式アドレスから aem-forms-ea@adobe.com にメールを送信して、早期導入プログラムを介したアクセスをリクエストします。

送信時に Microsoft® Power Automate のクラウドフローを実行するように、アダプティブフォームを設定できます。設定済みのアダプティブフォームは、キャプチャされたデータ、添付ファイルおよびレコードのドキュメントを Power Automate クラウドフローに送信して処理します。 Microsoft® Power Automate の機能を活用して、キャプチャされたデータを中心にビジネスロジックを構築し、顧客のワークフローを自動化しながら、カスタムのデータキャプチャエクスペリエンスを構築するのに役立ちます。

アダプティブフォームエディターには「Microsoft® Power Automate フローの呼び出し」送信アクションが用意されており、アダプティブフォームのデータ、添付ファイル、レコードのドキュメントを Power Automate クラウドフローに送信できます。

AEM as a Cloud Service では、フォーム送信を処理するための様々な送信アクションが標準で提供されます。これらのオプションについて詳しくは、アダプティブフォーム送信アクションの記事を参照してください。

メリット

アダプティブフォームを Microsoft® Power Automated と統合した後に実行できる操作の例を以下に示します。

  • Power Automate のビジネスプロセスでアダプティブフォームデータを使用する
  • Power Automate を使用して、500 を超えるデータソースまたは一般公開されている API にキャプチャしたデータを送信する
  • キャプチャしたデータに対する複雑な計算を実行する
  • 事前に定義されたスケジュールでアダプティブフォームのデータをストレージシステムに保存する

前提条件

アダプティブフォームを Microsoft® Power Automate に接続するには、以下が必要です。

  • Microsoft® Power Automate Premium ライセンス。
  • アダプティブフォームの送信データを受け入れるための When an HTTP request is received トリガーを使用した Microsoft® Power Automate フロー
  • Forms 作成者および Forms 管理者権限を持つ Experience Manager ユーザー
  • Microsoft® Power Automate に接続するために使用されるアカウントは、アダプティブフォームからデータを受け取るように設定された Power Automate フローの所有者です

Forms as a Cloud Service インスタンスを Microsoft® Power Automate に接続する connect-forms-server-with-power-automate

Forms as a Cloud Service インスタンスを Microsoft® Power Automate に接続するには、次の操作を実行します。

Microsoft® Azure Active Directory アプリケーションを作成します ms-power-automate-application

  1. Azure Portal にログインします。

  2. 左側のナビゲーションから Azure Active Directory を選択します。

  3. デフォルトのディレクトリページで、左側のパネルから「アプリの登録」を選択します。

  4. アプリ登録ページで、「新規登録」をクリックします。

  5. そのページで、名前、サポートされているアカウントタイプおよびリダイレクト URI を指定します。 リダイレクト URI で、次の情報を指定し、「保存」をクリックします。

    • https://[Forms as a Cloud Service Server]/libs/fd/powerautomate/content/dataverse/config.html
    • https://[Forms as a Cloud Service Server]/libs/fd/powerautomate/content/flowservice/config.html

    Azure Active Directory アプリケーションの登録

    note note
    NOTE
    必要に応じて、認証ページから追加のリダイレクト URI を指定することもできます。
    サポートされるアカウントタイプに対して、ユースケースに応じて、シングルテナント、マルチテナントまたは個人の Microsoft® アカウントを選択します
  6. 認証ページで、次のオプションを有効にし、「保存」をクリックします。

    • アクセストークン(暗黙的なフローに使用)
    • ID トークン(暗黙的なフローとハイブリッドフローに使用)
  7. API 権限ページで、「Add a permission」をクリックします。

  8. Microsoft® API で、「Power Automate」を選択し、次の権限を選択します。

    • Flows.Manage.All
    • Flows.Read.All
    • GCC 権限(GCC(政府のクラウドコンピューティング)テナントに接続する場合はオプション)
      Add permissions」をクリックして、権限を保存します。
  9. API 権限ページで、「Add a permission」をクリックします。組織で使用している API を選択し、DataVerse を検索して user_impersonation を有効にし、Add 権限をクリックします。

  10. (オプション)証明書とシークレットページで、「新しいクライアントシークレット」をクリックします。 「クライアントシークレットの追加」画面で、説明とシークレットの有効期限を入力し、「追加」をクリックします。 シークレットの文字列が生成されます。

  11. 組織固有の Dynamics 環境の URL をメモしておいてください。

Microsoft® Power Automate Dataverse クラウド設定の作成 microsoft-power-automate-dataverse-cloud-configuration

  1. AEM Forms のオーサーインスタンスで、ツール ハンマー 一般設定ブラウザー ​に移動します。

  2. 設定ブラウザー ​ページで「作成」を設定します。

  3. 設定を作成 ​ダイアログで、設定の​ タイトル ​を指定し、「クラウド設定」を有効にして「作成」を選択します。これにより、Cloud Services 用の設定コンテナが作成されます。フォルダー名にスペースが含まれていないことを確認します。

  4. ツール ハンマー Cloud ServicesMicrosoft® Power Automate Dataverse に移動し、前の手順で作成した設定コンテナを開きます。

    note note
    NOTE
    アダプティブフォームを作成する際に、設定コンテナ ​フィールドにコンテナ名を指定します。
  5. 設定ページで「作成」をタップして、AEM Forms 内に Microsoft® Power Automate Flow Service の設定を作成します。

  6. Microsoft® Power Automate の Dataverse Service の設定 ​ページで、クライアント ID(アプリケーション ID とも呼ばれます)、クライアントシークレットOAuth URL および​ Dynamics 環境 URL を指定します。前のセクションで作成した Microsoft® Azure Active Directory アプリケーションのクライアント ID、クライアントシークレット、OAuth URL およびDynamics 環境 URL を使用します。Microsoft® Azure Active Directory アプリケーション UI の「エンドポイント」オプションを使用して OAuth URL を検索する

    Microsoft Power Automate アプリケーション UI の「エンドポイント」オプションを使用した OAuth URL の検索

  7. 接続」を選択します。必要に応じて、Microsoft® Azure アカウントにログインします。「保存」を選択します。

Microsoft® Power Automate フローサービスのクラウド設定を作成 create-microsoft-power-automate-flow-cloud-configuration

  1. ツール ハンマー Cloud ServicesMicrosoft® Power Automate フローサービス ​に移動し、前の手順で作成した設定コンテナを開きます。

    note note
    NOTE
    アダプティブフォームを作成する際に、設定コンテナ ​フィールドにコンテナ名を指定します。
  2. 設定ページで「作成」をタップして、AEM Forms 内に Microsoft® Power Automate Flow Service の設定を作成します。

  3. (オプション)GCC テナントに接続するには、「Connect to Microsoft GCC」チェックボックスをオンにします。

    note note
    NOTE
    GCC(政府のクラウドコンピューティング)テナントに接続する場合は、Microsoft Azure Portal で GCC 権限を選択します。

    Power Automate クラウド設定

  4. Microsoft® Power Automate の Dataverse の設定 ​ページで、クライアント ID(アプリケーション ID とも呼ばれます)、クライアントシークレットOAuth URL および​ Dynamics 環境 URL を指定します。 クライアント ID、クライアントシークレット、OAuth URL、Dynamics 環境 ID を使用します。 Microsoft® Azure Active Directory アプリケーション UI の「エンドポイント」オプションを使用して、OAuth URL を検索します。 マイフローリンクを開いて「マイフロー」を選択し、URL にリストされている ID を Dynamics 環境 ID として使用します。

  5. 接続」を選択します。必要に応じて、Microsoft® Azure アカウントにログインします。「保存」を選択します。

Microsoft® Power Automate Dataverse と Microsoft® Power Automate フローサービスのクラウド設定の両方を公開する publish-microsoft-power-automate-dataverse-cloud-configuration

  1. ツール ハンマー Cloud ServicesMicrosoft® Power Automate Dataverse に移動し、前の「Microsoft® Power Automate Dataverse クラウド設定の作成」セクションで作成した設定コンテナを開きます。
  2. dataverse 設定を選択し、「公開」を選択します。
  3. 公開ページで「すべての設定」を選択し、「公開」を選択します。Power Automate Dataverse と Power Automate フローサービスのクラウド設定の両方を公開します。

これで、Forms as a Cloud Service インスタンスが Microsoft® Power Automate に接続されました。アダプティブフォームのデータを Power Automate フローに送信できるようになりました。

「Microsoft® Power Automate フローの呼び出し」送信アクションを使用して、Power Automate フローにデータを送信する use-the-invoke-microsoft-power-automate-flow-submit-action

Forms as a Cloud Service インスタンスを Microsoft® Power Automate に接続した後、次の操作を実行して、フォーム送信時に、キャプチャしたデータを Microsoft® フローに送信するようアダプティブフォームを設定します。

基盤コンポーネント
  1. オーサーインスタンスにログインし、アダプティブフォームを選択して、「プロパティ」をクリックします。

  2. 設定コンテナで、Microsoft® Power Automate Dataverse クラウド設定を作成セクションで作成したコンテナを参照して選択し、「保存して閉じる」を選択します。

  3. 編集用にアダプティブフォームを開き、アダプティブフォームのコンテナプロパティの「送信」セクションに移動します。

  4. プロパティコンテナで、送信アクション ​に「Power Automate フローを呼び出す」オプションを選択し、「Power Automate フロー」を選択します。必要なフローを選択すると、送信時にアダプティブフォームデータが送信されます。

    送信アクションの設定

  5. 完了」をクリックします。

note note
NOTE
アダプティブフォームを送信する前に、以下の JSON スキーマを持つ When an HTTP Request is received トリガーが Power Automate フローに追加されていることを確認してください。
code language-none
        {
            "type": "object",
            "properties": {
                "attachments": {
                    "type": "array",
                    "items": {
                        "type": "object",
                        "properties": {
                            "filename": {
                                "type": "string"
                            },
                            "data": {
                                "type": "string"
                            },
                            "contentType": {
                                "type": "string"
                            },
                            "size": {
                                "type": "integer"
                            }
                        },
                        "required": [
                            "filename",
                            "data",
                            "contentType",
                            "size"
                        ]
                    }
                },
                "templateId": {
                    "type": "string"
                },
                "templateType": {
                    "type": "string"
                },
                "data": {
                    "type": "string"
                },
                "document": {
                    "type": "object",
                    "properties": {
                        "filename": {
                            "type": "string"
                        },
                        "data": {
                            "type": "string"
                        },
                        "contentType": {
                            "type": "string"
                        },
                        "size": {
                            "type": "integer"
                        }
                    }
                }
            }
        }
コアコンポーネント
  1. オーサーインスタンスにログインし、アダプティブフォームを選択して、「プロパティ」をクリックします。

  2. 設定コンテナで、Microsoft® Power Automate Dataverse クラウド設定を作成セクションで作成したコンテナを参照して選択し、「保存して閉じる」を選択します。

  3. コンテンツブラウザーを開き、アダプティブフォームの​ ガイドコンテナ ​コンポーネントを選択します。

  4. ガイドコンテナプロパティ ガイドプロパティ アイコンをクリックします。 アダプティブフォームコンテナダイアログボックスが開きます。

  5. 送信」タブをクリックします。

  6. 送信アクションドロップダウンリストから「Power Automate フローを呼び出す」オプションを選択し、「Power Automate フロー」を選択します。 必要なフローを選択すると、送信時にアダプティブフォームデータが送信されます。

    送信アクションの設定

  7. 完了」をクリックします。

note note
NOTE
アダプティブフォームを送信する前に、以下の JSON スキーマを持つ When an HTTP Request is received トリガーが Power Automate フローに追加されていることを確認してください。
code language-none
        {
            "type": "object",
            "properties": {
                "attachments": {
                    "type": "array",
                    "items": {
                        "type": "object",
                        "properties": {
                            "filename": {
                                "type": "string"
                            },
                            "data": {
                                "type": "string"
                            },
                            "contentType": {
                                "type": "string"
                            },
                            "size": {
                                "type": "integer"
                            }
                        },
                        "required": [
                            "filename",
                            "data",
                            "contentType",
                            "size"
                        ]
                    }
                },
                "templateId": {
                    "type": "string"
                },
                "templateType": {
                    "type": "string"
                },
                "data": {
                    "type": "string"
                },
                "document": {
                    "type": "object",
                    "properties": {
                        "filename": {
                            "type": "string"
                        },
                        "data": {
                            "type": "string"
                        },
                        "contentType": {
                            "type": "string"
                        },
                        "size": {
                            "type": "integer"
                        }
                    }
                }
            }
        }
ユニバーサルエディター
  1. オーサーインスタンスにログインし、アダプティブフォームを選択します。

  2. 設定コンテナで、Microsoft® Power Automate Dataverse クラウド設定を作成セクションで作成したコンテナを参照して選択し、「保存して閉じる」を選択します。

  3. アダプティブフォームを編集用に開きます。

  4. エディターで​ フォームプロパティを編集 拡張機能をクリックします。
    フォームプロパティ ​ダイアログが表示されます。

    note note
    NOTE
    • ユニバーサルエディターインターフェイスに フォームプロパティを編集 アイコンが表示されない場合は、Extension Manager で​ フォームプロパティを編集 ​拡張機能を有効にします。
    • ユニバーサルエディターで拡張機能を有効または無効にする方法については、Extension Manager 機能のハイライトの記事を参照してください。
  5. 送信」タブをクリックし、「Power Automate フローを呼び出す」送信アクションを選択します。必要なフローを選択すると、送信時にアダプティブフォームデータが送信されます。

    送信アクションの設定

  6. 保存して閉じる」をクリックします。

note note
NOTE
アダプティブフォームを送信する前に、以下の JSON スキーマを持つ When an HTTP Request is received トリガーが Power Automate フローに追加されていることを確認してください。
code language-none
        {
            "type": "object",
            "properties": {
                "attachments": {
                    "type": "array",
                    "items": {
                        "type": "object",
                        "properties": {
                            "filename": {
                                "type": "string"
                            },
                            "data": {
                                "type": "string"
                            },
                            "contentType": {
                                "type": "string"
                            },
                            "size": {
                                "type": "integer"
                            }
                        },
                        "required": [
                            "filename",
                            "data",
                            "contentType",
                            "size"
                        ]
                    }
                },
                "templateId": {
                    "type": "string"
                },
                "templateType": {
                    "type": "string"
                },
                "data": {
                    "type": "string"
                },
                "document": {
                    "type": "object",
                    "properties": {
                        "filename": {
                            "type": "string"
                        },
                        "data": {
                            "type": "string"
                        },
                        "contentType": {
                            "type": "string"
                        },
                        "size": {
                            "type": "integer"
                        }
                    }
                }
            }
        }

関連記事

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab