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 39 Próxima »

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 

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.

Estratégia em Cláusula Nula

parameters-null-strategyDefine como o sistema deve tratar parâmetros nulos da 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, 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:

Sintaxe da Figura 2.2
(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.


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

O endereço na Lateral do identificador é um URI REST e possui a sintaxes diferentes dependendo do tipo de fonte: 

  1. Entidade: <domínio_do_sistema>/api/cronapi/odata/v2/<Identificador>/<parametro1>/.../<parametroN>/
  2. Bloco de programação: <domínio_do_sistema>/api/cronapi/query/<Identificador>/<parametro1>/.../<parametroN>/

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


Nessa página

Botão do componente

Imagem no Editor visual

 

 

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 

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.

Estratégia em Cláusula Nula

parameters-null-strategyDefine como o sistema deve tratar parâmetros nulos da 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, 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:

Sintaxe da Figura 2.2
(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()

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.


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

O endereço na Lateral do identificador é um URI REST e possui a sintaxes diferentes dependendo do tipo de fonte: 

  1. Entidade: <domínio_do_sistema>/api/cronapi/odata/v2/<Identificador>/<parametro1>/.../<parametroN>/
  2. Bloco de programação: <domínio_do_sistema>/api/cronapi/query/<Identificador>/<parametro1>/.../<parametroN>/

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


Nessa página

Botão do componente

Imagem no Editor visual

 

 

 

  • Sem rótulos