Dúvida
Como configurar um datasource para o formulário dinâmico?
Ambiente
Soluções Saúde - PEP 2.0
Para versões 12.1.19 e superiores
Solução
- O que é Datasources
Datasource é um recurso que permite obter dados externos para os componentes dos formulários dinâmicos. Os dados obtidos nos datasources são utilizados principalmente para popular opções nos componentes do formulário (ex. DROPDOWN, RADIO, AUTOCOMPLETE, etc).
- Criando Datasources
Para configurar um datasources siga os passos a baixo:
1. Acesse o menu Cadastro de Datasource> Incluir Datasource>
2. No campo de preenchimento obrigatório e de texto livre.
Exemplo:
3. No campo Tipo de Datasource o preenchimento é obrigatório, conforme o tipo selecionado, novos campos são requeridos, as opções são:
- Manual (lista de opções)
- JSON (lista de registros)
- JSON_Object (registro único)
- Manual
1. 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.
2. 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:
- LABEL é a informação que será exibida para o usuário em tela
- VALOR é a informação que será salva no banco de dados
- Datasource JSON
1. 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:
- CID
- Profissionais
- Alergias
Exemplo:
1. O campo ENDEREÇO DE ACESSO deve conter a URL do serviço.
2. 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.
3. O botão TESTAR pode ser usado para verificar se a requisição está OK.
4. Retorno JSON:
- JSON_Object
As informações são obtidas a partir da uma requisição para um serviço HTTP.
É 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.
Para mostrar no formulário os dados retornados pelo JSON_Object, deve-se fazer a referência à consulta SQL cadastrada no RM 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.
Exemplo de configuração JSON_Object:
- 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.
Exemplo: http://SERVIDOR/TotvsBusinessConnect/wsFormDinamico.asmx/GetJSON_OBJECT?CodSentenca=VT.FD.0001&CodAplicacao=O¶meters=CODPACIENTE=@QUERY('mpi');CODATENDIMENTO=@QUERY('attentionId') - 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.
Exemplo de retorno JSON_OBJECT:
4. Campo ATIVO: Habilita e desabilita o datasource na página de construção de formulários.
Exemplo:
Saiba Mais
Para saber mais sobre os parâmetros utilizados nos filtros, veja o artigo: RM - PEP 2.0 - Parâmetros de entrada em Formulário Dinâmico
0 Comentários