Passar parâmetros de consulta no Allbionyx Designer

Um parâmetro de consulta contém um valor externo que é inserido em uma instrução SQL antes da execução da consulta. Este valor pode ser estático ou gerado dinamicamente por uma expressão associada.

O valor do parâmetro de consulta é inserido na string de consulta SQL resultante na posição do marcador @QueryParameterName .

Nos painéis, os parâmetros de consulta são usados ​​nos seguintes cenários:

• Ao filtrar dados do painel no nível da fonte de dados usando o Query Builder .

• Ao vincular um painel a um procedimento armazenado, uma fonte de dados SQL fornece.

Você pode acessar os parâmetros de consulta usando a propriedade Parameters da consulta que o componente SqlDataSource do painel expõe. Esses parâmetros incluem aqueles que você criou no Query Builder ou que foram gerados para o procedimento armazenado da fonte de dados.

• Configurar parâmetros de consulta
• Forneça o valor do parâmetro de consulta
• Passe um valor de parâmetro de vários valores para uma consulta
• Passe um valor de parâmetro de painel de vários valores para um procedimento armazenado

Configurar parâmetros de consulta

A caixa de diálogo Editor de consultas contém as configurações dos parâmetros de consulta adicionados.

As seguintes propriedades estão disponíveis para cada parâmetro de consulta:

Use os botões Adicionar / Remover para adicionar ou remover parâmetros de consulta.

Clique no botão Visualizar… se precisar visualizar o resultado da consulta. Clique em Concluir para concluir a modificação da consulta.

Forneça o valor do parâmetro de consulta

Abaixo, você pode ver como especificar um valor para um parâmetro de consulta.

Especifique um valor estático

Escolha o tipo de valor de um parâmetro de consulta e defina um valor estático na propriedade Value de acordo com o tipo selecionado.

Defina um valor dinâmico

Ative a caixa de seleção Expressão para um parâmetro.

As seguintes opções são usadas para calcular o valor real do parâmetro dinamicamente:

• Crie uma expressão complexa expandindo a lista suspensa da propriedade Value e selecionando Editor de Expressão .

  

  Construa uma expressão no Editor de Expressão invocado .

  

• Mapeie um novo parâmetro de painel para um parâmetro de consulta expandindo a lista suspensa da propriedade Value e selecionando Adicionar parâmetro de painel .

  

  Especifique as configurações de parâmetro do painel na caixa de diálogo Parâmetro do painel chamada . Especifique o tipo de parâmetro do painel de acordo com o tipo do parâmetro de consulta correspondente. Clique em OK para sair da caixa de diálogo.

  

• Mapeie um parâmetro de painel que já existe em um painel para um parâmetro de consulta expandindo a lista suspensa da propriedade Value e selecionando o parâmetro que deseja usar. Uma string de expressão apropriada é gerada automaticamente.

  

Passe um valor de parâmetro de vários valores para uma consulta

Você pode mapear parâmetros de vários valores para parâmetros de consulta. Por exemplo, a consulta a seguir seleciona os pedidos cujos IDs podem ser encontrados nos valores que o parâmetro de consulta @OrderID fornece.

Os valores dos parâmetros são 10248 , 10249 e 10250 . A imagem abaixo mostra o resultado da visualização:

Passe um valor de parâmetro de painel de vários valores para um procedimento armazenado

Você não pode passar um valor de parâmetro de vários valores para um procedimento armazenado diretamente. Use a função de expressão Join () no Editor de Expressão para converter a matriz de valores de parâmetro em uma string se você usar os sistemas de banco de dados MS SQL Server, MySQL ou Oracle.

Abaixo estão exemplos de como obter valores de parâmetro da string passada em um procedimento armazenado.