DocumentaciónAEM as a Cloud ServiceGuía del usuario

Configuración de las fuentes de datos configure-data-sources

Last update: Wed Jan 07 2026 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Se aplica a:
  • Experience Manager as a Cloud Service

Creado para:

  • Principiante
  • Usuario
  • Desarrollador
Versión
Vínculo del artículo
AEM 6.5
Haga clic aquí
AEM as a Cloud Service
Este artículo

Integración de datos

La integración de datos de Experience Manager Forms le permite configurar y conectarse a fuentes de datos diferentes. Los siguientes tipos son compatibles de forma predeterminada:

  • Bases de datos relacionales: MySQL, Microsoft® SQL Server, IBM® DB2®, postgreSQL, Azure SQL y Oracle RDBMS
  • Servicios web RESTful
  • Servicios web basados en SOAP
  • Servicios OData (versión 4.0)
  • Microsoft® Dynamics
  • SalesForce
  • Microsoft® Azure Blob Storage

La integración de datos es compatible con los tipos de autenticación OAuth2.0(Código de autorización, Credenciales de cliente), autenticación básica y clave de la API predeterminados, y permite implementar la autenticación personalizada para acceder a servicios web. Mientras que los servicios RESTful, basados en SOAP y OData están configurados en Experience Manager as a Cloud Service, JDBC para bases de datos relacionales y conector para el perfil de usuario de Experience Manager están configurados en la consola web de Experience Manager.

Configuración de la base de datos relacional configure-relational-database

Requisitos previos

Antes de configurar bases de datos relacionales mediante la configuración de la consola web de Experience Manager, es obligatorio lo siguiente:

Pasos para configurar una base de datos relacional

Puede configurar bases de datos relacionales mediante la configuración de la consola web de Experience Manager. Haga lo siguiente:

Paso 1: clonar el repositorio Git de AEM as a Cloud Service

  1. Abra la línea de comandos y seleccione un directorio para almacenar el repositorio de AEM as a Cloud Service, como /cloud-service-repository/.

  2. Ejecute el siguiente comando para clonar el repositorio:

    code language-none 
    git clone https://git.cloudmanager.adobe.com/<organization-name>/<app-id>/

    ¿Dónde se encuentra esta información?

    Para obtener instrucciones paso a paso sobre cómo localizar estos detalles, consulte el artículo de Adobe Experience League “Acceder a Git”.

    Cuando el comando se complete correctamente, verá que se ha creado una nueva carpeta en su directorio local. Esta carpeta recibe el nombre de su aplicación.

Paso 2: Vaya a la carpeta de configuración

  1. Abra la carpeta del repositorio en un editor.

  2. Vaya al siguiente directorio de su <application folder> donde se debe colocar la configuración OSGi para el grupo JDBC:

    code language-bash 
    cd ui.config/src/jcr_root/apps/<application folder>/osgiconfig/config/

Paso 3: Crear el archivo de configuración de la conexión MySQL

  1. Cree el archivo:

    code language-bash 
    com.day.commons.datasource.jdbcpool.JdbcPoolService~<application folder>-mysql.cfg.json

  2. Añada las siguientes líneas de código:

{
  "jdbc.driver.class": "com.mysql.cj.jdbc.Driver",
  "jdbc.connection.uri": "jdbc:mysql://<hostname>:<port>/<database>?useSSL=false",
  "jdbc.username": "<your-db-username>",
  "jdbc.password": "<your-db-password>",
  "datasource.name": "<application folder>-mysql",
  "datasource.svc.prop.name": "<application folder>-mysql"
}

Reemplace marcadores de posición como <application folder>, <hostname>, <database>, <your-db-username> y <your-db-password> con valores reales.

Paso 4: confirmar y enviar los cambios

Abra el terminal y ejecute los siguientes comandos:

git add .
git commit -m "<commit message>"
git push

Paso 5: Implementar los cambios a través de la canalización de Cloud Manager

  1. Inicie sesión en AEM Cloud Manager.
  2. Vaya al proyecto y ejecute la canalización para implementar los cambios.
