El API de documentos digitales provee métodos básicos para agregar o eliminar instancias de elementos iterativos en un documento digital. El primer método es el addEmptyIterativeElement que crea un nuevo elemento iterativo, agregándolo a su lista de elementos y retornando el nuevo elemento para ser usado con el método setIterativeAttribute para asignar valores a los campos.
El método removeLastIterativeElement elimina el último elemento de un iterativo de un documento digital. Y el método removeAllIteratives elimina todos los iterativos dejando la lista vacía.
Ejemplos de uso:
// Vaciar la lista de iterativos para agregar uno en particular. //
xBTDigitalDocument.removeAllIteratives(xBODigitalDocument,“iterativeName”);
BODigitalDocument xBODigitalDocumentIterative = xBTDigitalDocument. addEmptyIterativeElement(xBODigitalDocument, “iterativeName”);
xBTDigitalDocument.setIterativeAttribute(xBODigitalDocumentIterative, "iterativeName/fieldName", new Double(10.0)); // Se setea el valor 10.0. //
Nota: el método addEmptyIterativeElement, también, permite informar un tercer parámetro adicional para evitar crear instancias vacías. Esto es, cuando se crea el formulario con la función buildEmptyDocument, si el mismo tiene iterativos se crea una instancia vacía de cada grupo. Esto ocasiona la presencia de instancias vacías de iterativos al agregar elementos dentro de la ejecución de reglas. Con el tercer parámetro de método, al informarlo con valor true, si se encuentra para el iterativo una única instancia y está vacía, no se agrega nada y se devuelve la referencia a esa instancia para que se complete con los datos como si fuera una instancia más dentro del proceso.
