Flujos de trabajo recomendados de relleno y envío basados en fuentes de datos para formularios adaptables

Puede utilizar cualquiera de los siguientes orígenes de datos con formularios adaptables convertidos mediante el servicio de Automated forms conversion:

  • Modelo de datos de formulario, OData o cualquier otro servicio de terceros
  • Esquema JSON
  • Esquema XSD

En función del origen de datos, puede elegir generar un formulario adaptable con o sin un modelo de datos.

En este artículo se describen los flujos de trabajo recomendados para rellenar previamente los valores de campo y las opciones de envío después de seleccionar un origen de datos y generar un formulario adaptable mediante el servicio de conversión.

Fuente de datos Flujo de trabajo recomendado

Modelo de datos de formulario, OData o cualquier otro servicio de terceros

Opción 1: Se selecciona modelo de datos de formulario, OData o cualquier otro servicio de terceros como origen de datos. genera un formulario adaptable sin enlace de datos mediante el servicio de Automated forms conversion. Los campos de formulario adaptables se enlazan manualmente a entidades del modelo de datos de formulario y se utiliza la opción Servicio de relleno previo del modelo de datos de formulario para rellenar previamente los valores de campo. La opción Enviar mediante el modelo de datos de formulario se utiliza para enviar el formulario adaptable.

Opción 2: Se selecciona modelo de datos de formulario, OData o cualquier otro servicio de terceros como origen de datos. genera un formulario adaptable sin enlace de datos mediante el servicio de Automated forms conversion. Los campos de formulario adaptables se enlazan mediante el editor de reglas para rellenar previamente los valores de campo. Si es necesario, modifique los valores de los campos y envíe los datos al repositorio crx.

Para obtener instrucciones paso a paso para ejecutar estos flujos de trabajo, consulte Utilizar la base de datos, OData o cualquier servicio de terceros como fuente de datos.

Esquema JSON

Puede seleccionar esquema JSON como fuente de datos. En función de la fuente de datos seleccionada:

Opción 1: Puede generar un formulario adaptable sin enlaces de datos mediante el servicio de Automated forms conversion y configurar el esquema JSON como el origen de datos. Los campos de formulario adaptables se enlazan manualmente al esquema JSON y se utiliza cualquiera de los protocolos admitidos para rellenar previamente los valores de campo. Si es necesario, modifique los valores de los campos y envíe los datos al repositorio crx.

Para obtener instrucciones paso a paso para ejecutar los flujos de trabajo, consulte Usar el esquema JSON como fuente de datos.

Opción 2: Puede generar un formulario adaptable con enlaces de datos JSON mediante el servicio de Automated forms conversion. El servicio de cumplimentación previa y el envío de formularios funcionan sin problemas. No necesita ningún paso de configuración.

Para obtener instrucciones paso a paso para ejecutar los flujos de trabajo, consulte Usar el esquema JSON como el origen de datos.

Esquema XSD

Puede seleccionar esquema XSD como fuente de datos. Según el origen de datos seleccionado, genera un formulario adaptable sin enlace de datos mediante el servicio de Automated forms conversion y configura el esquema XSD como el origen de datos. Los campos de formulario adaptables se enlazan manualmente al esquema XSD y se utiliza cualquiera de los protocolos admitidos para rellenar previamente los valores de campo. Si es necesario, modifique los valores de los campos y envíe los datos al repositorio crx.

Para obtener instrucciones paso a paso para ejecutar los flujos de trabajo, consulte Usar el esquema XSD como el origen de datos.

Para obtener más información sobre el servicio de Automated forms conversion, consulte los siguientes artículos:

La información proporcionada en este artículo se basa en la suposición de que cualquiera que la lea tiene conocimientos básicos de conceptos de formularios adaptables.

Requisitos previos

Formulario adaptable de ejemplo

Para ejecutar los casos de uso para rellenar previamente los valores de campo en un formulario adaptable y enviarlos al origen de datos, descargue el siguiente archivo PDF de muestra.

Formulario de solicitud de préstamo de muestra

Obtener archivo

