Menus Customizados

CONTEÚDO

01. VISÃO GERAL

A rotina de Menus Customizados permite a criação, edição e exclusão de novos menus próprios que são exibidos na barra lateral do TOTVS Saúde Portal Autorizador, com os demais menus padrões do sistema.

É possível criar vários menus e vincular várias páginas (submenus) a este mesmo menu. 

Vamos descobrir como funciona na prática?

02. EXEMPLO DE UTILIZAÇÃO

     02.01 Adicionando um novo menu customizado

      Acesse a rotina Menus Customizados e clique em +Novo

      Será redirecionado para a tela de cadastro de menu customizado. Onde deve-se preencher os seguintes campos:

      Nome do Menu: Nome do menu customizado. Será exibido quando o menu do TOTVS Saúde Portal Autorizador estiver expandido.

      Nome Reduzido: Nome reduzido do menu customizado. Será exibido quando o menu do TOTVS Saúde Portal Autorizador estiver colapsado (retraído).

      Ícone do Menu: Ícone do menu customizado, que será exibido à esquerda do nome. 

      Para definir o ícone, basta clicar no botão de ajuda do lado do campo "Ícone do Menu" , ou entrar no site https://po-ui.io/guides/icons e copiar o ID do ícone escolhido.

      Por exemplo: para o ícone de lupa precisaria informar po-icon po-icon-search no campo de ícone, ficando dessa forma  .

      Obs.: caso não seja informado nenhum ícone, será exibido o de ícone padrão .

      Além disso, é preciso vincular ao menos uma página customizada ao menu.

      Para isso clique em Nova Página Customizada. E preencha as informações da página:

      Título da Página: Título da página que será exibido no TOTVS Saúde Portal Autorizador.

      Tipo: Define se será informado código HTML da página a ser exibida, ou a URL de um site externo a ser incorporado no TOTVS Saúde Portal Autorizador.

      URL: URL do site externo que será incorporado ao sistema.

      HTML: HTML da página customizada. Garanta que a sintaxe esteja correta, o sistema não faz a validação.  Além disso, forneça apenas HTML, pois CSS da tag <style> não será interpretado.

      Com os campos preenchidos, clique em 'Salvar'. Após isso, um novo registro será criado e exibido na sessão 'Vincular Páginas Customizadas', com as informações da página que foi informado.

      Agora já é possível salvar o menu customizado. Clique em 'Salvar'.

      Veja um GIF de demonstração da rotina completa:

     02.02 Editando um menu customizado

        Acesse a rotina Menus Customizados disponível no menu Configurações do Ambiente de Administração.

        Clique sobre o ícone de edição do menu customizado que deseja alterar.

        Será redirecionado para a tela de edição, com os campos já preenchidos com as informações do menu em questão.

       Altere o que deseja e clique em Salvar. 

     02.03 Excluindo um menu customizado

    Acesse a rotina Menus Customizados disponível no menu Configurações do Ambiente de Administração.

   Clique sobre o ícone de exclusão no menu que deseja excluir.

   Clique em Confirmar.

     02.04 Sessão 'Vincular Páginas Customizadas'

       Essa sessão é responsável pelo controle das páginas que serão incluídas no menu customizado. 

       É possível editar ou excluir uma página customizada. Funciona da mesma lógica que foi mostrado para edição e exclusão dos menus customizados.

      Obs.: ao criar uma página customizada e fornecer o código HTML, garanta que a sintaxe esteja correta. O sistema não faz a validação.

      Além disso, forneça apenas HTML, pois CSS da tag <style> NÃO será interpretado.

     02.05  Visualizando um Menu Customizado Hat ( Link ) 

No portal autorizador iremos listar os menus customizados cadastrados. Caso seja anexado um link iremos incorporá-lo à nossa página.

Caso algum cliente desejar realizar uma validação interna, enviamos o Token de validação da sessão e o código do prestador por meio da URL. Além disso, disponibilizaremos uma API pública authenticationToken para permitir que nossos clientes realizem a validação desse Token através da requisição POST. 

Exemplo: www.totvs.com/?token=xxxxxx?healthProviderId=xxxxxx 

Essa funcionalidade fornecerá aos clientes a capacidade de anexar uma página de uso interno ao TOTVS Saúde Portal Autorizador e validar dinamicamente os usuários. Qualquer link anexado receberá essas informações na URL, ficando a critério do cliente utiliza-las ou não.

     02.06  Visualizando um Menu Customizado Hat ( HTML ) 

No portal autorizador, iremos listar os menus customizados cadastrados. Caso seja anexado um arquivo HTML, iremos incorporá-lo à nossa página.

     02.07  O que é o TOKEN de validação da sessão e como identificá-lo?