NOTE
Consulte las Conexiones SQL con el conjunto de fuentes de datos JDBC para obtener información más detallada.

Configurar carpetas para configuraciones de servicios en la nube cloud-folder

La configuración de la carpeta de servicios en la nube es necesaria para configurar los servicios en la nube para los servicios RESTful, SOAP y OData.

Todas las configuraciones de servicios en la nube en Experience Manager se consolidan en la carpeta /conf, en el repositorio Experience Manager. De forma predeterminada, la carpeta conf contiene la carpeta global, donde puede crear configuraciones de servicios en la nube. Con todo, debe habilitarlo manualmente para las configuraciones en la nube. También puede crear carpetas adicionales en conf para crear y organizar configuraciones de servicios en la nube.

Para configurar la carpeta para las configuraciones de servicios en la nube:

  1. Vaya a Herramientas > General > Explorador de configuración.

  2. Haga lo siguiente para habilitar la carpeta global para configuraciones de nube u omita este paso para crear y configurar otra carpeta para configuraciones de servicios en la nube.

    1. En el Explorador de configuración, seleccione la carpeta global y Propiedades.

    2. En el cuadro de diálogo Propiedades de configuración, habilite Configuraciones de nube.

    3. Seleccione  Guardar y cerrar  para guardar la configuración y salir del cuadro de diálogo.

  3. En el Explorador de configuración, seleccione Crear.

  4. En el cuadro de diálogo Crear configuración, especifique un título para la carpeta y habilite Configuraciones de nube.

  5. Seleccione  Crear  para crear la carpeta habilitada para las configuraciones del servicio en la nube.

Configurar servicios web de RESTful configure-restful-web-services

Los servicios web RESTful se pueden describir con las especificaciones de Swagger en formato JSON o YAML en un archivo de definición de Swagger o un punto final de servicio.

NOTE
Para configurar el servicio web RESTful en Experience Manager as a Cloud Service, asegúrese de que dispone del archivo Swagger (versión 2.0 de Swagger) o Swagger (versión 3.0 de Swagger) en su sistema de archivos o la URL donde se hospeda el archivo.

Configure los servicios RESTful para la versión 2.0 de la especificación de API abierta configure-restful-services-open-api-2.0

  1. Vaya a Herramientas > Cloud Services > Fuentes de datos. Seleccione para elegir la carpeta en la que desea crear una configuración de nube.

    Consulte Configurar carpetas para configuraciones de servicios en la nube para obtener información sobre la creación y configuración de una carpeta para configuraciones de servicios en la nube.

  2. Seleccione Crear para abrir el Asistente de configuración para crear fuentes de datos. Especifique un nombre y, opcionalmente, un título para la configuración, seleccione Servicio RESTful en la lista desplegable Tipo de servicio; opcionalmente puede examinar y seleccionar una imagen de miniatura para la configuración y seleccionar Siguiente.

  3. Especifique los siguientes detalles para el servicio RESTful:

    • Seleccione la URL o archivo en la lista desplegable Fuente de Swagger y, en consecuencia, especifique el Swagger URL para el archivo de definición ​ Swagger o cargue el archivo Swagger de su sistema de archivos local.

    • En función de la entrada de fuente de ​ Swagger, los siguientes campos aparecen ya cumplimentados con valores:

      • Esquema: Los protocolos de transferencia utilizados por el API de REST. El número de tipos de esquema que se muestran en la lista desplegable depende de los esquemas definidos en la fuente de Swagger.
      • Host: El nombre de dominio o la dirección IP del host que sirve el API de REST. Es un campo obligatorio.
      • Ruta base: El prefijo URL de todas las rutas de API. Es un campo opcional.
        Si es necesario, edite los valores rellenados previamente para estos campos.

    • Seleccione el tipo de autenticación (ninguna, OAuth2.0(Código de autorización, Credenciales de cliente), autenticación básica, clave de la API o autenticación personalizada) para acceder al servicio RESTful y facilitar los detalles correspondientes para la autenticación.

    Si selecciona clave de la API como tipo de autenticación, especifique el valor de la clave de la API. La clave de la API se puede enviar como encabezado de solicitud o como parámetro de consulta. Seleccione una de estas opciones en la lista desplegable Ubicación y especifique el nombre del encabezado o el parámetro de consulta en el campo Nombre del parámetro.

  4. Seleccione  Crear  para crear la configuración de nube para el servicio RESTful.

