Creación de formularios adaptables con Esquema XML

Requisitos previos

La creación de un formulario adaptable con un esquema XML como modelo de formulario requiere una comprensión básica de los esquemas XML. Además, se recomienda leer el siguiente contenido antes de este artículo.

• Creación de un formulario adaptable
• ESQUEMA XML

Uso de un esquema XML como modelo de formulario

AEM Forms admite la creación de un formulario adaptable utilizando un esquema XML existente como modelo de formulario. Este esquema XML representa la estructura en la que el sistema back-end de la organización produce o consume datos.

Las características clave del uso de un esquema XML son:

• La estructura del XSD se muestra como un árbol en la ficha Buscador de contenido en el modo de creación de un formulario adaptable. Puede arrastrar y agregar elementos de la jerarquía XSD al formulario adaptable.
• Puede rellenar previamente el formulario utilizando XML que sea compatible con el esquema asociado.
• Al enviar, los datos introducidos por el usuario se envían como XML que se alinea con el esquema asociado.

Un esquema XML consta de tipos de elementos simples y complejos. Los elementos tienen atributos que agregan reglas al elemento. Cuando estos elementos y atributos se arrastran a un formulario adaptable, se asignan automáticamente al componente de formulario adaptable correspondiente.

Esta asignación de elementos XML con componentes de formulario adaptables es la siguiente:

Esquema XML de muestra

Este es un ejemplo de un esquema XML.

<?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="leaderName" type="xs:string" default="Enter Name"/>
                <xs:element name="assignmentStartBirth" type="xs:date"/>
                <xs:element name="gender" type="GenderEnum"/>
                <xs:element name="noOfProjectsAssigned" type="IntType"/>
                <xs:element name="assignmentDetails" type="AssignmentDetails"
                                            minOccurs="0" maxOccurs="10"/>
            </xs:sequence>
        </xs:complexType>

        <xs:complexType name="AssignmentDetails">
            <xs:attribute name="name" type="xs:string" use="required"/>
            <xs:attribute name="durationOfAssignment" type="xs:unsignedInt" use="required"/>
            <xs:attribute name="numberOfMentees" type="xs:unsignedInt" use="required"/>
             <xs:attribute name="descriptionOfAssignment" type="xs:string" use="required"/>
             <xs:attribute name="financeRelatedProject" type="xs:boolean"/>
       </xs:complexType>
  <xs:simpleType name="IntType">
            <xs:restriction base="xs:int">
            </xs:restriction>
        </xs:simpleType>
  <xs:simpleType name="GenderEnum">
            <xs:restriction base="xs:string">
                <xs:enumeration value="Female"/>
                <xs:enumeration value="Male"/>
            </xs:restriction>
        </xs:simpleType>
    </xs:schema>

Añadir propiedades especiales a campos mediante el esquema XML

Puede agregar los atributos siguientes a los elementos de Esquema XML para agregar propiedades especiales a los campos del formulario adaptable asociado.

Límite de valores aceptables para un componente de formulario adaptable

Puede agregar las siguientes restricciones a los elementos de esquema XML para limitar los valores aceptables para un componente de formulario adaptable:

Preguntas frecuentes

¿Cómo sé qué elemento del árbol está asociado con qué elemento XML?

Al hacer clic con el botón doble en un elemento del Buscador de contenido, una ventana emergente muestra un nombre de campo y una propiedad llamada bindRef. Esta propiedad asigna el elemento de árbol al elemento o atributo del esquema.

El campo bindRef muestra la asociación entre un elemento de árbol y un elemento o atributo de un esquema.

¿Por qué no se pueden arrastrar elementos individuales de un subformulario (estructura generada a partir de cualquier tipo complejo) para subformularios repetibles (los valores minOccours o maxoccur son buenos a partir de 1)?

En un subformulario repetible, debe utilizar el subformulario completo. Si solo desea campos selectivos, utilice toda la estructura y elimine los no deseados.

Tengo una estructura larga y compleja en Content Finder. ¿Cómo puedo encontrar un elemento específico?

Tiene dos opciones:

• Desplácese por la estructura de árbol
• Utilice el cuadro Buscar para encontrar un elemento

¿Qué es bindRef?

Un bindRef es la conexión entre un componente de formulario adaptable y un elemento o atributo de esquema. Indica el XPath donde el valor capturado de este componente o campo está disponible en el XML de salida. También se utiliza un bindRefcuando se rellena previamente un valor de campo a partir de un XML prerelleno (prerellenado).