配置数据源

了解如何配置不同类型的数据源并利用它们创建表单数据模型。

AEM Forms数据集成允许您配置和连接到不同的数据源。 现成支持以下类型。 但是，只需少量自定义，您也可以集成其他数据源。

• 关系数据库 — MySQL、Microsoft SQL Server、IBM DB2和Oracle RDBMS。
• AEM用户用户档案
• REST风格的Web服务
• 基于SOAP的Web服务
• OData服务

数据集成支持OAuth2.0、基本身份验证和API密钥现成身份验证类型，并允许为访问Web服务实施自定义身份验证。 在AEM Cloud Services中配置RESTful、基于SOAP和OData服务时，在AEM Web控制台中配置关系数据库的JDBC和AEM用户用户档案的连接器。

配置关系数据库

您可以使用AEM Web Console配置配置关系数据库。 执行以下操作：

1. 转到位于https://[server]:[host]/system/console/configMgr的AEM Web控制台。

2. 查找​Apache Sling Connection Pooled DataSource​配置。 点按可在编辑模式下打开配置。

3. 在“配置”对话框中，指定要配置的数据库的详细信息，例如：

   • 数据源的名称
   • 存储数据源名称的数据源服务属性
   • JDBC驱动程序的Java类名
   • JDBC连接URI
   • 用于与JDBC驱动程序建立连接的用户名和密码
   注意

   请确保在配置数据源之前加密敏感信息，如口令。 要加密：

   1. 转到 https://[server]:[port]/system/console/crypto.
   2. 在​纯文本​字段中，指定要加密的密码或任何字符串，然后单击​Protect。

   加密的文本将显示在“受保护文本”字段中，您可以在配置中指定该字段。

4. 启用​“借取时测试”​或“返回时测试”，以指定在从池借取对象或将对象返回池之前，验证对象。

5. 在​验证查询​字段中指定SQL SELECT查询，以验证池中的连接。 查询必须至少返回一行。 根据您的数据库，指定以下任一选项：

   • 选择1（MySQL和MS SQL）
   • 双选(Oracle)

6. 点按​保存​以保存配置。

配置AEM用户用户档案

您可以使用AEM Web Console中的用户用户档案连接器配置配置来配置AEM用户用户档案。 执行以下操作：

1. 转到位于https://[server]:[host]/system/console/configMgr的AEM Web控制台。

2. 查找​AEM Forms用户档案集成 — 用户数据连接器配置，然后点击以在编辑模式下打开配置。

