Integra Lucid con Confluence Data Center

Escrito por:  Shanna S
Última actualización:  

La integración con Confluence Data Center te permitirá importar tus documentos de Lucidchart y pizarras de Lucidspark a Confluence Data Center. Sigue leyendo para obtener instrucciones sobre cómo instalar, configurar y usar esta integración.

Disponibilidad de planes: Equipo y Corporativo.
  • Disponible en cuentas de FedRAMP. Para los usuarios de FedRAMP en el entorno de Lucidchart for Gov, solo está disponible la integración de la aplicación de Lucidchart para Confluence Data Center.
  • Consulta el artículo Planes de Lucid para obtener más información sobre lo que está disponible en tu cuenta o el artículo Actualiza tu cuenta de Lucid para obtener instrucciones para actualizar.

Para administradores: instrucciones de instalación y configuración

Solo el dueño de la cuenta o los administradores de la cuenta de una cuenta Equipo o Corporativo pueden instalar y configurar la aplicación Lucidchart en Confluence Data Center o la aplicación Lucidspark en Confluence Data Center.
Sigue estas instrucciones de instalación:

  1. Inicia sesión en tu instancia Confluence como administrador.
  2. Abre el menú administrativo.
  3. Haz clic en Complementos en la barra lateral izquierda.
  4. Selecciona Buscar nuevos complementos.
  5. Busca "Lucidchart" o "Lucidspark" en el Marketplace de Atlassian. 
  6. Haz clic en el mosaico Conector de diagramas de Lucidchart o en el mosaico Conector de pizarras de Lucidspark.
  7. Selecciona Descargar ahora en la esquina superior derecha.
  8. Si instalas la aplicación Lucidchart, haz clic en Descargar ahora bajo Data Center en la ventana emergente.

La aplicación se descargará en tu dispositivo local. 

Desde la aplicación descargada, sigue estos pasos para configurarla en tu instancia:

  1. Haz clic en Administrar y Configurar para otorgarle a Lucid acceso a Confluence.
  2. Inicia sesión en tu cuenta de Lucid si aún no lo has hecho.
  3. Selecciona Vincular cuenta para conectar tu instancia Confluence a tu cuenta de Lucid.

Para configurar la aplicación Lucidchart para Confluence Data Center en tu entorno Lucidchart for Gov, ve a <baseUrl>/admin/plugins/lucidchart/environmentconfig.action (donde <baseUrl> es la URL base de tu instancia Confluence) y selecciona lucidgov.app en el menú desplegable.

lucidchart-environment-configuration-options-for-eu-data-center-or-lucid-govsuite.png

Agrega un documento a una página de Confluence

Para agregar un diagrama de Lucidchart o un tablero de Lucidspark a una página de Confluence, sigue estos pasos:

  1. Crea una página de Confluence o abre una existente. 
  2. Haz clic en Editar en la parte superior de la página.
  3. Haz clic en + en el menú de la parte superior de la página. 
  4. Selecciona Agregar diagrama de Lucidchart o Agregar tablero de Lucidspark
    • Si no ves esta opción, comunícate con el administrador de tu cuenta de Lucidchart y pídele que instale y configure la aplicación de Lucid adecuada para tu instancia Confluence.
    • Si el documento que estás agregando está en un repositorio, debes abrir ese repositorio antes de pasar al siguiente paso. Haz clic en Repositorios en la navegación de la izquierda y luego selecciona el repositorio específico.
  5. Pasa el cursor sobre el documento que quieres agregar y haz clic en Seleccionar
    • También puedes crear un nuevo documento haciendo clic en + Documento en la esquina superior izquierda.
  6. Una vez seleccionado, el documento se cargará en tu página de Confluence.
  7. Haz clic en Actualizar en la esquina inferior derecha de la página de Confluence para publicar el documento.

Una vez publicado el documento, todos los que tengan permisos para esa página podrán verlo.

Administra los documentos incrustados

Editar pizarras de Lucidspark directamente desde la página de Confluence

Cuando incrustas una pizarra de Lucidspark en Confluence Data Center, puedes elegir entre las siguientes configuraciones de acceso que estarán disponibles directamente en Confluence:

  • Solo vista: los usuarios de Confluence solo pueden ver la pizarra de Lucidspark integrado.
  • Solo comentarios: los usuarios de Confluence pueden ver y comentar en la Pizarra integrada de Lucidspark.
  • Editar: los usuarios de Confluence pueden editar la pizarra de Lucidspark integrado. 

Editar una pizarra de Lucidspark directamente en Confluence te proporcionará una amplia variedad de opciones, como agregar figuras y líneas o participar en una actividad visual. Si no tienes experiencia con Lucidspark y te interesa aprender a trabajar con una variedad de funciones disponibles para ti, explora nuestro artículo Te damos la bienvenida a Lucidspark.

edit-lucidspark-board-directly-on-confluence-page.png

Abrir un documento de Lucidchart en Lucid para editarlo

Si tienes acceso de edición a una página de Confluence con documentos de Lucidchart insertados, puedes editar los documentos en Lucid y enviar los cambios a Confluence.

Para editar un documento que ya se ha agregado a una página de Confluence, sigue estos pasos:

  1. En la página de Confluence publicada, pasa el cursor sobre el diagrama de Lucidchart o el tablero de Lucidspark insertado. 
  2. Haz clic en Abrir con Lucidchart.
    • Si estás en modo de edición en la página de Confluence, haz clic en el documento insertado y selecciona Editar en la barra de opciones que aparece debajo del diagrama.
  3. El documento se abrirá en el editor de Lucid y podrás hacer cambios en él.
  4. Cuando termines, haz clic en Volver a Confluence en la esquina superior izquierda del editor de Lucid.
    • Los cambios se sincronizarán automáticamente con el documento incrustado en Confluence.
  5. Haz clic en Actualizar en la parte inferior derecha de la página de Confluence para publicar tus cambios.

Elimina un documento de una página de Confluence

Para eliminar un documento que ya se ha agregado a una página de Confluence, sigue estos pasos:

  1. Haz clic en Editar en la parte superior de la página de Confluence.
  2. Selecciona el documento insertado.
  3. Haz clic en Eliminar en la barra de opciones que aparece debajo del documento.
  4. Haz clic en Actualizar en la parte inferior derecha de la página de Confluence para publicar tus cambios.

Ajusta las propiedades de visualización de un diagrama

Para acceder a las propiedades de visualización de un documento insertado:

  1. Haz clic en Editar en la parte superior de la página de Confluence.
  2. Selecciona el documento. 
  3. Haz clic en Propiedades en la barra de opciones que aparece debajo del documento para abrir la ventana modal de propiedades de visualización.
  4. Haz clic en Guardar después de realizar cualquier cambio en las propiedades de visualización.

diagram-properties-modal-in-confluence-to-adjust-Lucid-document.png

En esta ventana modal, es posible que veas la siguiente configuración, según la aplicación de Lucid que estés usando:

  • Ajustar el ancho y el alto del documento insertado.
  • Activar o desactivar el tamaño automático.
  • Ajustar la alineación de los diagramas que se muestran en la página de Confluence.
  • Para los documentos de Lucidchart, elegir qué páginas están disponibles para los lectores de la página de Confluence (por ejemplo, 3 o 2 a 3). 
    • Seleccionar una página o un rango de páginas solo es posible si estás usando el visor completo. 
  • Cambiar entre el visor simple y el completo.
  • Habilitar la actualización automática cuando los documentos se actualizan en Lucid. 
    • Habilitar la actualización automática solo es posible si estás usando el visor completo.

Nota: Solo es posible habilitar la actualización automática en un documento individual. Esta función te permite insertar automáticamente los cambios hechos en el editor de Lucid a los diagramas que se muestran en Confluence.

Visor simple y visor completo

Hay dos visores disponibles para mostrar documentos de Lucid en Confluence Data Center: el simple y el completo.

Puedes cambiar entre ellos en un documento específico a través de la ventana modal de configuración macro.

Visor simple

El visor simple está hospedado en los servidores de Confluence y proporciona un archivo PNG estático del documento. 

simple-viewer-in-confluence-displaying-static-PNG.png

Al pasar el cursor sobre el documento, el visor simple les permite a los lectores realizar las siguientes acciones:

  • Editar el diagrama en Lucid
  • Eliminar el diagrama de la página de Confluence
  • Cambiar al visor completo
  • Actualizar a la última versión del documento de Lucid
  • Acercar y alejar el diagrama

Si el documento insertado contiene varias páginas, puedes alternar entre ellas haciendo clic en la flecha correspondiente que aparece al costado del visor cuando pasas el cursor sobre el documento.

Nota: No es posible elegir qué páginas del documento de Lucidchart están disponibles para los lectores cuando usan el visor simple. Tienes que usar el visor completo para acceder a esa funcionalidad.

Visor completo

El visor completo está alojado en servidores de Lucid y requiere acceso a Internet para funcionar. Proporciona una interactividad completa con los documentos de Lucid. 

rich-viewer-in-confluence-with-full-interactivity-with-Lucid-document.png

Al pasar el cursor sobre los documentos que se muestran con el visor completo, aparecerá un marco. 

Desde la parte superior del marco, los usuarios pueden:

  • Abrir el documento de Lucid en una nueva pestaña del navegador
  • Ver el título del documento
  • Presentar las diapositivas que se hayan creado en el documento
  • Ingresar al modo de pantalla completa
  • Abrir la ventana modal de opciones del visor
    • Esta ventana modal para la aplicación Lucidchart contiene la capacidad de mostrar notas y áreas de acción, de habilitar WebGL y de actualizar a la última versión del diagrama

Desde la parte inferior del marco, los usuarios pueden: 

  • Seleccionar diferentes pestañas de la página para ver en el documento de Lucidchart
  • Ver diferentes capas en el diagrama del documento de Lucidchart
  • Acercar y alejar el diagrama

Convierte tus diagramas de Draw.io en documentos de Lucidchart

Para convertir tus diagramas de Draw.io en documentos de Lucidchart en Confluence Data Center, sigue estos pasos:

  1. Ve a la página que contiene los documentos que quieres convertir.
  2. Abre el archivo en Draw.io y descárgalo como archivo XML.
  3. Entra al modo de edición en tu página de Confluence.
  4. Usando el ícono de signo más en la barra de herramientas en la parte superior del editor, inserta un nuevo documento de Lucidchart seleccionando Lucidchart en el menú desplegable.
  5. Una vez que se abra el editor de Lucidchart, podrás importar el diagrama a través del menú de importación.
  6. Una vez que se importe el diagrama, selecciónalo de la lista de documentos y se agregará a tu página de Confluence. En ese momento, serás redirigido a Confluence.
  7. La conversión se habrá terminado y podrás eliminar el diagrama de Draw.io original de tu página de Confluence.

Migra de Confluence Data Center a Confluence Cloud

Ten en cuenta lo siguiente antes de migrar de Confluence Data Center a Confluence Cloud: 

  • Los documentos se convierten por espacio, no por página.
  • Esta migración no se puede deshacer de forma masiva sin restaurar una copia de seguridad anterior de la instancia Confluence.
  • La conversión se puede deshacer para cada documento. Para ello, ve al documento y restaura la página desde el historial de la página.

Si vas a migrar de Confluence Data Center a Confluence Cloud para tu aplicación de Lucidchart, sigue los pasos a continuación para restablecer tus documentos y que vuelvan a mostrarse:

  1. Ve a la sección de configuración del complemento de Lucidchart.
  2. Selecciona la pestaña “Conversión de Confluence”.
  3. Haz clic en Buscar para localizar diagramas que deben convertirse.
  4. Selecciona Convertir.

Una vez que hayas migrado tus documentos, explora nuestro artículo Integra Lucid con Confluence Cloud para obtener instrucciones sobre cómo usar esa integración.

Nota: Confluence trata al complemento de Lucidchart como un usuario. Esto significa que, para que el complemento acceda y convierta con éxito las macros existentes de Lucidchart, debe tener los permisos correctos. Si tienes problemas durante el proceso de conversión, verifica los permisos de tu espacio para asegurarte de que cualquier espacio o página que no se convierta por completo esté disponible para el usuario "Lucidchart Diagrams Connector".

Preguntas frecuentes

¿Quién puede ver y editar documentos de Lucid que se incrustaron en una página de Confluence?
Los permisos de visualización de los documentos de Lucid en Confluence Data Center se heredarán de la página de Confluence. Esto significa que si puedes ver una página de Confluence, podrás ver los documentos en la página de Confluence, independientemente de si tienes o no una cuenta de Lucid. 

La aplicación de Lucidchart en Confluence también obtiene los permisos de edición de la página de Confluence. Esto significa que si puedes ver y editar una página de Confluence y eres usuario con licencia de Lucid, podrás ver y editar los diagramas en la aplicación de Lucid haciendo clic en el botón Abrir en Lucidchart de cada documento.

La aplicación Lucidspark en Confluence requiere que tengas acceso de edición en Confluence y acceso de edición en el tablero de Lucidspark integrado para editar el documento en Confluence.

¿Por qué me trabo en un bucle de inicio de sesión cuando intento acceder a la integración?
Si experimentas un bucle de inicio de sesión en el que continuamente te piden que inicies sesión en Lucid cuando usas esta integración, lo más probable es que se deba a que las cookies de terceros están bloqueadas en tu navegador. Consulta nuestro artículo Solución de problemas: habilita las cookies de terceros para obtener detalles sobre cómo cambiar esa configuración para que ya no estén bloqueadas. 

¿Por qué veo márgenes blancos alrededor de mis diagramas de Lucid incrustados Confluence?
Un poco de espacio en blanco alrededor de tu documento puede ser normal al insertar diagramas en Confluence. Consulta esta publicación de la comunidad sobre espacios en blanco en los diagramas insertados (en inglés) para obtener instrucciones sobre cómo optimizar la apariencia de tus documentos incrustados.

¿Por qué veo un error de marca de tiempo de OAuth al intentar instalar una aplicación de Lucidchart para Confluence Data Center?
Si ves el siguiente error de marca de tiempo de OAuth cuando intentas instalar y configurar el conector de 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'”

es probable que esto signifique que la marca de tiempo en tu servidor que hospeda Confluence sea poco precisa. Incluso si la hora de tu servidor parece correcta, una diferencia de entre 15 y 30 segundos puede provocar que dos servidores no se comuniquen entre sí. No es posible ajustar manualmente la hora del servidor con suficiente precisión, por lo que deberás sincronizar tu marca de tiempo con un servidor NTP.

¿Por qué recibo el error “No estás en un equipo asociado con esta instancia”?
Este error significa que es probable que el usuario esté conectado a una cuenta de Lucid incorrecta. Para solucionar esto, sigue estos pasos:

  1. Inicia sesión en tu cuenta de Lucid que está vinculada incorrectamente a Confluence. 
  2. Haz clic en tu foto de perfil o iniciales en la esquina superior derecha de tu cuenta de Lucid.
  3. Selecciona Configuración de cuenta.
  4. Selecciona Aplicaciones e integraciones en el menú de la izquierda.
  5. Marca la casilla junto a "Confluence".
  6. Haz clic en el botón Eliminar. Esto desconectará la cuenta.
  7. Para restablecer la conexión correcta, cierra la sesión en Lucid. 
  8. Inserta cualquier documento de Lucid en una página de Confluence. 
  9. Cuando se te pida que inicies sesión en Lucid, asegúrate de iniciar sesión con el correo electrónico asociado con la cuenta de Lucid de tu organización.

¿Qué sucede con la conexión de Confluence para toda la cuenta si el administrador que la configuró inicialmente se va?
Si tu administrador se va, la conexión permanecerá activa, ya que se establece a nivel de cuenta. Los permisos de administrador solo se requieren durante el proceso de configuración inicial para crear la conexión.
 

Da tu opinión sobre este artículo

¿Tienes comentarios sobre este artículo? Cuéntanos tu experiencia aquí

¿Encontraste lo que estabas buscando?

¿Todavía tienes alguna pregunta o quieres compartir lo que has aprendido? Visita nuestro Comunidad   para obtener ayuda y colaborar con otras personas.