Datasource é um recurso que permite obter dados externos para os componentes dos formulários dinâmicos.
Esses dados podem ser dinâmicos, quando são obtidos a partir de um ERP ou software periférico, ou pré-definidos pelo usuário, no caso do datasource manual.
Os dados obtidos nos datasources são utilizados principalmente para popular opções nos componentes do formulário (ex. DROPDOWN, RADIO, AUTOCOMPLETE, etc).
Acessar o menu para inclusão de datasources e preencher os campos seguindo as orientações abaixo.
Campo de preenchimento obrigatório. Texto livre.
Campo de preenchimento obrigatório. Conforme o tipo selecionado, novos campos são requeridos, conforme detalhado nos próximos tópicos. As opções são:
Habilita e desabilita o datasource na página de construção de formulários.
As opções são definidas pelo próprio usuário, e salvas no banco de dados. Também podem ser modificados pelo usuário a qualquer momento.
O campo OPÇÕES PRÉ-DEFINIDAS deve ser preenchido respeitando o formato informado.
É indicado para listas de poucas opções, como:
- Sim, Não
- Escalas (0, 1, 2, 3, ... Boa, Regular, Ruim, ...)
Na configuração dos dados manuais, deve-se observar o seguinte:
- LABEL é a informação que será exibida para o usuário em tela
- VALOR é a informação que será salva no banco de dados
As opções são obtidas a partir da uma requisição para um serviço HTTP. O serviço deve retornar um JSON em formato compatível.
É indicado para listar informações de cadastros que já existem no ERP (ou software periférico), como:
O campo ENDEREÇO DE ACESSO deve conter a URL do serviço.
Os campos LABEL e VALOR deverão indicar quais as propriedades na lista de objetos do JSON deverão ser mostrados em tela e salvos no banco, respectivamente.
O botão TESTAR pode ser usado para verificar se a requisição está OK.
Exemplo de retorno JSON
As informações são obtidas a partir da uma requisição para um serviço HTTP. O serviço deve retornar um JSON em formato compatível.
É utilizado somente para buscar uma coleção de informações específicas, que podem ser mostradas no formulário, como:
- Dados do paciente
- Dados do atendimento
Em geral essa requisição é feita com a utilização de filtros na URL (código do paciente, por exemplo). Para enviar filtros na URL, utilizar a macro @QUERY('nome_do_filtro'). Os filtros que podem ser enviados nessa requisição do JSON_Object limitam-se aos filtros presentes na QUERYSTRING da requisição do formulário. O filtro mais comum é: mpi (código do paciente) - novos filtros poderão estar disponíveis no futuro.
Para mostrar no formulário os dados retornados pelo JSON_Object, deve-se fazer a referência à FUNÇÃO DE ACESSO na fórmula do metadado (ex. DADOSPACIENTE('EIR001_NAME') ).
Dessa forma, é possível que um componente TEXTBOX, por exemplo, exiba o nome do paciente no cabeçalho do formulário.
O campo ENDEREÇO DE ACESSO deve conter a URL do serviço. Pode ser utilizada a macro @QUERY('nome_do_filtro') para envio de parâmetros na URL.
O campo NOME DA FUNÇÃO DE ACESSO define um nome de função que permite acessar os dados do JSON retornado pela requisição. Este nome de função pode então ser usado na FÓRMULA de METADADO para que o valor seja recuperado para o componente.
O botão TESTAR pode ser usado para verificar se a requisição está OK.
.