Do dado ao portal
Uma fatura que aparece no portal do seu cliente nasceu no seu sistema — um ERP, um banco de dados, uma API. Esta página mostra o caminho que esse dado percorre até a tela, e onde você configura cada passo.
O caminho
- Conector — a ligação com o seu sistema: o endereço, as credenciais e as operações que ele oferece (por exemplo, Listar faturas). Configure em Conectores.
- Entidade — um tipo de dado que o portal mostra, como Fatura. A entidade diz qual operação do conector traz os registros, quais campos cada registro tem e qual campo indica o titular — de quem é o registro. Ela guarda uma cópia dos registros no Dashboard Mágico. Configure em Entidades.
- Bloco — no Construtor, você monta as páginas com blocos: uma tabela de faturas, o detalhe de uma fatura, uma lista de notas fiscais para baixar. Cada bloco de dados lê os registros de uma entidade. Veja Dados nos blocos.
- Página publicada — o portal mostra a versão que você publicou. Mudanças no rascunho só aparecem depois de publicar. Veja Publicar e versões.
- Usuário do portal — quem entra no portal vê só os registros cujo titular é igual ao tenant ID dele. Veja Titular e tenant ID e Usuários do portal.
O portal lê a cópia, não o seu sistema
Quando o usuário abre uma página, os blocos leem os registros que a entidade já guardou. O portal não consulta o seu sistema a cada visita — mesmo na sincronização Quando o usuário acessa, ele só busca de novo quando os registros guardados passam do prazo. Por isso:
- o portal continua rápido mesmo se o seu sistema for lento;
- uma instabilidade no seu sistema não derruba o portal — ele mostra os dados da última sincronização;
- um dado novo só aparece no portal depois da próxima sincronização da entidade.
Quando os dados se atualizam
Cada entidade escolhe como sincroniza com o seu sistema:
| Sincronização | Como funciona |
|---|---|
| Agendada | Lê todos os registros de tempos em tempos, no horário definido no conector. Também dá para pedir uma sincronização na hora. |
| Manual | Lê todos os registros só quando você pedir. |
| Quando o usuário acessa | Lê só os registros do tenant ID de quem está no portal, quando a pessoa entra e quando abre uma página com essa entidade. Os registros valem por um tempo que você escolhe (de 5 minutos a 24 horas); depois disso, o próximo acesso busca de novo, mostrando os registros guardados enquanto isso. Na primeira busca, quando ainda não há nada guardado, o bloco mostra Buscando seus dados…. |
Os detalhes estão em Sincronização das entidades.
Exemplo
Na Aurora Energia:
- O conector ERP Aurora Energia liga o Dashboard Mágico à API do ERP e sincroniza a cada 2 horas.
- A entidade Fatura usa a operação Listar faturas e marca o campo CPF/CNPJ do titular como titular.
- A página Faturas do Construtor tem uma tabela da entidade Fatura, com abas A pagar, Pagas e Todas.
- A página foi publicada.
- Uma cliente entra no portal e vê, na página Faturas, só as faturas do CPF dela.
Além de mostrar dados
O caminho também vale em sentido contrário, em dois casos:
- Usuários a partir de uma entidade — uma entidade pode criar os usuários do portal: cada registro vira um usuário, com o e-mail e o tenant ID tirados dos campos que você escolher. Veja Usuários do portal.
- Botões e formulários — um bloco de ação ou de formulário pode enviar dados para fora (um webhook ou um e-mail). Veja Formulários e ações.