INFOR.GET.ELEMENT

Esta función devuelve valores que representan uno o más atributos de elemento. Por ejemplo, Título (MEMBER_caption) o Id. (MEMBER_UNIQUE_NAME).

INFOR.GET.ELEMENT admite estas características:

  • 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.

    Si una expresión MDX devuelve un conjunto agregado de elementos, los atributos correspondientes se devuelven en una celda, separados por comas.

Sintaxis

La función tiene esta sintaxis:

=INFOR.GET.ELEMENT("data_connection", "cube", [attribute], "hierarchy" {, element, ...})

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

Parámetros Descripción
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, el valor predeterminado es MEMBER_CAPTION.
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.
element Representa el nombre exclusivo del elemento de la jerarquía especificada. Es una serie de cadenas o referencias de celdas.
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 un único valor de celda de cualquier tipo.

Para una jerarquía especificada y válida:

  • Si el parámetro element se especifica como varios nombres exclusivos separados por coma, se devuelve un miembro agregado. Los diversos elementos deben ser de la misma jerarquía.
  • Si el parámetro de element está vacío, se devuelve el elemento predeterminado de la jerarquía especificada.
  • Si el parámetro element solo es el nombre del elemento, se devuelve el primer elemento disponible con dicho nombre.

Cuando el parámetro de atributos contiene varios nombres exclusivos, por ejemplo, MEMBER_CAPTION y MEMBER_UNIQUE_NAME, la función devuelve una matriz del tamaño 1 x N. El orden de los atributos especificados define el orden de los artículos devueltos.

Si no se especifica el argumento [attribute], la función devuelve el atributo MEMBER_CAPTION.

Errores

La función devuelve un valor de error si falta algún parámetro necesario. Si los parámetros especificados no son válidos, se omite el element correspondiente.