Esta tela permite realizar o mapeamento lógico e a parametrização de uma nova Fonte de Dados (Datasource). É aqui que você define as regras de governança, restrições volumétricas e qual tabela ou visão (View) do banco de dados será exposta para alimentar os relatórios. Para acessar esse tela usamos o caminho: Configurações->Provedores de Dados->Fontes de Dados e selecionamos Adicionar no formulário que lista as fontes de dados.


Fig. 01


Campos de Identificação e Configuração

  • Nome: Identificação amigável e única que define a finalidade da Fonte de Dados no sistema (ex: Invoices II).
  • Descrição: Detalhamento do escopo ou contexto dos dados fornecidos por este registro (ex: List of Invoices).
  • Retorno Máximo de Registros (Global): Define o teto padrão de linhas que uma consulta baseada neste Datasource pode retornar do banco (ex: 10000).
    • Precedência Importante: Este valor atua como uma trava de segurança geral. Caso o operador possua limites específicos configurados através de suas Roles de acesso, este campo poderá ser desconsiderado pelo motor do sistema. Para entender detalhadamente as regras de cálculo e prioridade, consulte o tópico conceitual [Como o Sistema Processa o Limite Máximo de Registros].


Estrutura de Filtros Globais

  • Filtro SQL (Global): Campo de texto para a inserção de uma cláusula SQL bruta (hardcoded) que funcionará como uma barreira de corte fixa e obrigatória para qualquer relatório derivado desta fonte (ex: Country IN ('Brazil', 'France', 'Belgium')).
  • Descreva o filtro para que o usuário saiba quais restrições estão sendo aplicadas: Esta caixa de texto torna-se obrigatória assim que o formulário detecta o preenchimento de um Filtro SQL. Ela deve traduzir em linguagem clara e legível a restrição imposta pelo código técnico, permitindo que o usuário final compreenda a ausência de determinados registros na extração. 
    • Composição de Filtros: O filtro configurado aqui representa a 1ª Camada de isolamento de dados do ecossistema. Para compreender graficamente como ele interage com as regras dinâmicas de segurança das Roles e os critérios do usuário final, consulte o tópico Como o Sistema Processa os Filtros (Regra de Composição SQL).


Origem Física e Mapeamento

  • Conexão com Servidor: Menu de seleção que lista os servidores e credenciais previamente homologados pela equipe de TI.
  • Tabela/View: Exibe a listagem das tabelas e visões físicas disponíveis dentro do catálogo do banco selecionado na conexão acima. Permite apontar exatamente qual objeto será lido pelo motor do sistema (ex: Invoices (dbo)).


Ações do Formulário

  • Botão Salvar: Valida a obrigatoriedade dos campos, verifica o preenchimento da descrição do filtro (se aplicável) e grava a estrutura lógica da Fonte de Dados.
  • Botão Cancelar: Descarta as alterações ou preenchimentos realizados e retorna à tela de listagem principal.