Vincula Espacios directamente con repositorios de Bitbucket para saber siempre qué trabajo está relacionado.

Los propietarios y administradores del Entorno de trabajo pueden conectar Espacios a sus repositorios, lo que permite a los miembros añadir su trabajo de Bitbucket a tareas.

Las Tareas en Espacios con un repositorio conectado se pueden vincular con commits, ramas y solicitudes de extracción.

Qué necesitarás

• La integración de Bitbucket está disponible en todos los planes de ClickUp.
• Solo los propietarios y administradores del Entorno de trabajo pueden crear conexiones de Entorno de trabajo. Se permiten varias conexiones de Entorno de trabajo.
• Los miembros y roles superiores pueden crear conexiones personales.
• Los invitados y los miembros con acceso limitado no pueden usar la integración de Bitbucket.
• Solo los administradores del repositorio pueden añadir repositorios de Bitbucket a ClickUp.
• Solo los propietarios y administradores del Entorno de trabajo pueden actualizar los ajustes del Entorno de trabajo en el App Center.
• Solo los propietarios y administradores del Entorno de trabajo pueden añadir y vincular repositorios a Espacios.

Tipos de conexión

Las funciones y comandos disponibles dependen del tipo de conexión que uses.

Los comandos de ClickUp para Bitbucket solo están disponibles para conexiones personales. Los datos no están vinculados a las conexiones de Entorno de trabajo. Cuando un usuario tiene una conexión personal activada y ejecuta un comando de Bitbucket, verá una lista de opciones, como listas de repositorios, que está autorizado a ver en Bitbucket.

Configurar la integración

Hay tres pasos para configurar la integración de Bitbucket en ClickUp:

1. Conectar Bitbucket.
2. Vincular repositorios de Bitbucket a tu Entorno de trabajo. Los repositorios son necesarios para que ClickUp pueda vincular automáticamente las solicitudes de extracción a sus tareas de ClickUp correspondientes.
3. Enlazar repositorios de Bitbucket a Espacios de ClickUp.

Opcionalmente, puedes establecer un formato de nombre de rama personalizado. Este formato se utiliza en el panel de la aplicación de tareas para crear ramas directamente desde ClickUp.

Paso 1: Conectar Bitbucket

Para conectar Bitbucket desde el App Center:

1. Busca y selecciona Bitbucket.
2. Según el tipo de conexión que quieras, selecciona la pestaña Personal o Entorno de trabajo.
3. Elige cómo quieres autorizar:
   • Cuenta de Bitbucket: autoriza con tu cuenta de bitbucket.org.
   • Versión autoalojada: autoriza con una URL personalizada de Bitbucket.

     

4. Haz clic en Siguiente.
5. Autoriza ClickUp.
6. Haz clic en Listo.

Paso 2: Vincular repositorios de Bitbucket a tu Entorno de trabajo

Solo el propietario de la conexión puede añadir repositorios.

Vincular un repositorio no concede a los usuarios de ClickUp acceso al código fuente de dicho repositorio.

Para añadir un repositorio a un Entorno de trabajo:

1. En el App Center, busca y selecciona Bitbucket.
2. En la parte superior derecha, haz clic en Ajustes.
3. En Conectar repositorios a Espacios, haz clic en Añadir repositorio.
4. Selecciona el repositorio que quieras añadir.
5. Repite los pasos anteriores para añadir más repositorios.

Si no ves los repositorios correctos, asegúrate de haber iniciado sesión en la cuenta adecuada. Un propietario o administrador del Entorno de trabajo debe seleccionar cada repositorio para conectarlo. Los repositorios vinculados se pueden consultar en el App Center.

Paso 3: Enlazar repositorios de Bitbucket a Espacios de ClickUp

Tras añadir repositorios a tu Entorno de trabajo, un administrador puede añadir cada repositorio a uno o más Espacios. Cada Espacio de ClickUp puede tener varios repositorios añadidos.

Puedes añadir o quitar repositorios de los Espacios en cualquier momento.

Para enlazar un repositorio a un Espacio:

1. En el App Center, busca y selecciona Bitbucket.
2. En la parte superior derecha, haz clic en Ajustes.
3. En Conectar repositorios a Espacios, haz clic en el nombre del repositorio que quieras enlazar.
4. Haz clic en + Añadir Espacio y selecciona un Espacio.
5. Repite este paso para añadir más Espacios.

Establecer el formato del nombre de rama

Si tu organización utiliza un formato específico para los nombres de rama, puedes establecerlo desde la página de Bitbucket en el App Center. Cuando los usuarios creen ramas a partir de tareas de ClickUp, se utilizará este formato.

El formato predeterminado es: :taskId:_:taskName:_:username:

Por ejemplo: CU-ae27de_Auto-generated-naming_John-smith

Las opciones disponibles se muestran en la siguiente tabla:

Para establecer el formato de nombre predeterminado desde Bitbucket en el App Center:

