[CV] Fonte de Dados (Nova)

Objetivo

Vincular os componentes visuais (mobile ou web) com o banco de dados, através de uma consulta personalizada, de uma entidade do banco ou bloco de programação. Além disso, é possível adicionar permissões de acesso a determinados usuário, tratamento de erros e outras funcionalidades dos dados.

O componente fonte de dados pode obter seu conteúdo através de uma consulta personalizada (fonte de dados), 

Principais propriedades e eventos 

Propriedades

Detalhamento de algumas propriedades do Bloco de programação

Condição

Filtro de exibe somente os nomes que iniciam com a letra "A".

1. Adiciona uma nova condição;
2. Seleciona o campo da fonte de dados;
3. Seleciona os operadores de comparação;
4. Seleciona o tipo do que será comparado: expressão, booleano, String e outros;
5. Campo para informar o que será comparado: expressões, endereço do bloco de programação ou campo da tela;
6. Abre uma nova janela para informar uma expressão, selecionar um bloco de programação ou um campo na tela que será exibido no campo 5;
7. Exclui comparação.

Ordenação

Ordenação do campo estado em ordem crescente.

1. Adiciona uma nova ordenação;
2. Seleciona o campo que irá ordenar a fonte de dados;
3. Define se a ordenação será Ascendente ou Decrescente.

Parâmetros de Ligação

Parâmetro de Ligação com um bloco de programação.

1. Adiciona um novo Parâmetro de Ligação;
2. Seleciona o campo da fonte de dados;
3. Seleciona os operadores de comparação;
4. Seleciona o tipo do que será comparado: expressão, booleano, String e outros;
5. Campo para informar o que será comparado: expressões, endereço do bloco de programação ou campo da tela;
6. Abre uma nova janela para informar uma expressão, selecionar um bloco de programação ou um campo na tela que será exibido no campo 5;
7. Exclui o Parâmetro de Ligação.

Origem dos Dados

Ao seleciona o campo "Origem dos Dados" é possível selecionar uma fonte de dados pré existente ou uma entidade. É possível criar uma nova fonte de dados ou editar as que já existem.

Seleção de uma fonte de dados ou entidade.

1. Cria uma nova Fonte de Dados;
2. Nomes das fontes de dados e entidades;
3. Tipo da fonte de dados;
4. Seleciona o tipo do que será comparado: expressão, booleano, String e outros;

Nova consulta de Fonte de dados

Existem duas formas de criar uma nova fonte de dados ou editar uma já existente: através do parâmetro "Origem dos dados" componente do componente fonte de dados ou pelo menu do sistema "Projeto" > "Fonte de dados" (imagem abaixo).

 
Acesso as fontes de dados pelo menu do sistema.

Informações da Fonte de dados

Durante a criação ou edição de uma fonte de dados, é possível editar uma série de parâmetros, personalizando bastante a consulta.

Inserção do dados da Fonte de dados e consulta do filtro.

1. Identificador da fonte de dados. Essa consulta ficará armazenada no arquivo customQuery.json (localizado em "Código Fonte / Principal / Código Fonte Servidor / META-INF / ) com esse identificador;
   1. O endereço na Lateral do identificador é uma URI REST, e possui a seguinte sintaxe:
      "<domínio>/api/cronapi/odata/v2/<Identificador>/<parametro1>/.../<parametroN>/";
2. Nome da consulta que será visualizado pelo programador no momento da seleção das fontes de dados;
3. Define se a fonte de dados estará vinculada a uma Entidade ou Bloco de programação;
4. Seleciona o bloco de programação ou entidade de acordo com o item 3;
5. Aba Filtro: Define consultas JPQL e define os parâmetros das consultas ou blocos de programação;
6. Aba Permissões: Define permissões e executa métodos dos verbos HTTP;
7. Aba Eventos: Chama ações em diversos momentos da execução da fonte de dados;
8. Aba Campos: Alterar o valor de cada campo através da execução de um método e dar permissões a grupos aos campos;
9. Aba Campo calculados: Adicionar novos campos ao mapa retornado da fonte de dados, adicionar conteúdo a esse campo através da execução de um método e dar permissões a grupos a esse campo;
10. Aba Tratamento de erros: Adicionar mensagens de erros personalizadas, permite internacionalização das mensagens.

Filtro

Essa aba é responsável alterar os filtros da fonte de dados, quando vinculada a uma entidade, é possível editar a consulta JPQL em modo visual ou textual e definir os parâmetros na consulta ou do bloco de programação vinculado; 

Seleção de uma fonte de dados ou entidade.

1. Área de visualização da consulta JPQL (Só habilitado quando a fonte está vinculado a uma entidade);
2. Editar consulta JPQL em modo visual ou em modo texto (Só habilitado quando a fonte está vinculado a uma entidade);
3. Parâmetros da consulta JPQL ou do Bloco de programação. ************* SABER SE VAI EXISTIR AINDA

Permissões (SÒ FUNCIONA COM BLOCO DE PROGRAMAÇÂO???)

Permite a execução de um método no momento da execução de algum item de CRUD e Filtro, essa execução pode ser destinada a grupos de acessos específicos.

Seleção de uma fonte de dados ou entidade.

1. Ativa ou desativa cada um dos verbos;
2. Seleciona um método do bloco de programação;
3. Define os grupos de acesso com permissões a executar esses verbos.