Configurar servicios RESTful para la versión 3.0 de la especificación de API abierta configure-restful-services-open-api-3.0

  1. Vaya a Herramientas > Cloud Services > Fuentes de datos. Seleccione para elegir la carpeta en la que desea crear una configuración de nube.

    Consulte Configurar carpetas para configuraciones de servicios en la nube para obtener información sobre la creación y configuración de una carpeta para configuraciones de servicios en la nube.

  2. Seleccione Crear para abrir el Asistente de configuración para crear fuentes de datos. Especifique un nombre y, opcionalmente, un título para la configuración, seleccione Servicio RESTful en la lista desplegable Tipo de servicio; opcionalmente puede examinar y seleccionar una imagen de miniatura para la configuración y seleccionar Siguiente.

  3. Especifique los siguientes detalles para el servicio RESTful:

    • Seleccione la URL o archivo en la lista desplegable Fuente de Swagger y, en consecuencia, especifique la Swagger 3.0 URL para el archivo de definición ​ Swagger o cargue el archivo Swagger de su sistema de archivos local.
    • En función de la entrada de origen de ​ Swagger, se muestra la información de conexión con el servidor de destino.
    • Seleccione el tipo de autenticación (ninguna, OAuth2.0(Código de autorización, Credenciales de cliente), autenticación básica, clave de la API o autenticación personalizada) para acceder al servicio RESTful y facilitar los detalles correspondientes para la autenticación.

    Si selecciona clave de la API como tipo de autenticación, especifique el valor de la clave de la API. La clave de la API se puede enviar como encabezado de solicitud o como parámetro de consulta. Seleccione una de estas opciones en la lista desplegable Ubicación y especifique el nombre del encabezado o el parámetro de consulta en el campo Nombre del parámetro.

  4. Seleccione Crear para crear la configuración de nube para el servicio RESTful.

Algunas de las operaciones no admitidas por los servicios de la especificación de API abierta versión 3.0 son las siguientes:

  • Rellamadas
  • Uno de/cualquiera de
  • Referencia remota
  • Vínculos
  • Diferentes cuerpos de solicitud para diferentes tipos de MIME para una sola operación

Consulte Especificación de OpenAPI 3.0 para obtener información detallada.

Configuración de servicios RESTful mediante el punto final de servicio configure-restful-services-service-endpoint

La capacidad de punto final de servicio está en el programa para primeros usuarios y solo se aplica a los componentes principales. Puede enviar un correo electrónico a aem-forms-ea@adobe.com desde su ID de correo electrónico oficial para unirse al programa para primeros usuarios y solicitar acceso a esta funcionalidad.

  1. Vaya a Herramientas > Cloud Services > Fuentes de datos. Seleccione para elegir la carpeta en la que desea crear una configuración de nube.

    Consulte Configurar carpetas para configuraciones de servicios en la nube para obtener información sobre la creación y configuración de una carpeta para configuraciones de servicios en la nube.

  2. Seleccione  Crear  para abrir el asistente Crear configuración de origen de datos.

  3. Especifique un nombre y, opcionalmente, un título para la configuración. Seleccione Servicio RESTful en la lista desplegable Tipo de servicio; opcionalmente puede examinar y seleccionar una imagen de miniatura para la configuración y seleccionar Siguiente.

  4. En la página siguiente, seleccione Punto final de servicio de la lista desplegable Servicio RESTful.

    Punto final de servicio

  5. Especifique la URL de punto final de servicio.

    note note
    NOTE
    De forma predeterminada, el tipo de método es POST.

    1. Seleccione el tipo de contenido que prefiera de la lista desplegable. Los tipos de contenido son datos de formulario de varias partes, JSON y con codificación de URL (par clave-valor).

  6. Ahora puede seleccionar cualquiera de los tipos de autenticación, como OAuth 2.0, autenticación básica, clave API o autenticación personalizada, en la lista desplegable.
    Tipo de autenticación de punto final de servicio

  7. Haga clic en Crear.