1. Busca y selecciona Bitbucket.
2. En la parte superior derecha, haz clic en Ajustes.
3. En Nombre de rama generado automáticamente, escribe el formato de nombre de rama que prefieras.
4. Haz clic en Guardar.

Vincular tareas desde Bitbucket

ClickUp asocia automáticamente la nueva actividad de Bitbucket con las tareas si incluyes un ID de tarea de ClickUp válido en cualquier parte del título de la solicitud de extracción, la descripción de la solicitud de extracción, el nombre de la rama o el mensaje de confirmación.

Cuando se incluye un ID de tarea de ClickUp en una solicitud de extracción, se publica un comentario con un enlace a la tarea de ClickUp en dicha solicitud. El enlace no se mostrará al pegar manualmente una solicitud de extracción en una tarea de ClickUp.

El comentario se publicará usando la cuenta de Bitbucket de la persona que configuró el repositorio y la asignación del Espacio.

El ID de tarea debe tener el formato de una de estas opciones:

#{task_id}

CU-{task_id}

{custom_task_id}

#{custom_task_id}

Por ejemplo:

#1abc2de

CU-1abc2de

eng-123

#eng-123

Vincular tareas desde ClickUp

Vincula manualmente las tareas de ClickUp con confirmaciones, ramas y solicitudes de extracción de Bitbucket desde las tareas de ClickUp. Asegúrate de que la tarea esté ubicada en un Espacio vinculado a un repositorio.

Para vincular una tarea:

1. Abre la tarea.
2. En la barra lateral derecha, haz clic en el icono de Bitbucket. A la derecha verás los nombres de rama y mensajes de confirmación sugeridos que puedes copiar al portapapeles. También puedes copiar el ID de tarea desde aquí.
3. En la esquina inferior derecha, haz clic en Añadir enlace de Bitbucket.

   

4. Pega el enlace.
5. En la esquina inferior derecha, haz clic en Añadir.

Actividad de las tareas de ClickUp

El registro de actividad de la tarea a veces agrupa elementos de actividad similares para que veas los detalles más importantes.

Puedes realizar las siguientes acciones para localizar la actividad de Bitbucket:

• Haz clic en Más actualizaciones para mostrar la actividad que ha quedado oculta.
• Cuando se fusiona una rama, las confirmaciones se muestran como un único elemento de actividad en el registro de actividad de la tarea.
  • Haz clic en el enlace a todas las confirmaciones para abrir un modal.
  • Haz clic en una confirmación individual para abrirla en Bitbucket.
• Filtra la actividad de la tarea por Elementos de Git.

  

Actividad que falta

Si no puedes localizar cierta actividad, asegúrate de que estás haciendo referencia correctamente al ID de tarea de ClickUp para vincular la actividad en Bitbucket. Puedes usar cualquiera de las siguientes opciones para hacer referencia a tus tareas de ClickUp en confirmaciones, nombres de rama y solicitudes de extracción:

#{task_id}

CU-{task_id}

{custom_task_id}

Por ejemplo:

#1abc2de

CU-1abc2de

prefix-1

Puedes vincular manualmente las tareas de ClickUp con confirmaciones, ramas y solicitudes de extracción de Bitbucket desde la tarea de ClickUp.

Vistas previas de enlaces de Bitbucket

Cuando pegas un enlace de Bitbucket en mitad de una frase o dentro de un texto existente, se mostrará una vista previa de enlace en línea sobre la que puedes pasar el cursor para obtener más detalles.

Cuando pegas un enlace de Bitbucket en una línea nueva, puedes elegir mostrarlo en línea, como vista previa en vivo o como una URL normal.

Las vistas previas de enlace funcionan en las descripciones de tareas, comentarios, Documentos y mensajes de Chat. Para cambiar manualmente el tipo de vista previa de un enlace, pasa el cursor por encima y haz clic en el icono de puntos suspensivos ….

Crear problemas, ramas y solicitudes de extracción de Bitbucket desde ClickUp

Crea nuevas ramas y solicitudes de extracción directamente desde las tareas. Asegúrate de que la tarea esté ubicada en un Espacio vinculado a un repositorio.

Para crear una rama o una solicitud de extracción:

1. Abre una tarea y haz clic en el icono de Bitbucket.
2. A la derecha verás los nombres de rama y mensajes de confirmación sugeridos que puedes copiar al portapapeles. También puedes copiar el ID de tarea desde aquí.
3. En la esquina inferior derecha, haz clic en Añadir enlace de Bitbucket.
4. Elige una de las siguientes opciones:
   • Nueva rama de Bitbucket
   • Nueva solicitud de extracción de Bitbucket
5. Asigna un nombre a la rama o a la solicitud de extracción.
6. Selecciona un repositorio y rellena la información. Añade una rama de origen y una rama de destino si corresponde.
7. Haz clic en Crear.

Panel de la aplicación Bitbucket en las tareas

