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
| Nome | Propriedade | Função |
|---|---|---|
| Condição | condition | Cria filtros para para a fonte de dados. É possível usar expressões, campos da tela e blocos de programações. |
| Depende de | dependent-by | Vincula a fonte de dados com outras fontes de dados. Ao usar algumas propriedades (ex: Link Parameters), esse campo é preenchido automaticamente. |
| Nome | name | Nome da fonte de dados. |
| Postergar Carga | lazy | Só alimenta a fonte de dados após uma ação do usuário. |
| Parâmetros de Ligação | parameters | Vincula duas ou mais fontes de dados que possuam algum parâmetro de ligação. Essa propriedade força que ao salvar um dado da fonte pai, o dado correspondente da fonte filha é salvo junto. |
| Origem dos Dados | entity | Define a origem dos dados: Entidade ou consulta personalizada. |
| Ordenação | order-by | Seleciona campos para serem ordenados (acedente ou descendente). |
Dependente de salvamento | dependent-lazy-post | Aguarda a seleção da fonte de dados selecionada para realizar a ação dessa fonte de dados. |
| Linhas por página | rows-per-page | Retorna a quantidade de dados informada. |
Validar Campos Requeridos | checkrequired | Só insere ou atualiza os dados se todos os campos marcados como requeridos estiverem preenchidos. |
Atenção:
O ícone da fonte de dados deve está sempre acima do(s) componente(s) visual(is) no qual(is) ele está associado na tela de edição da view, podendo cada fonte de dados estar logo acima do componente (Imagem abaixo) ou todos juntos no inicio da view.
Fonte de dados "CidadesCombo" logo acima do comboBox "Cidades".
Propriedades
Detalhamento de algumas propriedades do Bloco de programação
Condição
Filtro de exibe somente os nomes que iniciam com a letra "A".
- Adiciona uma nova condição;
- Seleciona o campo da fonte de dados;
- Seleciona os operadores de comparação;
- Seleciona o tipo do que será comparado: expressão, booleano, String e outros;
- Campo para informar o que será comparado: expressões, endereço do bloco de programação ou campo da tela;
- 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;
- Exclui comparação.
Ordenação
Ordenação do campo estado em ordem crescente.
- Adiciona uma nova ordenação;
- Seleciona o campo que irá ordenar a fonte de dados;
- 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.
- Adiciona um novo Parâmetro de Ligação;
- Seleciona o campo da fonte de dados;
- Seleciona os operadores de comparação;
- Seleciona o tipo do que será comparado: expressão, booleano, String e outros;
- Campo para informar o que será comparado: expressões, endereço do bloco de programação ou campo da tela;
- 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;
- 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.
- Cria uma nova Fonte de Dados;
- Nomes das fontes de dados e entidades;
- Tipo da fonte de dados;
- 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 e Filtro
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.
- 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;
- Nome da consulta que será visualizado pelo programador no memento da seleção;
- Define se a fonte principal será uma Entidade ou Bloco de programação;
- Seleciona o bloco de programação ou entidade de acordo com o item 3;
- Aba Filtro: exibe a consulta JPQL criada pelo Assistente de consulta visual (Ficará habilitado somente quando selecionado Entidade);
- Aba Filtro: Acessa o Assistente de consulta visual do JPQL (Ficará habilitado somente quando selecionado Entidade);
- Aba Filtro: Exibe os parâmetros do bloco de programação ou da consulta JPQL;
- Aba Permissões;
Botão do componente | Imagem no Editor visual |
|---|---|
|