Integrar o Lucid com o Confluence Data Center

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

Somente o Proprietário da conta ou Administrador de conta em uma conta Equipe ou Corporativo pode 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 Encontrar novas extensões.
5. Pesquise “Lucidchart” ou “Lucidspark” no marketplace da Atlassian. 
6. Clique no blocoConector do diagramaLucidchart ou no blocoConector dos muraisLucidspark .
7. Selecione Obter agora no canto superior direito.
8. Se estiver instalando o aplicativo Lucidchart, clique em " Obter agora" em "Central de dados" 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 acesso ao Confluence à Lucid.
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 do Lucid.

Para configurar o aplicativo Lucidchart para Confluence Data Center em seu ambiente Lucidchart for Gov, navegue até <baseUrl>/Administrador/plugin/Lucidchart/environmentconfig.action, onde <baseUrl> é a URL base da sua instância 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 Lucidchart ou Adicionar mural 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 prosseguir para a próxima etapa. Clique em "Repositórios" na barra de navegação à esquerda e selecione o repositório específico.
5. Passe o cursor sobre o documento que deseja adicionar e clique em Selecionar. 
   • Você também pode criar um 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 painéis Lucidspark diretamente da página do Confluence

Ao incorporar um mural Lucidspark no Confluence Data Center, você 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 quadro Lucidspark incorporado.
• Somente comentários: os usuários do Confluence podem visualizar e comentar no quadro incorporado do Lucidspark.
• Editar: Os usuários do Confluence podem editar o quadro Lucidspark incorporado. 

Editar um quadro Lucidspark diretamente no Confluence fornecerá uma ampla variedade de opções, como adicionar formas e linhas ou participar de uma Visual Activity. Se você é novo no Lucidspark e está interessado em aprender como trabalhar com uma variedade de recursos disponíveis, confira nosso artigo Bem-vindo ao Lucidspark .

Edite um documento Lucidchart abrindo-o no Lucid

Se você tiver acesso de edição a uma página do Confluence com 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 quadro 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 do 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 seu diagrama Draw.io em um documento 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.

Migre do Confluence Data Center para o Confluence Cloud.

Antes de migrar do Confluence Data Center para o Confluence Cloud, tenha em mente o seguinte: 

• documento são convertidos por espaço, não por página.
• Essa migração não pode ser desfeita em massa sem restaurar um backup anterior da instância do Confluence.
• A conversão pode ser desfeita para cada documento individualmente, navegando até o documento e restaurando a página a partir do histórico de páginas.

Se estiver migrando do Confluence Data Center para o Confluence Cloud para seu aplicativo Lucidchart , siga os passos abaixo para redefinir seus documentos e exibi-los novamente:

1. Acesse a seção de configuração da Extensão.
2. Selecione o guia “Conversão Confluence ”.
3. Clique em Pesquisar para localizar os diagramas que precisam ser convertidos.
4. Selecione Converter.

Após migrar seu documento, confira nosso artigoIntegrar Lucid com Confluence Cloud para obter instruções sobre como usar essa integração.

Perguntas frequentes

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

O aplicativo Lucidspark 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 Confluence e for um usuário licenciado Lucid , poderá visualizar e editar o diagrama no aplicativo Lucid clicando 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 no Lucid ao usar a 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 informações 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 tempo limite do OAuth ao tentar instalar um aplicativo Lucidchart para o Confluence Data Center?
Se você vir o seguinte erro de carimbo de data/hora 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 um erro "Você não está em uma equipe associada a essa instância"?
Este erro significa que o usuário provavelmente está conectado a uma conta incorreta da Lucid. Para corrigir:

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 esquerdo.
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 Confluence em toda a conta se o administrador que a configurou inicialmente sair da empresa?
Se o administrador sair da conta, a conexão permanecerá ativa, pois foi estabelecida no nível da conta. As permissões de administrador são necessárias apenas durante o processo de configuração inicial para criar a conexão.
 

Dar feedback sobre este artigo