Después de pegar tu primer enlace de Bitbucket en la descripción o en un comentario de una tarea, verás un nuevo icono de Bitbucket en la barra lateral derecha de cualquier tarea que se encuentre en Espacios conectados a repositorios. Puedes hacer clic en este icono en cualquier momento para ver todos los enlaces de Bitbucket publicados en la tarea.

La actividad de las tareas de Bitbucket utiliza el nombre de usuario de ClickUp de la persona, o su nombre de usuario de Bitbucket si no tiene una cuenta de ClickUp.

Actualizar el estado de las tareas desde Bitbucket

Puedes actualizar el estado de una tarea de ClickUp cuando vinculas un commit, envías un commit o creas una solicitud de extracción. ClickUp recoge automáticamente la nueva actividad de Bitbucket y la asocia con las tareas si incluyes un ID de tarea válido en cualquier parte del título de la solicitud de extracción, la descripción de la solicitud de extracción o el mensaje del commit.

El ID de tarea debe tener el formato de una de estas opciones:

#{task_id}[status]

CU-{task_id}[status]

{custom_task_id}[status]

#{custom_task_id}[status]

Para actualizar el estado de una tarea:

1. Añade el ID de tarea de ClickUp en cualquier parte del mensaje del commit o de la solicitud de extracción.
2. Incluye el estado actualizado de la tarea entre corchetes.

Por ejemplo: #ud5b[ready]

Se pueden usar todos los formatos indicados en la sección Vincular tareas desde Bitbucket de este artículo. Para garantizar el formato correcto, no añadas un espacio entre el ID de tarea y la información de estado.

Gestionar incidencias, ramas, solicitudes de extracción y commits de Bitbucket desde ClickUp

Después de vincular incidencias, ramas, solicitudes de extracción o commits, estos aparecen en el lado derecho de tu tarea al hacer clic en el icono de Bitbucket. Usa el menú de puntos suspensivos ... para copiar el enlace o eliminar el elemento.

Si te has unido al Entorno de trabajo como invitado, no podrás usar la integración con Bitbucket. Ponte en contacto con el propietario o el administrador de tu Entorno de trabajo para solicitar una actualización a miembro del Entorno de trabajo.

Una vez que vinculas un elemento de Bitbucket, en tu tarea de ClickUp se muestra la siguiente información:

Información de la incidencia

Después de vincular una incidencia, puedes ver los siguientes detalles:

• La persona que abrió la incidencia, conocida como el autor
• Los revisores asignados
• Enlace creado
• Repositorio
• El estado de la incidencia
• URL

Información de la rama

Después de vincular una rama, puedes ver los siguientes detalles:

• La persona que creó la rama, conocida como el autor
• Creador del enlace
• Repositorio
• URL

Información de la solicitud de extracción

Después de vincular una solicitud de extracción, puedes ver los siguientes detalles:

• La persona que abrió la solicitud de extracción, conocida como el autor
• Los revisores asignados
• Asignados
• Cambios de línea
• Enlace creado
• Repositorio
• Rama de origen
• Rama de destino
• El estado de la solicitud de extracción
• URL

Información del commit

Después de vincular un commit, puedes ver los siguientes detalles:

• La persona que creó el commit, conocida como el autor
• Cambios de línea
• Enlace creado
• Repositorio
• URL

Añadir tu cuenta de Bitbucket a ClickUp

Configura una conexión personal usando tu cuenta de Bitbucket.

Para añadir tu cuenta de Bitbucket desde el App Center:

1. Busca y selecciona Bitbucket.
2. Haz clic en Conectar.
3. Inicia sesión en Bitbucket y autoriza a ClickUp.
4. Haz clic en Listo.

Problemas de conexión

En ocasiones, la cuenta de Bitbucket vinculada es incorrecta o hay un problema con la conexión. Para corregir los errores de conexión, intenta desconectar y volver a conectar tus repositorios o toda la cuenta.

Estas acciones no afectan a la capacidad de nadie para acceder a los repositorios mediante su cuenta de Bitbucket a través de Bitbucket.

Para desconectar un repositorio desde el App Center:

1. Busca y selecciona Bitbucket.
2. En la esquina superior derecha, haz clic en Ajustes.
3. En Repositorios, haz clic en el menú de puntos suspensivos ... situado a la derecha del repositorio.
4. Haz clic en Eliminar de ClickUp.

La sección siguiente incluye instrucciones para desconectar toda la cuenta.

Desconectar la integración con Bitbucket

Si ya no necesitas acceder a los archivos de Bitbucket en ClickUp, puedes desconectar la integración desde el App Center:

1. Busca y selecciona Bitbucket.
2. Selecciona la pestaña Entorno de trabajo. Solo los propietarios y los administradores pueden desconectar las conexiones del Entorno de trabajo.
3. Junto a Conectado, haz clic en el menú de puntos suspensivos ....
4. Selecciona Desconectar.
5. Para confirmar, haz clic en Desconectar.