Integração da Lucid com o Confluence Data Center

Para administradores: instruções de instalação e configuração

Somente o proprietário da conta ou os administradores de uma conta Equipe ou Corporativo podem instalar e configurar o aplicativo Lucidchart no Confluence Data Center ou o aplicativo Lucidspark no Confluence Data Center.
Siga estas instruções de instalação:

1. Faça login como administrador em sua instância do Confluence.
2. Abra o menu Administrativo.
3. Clique em Extensões na barra lateral esquerda.
4. Selecione Localizar novas extensões.
5. Pesquise “Lucidchart” ou “Lucidspark” no marketplace da Atlassian. 
6. Clique no bloco Conector de diagramas do Lucidchart ou no bloco Conector de murais do Lucidspark.
7. Selecione Obter agora no canto superior direito.
8. Se estiver instalando o aplicativo Lucidchart, clique em Obter agora em Data Center na janela pop-up.

O aplicativo será baixado no seu dispositivo local. 

Siga estas instruções no aplicativo baixado para configurá-lo para sua instância:

1. Clique em Gerenciar e Configurar para conceder ao Lucid acesso ao Confluence.
2. Faça login na sua conta do Lucid se ainda não estiver conectado.
3. Selecione Vincular conta para conectar sua instância do Confluence à sua conta da Lucid.

Para configurar o aplicativo Lucidchart para o Confluence Data Center para seu ambiente Lucidchart for Gov, navegue até <baseUrl>/admin/plugins/lucidchart/environmentconfig.action, onde <baseUrl> é a URL base de sua instância do Confluence, e selecione lucidgov.app no menu suspenso.

Adicionar um documento a uma página do Confluence

Para adicionar um diagrama do Lucidchart ou mural do Lucidspark a uma página do Confluence:

1. Crie uma página do Confluence ou abra uma já existente. 
2. Clique em Editar na parte superior da página.
3. Clique em + no menu na parte superior da página. 
4. Selecione Adicionar diagrama do Lucidchart ou Adicionar mural do Lucidspark. 
   • Se você não encontrar essa opção, fale com o administrador da sua conta do Lucidchart e solicite que instale e configure o aplicativo Lucid apropriado para sua instância do Confluence.
   • Se o documento que você está adicionando estiver em um repositório, você precisa abrir esse repositório antes de avançar para a próxima etapa. Clique em Repositórios no menu de navegação à esquerda e selecione o repositório específico.
5. Passe o cursor sobre o documento que você deseja adicionar e clique em Selecionar. 
   • Você também pode criar um novo documento clicando em + Documento no canto superior esquerdo.
6. Depois de selecionado, o documento será carregado em sua página do Confluence.
7. Clique em Atualizar no canto inferior direito da página do Confluence para publicar o documento.

Depois de publicado, todos que tiverem permissões para essa página poderão visualizar o documento.

Gerenciar documentos incorporados

Editar murais do Lucidspark diretamente da página do Confluence

Quando você incorpora um mural do Lucidspark no Confluence Data Center, pode escolher entre as seguintes configurações de acesso que estarão disponíveis diretamente no Confluence:

• Somente visualização: os usuários do Confluence podem visualizar somente o mural incorporado do Lucidspark.
• Somente comentários: os usuários do Confluence podem visualizar e comentar no mural incorporado do Lucidspark.
• Edição: os usuários do Confluence podem editar o mural incorporado do Lucidspark. 

A edição de um mural do Lucidspark diretamente no Confluence oferece uma ampla variedade de opções, como adicionar formas e linhas ou participar de uma atividade visual. Se você é novo no Lucidspark e está interessado em aprender a trabalhar com uma variedade de recursos disponíveis, consulte nosso artigo Bem-vindo ao Lucidspark.

Editar um documento do Lucidchart abrindo-o na Lucid

Se você tiver acesso de edição a uma página do Confluence que tenha documentos do Lucidchart inseridos, poderá editar os documentos no Lucid e enviar as alterações de volta ao Confluence.

Para editar um documento que já foi adicionado a uma página do Confluence:

1. Na página publicada do Confluence, passe o cursor sobre o diagrama do Lucidchart ou mural do Lucidspark inserido. 
2. Clique em Abrir com Lucidchart.
   • Se você estiver no modo de edição na página do Confluence, clique no documento inserido e selecione Editar na barra de opções que aparece abaixo do diagrama.
3. O documento será aberto no editor do Lucid, e então você poderá fazer alterações nele.
4. Quando terminar, clique em Voltar ao Confluence no canto superior esquerdo do editor do Lucid.
   • As alterações serão sincronizadas automaticamente com o documento incorporado no Confluence.
