@LANCESTORS

English (Español a continuación)

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

The result does not include the group members (this differentiates it from the @ILANCESTORS function which does include them).

The structure of this function consists of two parts:

@LANCESTORS (Part A, Part B);

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

  • Within a FIX with the functions @ATTRIBUTE (selects all the members of the outline that have a certain attribute assigned) or the function @UDA (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; collects the generation or level to which you want to go up in obtaining the ascendants. 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 ascendants is starting with the closest to the specified member, following the next closest, and so on.

Let’s see an example:

The function @LANCESTORS (@LIST (VALENCIA, BARCELONA), – 2)

Results:

  • CATALONIA
  • LEVANTE
  • SPAIN

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 ascendientes de los miembros de un determinado grupo, o de sus ascendientes hasta determinada generación o determinado nivel.

El resultado no incluye a los miembros del grupo (esto lo diferencia de la función @ILANCESTORS que sí los incluye).

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

@LANCESTORS(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 subir en la obtención de los ascendientes. 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 ascendientes 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 @LANCESTORS(@LIST(VALENCIA,BARCELONA),-2)

Da como resultado:

  • CATALUÑA
  • LEVANTE
  • ESPAÑA

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

Por ejemplo: