Função

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

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

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: