Guides

Disponibilize publicamente guias, referências e qualquer outro documento em seu portal utilizando Guides.

Guides funciona como uma plataforma de desenvolvimento de sites, permitindo que você crie livremente conteúdos que façam sentido para você e seus parceiros.

Criando uma nova página

Siga os passos abaixo para criar uma nova página de Guides para o seu portal.

Clique em + ao lado de Pages.
Você também pode criar páginas em hierarquia. Clique em + ao lado do nome de uma página existente e a nova página ficará abaixo dela (página filha).
Informe o nome da página. Este campo é obrigatório.
Selecione o papel (role) que o usuário deverá ter para visualizar e acessar o guia. Este campo é obrigatório. Leia sobre atribuição de papéis (roles).
Crie o conteúdo da nova página no campo abaixo da barra de ferramentas.
O texto deve ter no mínimo 3 caracteres e tamanho máximo de 5 MB.
Clique em SAVE para salvar as alterações ou em BACK para voltar.
Se você voltar sem salvar, as alterações serão perdidas.
Habilite Publish page para que as alterações sejam publicadas.
Os passos 5 e 6 não são obrigatórios. Você pode publicar a página em outro momento.
Clique em para copiar o link para a página criada.

Identifique quais páginas ainda não foram publicadas buscando por imagem de uma nuvem com um risco em diagonal em cima dela ao lado do nome da página.

Enquanto Public page estiver habilitada, sua página ficará publicada. As atualizações feitas e salvas serão aplicadas a cada vez que você clicar em SAVE, sem necessidade de publicar novamente.

É possível alterar a ordem e a hierarquia das páginas facilmente. Basta clicar e arrastar, movendo a página para onde desejar.

Atribuição de papéis (roles)

A atribuição de papéis permite controlar de forma precisa quem pode visualizar e acessar cada guia. Com esse recurso, administradores definem permissões específicas, garantindo que os usuários vejam apenas o conteúdo relevante para suas funções.

Principais vantagens:

Maior proteção para informações sensíveis e configurações do sistema.
Personalização granular de permissões conforme as necessidades de cada grupo.
Controle eficiente sobre a disponibilidade do conteúdo, seja público ou restrito.

Os papéis são configurados durante a criação/edição de um guia no Portal Manager.

Há dois papéis pré-definidos no sistema:

Authenticated: papel padrão (default role), que permite o acesso ao guia somente por usuários autenticados.
Public: papel que permite o acesso ao guia por qualquer usuário, incluindo não autenticados (sem necessidade de login).

Você pode ainda criar papéis customizados definindo permissões dedicadas para o consumo de diferentes públicos (internos, parceiros, clientes, etc.).

Para criar um papel customizado, siga os passos abaixo:

Acesse a tela Settings pelo menu lateral esquerdo.
Selecione a aba Roles na parte superior da tela.
Clique em + NEW ROLE para criar um novo papel.

Consulte a documentação sobre a criação de novos papéis.

Papéis customizados exigem autenticação do usuário.
É possível associar um ou mais papéis a cada guia.
Guias com o papel "public" ficam visíveis para todos os usuários, incluindo não autenticados. Essa visibilidade se estende automaticamente a todos os sub-guias.
Guias com papéis diferentes de "public" ficam visíveis apenas para usuários autenticados que possuam pelo menos um dos papéis configurados. Essa restrição se aplica tanto ao guia quanto aos seus sub-guias.
Usuários que não possuam nenhum dos papéis configurados não conseguirão visualizar o guia nem seus sub-guias.

Como funciona a herança de papéis e visibilidade entre guias

Subguias herdam automaticamente a visibilidade do guia principal e, por isso, não exibem a opção de configuração de papéis.
Ao mover um guia principal para dentro de outro guia, ele se torna um subguia e passa a usar automaticamente os papéis do novo guia pai.
Ao mover um subguia para outro guia principal, ele assume automaticamente os papéis do novo pai.
Ao transformar um subguia em guia principal, ele mantém os papéis anteriores, evitando liberar acesso indevido a usuários sem permissão.

Editando uma página

Independente da página estar publicada ou não, você pode sempre editá-la.

Clique no nome da página e, em seguida, clique em EDIT.

Deletando uma página

Para deletar uma página, clique no nome da página e, em seguida, clique em .

Alternativamente, você pode apenas tirar a publicação do ar. Para isso, clique no nome da página e, em seguida, desabilite Publish page.

Barra de Ferramentas

A barra de ferramentas dá acesso a diversos comandos para personalização e formatação da sua página.

imagem com a barra de ferramentas

Comando

Descrição

Estilo do parágrafo

caixa para escolha do estilo do parágrafo

Aplica uma das formatações: parágrafo simples, título 1, 2 ou 3 em um bloco de texto.

Código fonte

icone indicando código fonte mais a palavra Source

Permite ver ou editar o conteúdo da página em código fonte.

Negrito

letra B maiúscula em negrito

Coloca o texto em negrito. O atalho CTRL+B também pode ser usado.

Itálico

letra I maiúsucla em itálico

Coloca o texto em itálico. O atalho CTRL+I também pode ser usado.

Tachado

letra S tachada

Deixa o texto tachado (com um risco em cima do texto)

Código

sinal de menor e maior

Formata texto para indicar trecho com código: altera fonte para courier new e fundo para cinza. Selecione o trecho que deseja colocar nessa formatação.

Bloco de código

sinal de menor e maior no canto inferior de uma página com identações

Formata parágrafo para indicar trecho com código: altera fonte para courier new e cria uma área retangular com fundo cinza e indicação da linguagem do código. Selecione a linguagem no menu dropdown

Link

icone para link