Rellenar previamente los campos de un formulario adaptable prefill-adaptive-form-fields

Adobe recomienda utilizar la captura de datos moderna y ampliable Componentes principalespara crear un nuevo formulario adaptableo añadir formularios adaptables a páginas de AEM Sites. Estos componentes representan un avance significativo en la creación de formularios adaptables, lo que garantiza experiencias de usuario impresionantes. Este artículo describe un enfoque más antiguo para crear Formularios adaptables con componentes de base.

Introducción introduction

Puede rellenar previamente los campos de un formulario adaptable mediante los datos existentes. Cuando un usuario abre un formulario, los valores de esos campos están rellenos previamente. Para rellenar previamente los datos en un formulario adaptable, haga que los datos de usuario estén disponibles como un XML/JSON de relleno en el formato que se adhiera a la estructura de datos de relleno previo del formulario adaptable.

Estructura de los datos de relleno previo the-prefill-structure

Un formulario adaptable puede tener una combinación de campos enlazados y no enlazados. Los campos enlazados son campos que se arrastran desde la pestaña Buscador de contenido y que contienen valores de propiedad que no están vacíos bindRef en el cuadro de diálogo de edición de campos. Los campos no enlazados se arrastran directamente desde el explorador de componentes de la barra de tareas y tienen un valor vacío bindRef.

Puede rellenar previamente tanto los campos enlazados como los no enlazados de un formulario adaptable. Los datos de relleno previo contienen las secciones afBoundData y afUnBoundData para rellenar previamente tanto los campos enlazados como los no enlazados de un formulario adaptable. La sección afBoundData contiene los datos de relleno previo de los campos y paneles enlazados. Estos datos deben cumplir con el esquema del modelo de formulario asociado:

Ejemplo de estructura XML de relleno previo sample-prefill-xml-structure

<?xml version="1.0" encoding="UTF-8"?>
<afData>
  <afBoundData>
     <employeeData>
        .
     </employeeData>
  </afBoundData>

  <afUnboundData>
    <data>
      <textbox>Hello World</textbox>
         .
         .
      <numericbox>12</numericbox>
         .
         .
    </data>
  </afUnboundData>
</afData>

Ejemplo de estructura JSON de relleno previo sample-prefill-json-structure

{
   "afBoundData": {
      "employeeData": { }
   },
   "afUnboundData": {
      "data": {
         "textbox": "Hello World",
         "numericbox": "12"
      }
   }
}

Para los campos enlazados con los mismos campos bindref o unbound con el mismo nombre, los datos especificados en la etiqueta XML o el objeto JSON se rellenan en todos los campos. Por ejemplo, dos campos de un formulario se asignan al nombre textbox en los datos de relleno previo. Durante el tiempo de ejecución, si el primer campo de cuadro de texto contiene “A”, entonces “A” se rellena automáticamente en el segundo cuadro de texto. Esta vinculación se denomina vinculación activa de los campos del formulario adaptable.

Formularios adaptables que utilizan una plantilla de formulario XFA xfa-based-af

La estructura XML de relleno previo y el XML enviado para formularios adaptables basados en XFA es la siguiente:

Prefill-Submit-Data-ContentPackage.zip

Obtener archivo
Ejemplo que contiene datos de relleno previo y datos enviados

Formularios adaptables basados en esquemas XML xml-schema-af

La estructura de XML de relleno previo y de XML enviado para formularios adaptables basados en esquemas XML es la siguiente:

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

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

    <xs:complexType name="SampleType">
        <xs:sequence>
            <xs:element name="noOfProjectsAssigned" type="xs:string"/>
        </xs:sequence>
    </xs:complexType>
</xs:schema>

Para los campos cuyo modelo es un esquema XML, los datos se rellenan previamente en la etiqueta afBoundData como se muestra en el siguiente ejemplo XML. Se puede utilizar para rellenar previamente un formulario adaptable con uno o más campos de texto no enlazados.

<?xml version="1.0" encoding="UTF-8"?><afData>
  <afUnboundData>
    <data>
      <textbox>Ignorance is bliss :) </textbox>
    </data>
  </afUnboundData>
  <afBoundData>
    <data>
      <noOfProjectsAssigned>twelve</noOfProjectsAssigned>
    </data>
  </afBoundData>