Configuración del cliente HTTP del modelo de datos de formulario (FDM) para optimizar el rendimiento fdm-http-client-configuration

Modelo de datos del formulario Experience Manager Forms al integrarse con los servicios web RESTful, ya que la fuente de datos incluye configuraciones de cliente HTTP para la optimización del rendimiento.

Establezca las siguientes propiedades de la configuración Configuración del cliente HTTP del modelo de datos de formulario para fuente de datos de REST para especificar la expresión regular:

  • Utilice la propiedad http.connection.max.per.route para establecer el número máximo de conexiones permitidas entre el modelo de datos de formulario (FDM) y los servicios web RESTful. El valor predeterminado es 20 conexiones.

  • Utilice la propiedad http.connection.max para especificar el número máximo de conexiones permitidas para cada ruta. El valor predeterminado es 40 conexiones.

  • Utilice la propiedad http.connection.keep.alive.duration para especificar la duración durante la cual se mantiene activa una conexión HTTP persistente. El valor predeterminado es 15 segundos.

  • Utilice la propiedad http.connection.timeout para especificar la duración, durante la cual el servidor Experience Manager Forms espera a que se establezca una conexión. El valor predeterminado es 10 segundos.

  • Utilice la propiedad http.socket.timeout para especificar el período máximo de inactividad entre dos paquetes de datos. El valor predeterminado es 30 segundos.

El siguiente archivo JSON muestra un ejemplo:

{
   "http.connection.keep.alive.duration":"15",
   "http.connection.max.per.route":"20",
   "http.connection.timeout":"10",
   "http.socket.timeout":"30",
   "http.connection.idle.connection.timeout":"15",
   "http.connection.max":"40"
}

  1. Seleccione Configuración del cliente HTTP del modelo de datos de formulario para fuente de datos de REST.

  2. En el diálogo Configuración del cliente HTTP del modelo de datos de formulario para fuente de datos de REST:

    • Especifique el número máximo de conexiones permitidas entre el modelo de datos de formulario (FDM) y los servicios web RESTful en el campo Límite de conexión en total. El valor predeterminado es 20 conexiones.

    • Especifique el número máximo de conexiones permitidas para cada ruta en el campo Límite de conexión por ruta. El valor predeterminado son dos conexiones.

    • Especifique la duración, durante la cual se mantiene activa una conexión HTTP persistente, en el campo Mantener activa. El valor predeterminado es 15 segundos.

    • Especifique la duración durante la que el servidor Experience Manager Forms espera a que se establezca una conexión, en el campo Tiempo de espera de conexión. El valor predeterminado es 10 segundos.

    • Especifique el período de tiempo máximo de inactividad entre dos paquetes de datos en el campo Tiempo de espera de la toma. El valor predeterminado es 30 segundos.

Configurar servicios web SOAP configure-soap-web-services

Los servicios web basados en SOAP se describen utilizando Especificaciones del lenguaje de descripción de servicios web (WSDL). Experience Manager Forms no admite el modelo WSDL de estilo RPC.

Para configurar el servicio web basado en SOAP en Experience Manager as a Cloud Service, asegúrese de que cuenta con la URL de WSDL para el servicio web y haga lo siguiente:

  1. Vaya a Herramientas > Cloud Services > Fuentes de datos. Seleccione para elegir la carpeta en la que desea crear una configuración de nube.

    Consulte Configurar carpetas para configuraciones de servicios en la nube para obtener información sobre la creación y configuración de una carpeta para configuraciones de servicios en la nube.

  2. Seleccione Crear para abrir el Asistente de configuración para crear las fuentes de datos. Especifique un nombre y, opcionalmente, un título para la configuración, seleccione Servicio web SOAP en la lista desplegable Tipo de servicio. También puede examinar y seleccionar una imagen en miniatura para la configuración y seleccionar Siguiente.

  3. Especifique lo siguiente para el servicio web SOAP:

    • URL de WSDL para el servicio web.

    • Punto final de servicio. Especifique un valor en este campo para anular el punto final de servicio mencionado en WSDL.

    • Seleccione el tipo de autenticación (ninguna, OAuth2.0(Código de autorización, Credenciales de cliente), autenticación básica o autenticación personalizada) para acceder al servicio SOAP y facilitar los detalles correspondientes para la autenticación.

  4. Seleccione  Crear  para crear la configuración de nube para el servicio web SOAP.

