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

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 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:

  1. Vaya a la consola web de Experience Manager en https://server:host/system/console/configMgr.

  2. Localice la configuración de Grupos de conexiones JDBC de Day Commons. Seleccione esta opción para abrir la configuración en modo de edición.

    Grupo de conectores JDBC

  3. En el cuadro de diálogo de configuración, especifique los detalles de la base de datos que desea configurar, como por ejemplo, los siguientes:

    • Nombre de clase Java™ para el controlador JDBC

    • URI de conexión JDBC

    • Nombre de usuario y contraseña para establecer conexión con el controlador JDBC

    • Especifique una consulta SQL SELECT en el campo Consulta de validación para validar conexiones desde el grupo. La consulta debe devolver al menos una fila. En función de la base de datos, especifique una de las siguientes opciones:

      • SELECT 1 (MySQL y MS® SQL)
      • SELECT 1 desde dual (Oracle)
    • Nombre de la fuente de datos

    Cadenas de muestra para configurar una base de datos relacional:

    code language-text
       "datasource.name": "sqldatasourcename-mysql",
       "jdbc.driver.class": "com.mysql.jdbc.Driver",
       "jdbc.connection.uri": "jdbc:mysql://$[env:AEM_PROXY_HOST;default=proxy.tunnel]:30001/sqldatasourcename"
    
    note note
    NOTE
    Consulte las Conexiones SQL con el conjunto de fuentes de datos JDBC para obtener información más detallada.
  4. Seleccione  Guardar  para salvar la configuración.

Ahora puede utilizar la base de datos relacional configurada con el modelo de datos de formulario (FDM).

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

El servicio web RESTful se puede describir con las especificaciones de Swagger en formato JSON o YAML en un archivo de definición de Swagger. 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.

Configuración de servicios RESTful para la especificación de API abierta versión 2.0 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.

Configuración de servicios RESTful para la especificación de API abierta versión 3.0 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 del cliente HTTP del modelo de datos del 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 del cliente HTTP del modelo de datos del 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 del formulario para fuente de datos de REST.

  2. En el diálogo Configuración del cliente HTTP del modelo de datos del 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 Suspensión de la 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 Suspensión 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