</afData>

Un ejemplo sin los envoltorios afData y afBoundData an-example-without-afdata-and-afbounddata-wrapper

<?xml version="1.0" encoding="UTF-8"?><config>
 <assignmentDetails descriptionOfAssignment="Some Science Project" durationOfAssignment="34" financeRelatedProject="1" name="Lisa" numberOfMentees="1"/>
 <assignmentDetails descriptionOfAssignment="Kidding, right?" durationOfAssignment="4" financeRelatedProject="1" name="House" numberOfMentees="3"/>
</config>

Formularios adaptables basados en esquemas JSON json-schema-based-adaptive-forms

Para formularios adaptables basados en el esquema JSON, la estructura de JSON de relleno previo y JSON enviado se describe a continuación. Para obtener más información, consulte Crear formularios adaptables mediante el esquema JSON.

{
  "id": "https://some.site.somewhere/entry-schema#",
  "$schema": "https://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "address": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string"
        },
        "age": {
          "type": "integer"
        }
      }
    }
  }
}

Para los campos que utilizan el modelo de esquema JSON, los datos se rellenan previamente en el objeto afBoundData como se muestra en el siguiente archivo JSON de ejemplo. Se puede utilizar para rellenar previamente un formulario adaptable con uno o más campos de texto no enlazados. A continuación se muestra un ejemplo de datos con afData/afBoundData envoltorio:

{
  "afData": {
    "afUnboundData": {
      "data": { "textbox": "Ignorance is bliss :) " }
    },
    "afBoundData": {
      "data": { {
   "user": {
    "address": {
     "city": "Noida",
     "country": "India"
}}}}}}}

A continuación se muestra un ejemplo sin afData/afBoundData envolvente:

{
  "user": {
    "address": {
      "city": "Noida",
      "country": "India"
    }
  }
}

Formulario adaptable sin modelo de formulario adaptive-form-with-no-form-model

Para formularios adaptables sin modelo de formulario, los datos de todos los campos se encuentran en la etiqueta <data> de <afUnboundData> tag.

Asimismo, tome nota de lo siguiente:

Las etiquetas XML para los datos de usuario enviados para varios campos se generan al utilizar el nombre de los campos. Por lo tanto, los nombres de campo deben ser únicos.

<?xml version="1.0" encoding="UTF-8"?><afData>
  <afUnboundData>
    <data>
      <radiobutton>2</radiobutton>
      <repeatable_panel_no_form_model>
        <numericbox>12</numericbox>
      </repeatable_panel_no_form_model>
      <repeatable_panel_no_form_model>
        <numericbox>21</numericbox>
      </repeatable_panel_no_form_model>
      <checkbox>2</checkbox>
      <textbox>Nopes</textbox>
    </data>
  </afUnboundData>
  <afBoundData/>
</afData>

Configuración del servicio de relleno previo configuring-prefill-service-using-configuration-manager

Utilice la propiedad alloweddataFileLocations de la configuración predeterminada del servicio de relleno previo para establecer la ubicación de los archivos de datos o una regex (expresión regular) para las ubicaciones de los archivos de datos.

El siguiente archivo JSON muestra un ejemplo:

  {
  "alloweddataFileLocations": "`file:///C:/Users/public/Document/Prefill/.*`"
  }

Para establecer los valores de una configuración, consulte Generar configuraciones de OSGi mediante el SDK de AEM e implemente la configuración a su instancia de Cloud Service.

El curioso caso de los paneles repetibles the-curious-case-of-repeatable-panels

Por lo general, los campos enlazados (esquema de formulario) y no enlazados se crean en el mismo formulario adaptable, pero las siguientes son algunas excepciones en caso de que el enlace sea repetible:

Protocolos admitidos para rellenar previamente datos de usuario supported-protocols-for-prefilling-user-data

Los formularios adaptables se pueden rellenar previamente con datos de usuario en formato de datos de relleno previo cuando se configura con una regex válida mediante los siguientes protocolos:

