INFOR.GET.ELEMENT

Esta função retornará valores que representam um ou mais atributos de elemento. Por exemplo, Legenda (MEMBER_CAPTION) ou ID (MEMBER_UNIQUE_NAME).

INFOR.GET.ELEMENT suporta estes recursos:

  • Multisseleção

    Você pode especificar vários nomes exclusivos de elementos da mesma hierarquia.

  • Recuperação de todos os atributos
  • Expressões MDX

    Por exemplo, você pode especificar [HierarchyUN].DefaultMember para retornar os atributos de elemento padrão ou elementUN.Children para vários elementos filhos retornados.

    Se um conjunto de elementos agregado for retornado de uma expressão MDX, os atributos correspondentes serão retornados em uma célula, separados por vírgulas.

Sintaxe

A função tem a seguinte sintaxe:

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

Esta tabela mostra os parâmetros e suas descrições:

Parâmetros Descrição
data_connection Representa o nome exclusivo do banco de dados. É uma string ou uma referência de célula.
cube Representa o nome exclusivo do cubo. É uma string ou uma referência de célula.
attribute Representa o nome exclusivo do atributo. É uma matriz de strings ou referências a células. Se não for especificado, o valor padrão é MEMBER_CAPTION.
hierarchy Representa o nome exclusivo da hierarquia. É uma string ou uma referência de célula. Se a hierarquia não for especificada, o valor padrão será uma string vazia e a hierarquia é analisada a partir do nome exclusivo do elemento.
element Representa o nome exclusivo do elemento da hierarquia especificada. É qualquer número de strings ou referências de célula.
Nota

Se a hierarquia não for especificada, o nome exclusivo do elemento deverá ser especificado em sua forma longa, por exemplo, [PERIOD].[ALL YEARS].[2018].

.

Valores de retorno

Esta função retorna um valor de célula única de qualquer tipo.

Para uma hierarquia especificada e válida:

  • Se o parâmetro de elemento for especificado como vários nomes exclusivos separados por vírgula, será retornado um membro agregado. Os vários elementos devem ser da mesma hierarquia.
  • Se o parâmetro de elemento estiver vazio, o elemento padrão da hierarquia especificada será retornado.
  • Se o parâmetro de elemento for somente o nome do elemento, o primeiro elemento disponível com esse nome será retornado.

Quando o parâmetro de atributos contém vários nomes exclusivos, por exemplo, MEMBER_CAPTION e MEMBER_UNIQUE_NAME, a função retorna uma matriz de tamanho 1 x N. A ordem dos atributos especificados define a ordem dos itens retornados.

Se o argumento [attribute] não for especificado, a função retornará o atributo MEMBER_CAPTION.

Erros

A função retornará um valor de erro se qualquer parâmetro obrigatório estiver ausente. Se os parâmetros especificados forem inválidos, o elemento correspondente será ignorado.