Usar el modelo de datos de formulario use-form-data-model
La integración de datos de AEM Forms permite utilizar fuentes de datos de diferentes back-end para crear un modelo de datos de formulario que se puede utilizar como esquema en varios flujos de trabajo de formularios adaptables y comunicaciones interactivas. Para ello, es necesario configurar las fuentes de datos y crear un modelo de datos de formulario basado en los objetos y servicios de modelo de datos disponibles en las fuentes 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 lo siguiente:
- Crear formularios adaptables y fragmentos
- Crear comunicaciones interactivas y componentes básicos como fragmentos de texto, lista y condición
- Previsualizar comunicaciones interactivas con datos de ejemplo
- Prerrellenar formularios adaptables y comunicaciones interactivas
- Escribir en diferido datos de formulario adaptable en fuentes de datos
- Invocar servicios mediante reglas de formulario adaptable
Crear formularios adaptables y fragmentos create-af
Puede crear formularios adaptables y fragmentos de formulario adaptables a partir de 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:
-
En la pestaña Modelo de formulario de la pantalla Agregar propiedades, seleccione Modelo de datos de formulario en la lista desplegable Seleccionar desde.
-
Seleccione para expandir Seleccionar modelo de datos de formulario. Se muestran todos los modelos de datos de formulario disponibles.
Seleccione un modelo de datos de formulario.
-
(Solo fragmentos de formulario adaptable) Puede crear un fragmento de formulario adaptable basado en un único objeto de modelo de datos en un modelo de datos de formulario. Expanda la lista desplegable Definiciones del modelo de datos de formulario. Esta lista enumera todos los objetos de modelo de datos del modelo de datos de formulario especificado. Seleccione un objeto de modelo de datos de la lista.
Una vez creado el formulario adaptable o el fragmento de formulario adaptable basado en un modelo de datos de formulario, los objetos de modelo de datos de formulario aparecen en la pestaña Objetos del modelo de datos del Explorador de contenido en el Editor de formularios adaptables.
Puede arrastrar y soltar objetos de modelo de datos en el formulario adaptable o en el fragmento para agregar campos de formulario. Los campos de formulario agregados conservan las propiedades de metadatos y el enlace con las propiedades del objeto de modelo de datos. El enlace garantiza que los valores de los campos se actualicen en las fuentes de datos correspondientes al enviar el formulario y se prerrellenen cuando se representa el formulario.
Crear comunicaciones interactivas create-ic
Puede crear una comunicación interactiva basada en un modelo de datos de formulario que puede utilizar para prerrellenar la comunicación interactiva con datos de fuentes de datos configuradas. 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 pestaña General del cuadro de diálogo Crear comunicación interactiva.
Pestaña General del cuadro de diálogo Crear comunicación interactiva
Para obtener más información, consulte:
Crear una comunicación interactiva
Texto en comunicaciones interactivas
Condiciones de las comunicaciones interactivas
Usar una vista previa con datos de ejemplo preview-ic
El editor del modelo de datos de formulario permite generar y editar datos de ejemplo para objetos de modelo de datos en el modelo de datos de formulario. Puede utilizar estos datos para previsualizar y probar comunicaciones interactivas y formularios adaptables. Genere los datos de ejemplo antes de obtener la vista previa como se describe en Trabajar con el modelo de datos de formulario.
Para previsualizar una comunicación interactiva con datos del modelo de datos de formulario de ejemplo:
- En la instancia de autor de AEM, vaya a Formularios > Formularios y documentos.
- Seleccione una comunicación interactiva y seleccione Vista previa en la barra de herramientas para seleccionar Canal web, Canal de impresión o Ambos canales para previsualizar la comunicación interactiva.
- En el cuadro de diálogo Vista previa de [canal], asegúrese de que está seleccionado Probar datos del modelo de datos de formulario y seleccione Vista previa.
La comunicación interactiva se abre con datos de ejemplo prerrellenados.
Del mismo modo, para obtener una vista previa de un formulario adaptable con datos de ejemplo, ábralo en el modo Autor y seleccione Vista previa.
Prerrellenar mediante el servicio del modelo de datos de formulario prefill
AEM Forms proporciona de forma predeterminada un servicio de prerrellenado del modelo de datos de formulario que puede habilitar para formularios adaptables y comunicaciones interactivas basadas en el modelo de datos de formulario. El servicio de prerrellenado consulta las fuentes de datos de los objetos de modelo de datos del formulario adaptable y la comunicación interactiva y prerrellena los datos de la forma correspondiente al representar el formulario o la comunicación.
Para habilitar el servicio de prerrellenado del modelo de datos de formulario de un formulario adaptable, abra las propiedades del contenedor de formulario adaptable y seleccione Servicio de prerrellenado del modelo de datos de formulario en la lista desplegable Servicio de prerrellenado en el acordeón Básico. A continuación, guarde las propiedades.
Para configurar el servicio de prerrellenado del modelo de datos de formulario en una comunicación interactiva, puede seleccionar Servicio de prerrellenado del modelo de datos de formulario en la lista desplegable Servicio de prerrellenado al crearlo o posteriormente al modificar las propiedades.
Cuadro de diálogo Editar propiedades para una comunicación interactiva
Escribir los datos de los formularios adaptables enviados en fuentes de datos write-af
Cuando un usuario envía un formulario basado en un modelo de datos de formulario, se puede configurar el formulario para que escriba los datos enviados de un objeto de modelo de datos en sus fuentes de datos. Para aplicar este caso de uso, AEM Forms proporciona 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 de un objeto de modelo de datos en su fuente 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 Acción de envío, en el acordeón Envío. A continuación, examine y seleccione un objeto de modelo de datos en la lista desplegable Nombre del objeto de modelo de datos que se va a enviar. Guarde las propiedades.
Al enviar el formulario, los datos del objeto de modelo de datos configurado se escriben en la fuente de datos correspondiente.
También puede enviar los archivos adjuntos del formulario a una fuente de datos mediante la propiedad de objeto del modelo de datos binaria. Haga lo siguiente para enviar archivos adjuntos a una fuente de datos JDBC:
-
Agregue un objeto de modelo de datos que incluya una propiedad binaria al modelo de datos de formulario.
-
En el formulario adaptable, arrastre y coloque el componente Archivo adjunto desde el Explorador de componente al formulario adaptable.
-
Seleccione para seleccionar el componente agregado y seleccione
-
En el campo Referencia de enlace, seleccione
Seleccione
-
En la sección Envío de las propiedades del contenedor de formulario adaptable, active Enviar archivos adjuntos del formulario. Esto envía el archivo adjunto del campo de propiedad binaria a la fuente de datos al enviar el formulario.
Invocar servicios desde formularios adaptables mediante reglas invoke-services
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 enumera 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 usar el tipo de regla Set Value para invocar un servicio del modelo de datos de formulario y establecer el valor de un campo en la salida de vuelta por el servicio.
Por ejemplo, la siguiente regla invoca un servicio de obtención que toma el ID de empleado como entrada, y los valores devueltos se rellenan en los campos correspondientes ID de la persona dependiente, Apellidos, Nombre y Género del formulario.
Además, puede usar la API guidelib.dataIntegrationUtils.executeOperation para escribir un JavaScript en el Editor de código del Editor de reglas. Para obtener más información sobre las API, consulte API para invocar el servicio del modelo de datos de formulario.