Guia do Usuário do Cliente Web Spotfire®

NavigatePeriod()

Alguns métodos de navegação por nós são especialmente adequados para hierarquias que contêm dados periódicos, principalmente hierarquias de tempo. O tempo é estruturado hierarquicamente por natureza (como ano, trimestre, mês), e os períodos são recorrentes. Um desses métodos de navegação é NavigatePeriod(). Esse método permite definir sua própria navegação em uma hierarquia, porque você pode especificar quatro argumentos, ou seja, valores de entrada, que controlam qual eixo referenciar, quantos níveis mover para cima na hierarquia, quantas etapas mover para os lados e quantos níveis descer.

Na verdade, o método NavigatePeriod() pode substituir muitos dos outros métodos de navegação. Consulte Comparando os métodos NavigatePeriod() e Parent().

Além disso, como os nós em uma hierarquia de tempo são óbvios, qualquer nó que perca dados pode ser detectado automaticamente.

O método NavigatePeriod() é exemplificado a seguir.



Este exemplo usa Q3, 2020 como o nó inicial. Suponha que você queira fazer referência a Q3, 2018. Em seguida, você pode definir uma expressão NavigatePeriod() com três argumentos:

NavigatePeriod([Axis.X],"Year",-2)

O primeiro argumento é o eixo em questão, o segundo argumento navega até o nível Year e o terceiro argumento navega lateralmente nesse nível Year, dois passos para trás no tempo porque o valor é negativo. Quando um quarto argumento é omitido, você retorna automaticamente ao mesmo nível do ponto de partida, neste caso, o trimestre correspondente em 2018. Você pode, se desejar, especificar outro nível além do nível folha, adicionando um quarto argumento.
Dica: Ao especificar um nível de hierarquia de interesse, você também pode substituir o nome do nível pelo número de etapas para mover acima ou abaixo. Usar 0 como argumento significa que você permanece no mesmo nível. Na imagem acima, NavigatePeriod([Axis.X],1,-2) teria retornado o mesmo resultado que NavigatePeriod([Axis.X],"Year",- 2).

Exemplo

Nota: Para aplicar as expressões usadas neste tópico, presume-se que dados na memória sejam usados.

O gráfico de barras mostra os números de vendas em janeiro e fevereiro para diferentes tipos de frutas e vegetais, divididos também por sua categoria. Suponha que você queira exibir, expressa em porcentagem, a contribuição mensal de cada tipo para as vendas.



O método Parent() funcionaria bem para retornar a contribuição de um tipo dentro das categorias de frutas e vegetais respectivamente, ou seja, um nível acima na hierarquia, mas não funcionaria tão facilmente subindo duas etapas!

Nesse caso, o método NavigatePeriod() é uma boa escolha. Consulte a expressão no eixo de valor abaixo:



  • O primeiro argumento, [Axis.X], refere-se ao eixo da hierarquia, neste caso, o eixo de Categoria. Observe que o eixo de Categoria é sempre referido como Axis.X, não importa se a orientação do gráfico de barras é horizontal ou vertical.
  • O segundo argumento, "Month", navega até o nível Month, ou seja, duas etapas acima na hierarquia. "Month" também pode ser substituído por 2 na expressão.
  • O terceiro argumento, 0, especifica que nenhuma navegação ocorre lateralmente na hierarquia.
  • O quarto argumento, outro 0, mantém o nível Month.
Por exemplo, 27% das vendas totais em janeiro são vendas de bananas (88/(38+88+64+28+66+40)).
Nota: As percentagens estão arredondadas.