Parâmetros da pasta de trabalho

Usando parâmetros, você pode coletar entradas de consumidores e fazer referência a elas em outras partes de uma pasta de trabalho. Geralmente é usado para definir o escopo do conjunto de resultados ou definir o visual certo. Você pode criar relatórios e experiências interativos usando esse recurso principal.

Ao usar pastas de trabalho, você pode controlar como seus controles de parâmetro são apresentados aos consumidores. Eles podem ser caixa de texto versus lista suspensa, seleção única versus múltipla e valores de texto, JSON, KQL ou Azure Resource Graph.

Os tipos de parâmetros suportados incluem:

• Tempo: Permite selecionar a partir de intervalos de tempo pré-preenchidos ou selecionar um intervalo personalizado
• Lista suspensa: Permite selecionar a partir de um valor ou conjunto de valores
• Grupo Opções: Permite selecionar um valor de um conjunto conhecido
• Texto: Permite inserir texto arbitrário
• Critérios: Permite definir um conjunto de critérios com base em parâmetros previamente especificados, que serão avaliados para fornecer um valor dinâmico
• Recurso: permite selecionar um ou mais recursos do Azure
• Subscrição: permite-lhe selecionar um ou mais recursos de subscrição do Azure
• Vários valores: Permite definir um ou mais valores de texto arbitrários
• Tipo de recurso: permite selecionar um ou mais valores de tipo de recurso do Azure
• Localização: permite selecionar um ou mais valores de localização do Azure

Referenciar um parâmetro

Você pode fazer referência a valores de parâmetros de outras partes de pastas de trabalho usando associações ou expansões de valor.

Referenciar um parâmetro com ligações

Este exemplo mostra como fazer referência a um parâmetro de intervalo de tempo com associações:

1. Selecione Adicionar consulta para adicionar um controle de consulta e, em seguida, selecione um recurso do Application Insights.

2. Abra a lista suspensa Intervalo de tempo e selecione a opção Intervalo de tempo na seção Parâmetros na parte inferior:

   • Esta opção vincula o parâmetro de intervalo de tempo ao intervalo de tempo do gráfico.
   • O escopo de tempo da consulta de exemplo agora é Últimas 24 horas.

3. Execute a consulta para ver os resultados.

   

Referenciar um parâmetro com KQL

Este exemplo mostra como fazer referência a um parâmetro de intervalo de tempo com KQL:

1. Selecione Adicionar consulta para adicionar um controle de consulta e, em seguida, selecione um recurso do Application Insights.

2. No KQL, insira um filtro de escopo de tempo usando o parâmetro | where timestamp {TimeRange}:

   • Este parâmetro expande o tempo de avaliação da consulta para | where timestamp > ago(1d).
   • Esta opção é o valor do intervalo de tempo do parâmetro.

3. Execute a consulta para ver os resultados.

   

Referenciar um parâmetro com texto

Este exemplo mostra como fazer referência a um parâmetro de intervalo de tempo com texto:

1. Adicione um controle de texto à pasta de trabalho.
2. No Markdown, insira The chosen time range is {TimeRange:label}.
3. Selecione Edição Concluída.
4. O controle de texto mostra o texto O intervalo de tempo escolhido é Últimas 24 horas.

Opções de formatação de parâmetros

Cada tipo de parâmetro tem suas próprias opções de formatação. Use a seção Visualizações do painel Editar parâmetro para ver as opções de expansão de formatação para seu parâmetro.

Você pode usar essas opções para formatar todos os tipos de parâmetros, exceto para o seletor de intervalo de tempo. Para obter exemplos de tempos de formatação, consulte Opções de parâmetros de tempo.

Outros tipos de parâmetros incluem:

• Seletor de recursos: as IDs de recursos são formatadas.
• Seletor de assinatura: os valores da assinatura são formatados.

Converter toml para json

Sintaxe: {param:tomltojson}

Valor original:

name = "Sam Green"

[address]
state = "New York"
country = "USA"

Valor formatado:

{
  "name": "Sam Green",
  "address": {
    "state": "New York",
    "country": "USA"
  }
}

Escape JSON

Sintaxe: {param:escapejson}

Valor original:

{
	"name": "Sam Green",
	"address": {
		"state": "New York",
		"country": "USA"
  }
}

Valor formatado:

