Show Menu
TEMAS×

Configurar orígenes de datos

La integración de datos de AEM Forms le permite configurar y conectar fuentes de datos dispares. Los siguientes tipos son compatibles de forma predeterminada. Sin embargo, con poca personalización, también puede integrar otras fuentes de datos.
  • Bases de datos relacionales: MySQL, Microsoft SQL Server, IBM DB2 y Oracle RDBMS
  • perfil del usuario de AEM
  • Servicios web RESTful
  • Servicios Web basados en SOAP
  • Servicios OData
La integración de datos admite los tipos de autenticación OAuth2.0, Basic Authentication y API Key predeterminados, y permite implementar la autenticación personalizada para acceder a los servicios Web. Aunque los servicios RESTful, SOAP y OData están configurados en AEM cloud services, JDBC para bases de datos relacionales y conector para el perfil de usuarios de AEM se configura en la consola web de AEM.

Configurar base de datos relacional

Puede configurar bases de datos relacionales mediante la configuración de la consola web de AEM. Haga lo siguiente:
  1. Vaya a la consola web de AEM en https://server:host/system/console/configMgr.
  2. Busque la configuración de Apache Sling Connection Pooled DataSource . Toque para abrir la configuración en modo de edición.
  3. En el cuadro de diálogo de configuración, especifique los detalles de la base de datos que desea configurar, como:
    • Nombre del origen de datos
    • Propiedad del servicio de origen de datos que almacena el nombre del origen de datos
    • Nombre de clase Java para el controlador JDBC
    • URI de conexión JDBC
    • Nombre de usuario y contraseña para establecer la conexión con el controlador JDBC
    Asegúrese de cifrar información confidencial como contraseñas antes de configurar el origen de datos. Para cifrar:
    1. Vaya a https://' # : # '/system/console/crypto.
    2. En el campo Texto sin formato, especifique la contraseña o cualquier cadena que desee cifrar y haga clic en Proteger .
    El texto cifrado aparece en el campo Texto protegido que puede especificar en la configuración.
  4. Habilite Prueba a la Obtención o Prueba a la Devolución para especificar que los objetos se validen antes de ser tomados en préstamo o devueltos al grupo, respectivamente.
  5. Especifique una consulta SQL SELECT en el campo Consulta de validación para validar las conexiones del 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 from dual (Oracle)
  6. Toque Guardar para guardar la configuración.

Configuración del perfil de usuario de AEM

