Esta función selecciona a un miembro específico y a sus descendientes, ofreciendo dos opciones:
- Selecciona todos los miembros descendientes.
- Selecciona todos los miembros descendientes hasta cierto nivel o generación.
La estructura de esta función consta de dos partes:
@IRDESCENDANTS (Parte A, Parte B);
- “Parte A”: recoge el miembro del que se quieren obtener sus descendientes.
- “Parte B”: esta parte es opcional: si se deja vacía devuelve todos los descendientes, pero se puede indicar con un dígito hasta donde se quiere descender (si el número es cero o negativo indica un nivel; si es positivo indica una generación). También se puede indicar con el nombre del nivel / generación.
El orden en el que obtienen los descendientes es comenzando por el propio miembro, seguido del descendiente más cercano, siguiendo por el siguiente más cercano y así sucesivamente.
Veamos un ejemplo: Partiendo del siguiente outline:
Si aplicamos las siguientes funciones obtenemos los siguientes resultados:
@IRDESCENDANTS (“LEVANTE”)
- LEVANTE
- VALENCIA
- VALENCIA NORTE
- VALENCIA SUR
- ALICANTE
- CASTELLON
@IRDESCENDANTS (“LEVANTE”,1)
- LEVANTE
- VALENCIA
Si algún miembro descendiente es miembro compartido esta función incluye los descendientes de su correspondiente miembro principal. Esto lo diferencia de la función @IDESCENDANTS que no incluye a los descendientes del miembro principal de un miembro compartido. Veamos un ejemplo relativo al outline anterior.
@IRDESCENDANTS (“MERCADO IBERICO”)
- MERCADO IBERICO
- PORTUGAL
- CATALUÑA
- BARCELONA
- TARRAGONA
- LERIDA
- GERONA
- RESTO
“CATALUÑA” es miembro compartido; esta función incluye también los descendientes de su miembro principal (BARCELONA, TARRAGONA, LERIDA y GERONA),
@IDESCENDANTS (“MERCADO IBERICO”)
- MERCADO IBERICO
- PORTUGAL
- CATALUÑA
- RESTO
Esta función no incluye los descendientes de “CATALUÑA”.
Esta función se puede utilizar como parámetro de otra función que requiera una lista de miembros:
Por ejemplo:
