Base de Conhecimento

RM - PEP 2.0 - Configuração de datasources do formulário dinâmico

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> 
mceclip0.png

2.  No campo de preenchimento obrigatório e de texto livre.
Exemplo:

mceclip1.png

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)

mceclip2.png

  • 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

mceclip4.png

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

mceclip5.png

4. Retorno JSON:
    
mceclip6.png 

 

  • 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:

mceclip7.png

 Exemplo de retorno JSON_OBJECT:
      mceclip0.png

 4. Campo ATIVO: Habilita e desabilita o datasource na página de construção de formulários.
Exemplo:
mceclip3.png

 

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

 

 

Esse artigo foi útil?
Usuários que acharam isso útil: 0 de 0

0 Comentários

Por favor, entre para comentar.
X Fechar

Olá ,

Há pendência referente a um de seus produtos contratados para a empresa ().

Entre em contato com o Centro de Serviços TOTVS para tratativa.

Ligue! 4003-0015 opção 4 e 9 ou registre uma solicitação para CST – Cobrança – Verificação de pendências financeiras . clique aqui.

TOTVS

X Fechar

Olá ,

Seu contato não está cadastrado no Portal do Cliente como um perfil autorizado a solicitar consultoria telefônica.

Por gentileza, acione o administrador do Portal de sua empresa para: (1)configurar o seu acesso ou (2)buscar um perfil autorizado para registro desse atendimento.

Em caso de dúvidas sobre a identificação do contato administrador do Portal, ligue (11) 4003-0015, opção 7 e, em seguida, opção 4 para buscar o suporte com o time de Assessoria ao Portal do Cliente. . clique aqui.

TOTVS

X Fechar

Olá ,

Para o atendimento de "Consultoria Telefônica" você deverá estar de acordo com o Faturamento.

TOTVS

X Fechar

Olá,

Algo inesperado ocorreu, e o usuario nao foi reconhecido ou você nao se encontra logado

Por favor realize um novo login

Em caso de dúvidas, entre em contato com o administrador do Portal de Clientes de sua empresa para verificação do seu usuário, ou Centro de Serviços TOTVS.

Ligue! 4003-0015 opção 4 e 9 ou registre uma solicitação para CST – Cadastros . clique aqui.

TOTVS

Chat _

Preencha os campos abaixo para iniciar o atendimento:

Chat _