NumDescendant

Lê o número de desdendentes do membro da Dimensão Atual ou de um membro especificado. Esta função pode ser usada nos seguintes tipos de regras:

  • Cálculo

  • Conversão

  • Consolidação

  • Alocação

    Nota:

    Um membro é um descendente se estiver um nível abaixo de um pai em uma hierarquia de árvore. Os descendentes estão no mesmo ramo da árvore.

Por exemplo, nesta hierarquia, FosterCity e Sunnyvale são descendentes de Califórnia e UnitedStates.


Descendentes na Hierarquia

Sintaxe

HS.<Object>.NumDescendant("Element")
HS.Node.NumDescendant("S#Scenario.Y#Year.P#Period.E#Entity")
HS.<Object>.NumDescendant("")
HS.Custom(Dimension).NumDescendant(Member)

Nota:

Use uma string em branco "" para aplicar esta função ao membro atual.

Tabela 11-39 Sintaxe da função NumDescendant

Parâmetro Descrição

<Object>

Uma das seguintes palavras-chave de objeto:

  • Account

  • Custom1...4

  • Personalizada (Rótulo da Dimensão Personalizada)

  • Entity

  • Node

  • Parent

Element

Dependendo do objeto selecionado, o nome de um membro válido de uma das seguintes dimensões:

  • Account

  • Custom1...4

  • Personalizada

  • Entity

  • Node

  • Parent

Para objetos Conta e Personalizados, você deve especificar o membro – não é possível usar uma sequência em branco.

Para obter o número de descendentes de toda a dimensão, especifique ALL entre aspas, como argumento. Por exemplo:

iAcctBase = HS.Account.NumDescendant("ALL")

Scenario

Nome de um membro válido da dimensão Cenário.

Year

Um ano válido.

Period

Um período válido.

Entity

Nome de um membro válido da dimensão Entidade.

Valor de Retorno

O número de descendentes do membro especificado. No nó, o número de entidades descendentes abaixo do membro especificado.

Nota:

Se uma entidade descendente aparecer duas vezes em uma ramificação a entidade será contada duas vezes.

Exemplo

Neste exemplo, se a entidade France não tiver descendentes, os comandos entre as instruções If...Then e End If serão executados.

If HS.Entity.NumDescendant("France") = 0 Then
  ...
End If
If HS.Custom("Product").NumDescendant("P3000-Phones") = 0 Then
...
End If