El archivo PDF sirve como entrada al servicio de Automated forms conversion. El servicio convierte este archivo en un formulario adaptable. La siguiente imagen muestra la aplicación de préstamo de ejemplo en formato PDF.

formulario de solicitud de préstamo de muestra

Preparar datos para el modelo de formulario

La integración de datos de AEM Forms le permite configurar y conectar fuentes de datos dispares. Después de generar un formulario adaptable mediante el proceso de conversión, puede definir el modelo de formulario basado en un modelo de datos de formulario, XSD o un esquema JSON. Puede utilizar una base de datos, Microsoft Dynamics o cualquier otro servicio de terceros para crear un modelo de datos de formulario.

Este tutorial utiliza la base de datos MySQL como origen para crear un modelo de datos de formulario. Cree un esquema solicitud de préstamo en la base de datos y agregue una tabla solicitante al esquema en función de los campos disponibles en el formulario adaptable.

Datos de muestra mysql

Puede utilizar la siguiente instrucción DDL para crear la tabla solicitante en la base de datos.

CREATE TABLE `applicant` (
   `name` varchar(45) DEFAULT NULL,
   `address` varchar(45) DEFAULT NULL,
   `phonenumber` int(11) NOT NULL,
   `email` varchar(45) DEFAULT NULL,
   `occupation` varchar(45) DEFAULT NULL,
   `annualsalary` varchar(45) DEFAULT NULL,
   `familymembers` int(11) DEFAULT NULL,
   PRIMARY KEY (`phonenumber`)
 ) ENGINE=InnoDB DEFAULT CHARSET=utf8

Si utiliza un esquema XSD como modelo de formulario para ejecutar los casos de uso, cree un archivo XSD con el siguiente texto:

<?xml version="1.0" encoding="utf-8" ?>
    <xs:schema targetNamespace="http://adobe.com/sample.xsd"
                    xmlns="http://adobe.com/sample.xsd"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema">

<xs:element name="sample" type="SampleType"/>

  <xs:complexType name="SampleType">
    <xs:sequence>
      <xs:element name="name" type="xs:string"/>
   <xs:element name="address" type="xs:string"/>
   <xs:element name="phonenumber" type="xs:int"/>
   <xs:element name="email" type="xs:string"/>
   <xs:element name="occupation" type="xs:string"/>
   <xs:element name="annualsalary" type="xs:string"/>
   <xs:element name="familymembers" type="xs:string"/>
 </xs:sequence>
  </xs:complexType>

  </xs:schema>

O descargue el esquema XSD en el sistema de archivos local.

Esquema XSD de aplicación de préstamo de muestra

Obtener archivo

Para obtener más información sobre el uso de esquema XSD como modelo de formulario en formularios adaptables, consulte Creación de formularios adaptables con esquema XML.

Si utiliza un esquema JSON como modelo de formulario para ejecutar los casos de uso, cree un archivo JSON con el siguiente texto:

{
    "$schema": "http://json-schema.org/draft-04/schema#",
    "definitions": {
        "loanapplication": {
            "type": "object",
            "properties": {
                "name": {
                    "type": "string"
                },
                "address": {
                    "type": "string"
                },
    "phonenumber": {
                    "type": "number"
                },
    "email": {
                    "type": "string"
                },
    "occupation": {
                    "type": "string"
                },
    "annualsalary": {
                    "type": "string"
                },
    "familymembers": {
                    "type": "number"
                }
            }
        }
 },
 "type": "object",
    "properties": {
        "employee": {
            "$ref": "#/definitions/loanapplication"
        }
    }
}

O descargue el esquema JSON en el sistema de archivos local.

Esquema JSON de solicitud de préstamo de muestra

Obtener archivo

Para obtener más información sobre el uso de esquema JSON como modelo de formulario en formularios adaptables, consulte Creación de formularios adaptables con esquema JSON.

Generar formularios adaptables sin enlace de datos

