FAQ - Formbuilder

1 App Data Driver
2 formPreLoadData
3 Request para API externa

Esta documentação abrange a área de troubleshooting, essencial para resolver problemas técnicos e manter sistemas funcionando adequadamente. Exploraremos a abordagem sistemática de análise de sintomas, testes e diagnóstico, além de destacar a importância da colaboração e compartilhamento de conhecimento. O guia fornece informações valiosas para aprimorar habilidades técnicas e enfrentar desafios com confiança, garantindo a eficiência operacional. Mantenha-se atualizado com as últimas tendências nesse campo em constante evolução.

Em caso de necessidade de um analista para verificação em conjunto, abra um ticket com a Mobile Saúde e acione o nosso atendimento especial

App Data Driver

O App Data Driver é uma extensão do FormBuilder que facilita o preenchimento automático dos formulários com dados relevantes.

Sabendo disso, é possível utilizar os dados retornados do Login para o preenchimento de campos nos formulários.

Nem todos os dados que são retornados do Login são suportados pelo FormBuilder, segue a lista:

Array segurança - Não suportado
Array permissoes - Suportado
Array beneficiarios - Suportado
Array contratos - Não suportado

Dados do beneficiário

Para retornar os dados de um beneficiário em um componente do Formbuilder, como por exemplo retornar o nome do beneficiário em um componente basta:

Aba “API” > “Nome da propriedade customizada”
Preencha com "json.beneficiario.” + atributoDesejado

No exemplo citado teremos: json.beneficiario.dadosPessoais.nome

Objeto custom

Existe também a possibilidade de utilizar o objeto custom que se encontra dentro do Array de beneficiarios para retornar informações que desejar e que não estão por padrão no payload de Login
(por exemplo, exibir número da matricula funcional de empregado, tipo sanguíneo e etc).

"beneficiarios": [
  {
    "custom": 
      {
        "telefoneFixo": "99999999999",
        "corOlhos": "Azul"
      }    
  }
]

Para retornar os dados do objeto custom de um beneficiário em um componente do Formbuilder, como por exemplo retornar o telefone fixo do beneficiário em um componente basta:

Aba “API” > “Nome da propriedade customizada”
Preencha com "json.beneficiario.” + atributoDesejado

No exemplo citado teremos: json.beneficiario.custom.telefonefixo

formPreLoadData

Em caso de necessidade de um analista para verificação em conjunto, abra um ticket com a Mobile Saúde e acione o nosso atendimento especial

Integração que permite que a operadora carregue dados de endereço dos beneficiários em fluxos como atualização cadastral.

A integração é feita diretamente no Painel Publico, documentação técnica: 1.7 - formPreLoadData

Retorno da API - Sucesso

Este é um exemplo de retorno de sucesso da API após a integração realizada.

{
   "data": [
      {
         "endereco": {
            "endereco": "Costa Rica",
            "numero": "1391",
            "bairro": "Bacacheri",
            "cidade": "Curitiba",
            "estado": "PR",
            "cep": "82515270"
         }
      }
   ]
}

Integrando formPreLoadData ao FormBuilder

Utilizando o dado retornado pela integração em seu formulário.

Para retornar os dados da integração do formPreLoadData em um componente do Formbuilder, como por exemplo retornar o endereço em um componente basta:

Aba “API” > “Nome da propriedade customizada”
Preencha com "json.integracao.” + atributoDesejado

No exemplo citado teremos: json.integracao.endereco.endereco

Request para API externa

Problema: Preciso efetuar um request para uma API e alimentar os dados de um componente do formbuilder.

1 - O formbuilder ATUALMENTE só realiza chamadas do tipo POST, ajuste seu endpoint para responder a requisições deste tipo

2 - A API deve retornar os dados dentro do array “data” pois o formbuilder acessa os dados que estão dentro deste array, como no exemplo abaixo:

{
    "status": true,
    "data": [
        {
            "id": 29,
            "uf": "AC",
            "nome": "Acre",
            "codigoIBGE": "12"
        },
        {
            "id": 41,
            "uf": "AL",
            "nome": "Alagoas",
            "codigoIBGE": "27"
        }
    ]
}

3 - Crie um componente do tipo “Seleção API” e na aba “Dados” informe os campos necessários:

Grupo de segurança
- Caso crie uma regra para gerar tokens e seja enviados para API no header de forma dinamica
Headers da Requisição
- Caso possua um header para passar fixado
URL
- Precisam ser do tipo POST
Dados para Requisição
- Para enviar a API propriedades do tipo JSON no corpo da requisição, chave / valor
Propriedade Label
- Valor que será exibido na label do formulário
Propriedade Value
- Valor que será utilizado como valor para ser passado

Exemplo no print abaixo de preenchimento do componente utilizando o json de exemplo:

Como será exibido: