Gráfico Dinâmico: como inserir novos gráficos 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 Gráfico Dinâmico.

Com ela, é possível disponibilizar para os beneficiários ou cooperados diversas informações em formato de gráfico, facilitando a visualização e interpretação desse conteúdo. Por exemplo, índice de sinistralidade, histórico da quantidade de serviços realizados por um prestador, custos assistenciais e indicadores em geral.

Estão disponíveis seis modelos de gráficos: Linha, Coluna, Barra, Rosca, Pizza e Radar, e você pode configurá-los no Gerenciador de Aplicativos.

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

A seguir, apresentamos o passo a passo para configurar o Formulário Dinâmico.

Inserindo o Gráfico 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 apresentada na lista de Serviços Disponíveis


Funcionalidade sendo apresentada na lista de Serviços Configurados, num exemplo em que cinco diferentes gráficos 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 gráficos dinâmicos irão apontar para uma mesma rota, será preciso identificar qual gráfico 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”.


 

Configurações de exibição


Ainda no Gerenciador de Aplicativos, há outros campos que podem ser utilizados para configurar o Gráfico Dinâmico e determinar a maneira como ele será exibido nos aplicativos. São eles:


Tipo: o modelo de gráfico que será utilizado para a funcionalidade, conforme opções abaixo:



Exibir Legenda: determina se uma legenda será ou não exibida na tela da funcionalidade.


Posição da Legenda: define a o alinhamento da legenda na tela da funcionalidade, conforme opções abaixo:




Exibir Balão com Valor: ativa um balão que exibirá informações com os valores do gráfico na tela da funcionalidade.



Exemplos


No exemplo abaixo, configuramos no Gerenciador um gráfico do tipo “Linhas”, ativando a opção de “Exibir Legenda”, na posição “Baixo” e ativando também a opção “Exibir Balão com Valor”. Temos, então, o seguinte comportamento no aplicativo:



Aplicativo Cliente


Neste outro exemplo, configuramos um gráfico do tipo “Colunas”, ativando a opção “Exibir Legenda” na posição “Esquerda” e desativando a opção “Exibir Balão com Valor”. Temos, então, o seguinte comportamento no aplicativo:


Unimed Cooperado


Dica


Acessando a documentação técnica (Swagger), é possível realizar algumas simulações para as APIs da funcionalidade, definindo no campo “servicoId” o tipo de gráfico. Dessa maneira, é possível verificar a estrutura de retorno das APIs de “filtro” e de “conteúdo” das informações:


API: GET /api/Beneficiario/FiltrosGraficoDinamico

Tipo: Linha





Tipo: Coluna




 Confira também outras novidades disponibilizadas nesta mesma atualização dos aplicativos:
> Formulário 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