View
A view define uma fonte de dados consultável pela UI/ação, parametrizada e com contrato claro de entrada e saída.
Cabeçalho da view
- name: identificador único e estável da view, usado por ações/componente de tabela para invocação.
- description: rótulo descritivo para documentação e tooltips; pode repetir o name com mais contexto do que retorna a consulta.
query (corpo SQL/DSL)
- Conteúdo: instrução executada pelo mecanismo de dados alvo, podendo incluir agregações, junções e renomeações de campos para padronizar a saída consumida pela interface.
- Joins: estabelecem relações entre conjuntos de dados distintos para compor um resultado coerente; junções internas garantem que apenas registros presentes em todas as origens participem do resultado.
- Filtros com parâmetros: utilizam placeholders nomeados para restringir o conjunto de resultados com base em valores fornecidos em tempo de execução, promovendo reuso e desempenho consistente.
- Aliases: renomeiam campos na projeção para rótulos estáveis e legíveis, facilitando o mapeamento direto para configurações de apresentação na camada de UI.
Parâmetros de entrada
- name: identificador do parâmetro exposto pela view, que deve corresponder exatamente ao nome esperado por quem invoca a consulta.
- dataType: tipo declarado para validação e serialização corretas até o executor de dados, alinhado à forma de comparação na instrução.
- value: valor padrão opcional para testes e pré-visualização; quando a view é chamada por uma ação, esse valor é substituído pelo fornecido no contexto de execução.
Execução e integração
- Mecanismo de dados: a consulta deve ser compatível com a sintaxe e capacidades do executor configurado, respeitando limites de dialeto e funções disponíveis.
- Acoplamento com a UI: componentes de apresentação consomem a view por nome e injetam parâmetros dinamicamente; as colunas exibidas são configuradas com base nos campos retornados e seus aliases.
- Execução manual: a interface de visualização permite disparar a consulta interativamente, aplicando os parâmetros informados para fins de validação e depuração rápida.