アダプティブフォームを Microsoft® SharePoint に接続
「SharePoint に送信」の送信アクションにより、アダプティブフォームと Microsoft® SharePoint ストレージをシームレスに接続できます。フォームを送信した後、選択した SharePoint ストレージにフォームデータが送信されます。
AEM as a Cloud Service では、フォーム送信を処理するための様々な送信アクションが標準で提供されます。これらのオプションについて詳しくは、アダプティブフォーム送信アクションの記事をご覧ください。
メリット
アダプティブフォームから SharePoint ストレージにデータを送信する利点の一部を次に示します。
- フォームデータを SharePoint に直接送信し、情報を一元的に保存および管理できるようにします。
- SharePoint のアクセス制御機能と権限機能を適用すると、権限のある個人のみが送信されたデータを表示または変更できるようになります。
「SharePoint に送信」を使用して、次の操作を実行できます。
アダプティブフォームを SharePoint ドキュメントライブラリに接続 connect-af-sharepoint-doc-library
アダプティブフォームで「SharePoint ドキュメントライブラリに送信」送信アクションを使用するには、次の手順に従います。
- SharePoint ドキュメントライブラリ設定の作成：AEM フォームを Microsoft Sharepoint ストレージに接続します。
- アダプティブフォームでの「SharePoint に送信」送信アクションの使用：アダプティブフォームを設定済みの Microsoft® SharePoint に接続します。
SharePoint ドキュメントライブラリの設定を作成 create-sharepoint-configuration
AEM Forms を Microsoft® Sharepoint ドキュメントライブラリストレージに接続するには、次の手順に従います。
-
AEM Forms オーサー インスタンス／ツール／Cloud Services／Microsoft® SharePoint に移動します。
-
Microsoft® SharePoint を選択すると、SharePoint ブラウザー にリダイレクトされます。
-
設定コンテナ を選択します。設定は、選択した設定コンテナに保存されます。
-
クリック 作成 > SharePoint Document Library 」をドロップダウンリストから選択します。 SharePoint 設定ウィザードが表示されます。
-
「タイトル」、「クライアント ID」、「クライアント秘密鍵」および「OAuth URL」を指定します。OAuth URL のクライアント ID、クライアントの秘密鍵、テナント ID を取得する方法について詳しくは、Microsoft® のドキュメントを参照してください。
-
アプリの
Client IDとClient Secretは Microsoft® Azure Portal から取得できます。 -
Microsoft® Azure Portal で、リダイレクト URI を
https://[author-instance]/libs/cq/sharepoint/content/configurations/wizard.htmlとして追加します。[author-instance]をオーサーインスタンスの URL に置き換えます。 -
読み取り/書き込み権限を付与する API 権限
offline_accessおよびSites.Manage.Allを追加します。Sites.Manage.Allは、Microsoft Graph API の権限範囲で、Sites の削除や変更など、SharePoint Sites のあらゆる側面を管理する機能をアプリケーションに付与します。note note NOTE また、Microsoft Graph API の Sites.Selected権限範囲を使用して 制限付きアクセスでSharePoint Sites を設定することもできます。Sites.Selectedは、Microsoft Graph API の権限範囲で、SharePoint サイトへのさらに詳細な制限されたアクセスを可能にします。 -
OAuth URL
https://login.microsoftonline.com/tenant-id/oauth2/v2.0/authorizeを使用します。<tenant-id>を Microsoft® Azure Portal のアプリのtenant-idに置き換えます。
note note NOTE クライアント秘密鍵 フィールドは、Azure Active Directory アプリケーションの設定に応じて、必須またはオプションになります。アプリケーションでクライアント秘密鍵を使用するように設定されている場合は、クライアントの秘密鍵を指定する必要があります。 -
-
「接続」をクリックします。接続に成功した場合、
Connection Successfulのメッセージが表示されます。 -
SharePoint サイト／ドキュメントライブラリ／SharePoint フォルダー を選択して、データを保存します。
note note NOTE - デフォルトでは、
forms-ootb-storage-adaptive-forms-submissionは選択した SharePoint サイトに存在します。 - 選択した SharePoint サイトの
Documentsライブラリにまだ存在しない場合は、「フォルダーを作成」をクリックして、フォルダーをforms-ootb-storage-adaptive-forms-submissionとして作成します。
- デフォルトでは、
アダプティブフォームの送信アクションに、この SharePoint サイト設定を使用できるようになりました。
アダプティブフォームでの SharePoint ドキュメントライブラリ設定の使用 use-sharepoint-configuartion-in-af
作成した SharePoint ドキュメントライブラリ設定をアダプティブフォーム内で使用すると、データや生成済みレコードのドキュメントを SharePoint フォルダーに保存できます。 アダプティブフォームで SharePoint ドキュメントライブラリストレージ設定を使用するには、次の手順を実行します。
-
「アダプティブフォーム」を作成します。
note note NOTE - SharePoint ドキュメントライブラリストレージを作成したアダプティブフォームと同じ設定コンテナを選択します。
- 設定コンテナが選択されていない場合、グローバルなストレージ設定フォルダーが送信アクションのプロパティウィンドウに表示されます。
-
「送信アクション」を「SharePoint に送信」として選択します。
-
データを保存する場所に「ストレージ設定」を選択します。
-
「保存」をクリックして、送信設定を保存します。
フォームを送信すると、データは指定した Microsoft® Sharepoint ドキュメントライブラリストレージに保存されます。
データを保存するフォルダー構造は /folder_name/form_name/year/month/date/submission_id/data です。
アダプティブフォームを Microsoft® SharePoint リストに接続 connect-af-sharepoint-list
アダプティブフォームで「SharePoint リストに送信」送信アクションを使用するには、次の手順に従います。
- SharePoint リスト設定を作成：AEM Forms を Microsoft® Sharepoint リストストレージに接続します。
- アダプティブフォームで「フォームデータモデル（FDM）を使用して送信」を使用：アダプティブフォームを設定済みの Microsoft® SharePoint に接続します。
SharePoint リスト設定を作成 create-sharepoint-list-configuration
AEM Forms を Microsoft® Sharepoint リストに接続するには、次の手順に従います。
-
ツール／クラウドサービス／Microsoft® SharePoint に移動します。
-
設定コンテナ を選択します。設定は、選択した設定コンテナに保存されます。
-
クリック 作成 > SharePoint List 」をドロップダウンリストから選択します。 SharePoint 設定ウィザードが表示されます。
-
「タイトル」、「クライアント ID」、「クライアント秘密鍵」および「OAuth URL」を指定します。OAuth URL のクライアント ID、クライアントの秘密鍵、テナント ID を取得する方法について詳しくは、Microsoft® のドキュメントを参照してください。
-
アプリの
Client IDとClient Secretは Microsoft® Azure Portal から取得できます。 -
Microsoft® Azure Portal で、リダイレクト URI を
https://[author-instance]/libs/cq/sharepointlist/content/configurations/wizard.htmlとして追加します。[author-instance]をオーサーインスタンスの URL に置き換えます。 -
API 権限の追加
offline_accessおよびSites.Manage.All（内） Microsoft® Graph タブを使用して、読み取り/書き込み権限を設定します。 追加AllSites.Manageの権限 SharePoint タブをクリックして、SharePointデータをリモートで操作します。 -
OAuth URL
https://login.microsoftonline.com/tenant-id/oauth2/v2.0/authorizeを使用します。<tenant-id>を Microsoft® Azure Portal のアプリのtenant-idに置き換えます。note note NOTE クライアント秘密鍵 フィールドは、Azure Active Directory アプリケーションの設定に応じて、必須またはオプションになります。アプリケーションでクライアント秘密鍵を使用するように設定されている場合は、クライアントの秘密鍵を指定する必要があります。
-
-
「接続」をクリックします。接続に成功した場合、
Connection Successfulのメッセージが表示されます。 -
選択 SharePoint Site および SharePoint List 」をドロップダウンリストから選択します。
-
「作成」を選択して、Microsoft® SharePointList 用のクラウド設定を作成します。
アダプティブフォームで「フォームデータモデル（FDM）を使用して送信」を使用 use-submit-using-fdm
作成した SharePoint リスト設定をアダプティブフォーム内で使用すると、データや生成済みのレコードのドキュメントを SharePoint リストに保存できます。アダプティブフォームで SharePoint リストを使用するには、次の手順を実行します。
フォームを送信すると、データは指定した Microsoft® Sharepoint リストストレージに保存されます。
- 画像列
- メタデータ列
- ユーザー列
- 外部データ列