Utilice el servicio de Automated forms conversion para convertir el formulario de solicitud de préstamo de muestra en un formulario adaptable sin enlace de datos. Asegúrese de seleccionar la casilla de verificación Generate adaptive form(s) without data bindings para generar el formulario adaptable sin enlace de datos.

Formulario adaptable sin enlace de datos

Después de generar un formulario adaptable sin enlace de datos, seleccione un origen de datos para el formulario adaptable:

NOTA

Si el formulario adaptable que se convierte mediante el servicio de Automated forms conversion contiene varios campos con el mismo nombre, asegúrese de que dichos campos están enlazados a entidades de origen de datos para evitar una posible pérdida de datos durante el envío.

Utilizar base de datos, OData o cualquier servicio de terceros como fuente de datos

Caso de uso: Puede generar un formulario adaptable sin enlace de datos mediante el servicio de Automated forms conversion y configurar la base de datos MYSQL como el origen de datos. Los campos de formulario adaptables se enlazan manualmente a entidades del modelo de datos de formulario y se utiliza la opción Form Data Model Prefill Service para rellenar previamente los valores de campo. Utilice la opción Submit using Form Data Model para enviar el formulario adaptable.

Antes de ejecutar el caso de uso:

En función del caso de uso, cree el modelo de datos de formulario aplicación de préstamo y enlace el argumento de servicio de lectura a un valor Literal. El valor literal del número telefónico debe ser de uno de los registros configurados en el esquema solicitante de la base de datos MySQL. Los servicios utilizan el valor como argumento para recuperar detalles del origen de datos. También puede seleccionar Atributo de Perfil de usuario o Atributo de solicitud en la lista desplegable Binding To

Configurar modelo de datos de formulario

NOTA

Asegúrese de agregar servicios get e insert al modelo de datos de formulario, configurar y probar los servicios antes de ejecutar el caso de uso.

Siga estos pasos:

  1. Seleccione el formulario de solicitud de préstamo de ejemplo convertido disponible en la carpeta output y toque Properties.

  2. Toque la ficha Form Model, seleccione Form Data Model en la lista desplegable Select From y toque Select Form Data Model para seleccionar el modelo de datos de formulario aplicación de préstamo. Toque Save & Close para guardar el formulario.

  3. Seleccione el formulario de solicitud de préstamo de muestra y toque Edit.

  4. En la ficha Content, toque el icono de configuración:

    configurar contenedor de formulario

    1. En la sección Basic, seleccione Form Data Model Prefill service en la lista desplegable Prefill Service.

    2. En la sección Submission, seleccione Submit using Form Data Model en la lista desplegable Submit Action.

    3. Seleccione el modelo de datos mediante el campo Data Model to submit.

    4. Toque icono hecho para guardar las propiedades.

  5. Puntee en el cuadro de texto Nombre del solicitante y seleccione configurar icono (Configurar).

    1. En el campo Referencia de enlace, seleccione Solicitante > Nombre y toque icono hecho para guardar las propiedades. Del mismo modo, cree un enlace de datos para Dirección, Número de teléfono, Correo electrónico, Ocupación, Salario anual (en dólares) y No. de los campos miembros de la familia dependientes con las entidades del modelo de datos de formulario.

    Enlazar referencias

  6. Toque Preview para vista de los valores de campo de formulario adaptable rellenados previamente.

  7. Si es necesario, modifique los valores de los campos y envíe el formulario adaptable. Los valores de campo se envían a la base de datos MySQL. Puede actualizar la tabla solicitante de la base de datos para vista de los valores actualizados en la tabla.

Caso de uso: se genera un formulario adaptable sin enlace de datos mediante el servicio de Automated forms conversion y se configura la base de datos MYSQL como origen de datos. Los campos de formulario adaptables se enlazan mediante el editor de reglas para rellenar previamente los valores de campo. Si es necesario, modifique los valores de los campos y envíe los datos al repositorio crx.

Ejecute los siguientes pasos para utilizar editor de reglas para invocar el servicio del modelo de datos de formulario para enlazar campos y rellenar valores previamente en un formulario adaptable:

  1. Seleccione el formulario de solicitud de préstamo de muestra en la carpeta output y toque Edit.

  2. En la ficha Content, toque el icono de configuración:

    configurar contenedor de formulario

    En la sección Basic, seleccione Form Data Model Prefill service en la lista desplegable Prefill Service.

  3. Toque el cuadro de texto Applicant Name y toque Edit Rules.

    Editar reglas para crear un enlace de datos

  4. Puntee Create en la página Editor de reglas.

  5. En la página Rule Editor:

    1. Seleccione un estado para el cuadro de texto Nombre del solicitante. Por ejemplo, is initialized, que resulta en la ejecución de la condición Then al procesar el formulario en modo Preview.

    2. En la sección Then, seleccione Invoke Service en la lista desplegable Select Action. Todos los servicios de la instancia de Forms se muestran en la lista desplegable.

    3. Seleccione un servicio Get en la sección que enumera los modelos de datos de formulario. El campo Entrada muestra número de teléfono, que es la clave principal definida para el modelo de datos solicitante. El sistema recupera y antepone los valores del formulario adaptable a los campos de la sección Salida en función de este campo.

    4. Cree un enlace para los campos de formulario adaptables con las entidades del modelo de datos de formulario mediante la sección Salida. Por ejemplo, enlace el campo de formulario adaptable Applicant Name con la entidad name.

    5. Tocar Done. Vuelva a tocar Done en la página Editor de reglas.

    Editor de reglas para enlazar referencias

  6. Toque Preview para vista de los valores de campo de formulario adaptable rellenados previamente.

    NOTA

    Asegúrese de que la propiedad Return Array está establecida en OFF para la propiedad de servicio get en el modelo de datos de formulario asociado al formulario adaptable.

  7. Si es necesario, modifique los valores de los campos y envíe el formulario adaptable. Los datos enviados están disponibles en la siguiente ubicación del repositorio crx:

    http://host name:port/crx/de/index.jsp#/content/forms/fp/admin/submit/data/latest file available in the folder

Utilizar el esquema JSON como fuente de datos

Caso de uso: puede generar un formulario adaptable sin enlace de datos mediante el servicio de Automated forms conversion y configurar el esquema JSON como el origen de datos. Los campos de formulario adaptables se enlazan manualmente al esquema JSON y se utiliza la opción Previsualización con datos para rellenar previamente los valores de campo. Si es necesario, modifique los valores de los campos y envíe los datos al repositorio crx.

Antes de ejecutar el caso de uso, asegúrese de que:

Siga estos pasos:

  1. Seleccione el formulario de solicitud de préstamo de ejemplo convertido disponible en la carpeta output y toque Properties.

  2. Toque la ficha Form Model, seleccione Schema en la lista desplegable Select From y toque Select Schema para cargar el esquema demo.esquema JSON guardado en el sistema de archivos local. Toque Save & Close para guardar el formulario.

  3. Seleccione el formulario de solicitud de préstamo de muestra y toque Edit.

  4. Puntee en el cuadro de texto Nombre del solicitante y seleccione configurar icono (Configurar).

    En el campo Referencia de enlace, seleccione Solicitante > Nombre y toque icono hecho para guardar las propiedades. Del mismo modo, cree un enlace de datos para Dirección, Número de teléfono, Correo electrónico, Ocupación, Salario anual (en dólares) y No. de los campos de miembros de la familia dependientes con las entidades de esquema JSON.

  5. Seleccione el formulario de solicitud de préstamo de ejemplo convertido disponible en la carpeta output de nuevo y seleccione Preview > Preview with Data.

    Descargar archivo de datos de ejemplo

    Obtener archivo

  6. Si es necesario, modifique los valores de los campos y envíe el formulario adaptable. Los datos enviados están disponibles en la siguiente ubicación del repositorio crx:

    http://host name:port/crx/de/index.jsp#/content/forms/fp/admin/submit/data/latest file available in the folder

Utilice el esquema XSD como fuente de datos

