Função

Vincular os componentes visuais (mobile ou web) e obtém através de uma consulta personalizada de banco de dados, OData ou bloco de programação. A fonte de dados também permite adicionar filtros, permissões de acesso, adicionar novos campos, tratamento de erros e outras funcionalidades.

Como usar

O ícone da fonte de dados deve estar sempre acima do(s) componente(s) visual(is) no(s) qual(is) ele está associado na tela de edição da view, podendo cada fonte de dados estar logo acima do componente (exemplo Imagem abaixo) ou todos juntos no inicio da view. Na Figura 1 temos componente Caixa de seleção múltipla (2) e o ícone da Fonte de dados (1) que alimenta a lista da caixa de seleção.

O ícone de fonte de dados só é exibido no momento de edição da view, por isso caso não queira visualizar esses ícones no momento da edição, basta clicar no botão Exibir elementos não visuais (3) para ocultar ou exibir.

Figura 1.1 - Ícone fonte de dados (1) na tela de edição da view

Nem sempre é necessário arrastar o componente Fonte de dados para a janela de edição da view, ao definir uma fonte de dado nas propriedades Origem dos Dados ou Configuração de algum outro componente, o ícone é criado automaticamente acima do componente editado na janela de edição da view.

Principais propriedades e eventos 

Filtros e Parâmetros

Com o Filtros e Parâmetros é possível adicionar grupos de regras e agrupá-los com outros grupos, usando conectivos lógicos (e / ou). Regras podem ser criadas a partir de expressões, campos da tela, conteúdo estático ou blocos de programações.

Figura 2.1 - Janela de Filtros e Parâmetros

1. Grupo: define o condicional entre suas regras e outros grupos; 
2. Campo de seleção de condicional (e / ou) do grupo;
3. Adicionar nova regra a esse grupo;
4. Adicionar novo grupo filho;
5. Excluir grupo (não é possível excluir o primeiro grupo da hierarquia);
6. Regra: define um elemento de comparação entre um atributo da fonte de dado e outro elemento;
7. Selecionar o atributo da fonte de dados;
8. Selecionar o operador de comparação (=; ≠; <; >; <= ou >=);
9. Selecionar o tipo do que será comparado: expressão, booleano, String e outros;
10. Campo para informar o que será comparado: expressões, data, String, bloco de programação ou outros;
11. 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 10;
12. Excluir regra;

Figura 2.2 - Exemplo de uso da propriedade Filtros e Parâmetros

No exemplo da Figura 2.2, a sintaxe de comparação ficaria da seguinte forma:

(email = 'pedro.porto@email.com') AND ((name = cronapi.client('js.blockly.BlocoCliente.Funcao').attr().run()) OR (login = 'pedro.porto'))

A expressão cronapi.client('js.blockly.BlocoCliente.Funcao').attr().run() se trata do retorno de uma função de bloco de programação, ao selecionar essa função no botão (11) da Figura 2.1, o sistema preenche o endereço e a chamada da função.

Ordenação

A ordenação ocorre selecionando um ou mais campos da fonte de dados e definindo a ordem (acedente ou descendente).

Figura 2.3 - Ordenação do campo 'name' em ordem crescente.

1. Adiciona uma nova ordenação;
2. Seleciona o campo da fonte de dados que será o ordenador;
3. Define se a ordenação será ASCendente ou DESCendente.

Mestre Detalhe

A propriedade Mestre detalhe gera uma ligação entre um ou mais parâmetros da fonte de dados com outra fonte, como: expressões, campos na tela ou bloco de programação. Isso força que ao salvar um dado da fonte pai, o dado correspondente da fonte filho é salvo também.(isso ta certo ????)

Figura 2.4 - Ligação entre o atributo id da fonte de dados e o id de outra fonte de dados da view

1. Adiciona uma nova ligação;
2. Seleciona o atributo da fonte de dados principal;
3. operador de comparação igual (único possível);
4. Selecionar o tipo do que será comparado: expressão, booleano, String e outros;
5. Atributo da fonte filho, que pode ser: expressões, bloco de programação, campo da tela ou outros;
6. Abre uma nova janela para informar uma expressão, selecionar um bloco de programação ou um campo na tela. A seleção será exibida no campo (5);
7. Excluir a ligação.

