Ir para o conteúdo principal
Voltar para POWERB WORKBENCH
TUTORIAL · POWERB

Como criar uma navegação personalizada por usuário no PowerB utilizando um Nav File

PowerB POWERB WORKBENCH

Um Nav File permite definir uma estrutura de navegação personalizada para usuários da station. Em vez de apresentar somente a árvore técnica padrão, é possível organizar atalhos para telas, componentes e áreas de operação relevantes para cada perfil.

Neste procedimento, o Nav File será utilizado para criar uma navegação personalizada e associá-la a um usuário específico. As permissões de acesso continuam sendo controladas por Roles, Categories e Permissions da station.

Nav File organiza a navegação, mas não concede permissão

Um item aparecer no Nav File não significa que o usuário possui autorização para acessá-lo. O recurso precisa continuar disponível pelas permissões do Role e das Categories atribuídas ao usuário.

1. Antes de iniciar

Station acessível pelo PowerB

A station deve estar disponível para configuração pelo Workbench.

Usuários e Roles previamente definidos

Defina quais usuários utilizarão a navegação personalizada e confirme que os respectivos Roles possuem acesso aos recursos apresentados.

Telas ou componentes já disponíveis

Tenha disponíveis as PX, componentes ou outros destinos que serão utilizados como itens da navegação.

2. Entender o papel do Nav File

No Niagara, o Home pode representar uma árvore de navegação definida por um Nav File. Como o arquivo é associado ao usuário, diferentes perfis podem receber estruturas de navegação diferentes dentro da mesma station.

Exemplo de navegação para Operação

Início → Visão geral do prédio
Climatização → CAG, AHUs e Fan Coils
Alarmes → Tela de alarmes
Energia → Medição e consumo

Exemplo de navegação para Manutenção

Início → Visão geral
Climatização → Equipamentos
Alarmes → Tela de alarmes
Schedules → Programações horárias
Diagnóstico → Telas técnicas autorizadas

3. Criar um Nav File

  1. Crie o arquivo na pasta Files

    Clique com o botão direito na pasta Files da station e acesse New → NavFile.nav.

    Criação de NavFile na pasta Files da station
    Criação de um novo NavFile.nav na pasta Files.
  2. Abra o Nav File Editor

    Clique duas vezes no arquivo .nav criado para abrir o Nav File Editor.

    Nav File Editor no PowerB
    Abertura do arquivo de navegação no Nav File Editor.

4. Planejar a estrutura de navegação

Antes de configurar os destinos, organize a navegação pensando no trabalho do usuário. Evite reproduzir toda a estrutura técnica da station quando o objetivo for oferecer uma interface operacional mais simples.

PerfilConteúdo que costuma fazer sentido
OperaçãoVisão geral, equipamentos, schedules operacionais, alarmes e consumo.
ManutençãoEquipamentos, alarmes, schedules, diagnóstico e telas técnicas autorizadas.
GestãoDashboards, indicadores, energia, tendências e relatórios.
Princípio recomendado

Mostre ao usuário somente a navegação que ajuda na função dele. A segurança real, entretanto, deve continuar sendo configurada separadamente em Roles e Categories.

5. Configurar os destinos da navegação

Cada item do Nav File precisa apontar para um recurso válido da station. O campo Target Ord identifica o componente ou recurso que será aberto por aquele item.

  1. Edite o Target Ord

    No Nav File Editor, abra a configuração do item desejado e defina em Target Ord o caminho para a PX, componente ou recurso que deverá ser apresentado.

    Configuração de Target Ord no Nav File Editor
    Definição do destino utilizado pelo item da navegação.
  2. Selecione a visualização correta

    Se o componente possuir mais de uma visualização, utilize (Default View) para definir qual view deverá ser aberta.

Target Ord inválido pode causar erro de abertura

Se o recurso apontado não existir, tiver sido movido ou estiver inacessível para o usuário, a navegação poderá abrir uma página de erro em vez da visualização esperada.

6. Associar o Nav File ao usuário

  1. Abra o UserService

    Navegue até o UserService da station e abra as propriedades do usuário que receberá a navegação personalizada.

  2. Configure o campo Nav File

    No campo Nav File, informe o caminho do arquivo .nav que foi criado para esse usuário ou perfil.

    Associação do Nav File ao usuário no UserService
    Configuração do arquivo de navegação nas propriedades do usuário.

Como o Nav File é configurado no usuário, arquivos diferentes podem ser utilizados para oferecer experiências de navegação distintas na mesma station.

7. Combinar Nav File com Roles e Categories

RecursoFunção
Nav FileDefine a navegação personalizada apresentada ao usuário.
RoleAgrupa as permissões necessárias para uma função ou perfil de usuário.
CategoryOrganiza os componentes sobre os quais as permissões serão aplicadas.
Web ProfileDefine características da experiência de acesso pela interface web.
Ocultar não é bloquear

Remover um item do Nav File apenas retira esse caminho da navegação personalizada. Para impedir o acesso ao recurso, ajuste também as permissões do usuário por meio de Roles, Categories e Permissions.

8. Validar a navegação personalizada

  1. Reconecte com o usuário configurado

    Encerre e abra novamente a sessão utilizando o usuário que recebeu o Nav File.

  2. Confirme a nova navegação

    Verifique se os itens definidos no arquivo aparecem na árvore de navegação desse usuário.

  3. Teste cada destino

    Abra os itens configurados e confirme que cada Target Ord resolve para a visualização esperada e que o usuário possui permissão para acessá-la.

Resultado de Nav File personalizado na navegação da station
Exemplo de navegação apresentada após a associação do Nav File ao usuário.
Critério de sucesso

A configuração está concluída quando o usuário recebe a árvore de navegação prevista, consegue abrir os destinos autorizados e não visualiza atalhos desnecessários para sua função.

9. Se a navegação não funcionar como esperado

ComportamentoO que verificar
Nav File não aparece para o usuário.Confirme o arquivo configurado no campo Nav File do UserService e reconecte o usuário.
Um item abre HTTP 404.Revise o Target Ord, confirme que o recurso existe e verifique as permissões do Role e das Categories.
A view errada é aberta.Revise a seleção em (Default View).
O item aparece, mas o usuário não consegue abrir.O Nav File está correto, mas falta autorização. Revise Roles, Categories e Permissions do usuário.
Usuário visualiza mais recursos do que deveria.Revise tanto o Nav File quanto as permissões. O arquivo de navegação não substitui a configuração de segurança.
SUPORTE

Ainda precisa de ajuda?

Entre em contato com o suporte técnico da Mercato. Para agilizar o atendimento, informe o equipamento, produto ou sistema relacionado e descreva brevemente a dúvida ou o problema encontrado.

 Falar com o suporte no WhatsApp→ 

Este artigo foi útil?

Que bom!

Obrigado pelo seu feedback

Desculpe! Não conseguimos ajudar você

Obrigado pelo seu feedback

Deixe-nos saber como podemos melhorar este artigo!

Selecione pelo menos um dos motivos
A verificação do CAPTCHA é obrigatória.

Feedback enviado

Agradecemos seu esforço e tentaremos corrigir o artigo