Show Menu
TEMAS×

Usar modelo de datos de formulario

La integración de datos de AEM Forms permite utilizar orígenes de datos de servidor dispares para crear un modelo de datos de formulario que se puede utilizar como esquema en varios formularios adaptables y flujos de trabajo de comunicaciones interactivos. Requiere configurar orígenes de datos y crear un modelo de datos de formulario basado en objetos del modelo de datos y servicios disponibles en orígenes de datos. Para obtener más información, consulte:
Un modelo de datos de formulario es una extensión del esquema JSON que puede utilizar para:

Creación de formularios y fragmentos adaptables

Puede crear formularios Creación de un formulario adaptable adaptables y fragmentos de formulario adaptables basados en un modelo de datos de formulario. Para utilizar un modelo de datos de formulario al crear un formulario adaptable o un fragmento de formulario adaptable, haga lo siguiente:
  1. En la ficha Modelo de formulario de la pantalla Añadir propiedades, seleccione Modelo de datos de formulario en la lista desplegable Seleccionar desde .
  2. Puntee para expandir Seleccionar modelo de datos de formulario. Se muestran todos los modelos de datos de formulario disponibles.
    Seleccione un modelo de datos de.
  3. (Solo ​fragmentos de formulario adaptables) Puede crear un fragmento de formulario adaptable basado en un solo objeto de modelo de datos en un modelo de datos de formulario. Desplegable Expandir definiciones del modelo de datos de formulario. lista todos los objetos del modelo de datos en el modelo de datos de formulario especificado. Seleccione un objeto de modelo de datos de la lista.
Una vez creado el formulario adaptable o fragmento de formulario adaptable basado en un modelo de datos de formulario, los objetos del modelo de datos de formulario aparecen en la ficha Objetos del modelo de datos del navegador de contenido en el editor de formularios adaptable.
Para un fragmento de formulario adaptable, solo el objeto de modelo de datos seleccionado en el momento de la creación y los objetos de modelo de datos asociados aparecen en la ficha Objetos del modelo de datos.
Puede arrastrar y soltar objetos del modelo de datos en el formulario o fragmento adaptable para agregar campos de formulario. Los campos de formulario agregados conservan las propiedades de metadatos y el enlace con las propiedades de objeto del modelo de datos. El enlace garantiza que los valores de los campos se actualicen en los orígenes de datos correspondientes al envío del formulario y se rellenen previamente cuando se procesa el formulario.

Crear comunicaciones interactivas

Puede crear una comunicación interactiva basada en un modelo de datos de formulario que puede utilizar para rellenar previamente la comunicación interactiva con datos de orígenes de datos configurados. Además, los componentes básicos de una comunicación interactiva, como los fragmentos de documento de texto, lista y condición, pueden basarse en un modelo de datos de formulario.
Puede elegir un modelo de datos de formulario al crear una comunicación interactiva o un fragmento de documento. La siguiente imagen muestra la ficha General del cuadro de diálogo Crear comunicación interactiva.
Ficha General del cuadro de diálogo Crear comunicación interactiva
Para obtener más información, consulte:

Previsualización con datos de muestra

El editor del modelo de datos de formulario permite generar y editar datos de ejemplo para objetos del modelo de datos en el modelo de datos de formulario. Puede utilizar estos datos para realizar previsualizaciones y pruebas de las comunicaciones interactivas y los formularios adaptables. Debe generar los datos de ejemplo antes de realizar la vista previa como se describe en Trabajar con el modelo de datos de formulario.
Para previsualización de una comunicación interactiva con datos del modelo de datos de formulario de ejemplo:
  1. En la instancia de creación de AEM, vaya a Formularios > Formularios y Documentos .
  2. Seleccione una comunicación interactiva y toque Previsualización en la barra de herramientas para seleccionar Canal ​web, Canal de impresión o Ambos Canales para previsualización de la comunicación interactiva.
  3. En el cuadro de diálogo # de Previsualización, asegúrese de que está seleccionada la opción Probar datos del modelo de datos de formulario y toque la Previsualización .
La comunicación interactiva se abre con datos de ejemplo precargados.
Del mismo modo, para previsualización de un formulario adaptable con datos de ejemplo, abra el formulario adaptable en modo de autor y toque la Previsualización .

