VIEW de SQL

1. Geral

No Mitra, a VIEW de SQL é uma das três maneiras de carregar dados para os seus componentes. Essa funcionalidade permite que você crie uma consulta diretamente em SQL, utilizando as tabelas do seu database, e a query resultante vai alimentar os componentes configurados.

2. Configurando a VIEW de SQL

Para configurar uma VIEW de SQL, siga os passos abaixo:

2.1. Área de Query

É o espaço onde você vai escrever a sua consulta SQL. À medida que você monta a query, você pode utilizar o dicionário de dados à direita da tela para visualizar todas as tabelas e colunas disponíveis, equivalentes às entidades que você criou no database.

2.2. Suporte de Filtros e Variáveis de Input

A VIEW de SQL permite interação com os filtros e inputs que o usuário adiciona na interface. Essa funcionalidade possibilita uma experiência dinâmica de filtragem e busca, respeitando as interações dos usuários.

2.2.1. Variáveis de Filtro

Todo filtro configurado na tela pode ser acessado dentro da query SQL como uma variável. Esses filtros podem ser utilizados para que sua consulta seja filtrada de acordo com a seleção do usuário. O formato das variáveis de filtro é :ID_NOMEDOCADASTRO.

Exemplo prático:

Suponha que você queira que uma tabela filtre os dados de executivos selecionados pelo usuário, por um seletor. Se o usuário selecionar um executivo, sua query pode ser montada usando a variável de filtro :ID_EXECUTIVO, para filtrar os dados desse executivo em específico.

SELECT ID, DESCR, EMAIL FROM CAD_1003
WHERE ID = :

Essa query retornaria apenas os dados do executivo que foi selecionado no seletor da interface, permitindo uma interação direta e flexível entre o usuário e os dados.

2.2.2. Variáveis de Input

Da mesma maneira, você pode interagir com inputs adicionados à interface. Os valores inseridos pelos usuários podem ser aproveitados nas suas queries e em outras ações relacionadas ao banco de dados. O formato da variável de input é :INPUT_ID. Veja a documentação do componente "Input" para entender melhor como ele é configurado.

Exemplo prático:

Vamos supor que você deseja permitir que o usuário busque por nome de vendedor em uma lista. Ao adicionar um componente de input para o usuário digitar o nome do vendedor, esse valor pode ser usado na query SQL, aplicando a variável do input :INPUT_2737, da seguinte forma:

SELECT * FROM CAD_VENDEDOR
WHERE DESCR LIKE '%' :INPUT_2737 '%'

Aqui, o :INPUT_2737 é o ID do componente de input, e a query irá filtrar os resultados pelo nome inserido pelo usuário. No caso, se o usuário digitar "Maria", a query retornará todos os registros cujo nome contém "Maria".

2.3. Mapeamento de Colunas

Após executar sua query, você terá a opção de marcar colunas específicas para se relacionarem com cadastros. Por exemplo, se sua consulta retorna dados de executivos, você pode marcar a coluna de ID do executivo para que o Mitra entenda que essa coluna corresponde a um cadastro de vendedor. Isso facilita futuras interações, como formulários de edição ou modais de detalhes, já que o sistema saberá qual filtro aplicar com base nessa marcação.

Com essas etapas, a sua VIEW de SQL estará configurada e pronta para popular os componentes desejados.