Puede configurar el perfil de usuario de AEM mediante la configuración del conector de Perfil de usuario en la consola web de AEM. Haga lo siguiente:
  1. Vaya a la consola web de AEM en https://' # : # 'system/console/configMgr.
  2. Busque Integraciones de datos de AEM Forms - Configuración del conector de Perfil de usuario y toque para abrir la configuración en modo de edición.
  3. En el cuadro de diálogo Configuración del conector de Perfil de usuario, puede agregar, quitar o actualizar las propiedades del perfil de usuario. Las propiedades especificadas estarán disponibles para su uso en el modelo de datos de formulario. Utilice el siguiente formato para especificar las propiedades de perfil del usuario:
    name=[property_name_with_location_in_user_profile],type=[property_type]
    Ejemplos:
    • name=profile/phoneNumber,type=string
    • name=profile/empLocation/*/city,type=string
    El * del ejemplo anterior indica todos los nodos bajo el profile/empLocation/ nodo en el perfil de usuario de AEM en la estructura CRXDE. Significa que el modelo de datos de formulario puede acceder a la city propiedad de tipo string presente en cualquier nodo bajo el profile/empLocation/ nodo. Sin embargo, los nodos que contienen la propiedad especificada deben seguir una estructura coherente.
  4. Toque Guardar para guardar la configuración.

Configurar carpeta para configuraciones de servicio en la nube

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 de AEM se consolidan en la /conf carpeta del repositorio de AEM. De forma predeterminada, la conf carpeta contiene la global carpeta en la que puede crear configuraciones de servicio 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 > Navegador de configuración.
  2. Haga lo siguiente para habilitar la carpeta global para las configuraciones de nube o omita este paso para crear y configurar otra carpeta para las configuraciones de servicio en la nube.
    1. En el Explorador de configuración, seleccione la global carpeta y toque Propiedades .
    2. En el cuadro de diálogo Propiedades de configuración, habilite 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 cuadro de diálogo Crear configuración , especifique un título para la carpeta y habilite Cloud Configurations .
  5. Toque Crear para crear la carpeta habilitada para las configuraciones de servicio en la nube.

Configuración de los servicios web RESTful

El servicio web RESTful se puede describir usando las especificaciones Swagger en formato JSON o YAML en un archivo de definición Swagger. Para configurar el servicio web RESTful en AEM cloud services, asegúrese de que tiene el archivo Swagger en el sistema de archivos o la dirección URL donde se aloja el archivo.
Para configurar los servicios RESTful, haga lo siguiente:
  1. Vaya a Herramientas > Cloud Service > Fuentes de datos. Toque para seleccionar la carpeta en la que desea crear una configuración de nube.
    Consulte Configurar carpeta para configuraciones de servicios en la nube para obtener información sobre cómo crear y configurar una carpeta para configuraciones de servicios en la nube.
  2. Toque Crear para abrir el asistente ​Crear configuración de fuente de datos. Especifique un nombre y, si lo desea, un título para la configuración, seleccione RESTful Service en la lista desplegable Tipo de servicio, si lo desea, busque y seleccione una imagen en miniatura para la configuración y toque Siguiente .
  3. Especifique los siguientes detalles para el servicio RESTful:
    • Seleccione URL o archivo en el menú desplegable Origen de Swagger y, en consecuencia, especifique la URL de Swagger en el archivo de definición Swagger o cargue el archivo Swagger desde el sistema de archivos local.
    • En función de la entrada de Origen de intervalo, los siguientes campos se rellenan 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 el origen Swagger.
      • Host: El nombre de dominio o la dirección IP del host que sirve la API de REST. Es un campo obligatorio.
      • Ruta base: Prefijo de URL para 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, en consecuencia, proporcionar detalles 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 la lista desplegable Ubicación y especifique el nombre del encabezado o el parámetro de consulta en el campo Nombre de parámetro.
  4. Toque Crear para crear la configuración de nube para el servicio RESTful.

Configuración de servicios web SOAP

Los servicios Web basados en SOAP se describen mediante especificaciones del lenguaje de descripción de servicios Web (WSDL). Para configurar el servicio web basado en SOAP en AEM cloud services, asegúrese de que dispone de la URL WSDL para el servicio web y haga lo siguiente:
  1. Vaya a Herramientas > Cloud Service > Fuentes de datos. Toque para seleccionar la carpeta en la que desea crear una configuración de nube.
    Consulte Configurar carpeta para configuraciones de servicios en la nube para obtener información sobre cómo crear y configurar una carpeta para configuraciones de servicios en la nube.
  2. Toque Crear para abrir el asistente ​Crear configuración de fuente de datos. Especifique un nombre y, si lo desea, un título para la configuración, seleccione Servicio Web SOAP en la lista desplegable Tipo de servicio, si lo desea, busque y seleccione una imagen en miniatura para la configuración y toque Siguiente .
  3. Especifique lo siguiente para el servicio web SOAP:
    • URL 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, Autenticación personalizada o Token X509 — para acceder al servicio SOAP y, en consecuencia, proporcionar los detalles para la autenticación.
      Si selecciona el token X509 como tipo de autenticación, configure el certificado X509. Para obtener más información, consulte Configuración de certificados . Especifique el alias KeyStore para el certificado X509 en el campo Alias de clave. Especifique el tiempo, en segundos, hasta que la solicitud de autenticación siga siendo válida en el campo Tiempo de vida . Si lo desea, seleccione firmar el encabezado de la marca de tiempo o el cuerpo del mensaje o ambos.
  4. Toque Crear para crear la configuración de nube para el servicio web SOAP.

Configurar servicios OData

Un servicio OData se identifica mediante su URL raíz de servicio. Para configurar un servicio OData en AEM cloud services, asegúrese de que tiene una URL raíz de servicio para el servicio y haga lo siguiente:
Para obtener una guía paso a paso sobre la configuración de Microsoft Dynamics 365, en línea o local, consulte Configuración de OData de Microsoft Dynamics.
  1. Vaya a Herramientas > Cloud Service > Fuentes de datos. Toque para seleccionar la carpeta en la que desea crear una configuración de nube.
    Consulte Configurar carpeta para configuraciones de servicios en la nube para obtener información sobre cómo crear y configurar una carpeta para configuraciones de servicios en la nube.
  2. Toque Crear para abrir el asistente ​Crear configuración de fuente de datos. Especifique un nombre y, si lo desea, un título para la configuración, seleccione OData Service en la lista desplegable Tipo de servicio, si lo desea, busque y seleccione una imagen en miniatura para la configuración y toque Siguiente .
  3. Especifique los siguientes detalles para el servicio OData:
    • URL de raíz de servicio para el servicio OData que se va a configurar.
    • Seleccione el tipo de autenticación — Ninguno, OAuth2.0, Autenticación básica o Autenticación personalizada — para acceder al servicio OData y, en consecuencia, proporcionar los detalles para la autenticación.
    Debe seleccionar el tipo de autenticación OAuth 2.0 para conectarse con los servicios de Microsoft Dynamics mediante el extremo OData como raíz del 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 Creación de un modelo de datos de formulario para obtener más información.