INFOR.GET.ELEMENTS

Essa função é uma variação avançada da função INFOR.GET.ELEMENT. Ela retorna um ou mais valores de atributo para um ou mais elementos. É possível recuperar, por exemplo, filhos de um determinado elemento e solicitar legenda, MEMBER_CAPTION, e ID, MEMBER_UNIQUE_NAME.

INFOR.GET.ELEMENTS suporta estes recursos:

  • Matrizes dinâmicas

    Os valores recuperados são despejados nas células adjacentes.

  • 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 retornar vários elementos filhos.

    Nota

    Se um conjunto de elementos for retornado de uma expressão MDX, os valores serão automaticamente despejados e os atributos correspondentes serão retornados para cada elemento separadamente.

  • Recuo

    É possível especificar a string usada para recuar o nível dos elementos e indicar quais atributos devem ser recuados.

    Por padrão, somente o primeiro atributo é recuado e são usados dois espaços.

  • Paginação

    Há dois argumentos que podem ser usados para comportamento de paginação. É possível limitar o número de registros mostrados e definir qual página será usada.

Fórmula despejada

Se a função retornar vários valores, os valores serão despejados em células em branco adjacentes. A direção-padrão do despejamento é verticalmente para baixo para os elementos e horizontalmente para a direita para os valores de atributo.

Sintaxe

A função tem a seguinte sintaxe:

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

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

Parâmetros Descrição
spillByColumns Um valor booleano opcional para a direção do despejamento. Especifique true para despejar por colunas ou false para despejar por linhas. Valor padrão: false.
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, MEMBER_CAPTION é o valor padrão.
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.
number_of_records Um valor numérico ou uma referência de célula que serve como um limite de número de registros exibidos. Parâmetro opcional, com o valor padrão: 0 que não representa um limite.
page Valor numérico ou a referência de célula que define qual página será exibida. Parâmetro opcional, com o valor padrão: 1.
indentString String usada para recuo. Parâmetro opcional, com o valor padrão: ' ', dois espaços.
indentIndices Matriz de índices ou referências de célula que representa um ou mais atributos a serem recuados. Parâmetro opcional com o valor padrão 1. Por padrão, o primeiro atributo é recuado. Outros valores possíveis: 0 para recuar todos os atributos. -1 para não usar recuo.
element Qualquer número de matrizes de nomes exclusivos de elementos ou referências de células da hierarquia selecionada. O número máximo é 249 devido ao limite do Excel.
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 valores de string que representam um ou mais atributos de elemento, como legenda, MEMBER_CAPTION, id, MEMBER_UNIQUE_NAME, para um ou mais elementos. Se você fornecer dois nomes exclusivos de elementos e dois atributos, ele retornará uma matriz dois por dois como resultado.

Por exemplo, se você especificar Vendas da América do Norte para 2016, 2017 e 2018, a função retornará uma matriz um por três de valores de resumo para os anos selecionados.