Rellenar previamente mediante el servicio de modelo de datos de formulario

AEM Forms ofrece el servicio de cumplimentación previa del modelo de datos de formulario incorporado que puede activar para formularios adaptables y comunicaciones interactivas basadas en el modelo de datos de formulario. El servicio de cumplimentación previa consulta orígenes de datos para objetos del modelo de datos en el formulario adaptable y la comunicación interactiva y, en consecuencia, antepone los datos al procesar el formulario o la comunicación.
Para habilitar el servicio de cumplimentación previa del modelo de datos de formulario para un formulario adaptable, abra las propiedades del Contenedor de formulario adaptable y seleccione el servicio de cumplimentación previa del modelo de datos de formulario en la lista desplegable Servicio de cumplimentación previa del acordeón Básico. A continuación, guarde las propiedades.
Para configurar el servicio de cumplimentación previa del modelo de datos de formulario en una comunicación interactiva, puede seleccionar Servicio de cumplimentación previa del modelo de datos de formulario en la lista desplegable Servicio de cumplimentación previa al crearlo o posteriormente modificando las propiedades.
Cuadro de diálogo Editar propiedades para una comunicación interactiva

Escribir datos de formularios adaptables enviados en orígenes de datos

Cuando un usuario envía un formulario basado en un modelo de datos de formulario, se puede configurar el formulario para escribir los datos enviados para un objeto de modelo de datos en sus orígenes de datos. Para lograr este caso de uso, los AEM Forms proporcionan la acción de envío del Modelo de datos de formulario, disponible de forma predeterminada solo para formularios adaptables basados en un modelo de datos de formulario. Escribe los datos enviados para un objeto de modelo de datos en su origen de datos.
Para configurar la acción de envío del modelo de datos de formulario, abra las propiedades del Contenedor de formulario adaptable y seleccione Enviar mediante el modelo de datos de formulario en la lista desplegable Enviar acción en el acordeón Envío. A continuación, busque y seleccione un objeto de modelo de datos en la lista desplegable Nombre del objeto de modelo de datos para enviar . Guarde las propiedades.
Al enviar el formulario, los datos del objeto del modelo de datos configurado se escriben en el origen de datos correspondiente.
También puede enviar archivos adjuntos de formulario a un origen de datos mediante la propiedad object del modelo de datos binario. Para enviar archivos adjuntos a un origen de datos JDBC, haga lo siguiente:
  1. Añada un objeto de modelo de datos que incluya una propiedad binaria en el modelo de datos de formulario.
  2. En el formulario adaptable, arrastre y suelte el componente Archivo adjunto del navegador Componentes en el formulario adaptable.
  3. Toque para seleccionar el componente agregado y toque para abrir el navegador de propiedades del componente.
  4. En el campo Referencia de enlace, toque y desplácese hasta seleccionar la propiedad binaria que agregó en el modelo de datos de formulario. Configure otras propiedades según corresponda.
    Toque de verificación para guardar las propiedades. El campo de datos adjuntos ahora está enlazado a la propiedad binaria del modelo de datos de formulario.
  5. En la sección Envío de las propiedades del Contenedor de formulario adaptable, habilite Enviar datos adjuntos de formulario. Envía los datos adjuntos en el campo de propiedad binaria al origen de datos al enviar el formulario.

Invocar servicios en formularios adaptables mediante reglas

En un formulario adaptable basado en un modelo de datos de formulario, puede crear reglas para invocar servicios configurados en el modelo de datos de formulario. La operación Invocar servicios en una regla lista todos los servicios disponibles en el modelo de datos de formulario y permite seleccionar campos de entrada y salida para el servicio. También puede utilizar el tipo de regla Definir valor para invocar un servicio de modelo de datos de formulario y establecer el valor de un campo en el resultado devuelto por el servicio.
Por ejemplo, la regla siguiente invoca un servicio get que toma Id. de empleado como entrada y los valores devueltos se rellenan en los campos Id. dependiente, Apellido, Nombre y Género correspondientes del formulario.
Además, puede utilizar la guidelib.dataIntegrationUtils.executeOperation API para escribir un JavaScript en el editor de código del editor de reglas. Para obtener más información sobre API, consulte API para invocar el servicio del modelo de datos de formulario.