Uso del modelo de datos de formulario (FDM) use-form-data-model

Versión
Vínculo del artículo
AEM 6.5
Haga clic aquí
AEM as a Cloud Service
Este artículo

data-integration

La integración de datos de Experience Manager Forms permite utilizar fuentes de datos de diferentes back-end para crear un modelo de datos de formulario (FDM) que se puede utilizar como esquema en varios flujos de trabajo de formularios adaptables de . Para ello, es necesario configurar las fuentes de datos y crear un modelo de datos de formulario (FDM) 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 (FDM) es una extensión del esquema JSON que puede utilizar para lo siguiente:

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 (FDM). Para utilizar un modelo de datos de formulario (FDM) al crear un formulario adaptable o un fragmento de formulario adaptable, haga lo siguiente:

  1. En la pestaña Modelo de formulario de la pantalla Agregar propiedades, seleccione Modelo de datos de formulario en la lista desplegable Seleccionar desde.

    create-af-1-1

  2. Seleccione para expandir Seleccionar modelo de datos de formulario. Se muestran todos los modelos de datos de formulario disponibles (FDM).

    Seleccione un modelo de datos de formulario.

    create-af-2-1

  3. (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 (FDM). 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 (FDM) especificado. Seleccione un objeto de modelo de datos de la lista.

    create-af-3

    Una vez creado el formulario adaptable o el fragmento de formulario adaptable basado en un modelo de datos de formulario (FDM), los objetos de modelo de datos de formulario aparecen en la pestaña Fuentes de datos del Explorador de contenido en el Editor de formularios adaptables.

    note note
    NOTE
    En el caso de los fragmentos 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 pestaña Fuentes de datos.

    pestaña-objetos-modelo-datos

    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.

Usar una vista previa con datos de ejemplo; preview-ic

El editor del modelo de datos de formulario permite generar y editar datos de muestra para objetos de modelo de datos en el modelo de datos de formulario (FDM). Puede utilizar estos datos para previsualizar y probar formularios adaptables de . Debe generar los datos de ejemplo antes de obtener la vista previa, tal como se describe en Trabajo con el modelo de datos de formulario.

Para obtener una vista previa de un formulario adaptable con datos de ejemplo, abra el formulario adaptable en el modo Autor y seleccione Vista previa.

Servicio de rellenado previo con el modelo de datos de formulario prefill

Experience Manager Forms proporciona de forma predeterminada un servicio de prerrellenado del modelo de datos de formulario que puede habilitar para formularios adaptables basados en el modelo de datos de formulario (FDM). El servicio de prerrellenado consulta las fuentes de datos de los objetos de modelo de datos del formulario adaptable 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.

servicio-prerrellenado

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 (FDM), 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, Experience Manager 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 (FDM). Este escribe los datos enviados de un objeto de modelo de datos a su fuente de datos.

Para configurar la acción de envío del modelo de datos de formulario:

  1. Abra el Explorador de contenido y seleccione el componente Contenedor de guía del formulario adaptable.

  2. Haga clic en el icono de propiedades del contenedor de guía Propiedades de guía . Se abre el cuadro de diálogo Contenedor de formulario adaptable.

  3. Abra la pestaña Envío.

  4. En la lista desplegable Acción de envío, seleccione la opción Enviar mediante modelo de datos de formulario.

    Configuración de la acción

  5. Especifique el modelo de datos para enviar.

  6. Haga clic en Listo.

Al enviar el formulario, los datos del objeto de modelo de datos configurado se escriben en la fuente de datos correspondiente. Además, puede enviar a la fuente de datos un archivo adjunto de formulario mediante un modelo de datos de formulario (FDM) y un documento de registro (DoR). Para obtener información sobre el modelo de datos de formulario (FDM), consulte integración de datos de AEM Forms.

NOTE
AEM as a Cloud Service ofrece varias acciones de envío predeterminadas para gestionar los envíos de formularios. Puede obtener más información sobre estas opciones en el artículo Acción de envío del formulario adaptable.

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:

  1. Añada un objeto de modelo de datos que incluya una propiedad binaria al modelo de datos de formulario.

  2. En el formulario adaptable, arrastre y coloque el componente Archivo adjunto desde el explorador Componentes en el formulario adaptable.

  3. Seleccione para seleccionar el componente agregado y seleccione settings_icon para abrir el Explorador de propiedades del componente.

  4. En el campo Referencia de enlace, seleccione foldersearch_18 y desplácese hasta seleccionar la propiedad binaria añadida en el modelo de datos de formulario (FDM). Configure otras propiedades según corresponda.

    Seleccione check-button para guardar las propiedades. El campo Archivo adjunto 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, 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 (FDM), puede crear reglas para invocar servicios configurados en el modelo de datos de formulario (FDM). La operación Invocar servicios en una regla muestra todos los servicios disponibles en el modelo de datos de formulario (FDM) y permite seleccionar campos de entrada y salida para el servicio. También puede usar el tipo de regla Configurar el valor de para invocar un servicio del modelo de datos de formulario y establecer el valor de un campo en la salida devuelta 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.

invocar-servicio

Además, puede usar la API guidelib.dataIntegrationUtils.executeOperation para escribir un JavaScript en el Editor de código del Editor de reglas.

Invocar un modelo de datos de formulario (FDM) mediante funciones personalizadas invoke-form-data-model-using-custom-functions

Puede invocar un modelo de datos de formulario desde el editor de reglas mediante funciones personalizadas. Para invocar el modelo de datos de formulario (FDM), agregue un modelo de datos de formulario a la lista de permitidos. Para agregar un modelo de datos de formulario a una lista de permitidos:

  1. Vaya a la consola web de Experience Manager en https://server:host/system/console/configMgr.
  2. Localizar Lista blanca a nivel de formulario adaptable del modelo de datos de formulario para la invocación de servicio: fábrica de configuración.
  3. Haga clic en el icono de signo más para añadir la configuración.
  4. Añada Patrón de ruta de contenido para especificar la ubicación de sus Formularios adaptables. El valor predeterminado es /content/forms/af/(.*) que incluye todos los Formularios adaptables. También puede especificar la ruta para un Formulario adaptable específico.
  5. Añada el patrón de ruta del modelo de datos de formulario para especificar la ubicación del modelo de datos de formulario (FDM). El valor predeterminado es /content/dams/formsanddocuments-fdm/(.*), que incluye todo el modelo de datos de formulario. También puede especificar la ruta para un modelo de datos de formulario (FDM) específico.
  6. Guarde la configuración.

La configuración añadida se guarda en la opción Lista blanca a nivel de formulario adaptable del modelo de datos de formulario para la invocación del servicio: fábrica de configuración.

NOTE
Para invocar un modelo de datos de formulario (FDM) desde el editor de reglas utilizando funciones personalizadas a través de un proyecto de arquetipo de AEM:
  1. Creación de un archivo de configuración.
  2. Establezca las propiedades de getContentPathPattern y getFormDataModelPathPattern.
  3. Implemente el proyecto.

Artículos relacionados

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab