Configuración de fuentes de datos

Integración de datos

Experience Manager Forms La integración de datos permite configurar y conectar a fuentes de datos diferentes. Los siguientes tipos son compatibles de serie:

  • Servicios web RESTful
  • Servicios web basados en SOAP
  • Servicios OData (versión 4.0)
  • Microsoft Dynamics
  • SalesForce
  • Almacenamiento de Microsoft Azure Blob

La integración de datos es compatible con los tipos de autenticación OAuth2.0, Autenticación básica y API Key de serie, y permite implementar autenticación personalizada para acceder a servicios web. Mientras que los servicios RESTful, SOAP y OData están configurados en Experience Manager as a Cloud Service y conector para Experience Manager el perfil de usuario está configurado en Experience Manager consola web.

NOTA

Experience Manager Forms no admite la base de datos relacional.

Configuración de la carpeta para configuraciones de servicios en la nube

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

Todas las configuraciones de servicios en la nube en Experience Manager se consolidan en la variable /conf carpeta Experience Manager repositorio. De forma predeterminada, la variable conf La carpeta contiene el global carpeta donde puede crear configuraciones de servicios en la nube. Sin embargo, debe habilitarlo manualmente para las configuraciones de 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 del servicio 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 o omita este paso para crear y configurar otra carpeta para configuraciones de servicios de nube.

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

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

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

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

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

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

Configuración de los servicios web de RESTful

El servicio web RESTful se puede describir mediante Especificaciones de Swagger en formato JSON o YAML en un Swagger archivo de definición. Para configurar el servicio web RESTful en Experience Manager as a Cloud Service, asegúrese de que dispone de la variable Swagger archivo (Swagger versión 2.0) en el sistema de archivos o en la URL donde se aloja el archivo.

Haga lo siguiente para configurar los servicios RESTful:

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

    Consulte Configuración de la carpeta 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. Toque Crear para abrir el Asistente para la creación de la configuración de fuentes de datos. Especifique un nombre y, opcionalmente, un título para la configuración, seleccione Servicio RESTful de la variable Tipo de servicio lista desplegable, opcionalmente puede examinar y seleccionar una imagen en miniatura para la configuración, y pulsar Siguiente.

  3. Especifique los siguientes detalles para el servicio RESTful:

    • Seleccione URL o archivo en la Fuente de Swagger y, en consecuencia, especifique la variable Swagger URL a​ Swagger archivo de definición o cargue el Swagger del sistema de archivos local.

    • En función de la variable​ Swagger Entrada de origen, los siguientes campos están rellenados previamente con valores:

      • Esquema: Los protocolos de transferencia utilizados por la API de REST. El número de tipos de esquema que se muestran en la lista desplegable depende de los esquemas definidos en la Swagger fuente.

      • Host: El nombre de dominio o la dirección IP del host que sirve la 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 (Ninguno, OAuth2.0, Autenticación básica, Clave de API o Autenticación personalizada) para acceder al servicio RESTful y proporcione los detalles correspondientes para la autenticación.

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

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

Modelo de datos de formulario Configuración del cliente HTTP para optimizar el rendimiento

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

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

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

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

  • Utilice la variable 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 de 15 segundos.

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

  • Utilice la variable http.socket.timeout para especificar el periodo máximo de inactividad entre dos paquetes de datos. El valor predeterminado es de 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"
}

Para establecer los valores de una configuración, Generación de configuraciones de OSGi mediante el SDK de AEMy implementar la configuración a su instancia de Cloud Service.

Realice los siguientes pasos para configurar el cliente HTTP del modelo de datos de formulario:

  1. Iniciar sesión en Experience Manager Forms Instancia de autor como administrador y vaya a Experience Manager paquetes de la consola web. La dirección URL predeterminada es https://localhost:4502/system/console/configMgr.

  2. Toque Configuración del cliente HTTP del modelo de datos de formulario para el origen de datos REST.

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

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

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

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

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

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

Configuración de servicios web SOAP

Los servicios web basados en SOAP se describen utilizando Especificaciones del lenguaje de descripción de servicios web (WSDL). Experience Manager Forms no admiten 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 tiene la URL WSDL para el servicio web y haga lo siguiente:

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

    Consulte Configuración de la carpeta 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. Toque Crear para abrir el Asistente para la creación de la configuración de fuentes de datos. Especifique un nombre y, opcionalmente, un título para la configuración, seleccione Servicio web SOAP de la variable Tipo de servicio lista desplegable, opcionalmente puede examinar y seleccionar una imagen en miniatura para la configuración, y pulsar 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 extremo de servicio mencionado en WSDL.

    • Seleccione el tipo de autenticación (Ninguno, OAuth2.0, Autenticación básica o Autenticación personalizada) para acceder al servicio SOAP y proporcione los detalles para la autenticación.

  4. Toque 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

Puede especificar una expresión regular que sirva como filtro para las direcciones 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.

Configure las variables importAllowlistPattern propiedad de la variable 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, Generación de configuraciones de OSGi mediante el SDK de AEMy implementar la configuración a su instancia de Cloud Service.

Configuración de servicios 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:

NOTA

El modelo de datos de formulario es compatible OData versión 4.
Para obtener una guía paso a paso sobre la configuración Microsoft Dynamics 365, en línea o in situ, consulte Microsoft Dynamics Configuración de OData.

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

    Consulte Configuración de la carpeta 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. Toque Crear para abrir el Asistente para la creación de la configuración de fuentes de datos. Especifique un nombre y, opcionalmente, un título para la configuración, seleccione Servicio OData de la variable Tipo de servicio lista desplegable, opcionalmente puede examinar y seleccionar una imagen en miniatura para la configuración, y pulsar 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 (Ninguno, OAuth2.0, Autenticación básica, Clave de API o Autenticación personalizada) para acceder al servicio OData y proporcione los detalles correspondientes para la autenticación.

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

    NOTA

    Debe seleccionar el tipo de autenticación de OAuth 2.0 con el que conectarse Microsoft Dynamics servicios que utilizan el extremo OData como raíz de servicio.

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

Pasos siguientes

Ha configurado las fuentes de datos. A continuación, puede crear un Modelo de datos de formulario o, si ya ha creado un Modelo de datos de formulario sin un origen de datos, puede asociarlo a los orígenes de datos que acaba de configurar. Consulte Crear modelo de datos de formulario para obtener más información.

En esta página