MEMBERGET

Essa função retorna o nome exclusivo de um elemento por meio da referência dessa relação com um elemento consolidado. Esta função funciona apenas com bancos de dados compatíveis com ODBO. Para retornar a legenda, use o formato de número til (~).

Sintaxe

MEMBERGET("data_connection","cube","hierarchy","element_name","param" {,"param"})

Nota

O terceiro argumento da função é Hierarquia, e não Dimensão. Isso é importante quando você está usando bancos de dados relacionais ou do Analysis Services, que podem ter várias hierarquias em uma dimensão. É preciso especificar o nome exclusivo da hierarquia.

Ocorreu uma alteração temporária na forma como MEMBERGET trata parâmetros de hierarquia ou de elemento inválidos ou sem correspondência.

Se o mesmo nome de elemento existir em várias dimensões, pode ocorrer o erro Divergência de dimensionalidade. Para evitar isso, especifique o nome exclusivo do elemento.
Nota

Se você especificar uma string vazia como o nome do elemento, o elemento padrão da hierarquia especificada será assumido.

Exemplo

O exemplo seguinte usa o banco de dados Adventure Works do Analysis Services. A dimensão Geografia tem várias hierarquias. Este exemplo usa a hierarquia Cidade. Seu nome exclusivo é [Geography].[City].

=MEMBERGET("Adventure Works","Adventure Works","[Geography].[City]",
"[Geography].[City].&[Abingdon]&[ENG]","Sibling",2)
O exemplo retorna o elemento Alexandria [NSW]. Esse é o segundo irmão (contando de zero) de Abingdon [ENG]. Substitua 2 por 1 para retornar Albany [OR], que é o primeiro irmão de Abingdon [ENG].
Possíveis valores de Param1:
Filho
Retorna (com base em zero) o filho do pai, especificado por Param2. Param2 deve ser um número.
Avançar
Retorna o próximo elemento da hierarquia no mesmo nível do elemento especificado. Param2 não é necessário.
Nota

Memberget ("...,"Next") é equivalente a Memberget ("...,"Sibling",1)

Anterior
Retorna o elemento da hierarquia que está localizado antes do elemento especificado e no mesmo nível. Param2 não é necessário.
Irmão
Retornar o irmão do pai, especificado por param2. Param2 deve ser um número positivo ou negativo ou um zero.
Nota
Memberget ("...,"sibling",-1) is equivalent to Memberget ("...,"Prev")
Pai
Retorna o pai do elemento especificado. Param2 não é necessário.
=MEMBERGET("Adventure Works","Adventure Works","[Geography].[City]",
"[Geography].[City].&[Abingdon]&[ENG]","Parent")
Auto e Verificar
Auto e Verificar, ambas retornam o nome exclusivo do elemento especificado. Param2 não é necessário. Se o elemento não existir, a fórmula retorna o elemento padrão da hierarquia especificada.
'Verificar' confere se a hierarquia especificada existe. Se não existir, a fórmula retorna #NA.
‘Auto’ não verifica se a hierarquia especificada existe. Isto é, se o elemento existe, a fórmula retorna o seu nome exclusivo.
Nota

Memberget ("...,"Self") e Memberget ("...,"Verify") são ambos equivalentes a ("...,"Sibling",0)

Exemplo

O elemento padrão de uma hierarquia não é necessariamente o elemento de nível superior. Para descobrir qual é o elemento padrão, você pode usar o parâmetro auto e uma string vazia como o nome do elemento:

=MEMBERGET("data_connection","cube","hierarchy","","self")

Multisseleção

MEMBERGET suporta multisseleção. Ou seja, é possível usar MEMBERGET para retornar os nomes exclusivos de vários elementos armazenados no MLS-XML.

Por exemplo, uma variável de relatório chamada rv_multi contém este MLS-XML:
<?xml version="1.0" encoding="utf-16"?>
<MultiSelect xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <Hierarchy>[Period]</Hierarchy>
  <AggregationFunction>Sum</AggregationFunction>
  <StructureSelection>
    <Member>
      <MemberUName>[period].[all years].[2016]</MemberUName>
    </Member>
    <Member>
      <MemberUName>[period].[all years].[2017]</MemberUName>
    </Member>
  </StructureSelection>
</MultiSelect>
Você cria esta fórmula MEMBERGET:
=MEMBERGET( "BestPracticesOLAP", "Analysis", "[Period]", reportvariables.rv_multi.text, "child",2)

A fórmula MEMBERGET retorna este MLS-XML:

<?xml version="1.0" encoding="utf-16"?>
<MultiSelect xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <Hierarchy>[Period]</Hierarchy>
  <AggregationFunction>Sum</AggregationFunction>
  <StructureSelection>
    <Member>
      <MemberUName>[Period].[All Years].[2016].[2016_Q3]</MemberUName>
    </Member>
    <Member>
      <MemberUName>[Period].[All Years].[2017].[2017_Q3]</MemberUName>
    </Member>
  </StructureSelection>
</MultiSelect>
Nota

A célula que contém a fórmula MEMBERGET exibe </Multiselect>. Expanda a altura da célula para exibir a definição MLS-XML completa.

Você pode usar MULTISELECTGETMEMBERS ou MULTISELECTGETMEMBERSSIMPLE para extrair os nomes exclusivos dos elementos do MLS-XML.

Ou, para exibir as legendas dos elementos na célula, é possível especificar o caractere til (~) como o formato do número da célula.