Partilhar via

Critérios de parâmetros de texto

  • Artigo

Quando uma consulta depende de muitos parâmetros, a consulta será paralisada até que cada um de seus parâmetros tenha sido resolvido. Às vezes, um parâmetro pode ter uma consulta simples que concatena uma cadeia de caracteres ou executa uma avaliação condicional. Essas consultas ainda fazem chamadas de rede para serviços que executam essas operações básicas, e esse processo aumenta o tempo necessário para um parâmetro resolver um valor. O resultado são longos tempos de carregamento para pastas de trabalho complexas.

Ao usar parâmetros de critério, você pode definir um conjunto de critérios com base em parâmetros especificados anteriormente que serão avaliados para fornecer um valor dinâmico. O principal benefício do uso de parâmetros de critérios é que os parâmetros de critérios podem resolver valores de parâmetros previamente especificados e executar operações condicionais simples sem fazer chamadas de rede. O exemplo a seguir é um caso de uso criteria-parameters.

Exemplo

Considere a seguinte consulta condicional:

Captura de ecrã que mostra a consulta condicional. 

let metric = dynamic({Counter});
print tostring((metric.object == 'Network Adapter' and (metric.counter == 'Bytes Received/sec' or metric.counter == 'Bytes Sent/sec')) or (metric.object == 'Network' and (metric.counter == 'Total Bytes Received' or metric.counter == 'Total Bytes Transmitted')))

Se você estiver focado metric.counter no objeto, o valor do parâmetro isNetworkCounter deverá ser true se o parâmetro Counter tiver Bytes Received/sec, Bytes Sent/sec, Total Bytes Received, ou Total Bytes Transmitted.

Isso pode ser traduzido para um parâmetro de texto de critério:

Captura de tela que mostra o exemplo de critério.

Na captura de tela anterior, as condições serão avaliadas de cima para baixo e o valor do parâmetro isNetworkCounter levará o valor de qualquer condição avaliada para verdadeiro primeiro. Todas as condições, exceto a condição padrão (a condição "else") podem ser reordenadas para obter o resultado desejado.

Configurar critérios

  1. Comece com uma pasta de trabalho com pelo menos um parâmetro existente no modo de edição.

    1. Selecione Adicionar parâmetros>Adicionar parâmetro.
    2. No novo painel de parâmetros que se abre, introduza:
      • Nome do parâmetro: rand
      • Tipo de parâmetro: Text
      • Obrigatório: checked
      • Obter dados de: Query
      • Entre print rand(0-1) no editor de consultas. Este parâmetro produzirá um valor entre 0-1.
    3. Selecione Salvar para criar o parâmetro.

    Nota

    O primeiro parâmetro na pasta de trabalho não mostrará a guia Critérios .

    Captura de tela que mostra o primeiro parâmetro.

  2. Na tabela com o rand parâmetro, selecione Adicionar parâmetro.

  3. No novo painel de parâmetros que se abre, introduza:

    • Nome do parâmetro: randCriteria
    • Tipo de parâmetro: Text
    • Obrigatório: checked
    • Obter dados de: Criteria

  4. É apresentada uma grelha. Selecione Editar ao lado da caixa de texto em branco para abrir o formulário Configurações de critério. Para obter uma descrição de cada campo, consulte o formulário Configurações de critério.

    Captura de tela que mostra o formulário Configurações de critério.

  5. Insira os seguintes dados para preencher os primeiros critérios e selecione OK:

    • Primeiro operando: rand
    • Operador: >
    • Valor de: Static Value
    • Segundo operando: 0.25
    • Valor de: Static Value
    • O resultado é: is over 0.25

    Captura de tela que mostra o formulário Configurações de critérios preenchido.

  6. Selecione Editar ao lado da condição Click edit to specify a result for the default condition para editar a condição padrão.

    Nota

    Para a condição padrão, tudo deve ser desativado, exceto o último Value from e Result is os campos.

  7. Insira os seguintes dados para preencher a condição padrão e selecione OK:

    • Valor de: Valor estático
    • O resultado é: é igual ou inferior a 0,25

    Captura de tela que mostra o formulário padrão Configurações de critérios preenchido.

  8. Salve o parâmetro.

  9. Atualize a pasta de trabalho para ver o randCriteria parâmetro em ação. O seu valor basear-se-á no valor de rand.

Formulário Configurações de critérios

Campos de formulário Description
First operand Esta lista suspensa consiste em nomes de parâmetros que já foram criados. O valor do parâmetro será usado no lado esquerdo da comparação.
Operador O operador costumava comparar o primeiro e o segundo operandos. Pode ser uma avaliação numérica ou de cordas. O operador is empty desativará o Second operand porque apenas o First operand é necessário.
Valor de Se definido como Parameter, será exibida uma lista suspensa que consiste em parâmetros que já foram criados. O valor desse parâmetro será utilizado no lado direito da comparação.
Se definido como Static Value, será exibida uma caixa de texto onde você pode inserir um valor para o lado direito da comparação.
Second operand Será um menu suspenso que consiste em parâmetros criados ou uma caixa de texto, dependendo da seleção anterior Value from .
Valor de Se definido como Parameter, será exibida uma lista suspensa que consiste em parâmetros que já foram criados. O valor desse parâmetro será usado para o valor de retorno do parâmetro atual.
Se definido como Static Value:
- Aparece uma caixa de texto onde você pode inserir um valor para o resultado.
- Você também pode cancelar a referência de outros parâmetros usando chaves ao redor do nome do parâmetro.
- É possível concatenar vários parâmetros e criar uma string personalizada, por exemplo, "{paramA}, {paramB}e alguma string."

Se definido como Expression:
- Aparece uma caixa de texto onde você pode inserir uma expressão matemática que será avaliada como resultado.
- Como o caso, vários parâmetros podem ser desreferenciados nesta caixa de Static Value texto.
- Se o valor do parâmetro referenciado na caixa de texto não for um número, será tratado como o valor 0.
O resultado é Será um menu suspenso que consiste em parâmetros criados ou uma caixa de texto, dependendo da seleção anterior Value from . A caixa de texto será avaliada como o resultado final deste formulário Configurações de critérios.