Caso de uso: puede generar un formulario adaptable sin enlace de datos mediante el servicio de Automated forms conversion y configurar el esquema XSD como el origen de datos. Los campos de formulario adaptables se enlazan manualmente al esquema XSD y se utiliza la Previsualización con datos para rellenar previamente los valores de campo. Si es necesario, modifique los valores de los campos y envíe los datos al repositorio crx.

Antes de ejecutar el caso de uso, asegúrese de que:

Siga estos pasos:

  1. Seleccione el formulario de solicitud de préstamo de ejemplo convertido disponible en la carpeta output y toque Properties.

  2. Toque la ficha Form Model, seleccione Schema en la lista desplegable Select From y toque Select Schema para cargar el esquema aplicación de préstamo XSD guardado en el sistema de archivos local. Seleccione el elemento raíz para el esquema XSD y toque Save & Close para guardar el formulario.

  3. Seleccione el formulario de solicitud de préstamo de muestra y toque Edit.

  4. Puntee en el cuadro de texto Nombre del solicitante y seleccione configurar icono (Configurar).
    En el campo Referencia de enlace, seleccione Solicitante > Nombre y toque Icono hecho para guardar las propiedades. Del mismo modo, cree un enlace de datos para Dirección, Número de teléfono, Correo electrónico, Ocupación, Salario anual (en dólares) y No. de los campos de miembros de la familia dependientes con las entidades de esquema XSD.

  5. Seleccione el formulario de solicitud de préstamo de muestra convertido disponible en la carpeta output nuevamente y seleccione Preview > Preview with Data.

    Descargar archivo de datos de ejemplo

    Obtener archivo

  6. Si es necesario, modifique los valores de los campos y envíe el formulario adaptable. Los datos enviados están disponibles en la siguiente ubicación del repositorio crx:

    http://host name:port/crx/de/index.jsp#/content/forms/fp/admin/submit/data/latest file available in the folder

Generar formularios adaptables con enlace JSON

Utilice el servicio de Automated forms conversion para convertir el formulario de solicitud de préstamo de muestra en un formulario adaptable con enlace de datos. Asegúrese de no seleccionar la casilla de verificación Generate adaptive form(s) without data bindings al generar el formulario adaptable.

Formulario adaptable con enlace JSON

Utilizar el esquema JSON como fuente de datos

Caso de uso: se genera un formulario adaptable con enlace de datos JSON mediante el servicio de Automated forms conversion. El servicio de cumplimentación previa y el envío de formularios funcionan sin problemas. No necesita ningún paso de configuración.

Antes de ejecutar el caso de uso, asegúrese de que tiene un formulario adaptable con enlace de datos.

Siga estos pasos:

  1. Seleccione el formulario de solicitud de préstamo de ejemplo convertido disponible en la carpeta output de nuevo y seleccione Preview > Preview with Data.

    Descargar archivo de datos de ejemplo

    Obtener archivo

  2. Si es necesario, modifique los valores de los campos y envíe el formulario adaptable. Los datos enviados están disponibles en la siguiente ubicación del repositorio crx:

    http://host name:port/crx/de/index.jsp#/content/forms/fp/admin/submit/data/latest file available in the folder

Convertir datos JSON de formulario adaptable enviados al formato XML

Cuando se introducen valores en campos de formulario adaptables y se envían, los datos están disponibles en formato JSON en el repositorio crx. Puede convertir el formato de los datos JSON a XML mediante la API org.apache.sling.commons.json.xml o el siguiente código de muestra:

import org.apache.sling.commons.json.JSONException;
import org.apache.sling.commons.json.JSONObject;
import org.apache.sling.commons.json.xml.XML;
 
public class ConversionUtils {
 
    public static String jsonToXML(String jsonString) throws JSONException {
        //https://sling.apache.org/apidocs/sling5/org/apache/sling/commons/json/xml/XML.html#toString(java.lang.Object)
        //jar - http://maven.ibiblio.org/maven2/org/apache/sling/org.apache.sling.commons.json/2.0.18/
        //Note: Need to extract boundData part before converting to XML
        return XML.toString(new JSONObject(jsonString));
    }
}

En esta página