Origem dos Dados

A propriedade Origem dos Dados seleciona uma fonte de dados editável ou um OData de uma entidade do sistema. Edições só são possíveis em fonte de dados, OData não são editáveis.

É possível criar uma nova fonte de dados através do botão Nova fonte de dados ou através do menu do sistema, ver em Criar ou editar consultas de Fonte de dados.

Figura 2.5 - Seleção de uma fonte de dados ou entidade

1. Cria uma nova Fonte de Dados;
2. Nomes das fontes de dados ou entidades;
3. Tipo da fonte de dados;
4. Abre janela de edição para os tipos Fonte de dados.

Criar ou editar consultas de Fonte de dados

Existem duas formas de criar uma nova fonte de dados ou editar uma já existente: através da propriedade Origem dos dados de algum componente que utiliza fontes de dados ou pelo menu do sistema, acessando Projeto > Fonte de dados (Figura 3.1).

 
Figura 3.1 - Acesso as fontes de dados pelo menu do sistema

Edição da Fonte de dados

É possível editar uma série de parâmetros, personalizando bastante a consulta.

Figura 3.2 - Janela de edição da fonte de dados

1. Identificador: identificador da fonte de dados no sistema. Essa consulta da fonte de dados ficará armazenada no arquivo customQuery.json (localizado em Código Fonte / Principal / Código Fonte Servidor / META-INF / ) utilizando esse identificador;
2. Nome da consulta: nome que identifica a consulta para o programador no momento da seleção das fontes de dados;
3. Tipo da fonte: define se a fonte de dados estará vinculada a uma Entidade ou Bloco de programação;
4. Origem da fonte: seleção de um bloco de programação ou entidade OData;
   • campo: exibe a entidade ou bloco de programação selecionado;
   • "…": abre janela de seleção de entidade ou bloco de programação;
   • Novo Bloco de programação: Abre uma janela para a criação de bloco de programação;
   • Excluir: limpa a seleção do bloco de programação ou entidade;
5. Entidade base: Esse campo só é ativo para fontes do tipo Bloco de programação, e ;
6. Aba Filtro: define consultas JPQL e define os parâmetros das consultas ou blocos de programação;
7. Aba Permissões: define permissões e executa métodos dos verbos HTTP;
8. Aba Eventos: chama ações em diversos momentos da execução da fonte de dados;
9. 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;
10. 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 para esse campo;
11. 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. Em fontes do tipo entidade é possível filtrar por consultas JPQL (1), essa opção fica desabilitada para blocos de programação que apenas exibirá o nome dos parâmetros do bloco.

No exemplo da Figura 3.3, a fonte de dados retornará todos os usuários que possuem e-mails de um servidor específico selecionado pelo usuário através do retorno da função de bloco de programação ObterValorDropdownEmail.

Figura 3.3 - Exemplo de filtro para uma 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 parâmetros do Bloco de programação;
4. Valor do Parâmetro selecionado através da inserção de uma String ou retorno de um bloco de programação, por exemplo a obtenção do conteúdo de um campo na tela;
5. Seleção de um bloco de programação já criado;
6. Criação de um novo bloco de programação;
7. Limpar o campo Valor do parâmetro (4).

Permissões

Em permissões é possível definir algum método para executar no lugar dos verbo HTML padrões (get, post, put, delete) da entidade base. Na Figura 3.4 será executado a função Metodo2 no lugar do get da Entidade base User.

Fontes do tipo Entidade não podem selecionar uma função de bloco para realizar esse tratamento, apenas definir permissões para os grupos.

Figura 3.4 - Aba Permissões configurada para chamar um evento na ação get

1. Permissão do verbo: Ativa ou desativa cada um dos verbos ou CRUD e o filtro;
2. Método do bloco a utilizar: Seleciona um método do bloco de programação que será executado no momento de execução de um dos verbos. Disponível apenas para fonte de dados do tipo bloco de programação;
3. Permissão: Define os grupos de acesso com permissões a executar esses verbos.