{\r\n\t\"name\": \"Sam Green\",\r\n\t\"address\": {\r\n\t\t\"state\": \"New York\",\r\n\t\t\"country\": \"USA\"\r\n  }\r\n}

Codificar texto para base64

Sintaxe: {param:base64}

Valor original:

Sample text to test base64 encoding

Valor formatado:

U2FtcGxlIHRleHQgdG8gdGVzdCBiYXNlNjQgZW5jb2Rpbmc=

Formatar parâmetros usando JSONPath

Para parâmetros de cadeia de caracteres que são conteúdo JSON, você pode usar JSONPath na cadeia de caracteres de formato de parâmetro.

Por exemplo, você pode ter um parâmetro de cadeia de caracteres chamado selection que foi o resultado de uma consulta ou seleção em uma visualização que tem o seguinte valor:

{ "series":"Failures", "x": 5, "y": 10 }

Usando JSONPath, você pode obter valores individuais desse objeto:

Formato	Result
{selection:$.series}	Failures
{selection:$.x}	5
{selection:$.y}	10

Nota

Se o valor do parâmetro não for JSON válido, o resultado do formato será um valor vazio.

Estilo do parâmetro

Os seguintes estilos estão disponíveis para os parâmetros.

Pílulas

O estilo Pills é o estilo padrão. Os parâmetros se parecem com texto e exigem que o usuário os selecione uma vez para entrar no modo de edição.

Standard

No estilo padrão, os controles são sempre visíveis, com uma etiqueta acima do controle.

Formulário horizontal

No estilo horizontal do formulário, os controles são sempre visíveis, com o rótulo no lado esquerdo do controle.

Formulário vertical

No estilo vertical do formulário, os controles são sempre visíveis, com o rótulo acima do controle. Ao contrário do estilo padrão, há apenas um rótulo ou controle em uma linha.

Nota

Nos layouts padrão, horizontal e vertical do formulário, não há conceito de edição embutida. Os controles estão sempre no modo de edição.

Parâmetros globais

Agora que você aprendeu como os parâmetros funcionam e as limitações sobre só poder usar um parâmetro "a jusante" de onde ele está definido, é hora de aprender sobre parâmetros globais, que alteram essas regras.

Com um parâmetro global, o parâmetro ainda deve ser declarado antes de poder ser usado. Mas qualquer etapa que defina um valor para esse parâmetro afetará todas as instâncias desse parâmetro na pasta de trabalho.

Nota

Como a alteração de um parâmetro global tem esse comportamento de "atualizar tudo", a configuração global só deve ser ativada para parâmetros que exijam esse comportamento. Uma combinação de parâmetros globais que dependem uns dos outros pode criar um ciclo ou oscilação onde os globais concorrentes mudam uns aos outros repetidamente. Para evitar ciclos, não é possível "resgatar" um parâmetro que tenha sido declarado como global. Quaisquer declarações subsequentes de um parâmetro com o mesmo nome criarão um parâmetro somente leitura que não pode ser editado nesse local.

Usos comuns de parâmetros globais:

1. Sincronize intervalos de tempo entre muitos gráficos:

   • Sem um parâmetro global, qualquer pincel de intervalo de tempo em um gráfico só será exportado depois desse gráfico. Assim, selecionar um intervalo de tempo no terceiro gráfico atualizará apenas o quarto gráfico.
   • Com um parâmetro global, você pode criar um parâmetro timeRange global, dar-lhe um valor padrão e fazer com que todos os outros gráficos usem isso como seu intervalo de tempo acoplado e saída de pincel de tempo. Além disso, defina a configuração Somente exportar o parâmetro quando um intervalo for escovado . Qualquer alteração de intervalo de tempo em qualquer gráfico atualiza o parâmetro global timeRange na parte superior da pasta de trabalho. Essa funcionalidade pode ser usada para fazer com que uma pasta de trabalho aja como um painel.

2. Permita alterar a guia selecionada em uma etapa de links por meio de links ou botões:

   • Sem um parâmetro global, a etapa de links gera apenas um parâmetro para a guia selecionada.
   • Com um parâmetro global, você pode criar um parâmetro selectedTab global. Em seguida, você pode usar esse nome de parâmetro nas seleções de guias na etapa de links. Você pode passar esse valor de parâmetro para a pasta de trabalho a partir de um link ou usando outro botão ou link para alterar a guia selecionada. Usar botões de uma etapa de links dessa maneira pode criar uma experiência semelhante a um assistente, onde botões na parte inferior de uma etapa podem afetar as seções visíveis acima dela.

Criar um parâmetro global

Ao criar o parâmetro em uma etapa de parâmetros, use a opção Tratar este parâmetro como uma opção global em Configurações avançadas. A única maneira de fazer um parâmetro global é declará-lo com uma etapa de parâmetros. Os outros métodos de criação de parâmetros, através de seleções, pinceladas, links, botões e guias, só podem atualizar um parâmetro global. Eles não podem declarar um.

O parâmetro estará disponível e funcionará como os parâmetros normais.

Atualizar o valor de um parâmetro global existente

Para o exemplo de gráfico, a maneira mais comum de atualizar um parâmetro global é usando a escovação de tempo.

Neste exemplo, o parâmetro timerange é declarado como global. Em uma etapa de consulta abaixo disso, crie e execute uma consulta que usa esse parâmetro de intervalo de tempo na consulta e retorna um resultado de gráfico de tempo. Em Configurações avançadas para a etapa de consulta, habilite a configuração de escovação do intervalo de tempo. Use o mesmo nome de parâmetro que a saída para o parâmetro time brush. Além disso, selecione a opção Exportar o parâmetro somente quando um intervalo for escovado .

Sempre que um intervalo de tempo é pincelado neste gráfico, ele também atualiza o parâmetro de intervalo de tempo acima dessa consulta e a etapa de consulta em si, porque também depende do intervalo de tempo.

1. Antes da escovação:

   • O intervalo de tempo é mostrado como Última hora.
   • O gráfico mostra a última hora de dados.

   

2. Durante a escovação:

   • O intervalo de tempo ainda é a última hora, e os contornos de escovação são desenhados.
   • Nenhum parâmetro foi alterado. Depois de soltar o pincel, o intervalo de tempo é atualizado.

   

3. Após a escovação:

   • O intervalo de tempo especificado pelo pincel de tempo é definido por esta etapa. Sobrepõe-se ao valor global. A lista suspensa de intervalo de tempo agora exibe esse intervalo de tempo personalizado.
   • Como o valor global na parte superior foi alterado e como esse gráfico depende do intervalo de tempo como entrada, o intervalo de tempo da consulta usada no gráfico também é atualizado. Como resultado, a consulta e o gráfico serão atualizados.
   • Quaisquer outras etapas na pasta de trabalho que dependam do intervalo de tempo também serão atualizadas.

   

   Nota

   Se você não usar um parâmetro global, o valor do parâmetro de intervalo de tempo só será alterado abaixo desta etapa de consulta. As coisas acima desta etapa ou deste item em si não serão atualizadas.