Caso o menu customizado tenha sido criado através da incorporação de um link externo, é enviado um TOKEN de validação da sessão no momento da chamada desse link externo fornecido, junto com a informação de qual é o prestador selecionado, em formato de QUERY PARAM. Isso possibilita anexar uma página externa ao TOTVS Saúde Portal Autorizador, validando dinamicamente a autorização dos usuários.

Exemplo de validação do TOKEN:

Link externo incorporado:

Ao chamar o link externo para incorporá-lo no TOTVS Saúde Portal Autorizador, fornecemos o token e o código do prestador como query param na requisição:

O TOKEN é tudo o que está após o igual (=) e antes do ponto de interrogação (?). Neste caso, o token então é: 

Bearer%20eyJhbGciOiJSUzI1NiIsImtpZCI6IjJiYjZmYzUyM2ZjNzQwZjI4NmMxOTZmY2ExMzUyNzE2IiwidHlwIjoiSldUIn0.eyJuYmYiOjE2ODkxMDI5NDUsImV4cCI6MTY4OTEwNDE0NSwiaXNzIjoiaHR0cHM6Ly8xMC4xNzEuNDAuNTE6NDAwMC90b3R2cy5yYWMiLCJhdWQiOiJhdXRob3JpemF0aW9uX2FwaSIsImNsaWVudF9pZCI6ImF1dF9vaWRjIiwic3ViIjoiNDQ2IiwiYXV0aF90aW1lIjoxNjg5MTAyOTQ1LCJpZHAiOiJsb2NhbCIsImh0dHA6Ly93d3cudG5mLmNvbS9pZGVudGl0eS9jbGFpbXMvcHJvZHVjdElkIjoiMSIsImh0dHA6Ly93d3cudG5mLmNvbS9pZGVudGl0eS9jbGFpbXMvcHJvZHVjdE5hbWUiOiJUT1RWUyBSQUMiLCJodHRwOi8vd3d3LnRuZi5jb20vaWRlbnRpdHkvY2xhaW1zL3JhY1ZlcnNpb24iOiIxLjIxLjQuMCIsImh0dHA6Ly93d3cudG5mLmNvbS9pZGVudGl0eS9jbGFpbXMvdXNlckZ1bGxuYW1lIjoiSG9zcGl0YWwgQm9tIENsaW1hIiwibmFtZSI6WyJoc2JvbWNsaW1hIiwiSG9zcGl0YWwgQm9tIENsaW1hIl0sImVtYWlsIjoiaHNib21jbGltYUBoc2JvbWNsaW1hLmNvbSIsInNpZCI6IjFDRjg3OTRFQzAxQzM5OTk1QzE4RDk1QzZGRjJBQ0RCIiwiaWF0IjoxNjg5MTAyOTQ1LCJzY29wZSI6WyJvcGVuaWQiLCJwcm9maWxlIiwiZW1haWwiLCJhdXRob3JpemF0aW9uX2FwaSIsIm9mZmxpbmVfYWNjZXNzIl0sImFtciI6WyJwd2QiXX0.fCtZ5MPVh4TN0gTnrhxMgr6IKDk5b-W8HQuyzhH6lYfot9aOWI-Bzvap1QuFwAbyXDOk5lQ5fes6LphNtxt7fzd0Nc83bXeQZQh6UTDFcBPYfqA7d18rPoflpySV-duN6dqE1nWubVYzU6hhESY5wYqyAcR0eSDJJsg9L2rMSpSNk9dV4pT2wjlhhjTnFr1kv2QSIoiHAdANPvydOCfm_GVyX4e7hAYVt5cxETxpBfDmpTX2nIxq8vvqfWvkiO_FgAFHpwh08o9LJndo88lqDSnCX5yAPC7FPOva224PV3fU_KXAK0LkLSOv8f6_XWpsca-HoW6ts8zH-tc3bkKtpA

Com isso, é possível validar o usuário que está tentando acessar, através do verbo POST na API authenticationToken. 

     02.08  Como validar o TOKEN de validação de sessão?

Deve-se enviar uma requisição POST na API authenticationToken e no Header da requisição, deve-se incluir 'Authorization', passando como valor o token acima. Ficando dessa forma:

      - Se o token for válido, o código de resposta será 200 (como mostra o print acima).

      - Se for inválido, código de resposta será 401, junto com uma mensagem informando que o token não é válido:

Também é possível ter acesso a informações específicas, como nome e e-mail, do usuário logado através do TOKEN.

O site https://jwt.io/ faz essa decodificação automática: