Você está vendo a versão antiga da página. Ver a versão atual.

Comparar com o atual Ver Histórico da Página

« Anterior Versão 33 Próxima »

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 

NomePropriedadeFunção
Filtros e Parâmetros

condition

Cria filtros para a fonte de dados.
Depende dedependent-byVincula a fonte de dados principal com outras fontes de dados. Ao usar algumas propriedades (ex: Mestre Detalhe), esse campo é preenchido automaticamente.
NomenameNome do componente fonte de dados na view.
Postergar CargalazySó alimenta a fonte de dados após uma ação do usuário.
Mestre DetalheparametersVincula um ou mais atributos da fontes de dados com outra fonte.
Origem dos DadosentityDefine a origem dos dados: Entidade ou consulta personalizada.
Ordenaçãoorder-byOrdena o conteúdo da fonte de dados.

Dependente de salvamento

dependent-lazy-postAguarda a seleção da fonte de dados selecionada nessa propriedade para realizar a ação da fonte de dados principal.
Linhas por páginarows-per-pageRetorna a quantidade de dados informada para realizar paginação na exibição dos dados.

Validar Campos Requeridos

checkrequiredSó insere ou atualiza os dados se todos os campos marcados como requeridos estiverem preenchidos.
ChaveskeysExibe as chaves primárias todas as entidades atribuídas a fonte de dados.

 

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 e blocos de programações.

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

NOVO: (adicionar como é a linha Grupo e a linha Regra)

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

Ordenação

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

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.

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.


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

  1. Adiciona um novo Parâmetro de Ligação;
  2. Seleciona o atributo da fonte de dados principal;
  3. Seleciona o operador de comparação; (????? é fixo ?????)
  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 que será exibido no campo 5;
  7. Exclui a ligação.

Origem dos Dados

A propriedade Origem dos Dados permite selecionar 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.

 

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 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.

Edição da Fonte de dados (ENtidade base ????)

É 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: 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 / ) com esse identificador;
    • O endereço na Lateral do identificador é um URI REST e possui a seguinte sintaxe:
      <domínio_do_sistema>/api/cronapi/odata/v2/<Identificador>/<parametro1>/.../<parametroN>/;
  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:
    • campo: exibe a entidade ou bloco de programação selecionado;
    • "…": seleciona a entidade ou bloco de programação;
    • Novo Bloco de programação: Abre uma janela para a criação do bloco de programação;
    • Excluir: limpa a seleção do bloco de programação ou entidade;
  5. Entidade base: ??????;
  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, 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.


Eventos

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. Momentos em que os eventos serão executados;
  2. Métodos selecionados para cada momento;
  3. Seleção do método;
  4. Criar um novo método por bloco de programação;
  5. Limpar o campo.

Campos

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. Momentos em que os eventos serão executados;
  2. Métodos selecionados para cada momento;
  3. Seleção do método;
  4. Criar um novo método por bloco de programação;
  5. Limpar o campo

 

Campo calculados

Adiciona novos campos ao mapa retornado da fonte de dados. Sendo possível inserir valores padrões, usar expressões AngularJS, lógica ou usar retorno de bloco de programação.

  1. Nome do campo: informar o nome do novo campo criado;
  2. +: cria o novo campo;
  3. Campo: nome do campo criado;
  4. Tipo do valor padrão: define o tipo de dado que será informado no campo valor padrão;
  5. Valor padrão: campo para informação do valor padrão;
  6. Tipo: define o tipo de dado do retorno do bloco de programação;
  7. Permissões: cria permissões CRUD e filtro para os grupos de... cadastrados no sistema;
  8. Limpar: limpa os dados inseridos nesse campo;
  9. Excluir: apaga o campo.

Tratamento de erros

Se o sistema não encontrar algum item, algumas mensagens podem ser personalizadas para o usuário. É possível também internacionalizar essas mensagens.

 

  1. Campo Erro de chave primária: mensagem informada ao usuário quando não for possível encontrar algum item no banco;
  2. Campo Erro de chave estrangeira: mensagem informada ao usuário quando não for possível encontrar algum item no banco através do uso da foreign key; 
  3. Internacionalização: Abre a janela de internacionalização da mensagem;
  4. Limpar: exclui o conteúdo preenchido no campo.

Informações extras

Localização da fonte de dados na view

O ícone da fonte de dados deve estar 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"


Ocultar componentes fonte de dados

A área de edição das telas que possuem muitos componentes dinâmicos ou que fazem muitas requisições diferentes podem ficar poluídas com a grande quantidade de componentes fonte de dados, os mesmos podem ser ocultados através do botão Exibir elementos não visuais.

Ocultar elementos não visuais na tela de edição


Nessa página

Botão do componente

Imagem no Editor visual

 

 

 

  • Sem rótulos