group-into-blocks

www.altova.com Imprimir este apartado Página anterior Subir un nivel Página siguiente

Inicio >  Funciones > Referencia de la biblioteca de funciones > core | sequence functions (secuencia) >

group-into-blocks

La función group-into-blocks crea grupos iguales que contienen exactamente N elementos, donde N es el valor que se le da al argumento block-size. Observe que el último grupo puede contener N elementos o menos en función de la cantidad de elementos de la fuente. En el ejemplo siguiente, block-size es 2. Como hay cinco elementos en total, cada grupo contiene exactamente dos elementos, excepto el último, que solo puede contener uno.

mf_group-into-blocks

 

Argumentos

Nombre

Tipo

Descripción

nodes/rows

Una secuencia de elementos

Una secuencia de nodos o filas (por ejemplo, el origen de la conexión puede estar en un nodo XML de origen con secundarios, un registro CSV, etc.).

block-size

xs:integer

Indica el tamaño de cada grupo.

 

Ejemplo

Imaginemos que sus datos de origen son un archivo XML con el siguiente contenido (tenga en cuenta que, para simplificar, en el código de ejemplo siguiente hemos eliminado el espacio de nombre y las declaraciones XML).

 

<company>
  <person department="Administration" name="Vernon Callaby"/>
  <person department="Marketing" name="Susi Sanna"/>
  <person department="Engineering" name="Michelle Butler"/>
  <person department="Engineering" name="Fred Landis"/>
  <person department="Administration" name="Frank Further"/>  
</company>

 

El requisito empresarial es agrupar registros de personas en bloques de dos elementos cada uno. Para ello, la siguiente asignación invoca la función group-into-blocks y da como tamaño (block-size) el valor entero "2".

mf_group-into-blocks_map

El resultado de la asignación es el siguiente:

 

<groups>
  <group>
    <record key="Administration" value="Vernon Callaby"/>
    <record key="Marketing" value="Susi Sanna"/>
  </group>
  <group>
    <record key="Engineering" value="Michelle Butler"/>
    <record key="Engineering" value="Fred Landis"/>
  </group>
  <group>
    <record key="Administration" value="Frank Further"/>
  </group>
</groups>

 

Observe que el último grupo contiene un único elemento, ya que el número total de elementos (5) no se puede dividir entre 2.

 

Este ejemplo, junto con otros ejemplos de agrupación, es parte de esta asignación: <Documentos>\Altova\MapForce2019\MapForceExamples\Tutorial\GroupingFunctions.mfd. Antes de hacer clic en la pestaña Resultados, recuerde hacer clic en el botón Vista previa mf_ic_preview de la función que quiere comprobar.


© 2019 Altova GmbH