Habilitar el uso de instrucciones de importación en el WSDL de los servicios web SOAP enable-import-statements

Puede especificar una expresión regular que sirva como filtro para las URL absolutas permitidas como instrucciones de importación en el WSDL de los servicios web SOAP. De forma predeterminada, no hay ningún valor en este campo. Como resultado, Experience Manager bloquea todas las instrucciones de importación disponibles en WSDL. Si especifica .* como el valor de este campo, Experience Manager permite todas las instrucciones de importación.

Establezca la propiedad importAllowlistPattern de la configuración Lista de permitidos de importación de servicios web SOAP del modelo de datos de formulario configuración para especificar la expresión regular. El siguiente archivo JSON muestra un ejemplo:

{
  "importAllowlistPattern": ".*"
}

Para establecer los valores de una configuración, Generar configuraciones OSGi mediante el SDK de AEM e implemente la configuración a su instancia de Cloud Service.

Configurar servicios OData config-odata

Un servicio OData se identifica mediante su URL raíz de servicio. Para configurar un servicio OData en Experience Manager as a Cloud Service, asegúrese de que tiene una URL raíz de servicio para el servicio y haga lo siguiente:

NOTE
El modelo de datos de formulario (FDM) es compatible con la versión 4 de OData.
Para obtener una guía paso a paso sobre la configuración de Microsoft®® Dynamics 365, en línea o de forma local, consulte Microsoft® Dynamics Configuración de OData.

  1. Vaya a Herramientas > Cloud Services > Fuentes de datos. Seleccione para elegir la carpeta en la que desea crear una configuración de nube.

    Consulte Configurar carpetas para configuraciones de servicios en la nube para obtener información sobre la creación y configuración de una carpeta para configuraciones de servicios en la nube.

  2. Seleccione Crear para abrir el Asistente de configuración para crear fuentes de datos. Especifique un nombre y, opcionalmente, un título para la configuración, seleccione Servicio OData en la lista desplegable Tipo de servicio. También puede examinar y seleccionar una imagen en miniatura para la configuración y seleccionar Siguiente.

  3. Especifique los siguientes detalles para el servicio OData:

    • URL raíz del servicio para configurar el servicio OData.
    • Seleccione el tipo de autenticación (ninguna, OAuth2.0,(Código de autorización, Credenciales de cliente), autenticación básica, clave de la API o autenticación personalizada) para acceder al servicio OData y facilitar los detalles correspondientes para la autenticación.

    Si selecciona clave de la API como tipo de autenticación, especifique el valor de la clave de la API. La clave de la API se puede enviar como encabezado de solicitud o como parámetro de consulta. Seleccione una de estas opciones en la lista desplegable Ubicación y especifique el nombre del encabezado o el parámetro de consulta en el campo Nombre del parámetro.

    note note
    NOTE
    Debe seleccionar el tipo de autenticación OAuth 2.0 con el que conectarse a los servicios de Microsoft®® Dynamics que utilizan el punto final OData como raíz de servicio.

  4. Seleccione  Crear  para crear la configuración de nube para el servicio OData.

Pasos siguientes next-steps

Ha configurado las fuentes de datos. A continuación, puede crear un modelo de datos de formulario (FDM) o, si ya ha creado uno sin fuente de datos, puede asociarlo a la fuente de datos que acaba de configurar. Consulte Crear un modelo de datos de formulario para obtener más información.

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