5. Clique em Atualizar no canto inferior direito da página do Confluence para publicar suas alterações.

Excluir um documento de uma página do Confluence

Para excluir um documento que já foi adicionado a uma página do Confluence:

1. Clique em Editar na parte superior da página do Confluence.
2. Selecione o documento inserido.
3. Clique em Remover na barra de opções que aparece abaixo do documento.
4. Clique em Atualizar no canto inferior direito da página do Confluence para publicar suas alterações.

Ajustar as propriedades de exibição do diagrama

Para acessar as propriedades de exibição de um documento inserido:

1. Clique em Editar na parte superior da página do Confluence.
2. Selecione o documento. 
3. Clique em Propriedades na barra de opções que aparece abaixo do documento para abrir o modal de propriedades de exibição.
4. Clique em Salvar depois de fazer qualquer alteração nas propriedades de exibição.

Nesse modal, você pode ver as seguintes configurações, dependendo de qual aplicativo Lucid você está usando:

• Ajustar a largura e a altura do documento inserido.
• Ativar ou desativar o dimensionamento automático.
• Ajustar o alinhamento dos diagramas exibidos na página do Confluence.
• Para documentos do Lucidchart, determinar quais páginas estão disponíveis para os visualizadores da página do Confluence (por exemplo, 3 ou 2-3). 
  • A seleção de uma página ou intervalo de páginas só é possível se você estiver usando o visualizador avançado. 
• Alternar entre os visualizadores avançado e simples.
• Ativar a atualização automática para quando os documentos forem atualizados no Lucid. 
  • A ativação da atualização automática só é possível se você estiver usando o visualizador avançado.

Visualizadores simples e avançado

Há dois visualizadores disponíveis para exibir documentos da Lucid no Confluence Data Center: simples e avançado.

Você pode alternar entre os visualizadores simples e avançado em um documento específico no modal de configurações de macro.

Visualizador simples

O visualizador simples é hospedado em servidores Confluence e apresenta um PNG estático do documento. 

Ao passar o cursor sobre o documento, o visualizador simples permite que os visualizadores executem as seguintes ações:

• Edite o diagrama no Lucid
• Remover o diagrama da página do Confluence
• Alternar para o visualizador avançado
• Atualizar para a versão mais recente do documento Lucid
• Ampliar e reduzir o zoom do diagrama

Se o documento inserido contiver várias páginas, você pode passar de uma para outra clicando nas setas que aparecem na lateral do visualizador quando você passa o cursor sobre o documento.

Visualizador avançado

O visualizador avançado está hospedado em servidores Lucid e requer acesso à Internet para ser executado. Ele possibilita total interatividade com os documentos do Lucid. 

Um quadro aparecerá ao passar o cursor sobre os documentos exibidos com o visualizador avançado. 

Na parte superior do quadro, os usuários podem:

• Abrir o documento Lucid em uma nova aba do navegador
• Ver título do documento
• Apresentar todos os slides que foram criados no documento
• Entrar no modo de tela cheia
• Abrir o modal de opções do visualizador
  • Esse modal para o aplicativo Lucidchart tem a capacidade de mostrar anotações, pontos de interação, habilitar o WebGL e atualizar para a versão mais recente do diagrama

Na parte inferior do quadro, os usuários podem: 

• Selecionar diferentes abas de página para visualizar no documento do Lucidchart
• Visualizar o diagrama em diferentes camadas no documento do Lucidchart
• Ampliar e reduzir o zoom do diagrama

Converter seus diagramas do Draw.io em documentos do Lucidchart

Para converter seus diagramas do Draw.io em documentos do Lucidchart no Confluence Data Center, siga estas etapas:

1. Navegue até a página que contém os documentos que você deseja converter.
2. Abra o arquivo no Draw.io e baixe-o como arquivo XML.
3. Entre no modo de edição na página do Confluence.
4. Usando o ícone de adição na barra de ferramentas na parte superior do editor, selecione Lucidchart no menu suspenso para inserir um novo documento.
5. Depois de abrir o editor do Lucidchart, você pode importar o diagrama pelo menu de importação.
6. Selecione o documento importado na lista de documentos e ele será adicionado à sua página do Confluence. Nesse ponto, você será redirecionado de volta ao Confluence.
7. A conversão foi concluída, e você poderá excluir seu diagrama original do Draw.io da sua página do Confluence.

Migrar do Confluence Data Center para o Confluence Cloud

Tenha em mente o seguinte antes de migrar do Confluence Data Center para o Confluence Cloud: 

