¶ 1. Visão Geral
Papéis são utilizados dentro do T6 para restringir ou permitir o acesso em determinados contextos do cubo. Podemos também, definir se o usuário terá acesso à leitura e escrita, ou , somente leitura, dentro destes contextos no formulário. Com isto é possível que, em um mesmo formulário, diferentes usuários tenham visão mais ampla ou restrita das informações nele contidas.
Um Papel é uma ótima maneira de restringir acesso em formulários. Porém este recurso deve ser usado com cautela, pois quanto maior forem as restrições nele definidas, maior será o tempo de carregamento dos formulários.
Os Papéis somente serão aplicados caso a funcionalidade Criar e visualizar formulários de entrada de dados esteja desabilitada para o usuário nas funcionalidades do perfil Gestor.
¶ 1.1. Pré-Requisitos
Para podermos criar e editar papéis no T6 precisaremos ter algumas Features habilitadas:
- Administrador: Gerenciar a segurança da aplicação (pleno) (multi-app); e Gerenciar Usuários do Sistema
- Gestor: Gerenciar Segurança da Aplicação;
Um usuário só poderá dar permissões em papéis dos quais é proprietário ou tenha permissões.
¶ 2. Funcionalidade
Através dos papéis podemos realizar as seguintes funções:
- Permitir ou restringir a visualização e edição de um contexto dentro de um formulário do cubo (pode se aplicar a um usuário específico, ou, um grupo de usuários);
- Criar, editar e excluir papéis;
- Visualizar os papéis cadastrados na aplicação;
- Definição do tipo de papel;
- Configuração de papel estático ou dinâmico.
¶ 3. Utilização
Para criarmos um novo papel no T6, deveremos seguir os seguintes passos:
- No menu principal do T6 podemos acessar 2 possíveis caminhos;
- Selecionando a opção Explorer;
ou - selecionando a opção Controle de Acesso → Papel;
- Selecionando a opção Explorer;
- Iremos clicar em
na seção Novo na ribbon, ir em Controle de Acesso e selecionar Papel; - Após criar o novo papel, iremos selecioná-lo e clicar em
; - Será aberto um panel na lateral onde iremos configurar o papel;
- Teremos os seguintes campos para preenchimento:
-
Nome: Nome do papel, que será exibido na listagem do explorer;
-
Descrição: Descrição do papel, que será exibida na listagem do explorer;
-
Aplicação: Selecione a aplicação que estará atrelada ao papel;
-
Permissões: Selecione uma entre as opções:
- Permitir Leitura/Escrita: Concede permissão às células definidas nos membros das dimensões as quais desejamos aplicar o papel.
- Negar Leitura/Escrita: Bloqueia a permissão às células definidas nos membros das dimensões as quais desejamos aplicar o papel.
- Permitir Leitura: Concede permissão de leitura às células definidas nos membros das dimensões as quais desejamos aplicar o papel.
- Negar Escrita: Bloqueia permissão de escrita às células definidas nos membros das dimensões as quais desejamos aplicar o papel.
- Processar: Tipo especial de papel que, com base nos parâmetros do processo associados as dimensões da aplicação atual a qual o papel está associado, irá calcular o escopo do papel em tempo de execução, de acordo com as instâncias de processo que o usuário possui no momento.
-
O usuário precisa de um papel para conseguir visualizar os dados dos formulários da aplicação, deveremos ter no mínimo 1 papel dando permissão de leitura e escrita aos usuários que forem utilizar o formulário.
Se usarmos a permissão permitir leitura e escrita e incluir algum membro, o sistema automaticamente dará permissão somente para o membro selecionado, e restringirá todos os demais. Ou seja, se quisermos permitir leitura e escrita, não precisamos informar nenhum membro em nenhuma dimensão, apenas salvar o papel em branco. Depois iremos adicionar outros papeis para restrições.
Se negarmos a leitura e escrita em algum membro específico, automáticamente estaremos liberando os demais membros.
Se não tivermos um papel permitirmos a leitura e escrita na aplicação e permitirmos leitura e escrita em algum membro específico, automáticamente estaremos restringindo a visualização e edição de todos os demais membros.
Papéis de restrição sempre irão sobrepor papéis de permissão.
¶ 3.1. Papéis Estáticos
Em Papéis Estáticos teremos o contexto em forma de tabela, onde iremos selecionar as dimensões e os membros que iremos vincular ao papel;
- Selecione a dimensão clicando em
; - Será aberta uma nova tela no panel: Seleção de Membro, clique em
; - Poderemos selecionar a Hierarquia, caso a dimensão seleciona tenha uma, clicando em
; - Poderemos também selecionar a Agregação, clicando em , serão exibidas as seguintes opções:
Clique para exibir as opções de Agregação.
| Agregação | Descrição |
|---|---|
| Membro | Seleciona somente o membro referência |
| Descendentes | Seleciona todos os descendentes do membro referência |
| Descendentes (inc) | Seleciona todos os descendentes do membro referência, inclusive ele próprio |
| Ancestrais | Seleciona todos os ancestrais do membro referência |
| Anterior | Seleciona o membro diretamente anterior na árvore de membros, no mesmo nível do membro referência |
| Próximo | Seleciona o membro diretamente posterior na árvore de membros, no mesmo nível do membro referência |
| Anterior (Relativo ao Pai) | Seleciona o membro anterior, no mesmo nível e na mesma posição do pai do membro referência |
| Ancestrais (inc) | Seleciona todos os ancestrais do membro referência, inclusive ele próprio |
| Membros mesmo nível | Seleciona todos os membros que estão no mesmo nível do membro referência |
| Membros mesmo nível (inc) | Seleciona todos os membros que estão no mesmo nível do membro referência, inclusive ele próprio |
| Pai Membro | Seleciona o pai do membro referência |
| Próximo (Relativo ao Pai) | Seleciona o próximo membro, no mesmo nível e na mesma posição do pai do membro referência |
| Anterior (Relativo a Raiz) | Seleciona o membro anterior na árvore de membros, no mesmo nível e na mesma posição relativa à raiz da árvore de membros |
| Próximo (Relativo a Raiz) | Seleciona o próximo membro na árvore de membros, no mesmo nível e na mesma posição relativa à raiz da árvore de membros |
| Pai Membro (inc) | Seleciona o pai do membro referência, inclusive ele próprio |
| Filhos Membro | Seleciona os filhos do membro referência |
| Filhos Membro (inc) | Seleciona os filhos do membro referência, inclusive ele próprio |
| Descendentes Sem Filhos | Seleciona todos os descendentes sem filhos (que sejam "folhas") do membro referência |
| Anteriores mesma Raiz (inc) | Seleciona os membros anteriores na árvore de membros, no mesmo nível e na mesma raiz do membro referência |
| Próximos mesma Raiz (inc) | Seleciona os membros posteriores na árvore de membros, no mesmo nível e na mesma raiz do membro referência |
| Anteriores mesma quantidade filhos Raiz (inc) | Seleciona os membros anteriores do membro referência, na mesma raiz e mesma quantidade de membros |
| Dado Membro | Seleciona somente o Dado Membro do membro selecionado |
| Descendentes Dado Membro (inc) | Seleciona todos os Dados Membro descendentes do membro referência, inclusive o Dado Membro dele próprio |
| Excluir Membro | Exclui o membro referência |
| Excluir Dado Membro | Exclui o Dado Membro do membro referência |
| Próximos mesma quantidade filhos Raiz (inc) | Seleciona os membros posteriores do membro referência, na mesma raiz e mesma quantidade de membros |
| Filhos [Words-DataMember] | Seleciona somente os Dados Membro filhos do membro selecionado |
Por padrão a agregação estará como Membro.
- Abaixo das boxes hierarquia e agregação, temos a listagem com os membros disponíveis para seleção;
- Selecione os membros desejados clicando em
; - Os membros selecionados serão exibidos acima das boxes hierarquia e agregação;
- É possível alterar a agregação de um membro já selecionado clicando em
na listagem de membros selecionados; - Após selecionar os membros e a agregação clique em
; - Na tabela de contexto, mencionada anteriormente, agora serão exibidos os membros e a agregação selecionados, conforme exemplo abaixo:
- Após selecionar os membros e agregações desejados, clique em
.
¶ 3.2. Papéis Dinâmicos
Em Papéis Dinâmicos teremos que selecionar uma tabela de dados, serão exibidos os contextos existentes na tabela selecionada, onde iremos selecionar os contextos e as colunas que iremos vincular ao papel;
- Em Tabela vamos selecionar a tabela de dados onde vamos configurar as permissões (o nome da tabela será exibido conforme o banco de dados);
- Os contextos exibidos levam em consideração os contextos configurados na aplicação selecionada;
- As colunas exibidas para seleção vão aparecer conforme as colunas do banco de dados, da tabela selecionada, porém as permissões vinculadas ao papel somente surtirão efeito nas colunas do formulário (as colunas exibidas na interface);
- Escolha o contexto e ao lado a coluna da tabela, clicando em ;
- Após selecionar as colunas nos contextos, clique em .
¶ 3.3. Associação
¶ 3.3.1. Adicionar Usuário
Para associar um papel a um usuário, vamos seguir os seguintes passos:
-
Selecione o papel que deseja associar e clique em
; -
Será aberto um panel na lateral, onde vamos selecionar Usuários;
- Usuários: Podemos, a partir do papel criado, selecionar quais usuários terão as permissões contidas no papel;
- Clique em
e serão exibidos os usuários disponíveis para seleção; - Marque a checkbox exibida ao lado do nome do usuário que deseja associar;
- Clique em
;
-
Após selecionar quais usuários serão associados ao papel, clique em
novamente; -
Para finalizar, clique em
.
¶ 3.3.2. Remover Usuário
Para remover usuários de um papel, vamos seguir os seguintes passos:
-
Selecione o papel do qual deseja remover usuários e clique em
; -
Será aberto um panel na lateral, onde vamos selecionar Usuários;
- Usuários: Teremos a listagem de usuários que estão associados ao papel;
- Clique em , onde os usuários associados ao papel estarão com a checkbox habilitada;
- Desmarque a checkbox exibida ao lado do nome do usuário que deseja remover do papel;
- Clique em ;
-
Após selecionar quais usuários serão removidos do papel, clique em
novamente; -
Para finalizar, clique em
.
Somente serão exibidos na listagem, usuários que tenham permissão na aplicação selecionada no papel e usuários que o usuário logado tenha permissão de visualização.
¶ 3.3.3. Adicionar Grupo
Para associar um papel a um grupo, vamos seguir os seguintes passos:
-
Selecione o papel que deseja associar e clique em
; -
Será aberto um panel na lateral, onde vamos selecionar Grupos;
- Grupos: Podemos, a partir do papel criado, selecionar quais grupos terão as permissões contidas no papel;
- clique em e serão exibidos os grupos disponíveis para seleção;
- Marque a checkbox exibida ao lado do nome do grupo que deseja associar;
- Clique em ;
-
Após selecionar quais grupos serão associados ao papel, clique em
novamente; -
Para finalizar, clique em
.
¶ 3.3.4. Remover Grupo
Para remover grupos de um papel, vamos seguir os seguintes passos:
-
Selecione o papel do qual deseja remover grupos e clique em
; -
Será aberto um panel na lateral, onde vamos selecionar Grupos;
- Grupos: Teremos a listagem de grupos que estão associados ao papel;
- Clique em , onde os grupos associados ao papel estarão com a checkbox habilitada;
- Desmarque a checkbox exibida ao lado do nome do grupo que deseja remover do papel;
- Clique em ;
-
Após selecionar quais grupos serão removidos do papel, clique em
novamente; -
Para finalizar, clique em
.
¶ 4. Q&A
Perguntas Frequentes
1. O que são Papéis no T6?
Papéis são utilizados para restringir ou permitir o acesso em determinados contextos do cubo, definindo se o usuário terá acesso à leitura e escrita, ou somente leitura, dentro dos formulários.
2. Quais funcionalidades preciso ter habilitadas para criar papéis?
Para criar e editar papéis, o usuário precisa ter as seguintes funcionalidades habilitadas:
De Administrador: Gerenciar a segurança da aplicação (pleno) (multi-app) e Gerenciar Usuários do Sistema.
De Gestor: Gerenciar Segurança da Aplicação.
3. Qual o impacto no desempenho ao usar Papéis?
Quanto maiores forem as restrições definidas nos papéis, maior será o tempo de carregamento dos formulários, por isso devem ser usados com cautela.
4. Posso dar permissões em qualquer papel?
Não, um usuário só poderá dar permissões em papéis dos quais é proprietário ou tenha permissões para tal.
5. Quais tipos de permissões posso configurar nos papéis?
Existem 5 tipos de permissões que podem ser configuradas nos papéis:
- Permitir Leitura/Escrita;
- Negar Leitura/Escrita;
- Permitir Leitura;
- Negar Escrita;
- Processar (tipo especial que calcula o escopo em tempo de execução).
6. Como funciona a permissão "Permitir Leitura e Escrita" nos papéis?
A permissão Permitir Leitura e Escrita nos papéis funciona da seguinte maneira:
Caso seja incluído algum membro, o sistema automaticamente dará permissão somente para o membro selecionado e restringirá todos os demais.
Para permitir tudo, não informe nenhum membro em nenhuma dimensão.
7. O que acontece quando uso "Negar Leitura e Escrita" nos papéis?
Quando um papel usa a permissão Negar Leitura e Escrita em algum membro específico, automaticamente estará bloqueando o acesso a esse membro, mas liberando todos os demais.
8. O que acontece quando há conflito entre papéis de permissão e restrição?
Quando há conflito entre papéis de permissão e restrição, os Papéis de Restrição sempre irão sobrepor papéis de permissão.
9. Qual a diferença entre Papéis Estáticos e Dinâmicos?
A diferença entre os dois tipos de papéis é a forma como o contexto é selecionado.
Papéis Estáticos usam contexto em forma de tabela onde você seleciona dimensões e membros;
Papéis Dinâmicos usam uma tabela de dados onde você seleciona contextos e colunas da tabela.
10. Quais opções de agregação estão disponíveis nos papéis estáticos?
Existem mais de 20 opções de agregação disponíveis para seleção nos papéis estáticos. Abaixo estão listadas todas as opções:
| Agregação | Agregação | Agregação | Agregação |
|---|---|---|---|
| Membro | Descendentes | Descendentes(inc) | Ancestrais |
| Anterior | Próximo | Anterior(relativo ao pai) | Ancestrais(inc) |
| Membros mesmo nível | Membros mesmo nível(inc) | Pai membro | Próximo(relativo ao pai) |
| Anterior(relativo a raiz) | Próximo(relativo a raiz) | Pai membro(inc) | Filhos membro |
| Filhos membro(inc) | Descendentes sem filhos | Anteriores mesma raiz(inc) | Próximos mesma raiz(inc) |
| Anteriores mesma quantidade filhos raiz(inc) | Dado membro | Descendentes dado membro(inc) | Excluir membro |
| Excluir dado membro | Próximo mesma quantidade filhos raiz(inc) | Filhos dado membro |
11. Como associo usuários a um papel?
Para associar usuários a um papel o papel já deve existir. Siga os passos abaixo:
- Acesse o Explorer e selecione o papel desejado;
- Clique em Permissões na ribbon;
- No painel lateral, selecione a aba Usuários;
- Clique em Gerenciar;
- Marque os usuários desejados;
- Clique em Aplicar;
- Clique em Salvar.
12. Posso associar grupos aos papéis?
Sim, porém para adicionar grupos aos papéis o papel já deve existir. Siga os passos abaixo:
- Acesse o Explorer e selecione o papel desejado;
- Clique em Permissões na ribbon;
- Vá em Grupos no painel lateral;
- Clique em Gerenciar;
- Marque os grupos desejados;
- Clique em Aplicar;
- Clique em Salvar.
13. Como crio um novo papel?
Para criar um novo papel, siga os passos abaixo:
- No menu principal do T6, acesse o Explorer;
- Clique em Novo Item na ribbon, na seção Controle de Acesso, selecione Papel.
- Preencha Nome do papel.
- Selecione a Aplicação.
- Defina as Permissões.
- Configure o papel como Estático ou Dinâmico, selecionando os membros em cada dimensão.
- Clique em Salvar.
Após criar o papel, será possível associar usuários e/ou grupos a ele.