El protocolo crx:// the-crx-protocol

http
https://`servername`/content/forms/af/xml.html?wcmmode=disabled&dataRef=crx:///tmp/fd/af/myassets/sample.xml

El nodo especificado debe tener una propiedad denominada jcr:data y mantener los datos.

El protocolo file://  the-file-protocol-nbsp

https://`servername`/content/forms/af/someAF.html?wcmmode=disabled&dataRef=file:///C:/Users/form-user/Downloads/somesamplexml.xml

El archivo de referencia debe estar en el mismo servidor.

El protocolo https:// the-http-protocol

https://`servername`/content/forms/af/xml.html?wcmmode=disabled&dataRef=https://servername/somesamplexmlfile.xml

El protocolo service:// the-service-protocol

https://`servername`/content/forms/af/abc.html?wcmmode=disabled&dataRef=service://[SERVICE_NAME]/[IDENTIFIER]

Configurar el atributo de datos en slingRequest setting-data-attribute-in-slingrequest

También puede configurar el atributo data en slingRequest, donde el atributo data es una cadena que contiene XML o JSON, como se muestra en el siguiente código de ejemplo (el ejemplo es para XML):

<%
           String dataXML="<afData>" +
                            "<afUnboundData>" +
                                "<data>" +
                                    "<first_name>"+ "Tyler" + "</first_name>" +
                                    "<last_name>"+ "Durden " + "</last_name>" +
                                    "<gender>"+ "Male" + "</gender>" +
                                    "<location>"+ "Texas" + "</location>" +
                                    "</data>" +
                            "</afUnboundData>" +
                        "</afData>";
        slingRequest.setAttribute("data", dataXML);
%>

Puede escribir una cadena XML o JSON simple que contenga todos los datos y establecerlos en slingRequest. Esto se puede hacer fácilmente en el JSP del procesador para cualquier componente que quiera incluir en la página donde puede establecer el atributo de datos slingRequest.

Por ejemplo, donde quiera un diseño específico para la página con un tipo específico de encabezado. Para lograrlo, puede escribir su propio header.jsp, que puede incluir en el componente de página y establecer el atributodata.

Otro buen ejemplo es un caso de uso en el que le gustaría rellenar previamente los datos de inicio de sesión a través de cuentas en redes sociales como Facebook, Twitter o LinkedIn. En este caso, puede incluir un JSP simple en header.jsp, que obtenga datos de la cuenta de usuario y establezca el parámetro de los datos.

prefill-page component.zip

Obtener archivo
Ejemplo de prefill.jsp en el componente de página

AEM Forms servicio de relleno previo personalizado aem-forms-custom-prefill-service

Puede utilizar el servicio de relleno previo personalizado para escenarios en los que se lean constantemente datos de una fuente predefinida. El servicio de relleno previo lee datos de orígenes de datos definidos y prefiere los campos del formulario adaptable con contenido del archivo de datos de relleno previo. También le ayuda a asociar de forma permanente los datos rellenos previamente con un formulario adaptable.

Crear y ejecutar un servicio de relleno previo create-and-run-a-prefill-service

El servicio de relleno previo es un servicio OSGi y se empaqueta a través del paquete OSGi. Puede crear el paquete OSGi, cargarlo e instalarlo en paquetes AEM Forms. Antes de empezar a crear el paquete, haga lo siguiente:

Obtener archivo

Crear un servicio de relleno previo create-a-prefill-service

El paquete de plantillas (paquete de servicio de relleno previo de muestra) contiene una implementación de muestra del servicio de relleno previo AEM Forms. Abra el paquete de plantillas en un editor de código. Por ejemplo, abra el proyecto de plantillas en Eclipse para editarlo. Después de abrir el paquete de plantillas en un editor de código, realice los siguientes pasos para crear el servicio.

Iniciar y utilizar el servicio de relleno previo start-and-use-the-prefill-service

Para iniciar el servicio de relleno previo, cargue el archivo JAR en la AEM Forms consola web y active el servicio. Ahora, el servicio aparecerá en el editor de formularios adaptables. Para asociar un servicio de relleno previo a un formulario adaptable, haga lo siguiente: