Labels

Essa etapa consiste em criar as labels (permissões de acesso) para seu produto. No PM (opens new window), acesse a tela de ACl Labels e selecione projeto desejado.

Importar Menu

No primeiro acesso a tela estará vazia. Clique no botão Importar Menu.

Importe os menus através do modal aberto. Preencha o campo URL com o endereço completo da rota lib_buildMenu da tek-lib.

Exemplo:

http://localhost/seu_produto/backend/service/index.php/lib_buildMenu

Dica

O exemplo acimase trata de uma URL de ambiente local. Você deve usar do ambiente em que seu produto (menu) se encontra mais atualizado possível. Em muitos casos, esse ambiente pode ser o de teste.

Se a importação funcionou, uma lista de elementos aparecerá na tela como Novo. Clique em salvar caso esteja tudo certo.

Durante o processo de importação do menu, as labels do mesmo são criadas automaticamentes com o valor do id de cada um. No exemplo acima podemos ver as labels destacadas no componente azul.

Tipos

Menu

Ao importar o menu a partir da URL com intuito de atualizar as labels da tela, seja para adicionar ou remover elementos, algumas regras são seguidas:

• Menus que já existam (com mesmo id) serão mantidos. Dessa forma, nenhuma regra adicionada será perdida.
• Menus novos serão adicionados e marcados como Novo.
• Menus cadastrados mas que não existem na URL serão removidos.

Dica

Menus não são criados através da tela, eles serão sempre importados. Caso sua aplicação tenha um novo menu, você deve importar através da URL novamente. A mesma lógica é aplicada para excluir um menu.

Regra

Esse tipo corresponde as regras de acesso que seu produto irá possuir, além das permissões de menu. Visualizar um botão na tela, por exemplo.

Para criar uma regra, clique na action Adicionar disponível na toolbar da tela, com um item do tipo menu ou agrupador selecionado.

Dica

Para selecionar um item basta selecionar a linha correspondente. O item selecionado ficará destacado.

Ao clicar na action Adicionar, um modal será exibido. O campo Tipo exibirá o valor Regra.

Diferente do agrupador que não possui label, ao criar uma regra você deve preencher o campo Label além do campo Nome. Com os campos preenchidos, basta clicar no botão Adicionar.

Quando o modal fechar, clique no botão de Salvar na toolbar.

Dica

Você pode criar e editar várias regras e agrupadores antes de salvar.

Para excluir uma regra basta clicar uma vez em cima da qual deseja excluir para selecioná-la e depois clicar na action Excluir na toolbar.

Dica

Você pode selecionar mais de uma regra para excluir, basta manter pressionada a tecla CTRL enquanto seleciona as regras.

Atenção

Quando clicar na action de excluir o(s) item(s) selecionados serão excluídos definitivamente.

Agrupador

Esse tipo serve como auxiliar para agrupar regras. Geralmente, é utilizado em regras que interagem em mais de uma tela.

Para criar um agrupador basta clicar na action Adicionar da toolbar sem que nenhum item da árvore esteja selecionado. Um modal para adicionar o Agrupador vai ser exibido. Digite um nome e clique no botão adicionar.

Toolbar

Adicionar

Exibirá um modal com um formulário para criar um item. O tipo poderá variar caso algum item esteja selecionado.

Dica

Essa ação incluirá novos itens mas não persistirá no banco de dados.

Excluir

Exclui os itens selecionados. Exclui definitivamente do banco de dados.

Atenção

Exclui definitivamente do banco de dados.

Reload

Atualiza os dados acordo com o banco de dados fazendo uma requisição para o backend.

Atenção

Se existir alguma operação pendente na tela sem estar salva, ao utilizar essa ação as alterações serão perdidas.

Expandir itens

Expande todos os itens.

Fechar itens

Fecha todos os itens.

Cancelar

Cancela as alterações feitas nos itens que ainda não foram salvos no banco de dados.

Salvar

Salva as alterações feitas nos itens no banco de dados.

Importar Menu

Exibe um modal com um formulário para importar os menus a partir de uma URL.

Download

Gera um arquivo json a partir dos itens. Esse arquivo deve ser adicionado no diretório raiz do seu produto.

Dica

Essa ação irá gerar uma nova versão para atribuir aos itens listados como Novo.

Informação

Esse processo de atribuição de versão facilita outra etapa do processo de ACL na tela de Perfil de Acesso, identificando itens novos para facilitar as parametrizações pelo lado do usuário final.