Função

O componente visual fonte de dados é um recurso (cliente) utilizado exclusivamente pelas nas páginas das aplicações web e mobile do Cronapp. Ele possibilita o vínculo permite estabelecer uma conexão entre uma Fonte de dados <TODO: link>, criada no lado do lado servidor, e outro componente visual da outros componentes visuais na tela, como Grade ou , Lista Avançada e outros.

Ele faz a comunicação entre uma Fonte de dados, criada no lado servidor, com outros componente visuais da telas

A fonte de dados normalmente é utilizada para fazer a comunicação entre os dados persistidos (ex.: banco de dados) e a tela na qual o usuário realiza alguma interação. Ela permite tratar os dados em componentes visuais, relatórios, sistema BPM e gerar requisições REST dentro ou fora da aplicação. A fonte de dados utiliza a tecnologia OData para trafegar os dados e pode ser alimentada por uma consulta JPQL, bloco de programação ou web services (REST e SOAP). Esses fatores garantem a interoperabilidade e integração entre as camadas do sistema.

Após a configuração, o componente fonte de dados consegue reconhecer os comandos CRUD (criar, ler, atualizar ou deletar) gerados pelo componente visual associado para um ou mais registros. Ele então encaminha essa requisição RESTful (ODATA) para a Fonte de Dados (servidor) vinculada, fornecendo os dados necessários, como campos, parâmetros e filtros (Figura 1).

O componente fonte de dados suporta os 4 tipos de Fonte de dados criados e customizados do lado servidor e mais o tipo Entidade, em que uma classe é selecionada e os filtros são configurados diretamente pelas propriedades do componente visual fonte de dados. Essas propriedades adicionam parâmetros query string às requisições, possibilitando customização a uma Fonte de dados. Além das propriedades, o componente visual também possui eventos próprios, que são executados do lado cliente (javascript).

Image Added

Figura 1 - Fluxo de dados do componente visual Fonte de dados

Tipos

O componente fonte de dados suporta os 4 tipos de Fonte de dados criadas e customizadas do lado servidor e mais o tipo Entidade, em que uma classe é selecionada e os filtros são configurados diretamente pelas propriedades do componente visual fonte de dados (figura 1).

• Customizados no lado servidor:
  • Bloco de Programação: Fonte cuja origem dos dados é obtido a partir de um bloco de programação servidor (Java) que retorna uma lista de objetos. Caso a Fonte de dados possua uma entidade base vinculada, os campos serão automaticamente preenchidos  
  • Entidades: selecione uma classe do sistema e faça um filtro a partir de uma consulta JPQL.
  • Web Services: utilize um endpoint REST ou um endereço *.wsdl SOAP. Para mais detalhes, acesse a documentação Fonte de dados tipo Web Service (REST / SOAP).
  • Classe: retornará todos os registros de uma classe sem a possibilidade de configurações ou filtros.
• Não customizado no lado servidor:
  • Entidade: