Criando parâmetros para seus painéis

Crie parâmetros que podem ser usados em todos os seus widgets com uma origem de dados da API AQL ou Genérica, como Time Period e Time Value Usar parâmetros comuns e valores padrão pode reduzir o tempo que leva para criar ou editar consultas individuais para seus widgets.

Antes de iniciar

Os parâmetros aparecem entre chaves, como no seguinte exemplo AQL:
Curly braces em uma instrução AQL

Como as chaves também são usadas em uma instrução AQL dentro de uma sequência de caracteres entre aspas (uma sequência literal entre aspas), use uma barra invertida (\) como caractere de escape antes da chave de abertura em uma sequência entre aspas. Esta sintaxe assegura que a sequência de caracteres entre aspas não seja interpretada como um parâmetro e cause resultados de consulta incorretos. Se você tiver uma barra invertida em uma sequência de caracteres entre aspas, inclua uma barra invertida adicional como o caractere de escape.

Procedimento

  1. Em um painel que contém widgets baseados em AQL ou em API genérica, como o painel Eventos e métricas de fluxo , clique no menu do painel (Mais opções > Gerenciar parâmetros).
    A janela Gerenciar Valores de Parâmetro exibe os parâmetros que já foram criados em sua área de trabalho Se qualquer um dos parâmetros tiver valores padrão, eles serão listados na coluna Valor padrão .. A coluna Número de ocorrências indica o número de widgets que usam cada parâmetro. Passe o mouse sobre o número para ver quais widgets usam o parâmetro.
  2. Para configurar um valor padrão para um parâmetro, clique no ícone Mais opções , insira o valor padrão no campo e, em seguida, clique em Salvar.
    Notas:
    • Esta ação configura o valor padrão para cada widget que usa o parâmetro e o cartão Parâmetros atualiza-se automaticamente. Como alternativa, é possível incluir um valor para o parâmetro em widgets específicos.
    • Ao mudar o valor padrão de um parâmetro, ele é mudado em todos os lugares nos quais o parâmetro é usado em sua área de trabalho, exceto em painéis e widgets expandidos ou fixados. Se você não configurar o valor como padrão, a mudança atualizada se aplicará apenas à sessão atual. No entanto, se você configurar o valor como padrão, o valor da sessão atual também usará esse valor.
    • O parâmetro SYSTEM:username predefinido retorna o nome do usuário que está conectado. Os parâmetros do sistema são do tipo somente leitura e não é possível mudar o valor padrão.
    • O parâmetro SYSTEM:timerange predefinido representa o valor do seletor de tempo..
  3. Para incluir um parâmetro em sua área de trabalho, clique em Incluir, dê ao parâmetro um nome e valor padrão e, em seguida, clique em Salvar.
  4. Antes de excluir um parâmetro, verifique se ele não pertence a nenhum widget, passando o mouse sobre o número para ver os nomes de widgets que o utilizam. Depois de remover o parâmetro desses widgets, será possível clicar em Excluir.
  5. Clique em Voltar ao Painel para retornar à visualização principal e continuar seu trabalho.