@ILDESCENDANTS

English (Español a continuación)

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

The structure of this function consists of two parts:

@ILDESCENDANTS (Part A, Part B);

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

  • If it is 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).
  • If it is 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, continuing with the next closest, and so on.

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

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

Results:

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

The function @ILDESCENDANTS (@LIST (CATALUÑA, VALENCIA), – 1)

Results:

  • CATALONIA
  • VALENCIA

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 miembros de un determinado grupo, además de todos sus descendientes o de sus descendientes hasta determinada generación o determinado nivel.

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

@ILDESCENDANTS (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 @ILDESCENDANTS(@LIST(CATALUÑA,VALENCIA),0)

Da como resultado:

  • CATALUÑA
  • BARCELONA
  • TARRAGONA
  • LERIDA
  • GERONA
  • VALENCIA
  • VALENCIA NORTE
  • VALENCIA SUR

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

Da como resultado:

  • CATALUÑA
  • VALENCIA

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

Por ejemplo: