INFOR.GET.ELEMENTS

Esta función es una variante mejorada de la función INFOR.GET.ELEMENT. Devuelve uno o más valores de atributos para uno o más elementos. Puede recuperar, por ejemplo, elementos secundarios de un elemento determinado y solicitar el título, MEMBER_CAPTION y el id., MEMBER_UNIQUE_NAME.

INFOR.GET.ELEMENTS admite estas características:

  • Matrices dinámicas

    Los valores recuperados se desbordan hacia las celdas adyacentes.

  • Selección múltiple

    Puede especificar varios nombres exclusivos de elementos de la misma jerarquía.

  • Recuperación de todos los atributos
  • Expresiones MDX

    Por ejemplo, puede especificar [HierarchyUN].DefaultMember para devolver los atributos del elemento predeterminado o elementoUN.Children para devolver varios elementos secundarios.

    Nota

    Si se devuelve un conjunto de elementos de una expresión MDX, los valores se desbordan automáticamente y los atributos correspondientes se devuelven para cada elemento por separado.

  • Sangría

    Puede especificar la cadena que se utiliza para la sangría de nivel de elementos y que indica a qué atributos se debe aplicar.

    De forma predeterminada, solo se aplica la sangría al primer atributo, y se utilizan dos espacios.

  • Paginación

    Hay dos argumentos que se pueden utilizar para el comportamiento de la paginación. Puede limitar el número de registros mostrados y definir qué página se utiliza.

Desbordamiento de fórmulas

Si la función devuelve varios valores, dichos valores se desbordan en las celdas en blanco adyacentes. La dirección de desbordamiento predeterminada indica que los elementos se desborden verticalmente hacia abajo, y que los valores de atributo se desborden horizontalmente hacia la derecha.

Sintaxis

La función tiene esta sintaxis:

=INFOR.GET.ELEMENTS("spillByColumns", "data_connection", "cube", [attribute], "hierarchy" {, "number_of_records", "page", "indentString", [indentIndices], [element], ...})

En esta tabla se muestran los parámetros y sus descripciones:

Parámetros Descripción
spillByColumns Valor booleano opcional para dirección de desbordamiento. Especifique true para desbordar por columnas o false para desbordar por filas. Valor predeterminado: false.
data_connection Representa el nombre exclusivo de la base de datos. Es una cadena o una referencia de celda.
cube Representa el nombre exclusivo del cubo. Es una cadena o una referencia de celda.
attribute Representa el nombre exclusivo del atributo. Es una matriz de cadenas o referencias de celdas. Si no se especifica, MEMBER_CAPTION es el valor predeterminado.
hierarchy Representa el nombre exclusivo de la jerarquía. Es una cadena o una referencia de celda. Si no se especifica la jerarquía, el valor predeterminado es una cadena vacía y la jerarquía se analiza a partir del nombre exclusivo del elemento.
number_of_records Valor numérico o referencia de celda que sirve como límite del número de registros que se muestran. Parámetro opcional, con el valor predeterminado: 0 que no representa ningún límite.
page Valor numérico o referencia de celda que define la página que se va a mostrar. Parámetro opcional, con el valor predeterminado: 1.
indentString Cadena usada para la sangría. Parámetro opcional, con el valor predeterminado: ' ', dos espacios.
indentIndices Matriz de índices o referencias de celda que representan uno o más atributos a los que se va a aplicar sangría. Parámetro opcional con el valor predeterminado 1. De forma predeterminada, se aplica sangrado al primer atributo. Otros valores posibles: 0 para aplicar sangría a todos los atributos. -1 para no utilizar sangría.
element Cualquier número de matrices de nombres exclusivos de elementos o referencias de celda de la jerarquía seleccionada. El número máximo es 249 debido al límite de Excel.
Nota

Si no se especifica la jerarquía, el nombre exclusivo de los elementos se debe especificar en su formato largo, por ejemplo, [PERIOD].[ALL YEARS].[2018].

Valores devueltos

Esta función devuelve valores de cadena que representan uno o más atributos de elemento, como el título, MEMBER_CAPTION, y el id., MEMBER_UNIQUE_NAME, para uno o más elementos. Si proporciona 2 nombres exclusivos de elemento y dos atributos, devuelven como resultado una matriz de dos por dos.

Por ejemplo, si especifica Ventas desde Norteamérica para 2016, 2017 y 2018, la función devuelve una matriz de uno por tres de valores de resumen para los años seleccionados.