Las secciones repetibles son paneles que se pueden agregar o quitar de forma dinámica a un formulario.
Por ejemplo, mientras solicita un trabajo, el buscador de empleo proporciona detalles de empleo previos, como el nombre de la empresa, la función, el proyecto y otra información. La información de todos los empleadores requiere secciones diferentes pero parecidas. En ese caso, el formulario de empleo proporciona una sección de empleadores y también ofrece la opción de agregar dinámicamente más de esas secciones. Estas secciones, que se agregan dinámicamente, se conocen como secciones repetibles.
Puede utilizar uno de los siguientes métodos para crear paneles repetibles:
En el modo de edición, seleccione un panel y, a continuación, pulse . En la barra lateral, en Propiedades, habilite Hacer que el panel sea repetible. Especifique valores para los campos Maximum y Minimum.
El campo Maximum especifica el número máximo de veces que puede aparecer un panel en la página. Puede especificar -1 en el campo Recuento máximo para permitir que el panel aparezca durante un número infinito de veces.
El campo Minimum especifica el número mínimo de veces que aparece un panel en el formulario. Si establece el campo Recuento mínimo en cero, más adelante, puede eliminar todas las instancias mediante secuencias de comandos una vez completada la representación.
Para crear un panel no repetible, establezca el valor del campo Máximo y Mínimo en uno. El diseño del acordeón no admite -1 en el campo Recuento máximo . Puede especificar un número elevado para dar la noción de valor infinito.
El elemento principal del panel, que se va a repetir, debe contener botones de adición y eliminación para administrar las instancias de los paneles repetibles. Realice los siguientes pasos para insertar botones en el elemento principal y activar secuencias de comandos en los botones:
Desde la barra lateral, arrastre y suelte un componente de botón en el panel principal. Seleccione el componente y pulse . Las reglas del botón se abren en el editor de reglas.
En la ventana Editor de reglas, haga clic en Crear.
Seleccione Visual Editor en la fila Objetos de formulario y funciones.
En el área de regla, en CUÁNDO, seleccione el estado en el que se hace clic.
En ENTONCES:
Seleccione Editor de código en la fila Objetos y funciones del formulario. Haga clic en Editar reglas y en el área de código:
this.panel.instanceManager.addInstance()
this.panel.instanceManager.removeInstance(this.panel.instanceIndex)
Haga clic en Listo.
Si un campo pertenece a un panel repetible, no puede acceder a él directamente utilizando su nombre en las secuencias de comandos. Para acceder al campo , especifique la instancia repetible a la que pertenece el campo utilizando la API instances
en InstanceManager
. La sintaxis para utilizar la API instances
en InstanceManager
es:
<panelName>.instanceManager.instances[<instanceNumber>].<fieldname>
Por ejemplo, se crea un formulario adaptable con un panel repetible que tiene un cuadro de texto. Cuando rellene previamente el formulario con tres cuadros de texto repetibles, necesitará el xml siguiente:
<panel1><textbox1>AA1</panel1></textbox1>
<panel1><textbox1>AA2</panel1></textbox1>
<panel1><textbox1>AA3</panel1></textbox1>
Para leer datos de AA1, especifique:
Panel1.instanceManager.instances[0].textbox.value
Para leer datos de AA2, especifique:
Panel1.instanceManager.instances[1].textbox.value
Para obtener más información, consulte: Clase: InstanceManager#instances en Referencia de la API Java de AEM Forms.
Cuando todas las instancias de un panel se eliminen de un formulario adaptable, para agregar una instancia del panel eliminado, utilice la sintaxis _panelName para capturar el administrador de instancias del panel y use la API addInstance de instance manager para agregar la instancia eliminada. Por ejemplo, _panelName.addInstance(). Agrega una instancia del panel eliminado.
Un panel tiene varias opciones de diseño. La opción Diseño para el diseño de acordeón es compatible de serie con paneles repetibles. Realice los siguientes pasos en el panel repetible con la opción Diseño para diseño acordeón :
En el panel principal que se va a repetir, pulse . Puede ver las propiedades en la barra lateral. En la lista desplegable Layout, seleccione Acordeón.
En un panel, que se va a repetir, pulse . Puede ver las propiedades del panel en la barra lateral. Active la pestaña Make Panel Repetido y especifique el valor de los campos Maximum y Minimum.
Ahora, puede utilizar los botones más (+) y eliminar ( ) para agregar y quitar los paneles.
El subformulario repetible es similar a los paneles repetibles de Forms adaptable. En AEM Forms Designer, realice los siguientes pasos para crear un subformulario de repetición:
El archivo .zip adjunto contiene un subformulario repetible de ejemplo.
Puede crear paneles repetibles a partir de un esquema XML y de la propiedad minOccours & maxOccurs de cualquier elemento de tipo complejo. Para obtener información detallada sobre el esquema XML, consulte Creación de formularios adaptables utilizando el esquema XML como modelo de formulario.
En el siguiente código, el panel SampleType
utiliza la propiedad minOccours & maxOcurrs .
<?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="assignmentStartDate" 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>
Para una presentación distinta de la de acordeón, utilice componentes de botón de formulario adaptable para añadir y quitar instancias.