Formulário Dinâmico: como inserir novos formulários nos apps

        15 de setembro, 2023

Com a atualização realizada em 18 de setembro de 2023, os aplicativos Unimed Cliente e Unimed Cooperado ganharam a nova funcionalidade Formulário Dinâmico.

Com ela, é possível criar formulários diversos no app, destinados à finalidade que sua Unimed precisar. Por exemplo, questionários, pesquisas, canal de sugestões ou até mesmo para preenchimento de dados cadastrais.

O Formulário Dinâmico possui toda a sua estrutura baseada em uma funcionalidade já existente, a de Atualização Cadastral, só que oferece flexibilidade de personalização.

Assim, você pode inserir mais de um formulário e customizar nome, descrição, campos e até ícones, tudo pelo Gerenciador de Aplicativos.

A descrição detalhada dos requisitos desta funcionalidade você encontra no Swagger.

A seguir, apresentamos os componentes disponíveis e o passo a passo para configurar o Formulário Dinâmico.

Componentes


O Formulário Dinâmico apresenta a seguinte estrutura:


Label – componente que define um rótulo/título para o campo


Textbox – caixa de texto para preenchimento livre



Textbox Numérico – campo para preenchimento restrito a valores numéricos



Dropdown – campo na forma de menu suspenso, permitindo listar opções para seleção



Radiobutton – campo que exibe botões de opção, permitindo que apenas um seja selecionado



Checkbox – campo que exibe caixas de seleção



Multiple Checkbox - campo que exibe caixas de seleção, permitindo marcar mais de uma opção



Date – componente de data com a estrutura dia, mês e ano



CPF – campo específico para inserção dos dígitos de um CPF



CNPJ – campo específico para inserção dos dígitos de um CNPJ



E-mail – campo específico para inserção de um endereço de e-mail



CEP – campo específico para inserção dos dígitos de um CEP



CEP Autocompletar – campo de endereço que será preenchido automaticamente quando o usuário informar o CEP



File Attach – campo que permite ao usuário fazer o upload de um ou mais arquivos

 


 

Configurando o Formulário Dinâmico


No Gerenciador de Aplicativos, a funcionalidade está disponível para ser adicionada na listagem de Serviços Disponíveis. Ao adicionar a funcionalidade no app, ela passará a ser exibida na listagem de Serviços Configurados.


Vale destacar que, mesmo após adicionada, a funcionalidade continuará sendo exibida em Serviços Disponíveis, para que possa ser adicionada mais de uma vez, conforme a necessidade de cada Unimed.


Funcionalidade sendo exibida na lista de Serviços Disponíveis




Funcionalidade sendo exibida na lista de Serviços Configurados, num exemplo em que quatro formulários foram adicionados


Para cada funcionalidade adicionada, você poderá atribuir um nome/descrição no campo Título do Serviço, além de escolher um Ícone, para diferenciar determinada funcionalidade das demais:




Além disso, será necessário que alguns parâmetros sejam configurados de maneira que diferencie uma funcionalidade da outra, conforme mostraremos a seguir.

Identificador de Integração


Como todos os formulários dinâmicos irão apontar para uma mesma rota, será preciso identificar qual formulário está sendo utilizado pelo usuário. Para isso, basta definir um parâmetro para ele no campo Identificador de Integração, ainda no Gerenciador de Aplicativos.

Esse parâmetro deve ser definido sem caractere especial, informando somente texto e número, considerando que será utilizado nas URLs de requisição. Exemplo:




Conforme a documentação técnica de integração dos aplicativos, esse parâmetro será encaminhado na requisição como “servicoId”.



Ainda seguindo o exemplo anterior, em que o formulário foi configurado no Gerenciador com o identificador “dados”, temos o seguinte comportamento da funcionalidade no aplicativo:


Unimed Cliente


Já definindo o formulário com o identificador “contato”, por exemplo, temos o seguinte comportamento da funcionalidade no aplicativo:



Unimed Cooperado

 

Dica


Ainda dentro da documentação técnica (Swagger), é possível realizar algumas simulações para as APIs da funcionalidade, definindo no campo “servicoId” o nome do formulário. Dessa maneira, é possível verificar a estrutura de retorno das APIs:


curl -X GET --header 'Accept: application/json' --header 'X-Carteira: 05000000000000001' --header 'X-CPF: 00000000000' --header 'X-AppId: 1' --header 'X-CoopId: 0' 'http://app-hml.portalunimed.com.br/apps/proxy/api/Beneficiario/FormularioDinamico?servicoId=dados'


Documentação técnica (Swagger) Demo


Confira também outras novidades disponibilizadas nesta mesma atualização dos aplicativos:

> Gráfico Dinâmico
> Preview


 

Ficou com outras dúvidas?

> Pesquise pelo que precisa aqui na Central de Ajuda, ou
> Abra um chamado para nossa equipe em: Canal do Colaborador > Aplicativos > GIU > Sistema de Gestão de Demandas > Abertura de Chamados > Sistemas e Aplicações