• Os documentos são convertidos por espaço, não por página.
• Não é possível desfazer essa migração em massa sem restaurar um backup anterior da instância do Confluence.
• A conversão pode ser desfeita por documento acessando o documento e restaurando a página a partir do histórico de páginas.

Se você estiver migrando do Confluence Data Center para o Confluence Cloud no seu aplicativo do Lucidchart, siga as etapas abaixo para redefinir seus documentos para que voltem a ser exibidos:

1. Navegue até a seção de configuração da extensão Lucidchart.
2. Selecione a guia “Conversão do Confluence”.
3. Clique em Pesquisar para localizar diagramas que precisam ser convertidos.
4. Selecione Converter.

Depois de migrar seus documentos, confira nosso artigo Integração do Lucid com o Confluence Cloud para obter instruções sobre como usar essa integração.

Perguntas frequentes

Quem pode visualizar e editar documentos da Lucid incorporados a uma página do Confluence?
As permissões de visualização de documentos da Lucid no Confluence Data Center serão herdadas da página do Confluence. Isso significa que, se você puder visualizar uma página do Confluence, poderá visualizar os documentos na página do Confluence, independentemente de ter ou não uma conta da Lucid. 

O aplicativo Lucidchart no Confluence também extrai permissões de edição da página do Confluence. Isso significa que, se você puder visualizar e editar uma página do Confluence e for um usuário licenciado da Lucid, poderá visualizar e editar os diagramas no aplicativo Lucid ao clicar no botão Abrir no Lucidchart em cada documento.

O aplicativo Lucidspark no Confluence requer que você tenha acesso de edição no Confluence e acesso de edição no mural do Lucidspark incorporado para editar o documento no Confluence.

Por que estou preso em um loop de login ao tentar acessar a integração?
Se você passar por um loop de login, que solicita continuamente que você faça login na Lucid ao usar esta integração, é mais provável que cookies de terceiros estejam bloqueados em seu navegador. Consulte nosso artigo Resolução de problemas: habilitar cookies de terceiros para obter detalhes sobre como alterar essa configuração para que eles não sejam mais bloqueados. 

Por que estou vendo margens brancas ao redor dos meus diagramas Lucid incorporados no Confluence?
Espaços em branco ao redor do documento podem ser normais quando diagramas são inseridos no Confluence. Consulte esta postagem da comunidade sobre Espaço em branco em diagramas inseridos (em inglês) para obter instruções sobre como otimizar a aparência de seus documentos incorporados.

Por que estou vendo um erro de data e hora do OAuth ao tentar instalar um aplicativo Lucidchart para o Confluence Data Center?
Caso encontre o seguinte erro de timestamp OAuth ao tentar instalar e configurar o conector Lucidchart Confluence Data Center,

“org.scribe.exceptions.OAuthException: Response body is incorrect. Can't extract token and secret from this: 'oauth_problem=expired_timestamp,_yours_1359614629,_ours_1359585813'”,

provavelmente o timestamp no seu servidor de hospedagem do Confluence não está correto. Mesmo que seu servidor pareça estar correto, uma discrepância de 15 a 30 segundos pode resultar em dois servidores que não se comunicam. Não é possível ajustar manualmente a hora do servidor com precisão adequada, portanto, será necessário sincronizar seu timestamp com um servidor NTP.

Por que estou recebendo a mensagem de erro “Você não faz parte de uma equipe associada a esta instância”?
Esse erro significa que o usuário provavelmente está conectado a uma conta da Lucid incorreta. Para corrigir isso, siga estas etapas:

1. Faça o login em sua conta Lucid atualmente vinculada ao Confluence de forma incorreta. 
2. Clique nas iniciais ou na imagem de perfil no canto superior direito da sua conta Lucid.
3. Selecione Configurações da conta.
4. Selecione Aplicativos e integrações no menu à esquerda.
5. Marque a caixa ao lado de "Confluence".
6. Clique no botão Remover. Isto desvinculará a conta.
7. Para restabelecer a conexão correta, saia do Lucid. 
8. Insira qualquer documento do Lucid em uma página do Confluence. 
9. No momento de fazer login no Lucid, certifique-se de informar o e-mail associado à conta Lucid de sua organização.

O que acontece com a conexão do Confluence para toda a conta se o administrador que a configurou inicialmente sair?
Se o administrador sair, a conexão permanece ativa, pois é estabelecida no nível da conta. As permissões de administrador só são necessárias durante o processo de configuração inicial para criar a conexão.
 

Dar feedback sobre este artigo