Versões comparadas

Versão antiga 22

changes.mady.by.user Igor Andrade

Gravado em

comparado com

Nova versão 23

changes.mady.by.user Igor Andrade

Gravado em

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

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 

NomePropriedadeFunçã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 dedependent-byVincula a fonte de dados com outras fontes de dados. Ao usar algumas propriedades (ex: Link Parameters), esse campo é preenchido automaticamente.
Nomename Nome da fonte de dados.
Postergar CargalazySó alimenta a fonte de dados após uma ação do usuário.
Mestre DetalheparametersVincula 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 DadosentityDefine a origem dos dados: Entidade ou consulta personalizada.
Ordenaçãoorder-bySeleciona campos para serem ordenados (acedente ou descendente).

Dependente de salvamento

dependent-lazy-postAguarda a seleção da fonte de dados selecionada para realizar a ação dessa fonte de dados.
Linhas por páginarows-per-pageRetorna a quantidade de dados informada.

Validar Campos Requeridos

checkrequiredSó insere ou atualiza os dados se todos os campos marcados como requeridos estiverem preenchidos.
Nota
titleAtençã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

Âncora
linkCondicao
linkCondicao
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.

Âncora
LinkOrdenacao
LinkOrdenacao
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.

Âncora

LinkLigacao

LinkMasterDetalhe

LinkLigacao

LinkMasterDetalhe
Mestre Detalhe


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

Âncora
LinkSource
LinkSource
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;

Na seleção da origem da Fonte de dados é possível selecionar tanto uma fonte de dados editável como um OData de uma entidade. Não é possível editar ou adicionar filtros a um OData, apenas fontes de dados criadas.

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

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.

Âncora
abaFiltro
abaFiltro
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

Âncora
abaPermissoes
abaPermissoes
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.


Âncora
abaEventos
abaEventos
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.

Âncora
abaCampos
abaCampos
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

 

Âncora
abaCampoCalculados
abaCampoCalculados
Aba 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.

 

 

 

Âncora
abaTratamentoErros
abaTratamentoErros
Aba tratamento de erros

Se o sistema não encontrar algum item, algumas mensagens podem ser personalizadas para o usuário. É possível tambéminternacionalização dessas 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.

 

 

Painel
titleNessa página

Índice

Botão do componente

Imagem no Editor visual

 

 

...