将自适应表单连接到Microsoft® SharePoint

Last update: Thu Jul 25 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

创建对象：

用户
开发人员

通过 提交到SharePoint 提交操作，可将自适应表单与Microsoft® SharePoint存储无缝连接。在您提交表单后，它会将表单数据发送到您选择的SharePoint存储中。

AEM as a Cloud Service提供了多种现成的提交操作来处理表单提交。您可以在自适应表单提交操作文章中了解有关这些选项的更多信息。

优点

将数据从自适应表单提交到SharePoint存储的一些优势包括：

它有助于将表单数据直接提交到SharePoint，为存储和管理信息提供一个集中的位置。
通过应用SharePoint的访问控制和权限功能，可确保只有授权人员才能查看或修改提交的数据。

使用 提交到SharePoint，您可以：

将自适应表单连接到SharePoint文档库
将自适应表单连接到SharePoint列表

将自适应表单连接到SharePoint文档库 connect-af-sharepoint-doc-library

要在自适应表单中使用 提交到SharePoint文档库 提交操作，请执行以下操作：

创建SharePoint文档库配置：它将AEM Forms连接到您的Microsoft® Sharepoint存储。
在自适应表单中使用“提交到 SharePoint”提交操作：它将自适应表单连接到配置的 Microsoft® SharePoint。

创建SharePoint文档库配置 create-sharepoint-configuration

要将AEM Forms连接到Microsoft®Sharepoint文档库存储，请执行以下操作：

转到您的 AEM Forms创作 实例> 工具 > Cloud Service > Microsoft®SharePoint。
选择 Microsoft® SharePoint 后，您将被重定向到 SharePoint浏览器。
选择 配置容器。配置存储在选定的配置容器中。
从下拉列表中单击创建 > SharePoint文档库。这将显示 SharePoint 配置向导。

指定标题、客户端 ID、客户端密码 和 OAuth URL。有关如何检索 OAuth URL 的客户端 ID、客户端密码、租户 ID 的信息，请参阅 Microsoft® 文档。

您可以从 Microsoft® Azure 门户检索应用程序的Client ID 和Client Secret。
在 Microsoft® Azure 门户中，将重定向 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中的权限范围，它允许应用程序管理SharePoint Sites的所有方面，例如删除或修改站点。

note note
NOTE
您还可以使用SharePoint图形API中的`Sites.Selected`权限范围配置具有有限访问权限的Microsoft站点。 `Sites.Selected`是Microsoft的Graph API中的权限范围，它允许对SharePoint站点进行更细粒度和更受限的访问。

使用 OAuth URL：https://login.microsoftonline.com/tenant-id/oauth2/v2.0/authorize。将 <tenant-id> 替换为 Microsoft® Azure 门户中应用程序的 tenant-id。

note note
NOTE
客户端密码字段是必填还是可选字段取决于 Azure Active Directory 应用程序配置。如果应用程序配置为使用客户端密码，则必须提供客户端密码。

单击连接。连接成功后，将显示Connection Successful消息。

现在，选择 SharePoint站点 > 文档库 > SharePoint文件夹 以保存数据。

note note
NOTE
默认情况下，`forms-ootb-storage-adaptive-forms-submission`存在于选定的SharePoint站点中。通过单击创建文件夹，将文件夹创建为`forms-ootb-storage-adaptive-forms-submission`(如果选定SharePoint站点的`Documents`库中尚不存在)。

现在，您可以在自适应表单中将此SharePoint Sites配置用于提交操作。

在自适应表单中使用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。