3. 在“用户用户档案连接器配置”对话框中，可以添加、删除或更新用户用户档案属性。 指定的属性将可用于表单数据模型中。 使用以下格式指定用户用户档案属性：

   name=[property_name_with_location_in_user_profile],type=[property_type]

   示例：

   • name=profile/phoneNumber,type=string
   • name=profile/empLocation/*/city,type=string
   注意

   上例中的​*****​表示CRXDE结构中AEM用户用户档案中profile/empLocation/节点下的所有节点。 这意味着表单数据模型可以访问profile/empLocation/节点下任何节点中存在的string类型的city属性。 但是，包含指定属性的节点必须采用一致的结构。

4. 点按​保存​以保存配置。

为云服务配置配置文件夹

AEM中的所有云服务配置都整合在AEM存储库的/conf文件夹中。 默认情况下，conf文件夹包含global文件夹，您可以在其中创建云服务配置。 但是，您需要为云配置手动启用它。 您还可以在conf中创建其他文件夹，以创建和组织云服务配置。

要为云服务配置配置文件夹，请执行以下操作：

1. 转到​工具>常规>配置浏览器。

   • 有关详细信息，请参阅配置浏览器文档。

2. 执行以下操作以启用云配置的全局文件夹，或跳过此步骤，为云服务配置创建和配置其他文件夹。

   1. 在​配置浏览器​中，选择global文件夹，然后点按​属性。
   2. 在​配置属性​对话框中，启用​云配置。
   3. 点按​保存并关闭​以保存配置并退出对话框。

3. 在​配置浏览器​中，点按​创建。

4. 在​创建配置​对话框中，指定文件夹的标题并启用​云配置。

5. 点按​创建​以创建为云服务配置启用的文件夹。

配置RESTful Web服务

RESTful Web服务可在Swagger定义文件中使用JSON格式的Swagger规范或YAML格式进行描述。 要在AEM云服务中配置RESTful Web服务，请确保您的文件系统上有Swagger文件或文件托管的URL。

执行以下操作以配置RESTful服务：

1. 转到​工具>Cloud Services>数据源。 点按以选择要在其中创建云配置的文件夹。

   有关为云服务配置创建和配置文件夹的信息，请参阅为云服务配置配置文件夹。

2. 点按​创建​以打开​创建数据源配置对话框。 指定配置的名称和标题（可选），从​服务类型​下拉菜单中选择​RESTful服务，选择浏览并选择配置的缩略图，然后点按​下一步。

3. 为RESTful服务指定以下详细信息：

   • 从“Swagger源”下拉菜单中选择“URL”或“文件”，然后相应地指定Swagger URL到Swagger定义文件，或从本地文件系统上传Swagger文件。
   • 选择身份验证类型（无、OAuth2.0、基本身份验证、API密钥或自定义身份验证）以访问RESTful服务，并相应地提供身份验证的详细信息。

4. 点按​创建​以创建RESTful服务的云配置。

配置SOAP Web服务

使用Web服务描述语言(WSDL)规范描述基于SOAP的Web服务。 要在AEM云服务中配置基于SOAP的Web服务，请确保您具有Web服务的WSDL URL，并执行以下操作：

1. 转到​工具>Cloud Services>数据源。 点按以选择要在其中创建云配置的文件夹。

   有关为云服务配置创建和配置文件夹的信息，请参阅为云服务配置配置文件夹。

2. 点按​创建​以打开​创建数据源配置对话框。 指定配置的名称和标题（可选），从​服务类型​下拉菜单中选择​SOAP Web服务，选择浏览并选择配置的缩略图，然后点按​下一个。

3. 为SOAP Web服务指定以下内容：

   • Web服务的WSDL URL。

   • 服务端点. 在此字段中指定一个值，以覆盖在WSDL中指定的服务端点。

   • 选择身份验证类型（无、OAuth2.0、基本身份验证、自定义身份验证或X509令牌）以访问SOAP服务，并相应地提供身份验证的详细信息。

     如果选择“X509令牌”作为身份验证类型，请配置X509证书。 有关详细信息，请参阅设置证书。
     在​键别名​字段中指定X509证书的KeyStore别名。 在​“Time To Live”字段中指定验证请求保持有效的时间（以秒为单位）。 （可选）选择对邮件正文或时间戳标题进行签名，或者同时对两者进行签名。

4. 点按​创建​以创建SOAP Web服务的云配置。

配置OData服务

OData服务由其服务根URL标识。 要在AEM云服务中配置OData服务，请确保您具有该服务的服务根URL，并执行以下操作：

1. 转到​工具>Cloud Services>数据源。 点按以选择要在其中创建云配置的文件夹。

   有关为云服务配置创建和配置文件夹的信息，请参阅为云服务配置配置文件夹。

2. 点按​创建​以打开​创建数据源配置对话框。 指定配置的名称和标题（可选），从​服务类型​下拉菜单中选择​OData服务，选择浏览并选择配置的缩略图，然后点按​下一步。

3. 为OData服务指定以下详细信息：

   • 要配置的OData服务的服务根URL。
   • 选择身份验证类型（无、OAuth2.0、基本身份验证或自定义身份验证）以访问OData服务，并相应地提供身份验证的详细信息。
   注意

   必须选择OAuth 2.0身份验证类型，才能使用OData端点作为服务根连接Microsoft Dynamics服务。

4. 点按​创建​以创建OData服务的云配置。

后续步骤

您已配置数据源。 接下来，您可以创建表单数据模型；如果已经创建了没有数据源的表单数据模型，则可以将其与刚刚配置的数据源关联。 有关详细信息，请参阅创建表单数据模型。