Altova MapForce 2023 Enterprise Edition

La función group-starting-with toma como argumento una condición booleana. Si se cumple la condición booleana se crea un grupo nuevo que empieza con el registro que cumple esa condición. En el siguiente ejemplo la condición es que la clave "Clave" debe ser "título". Esta condición se cumple en el caso de los registros primero y cuarto, así que se crean dos grupos:

mf_group-starting-with

Nota: si existen registros antes del primero que cumple la condición, se crea un grupo más. Por ejemplo, si hubiera más registros "línea" antes del último registro "título", estos se colocarían en ese grupo adicional.

 

Lenguajes

La función está disponible para XSLT 2.0, XSLT 3.0, Java, C#, C++ y el motor de ejecución integrado.

 

Parámetros

Nombre

Descripción

nodos/filas

Esta entrada debe recibir una conexión desde un elemento de la asignación que suministre una secuencia de cero o más valores. Por ejemplo, la conexión puede provenir de un elemento XML de origen, un campo CSV, un registro de BD, etc.

bool

xs:boolean Indica la condición booleana que inicia un nuevo grupo si se cumple (true).

 

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).

 

<records>
<record key="heading" value="Intro"/>
<record key="line" value="A"/>
<record key="line" value="B"/>
<record key="heading" value="Body"/>
<record key="line" value="C"/>
</records>

 

El requisito empresarial es crear un grupo para cada registro "heading". Cada grupo también debe incluir los registros "line" que siguen al registro "heading". Para ello, la siguiente asignación invoca la función group-starting-with. En la siguiente asignación, siempre que el nombre de key sea "heading", el argumento dado a bool pasa a ser true y se crea un grupo nuevo.

mf_group-starting-with_map

El resultado de la asignación es el siguiente:

 

<groups>
<group>
<record key="heading" value="Intro"/>
<record key="line" value="A"/>
<record key="line" value="B"/>
</group>
<group>
<record key="heading" value="Body"/>
<record key="line" value="C"/>
</group>
</groups>

 

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

© 2017-2023 Altova GmbH