@LDESCENDANTS

English (Español a continuación)

This function obtains all the descendants of a certain group, or their descendants up to a certain generation or certain level.

  • This function does not include group members in the result, unlike the @ILDESCENDANTS function that does.

The structure of this function consists of two parts:

@LDESCENDANTS (Part A, Part B);

“Part A”: A group of members. You can specify:

  • Within a FIX with the functions @ATTRIBUTE (it selects all the members of the outline that have a certain tribute assigned) or the function @UDA (it selects all the members of the outline that have a certain UDA assigned).
  • Outside a FIX with the @LIST function.

All members of the list must belong to the same dimension.

“Part B”: this part is optional; selects the generation or the level to which you want to go down in obtaining the descendants. It can be indicated with a number (if it is positive it defines a generation and if it is 0 or negative it defines a level) or with the name of the generation or level.

The order in which you get the descendants is starting with the closest to the specified member, following the next closest, and so on.

Let’s see an example: Starting from the following outline:

The function @LDESCENDANTS (@LIST (CATALUÑA, VALENCIA), 0):

Results:

  • BARCELONA
  • TARRAGONA
  • LERIDA
  • GERONA
  • VALENCIA NORTH
  • SOUTH VALENCIA

The function @LDESCENDANTS (@LIST (CATALUÑA, VALENCIA), 1):

  • It does not give any result, since the levels 1 of these members would be themselves (CATALUÑA, VALENCIA), but in this function the group members do not enter in the solution.

This function can be used as a parameter to another function that requires a list of members:

For example:

Español

Esta función obtiene todos los descendientes de un determinado grupo, o sus descendientes hasta determinada generación o determinado nivel.

  • Esta función no incluye en el resultado a los miembros del grupo, a diferencia de la función @ILDESCENDANTS que sí los incluye.

La estructura de esta función consta de dos partes:

@LDESCENDANTS (Parte A, Parte B);

“Parte A”: Un grupo de miembros. Se puede especificar:

  • Si es dentro de un FIX con las funciones @ATTRIBUTE  (selecciona todos los miembros del outline que tienen asignado determinado tributo) o la función @UDA (selecciona todos los miembros del outline que tienen asignado determinado UDA).
  • Si es fuera de un FIX con la función @LIST.

Todos los miembros de la lista deben pertenecer a la misma dimensión.

“Parte B”: esta parte es opcional; recoge la generación o el nivel hasta  el que se quiere bajar en la obtención de los descendientes. Se puede indicar con un número (si es positivo define una generación y si es 0 o negativo define un nivel) o con el nombre de la generación o nivel.

El orden en el que obtiene los descendientes es comenzando por el más cercano al miembro especificado, siguiendo por el siguiente más cercano y así sucesivamente.

Veamos un ejemplo: Partiendo del siguiente outline:

La función @LDESCENDANTS(@LIST(CATALUÑA,VALENCIA),0)

Da como resultado:

  • BARCELONA
  • TARRAGONA
  • LERIDA
  • GERONA
  • VALENCIA NORTE
  • VALENCIA SUR

La función @LDESCENDANTS(@LIST(CATALUÑA,VALENCIA),1)

No da ningún resultado, ya que los niveles 1 de estos miembros serían ellos mismos (CATALUÑA,VALENCIA), pero en esta función los miembros del grupo no entran en la solución.

Esta función se puede utilizar como parámetro de otra función que requiera una lista de miembros:

Por ejemplo: