Enlaza espacios directamente con repositorios de Bitbucket para siempre saber qué trabajo está relacionado.

Los propietarios y administradores del entorno de trabajo pueden conectar espacios a sus repositorios, permitiendo a los miembros añadir su trabajo de Bitbucket a tareas.

Tareas en espacios con un repositorio conectado pueden vincularse con confirmaciones, ramas y solicitudes de validación.

Qué necesitas

• La integración con Bitbucket está disponible en todos los planes de ClickUp.
• Solo los propietarios y administradores del entorno de trabajo pueden crear conexiones en el entorno de trabajo. Se permiten múltiples conexiones de entornos de trabajo.
• Solo los administradores del repositorio pueden agregar repositorios de Bitbucket a ClickUp.
• Solo los propietarios y administradores del entorno de trabajo pueden actualizar los ajustes del entorno de trabajo en el Centro de aplicaciones.
• Solo los propietarios y administradores del entorno de trabajo pueden añadir y enlazar repositorios a espacios.
• Los miembros y superiores pueden crear conexiones personales.
• Invitados no pueden usar la integración de Bitbucket.

Tipos de conexión

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

Los comandos de ClickUp para Bitbucket solo están disponibles para conexiones personales. Los datos no están vinculados a las conexiones del 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, a las que tiene autorización para acceder en Bitbucket.

Configura la integración

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

1. Conecta Bitbucket.
2. Adjunta repositorios de Bitbucket a tu entorno de trabajo.
   

   Se necesitan repositorios para que ClickUp pueda vincular automáticamente las solicitudes de validación con sus respectivas tareas de ClickUp.

3. Vincula repositorios de Bitbucket a los espacios de ClickUp.

Puedes establecer opcionalmente un formato de nombre de rama personalizado. Este formato se utiliza en el panel de la app de tareas para crear ramas directamente desde ClickUp.

Paso 1: Conecta Bitbucket

Para conectar Bitbucket desde el Centro de aplicaciones:

1. Busca y selecciona Bitbucket.
2. Dependiendo del tipo de conexión que desees, selecciona la pestaña Personal o Entorno de trabajo.
3. Elige cómo quieres autorizar:
   • Cuenta de Bitbucket: Autoriza usando tu cuenta de bitbucket.org.
   • Versión autoalojada: Autoriza usando una URL de Bitbucket personalizada.
4. Haz clic en Siguiente.
5. Autoriza a ClickUp.
6. Haz clic en Terminado.

Paso 2: Adjunta repositorios de Bitbucket a tu entorno de trabajo

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

Adjuntar un repositorio no otorga a los usuarios de ClickUp acceso al código fuente de tu repositorio.

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

1. En el Centro de aplicaciones, busca y selecciona Bitbucket.
2. En la esquina superior derecha, haz clic en Ajustes.
3. Bajo Conectar Repositorios a Espacios, haz clic en Añadir repo.
4. Selecciona el repositorio que deseas 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 con la cuenta adecuada. Un propietario o administrador del entorno de trabajo debe seleccionar cada repositorio para conectar. Los repositorios enlazados se pueden ver en el Centro de aplicaciones.

Paso 3: Enlazar repositorios de Bitbucket con los espacios de ClickUp

Después de añadir repositorios a tu entorno de trabajo, un administrador puede añadir cada repositorio a uno o más espacios. Cada espacio en ClickUp puede tener varios repositorios añadidos.

Puedes añadir o eliminar repositorios de los espacios en cualquier momento.

Para enlazar un repositorio a un espacio:

1. En el Centro de aplicaciones, busca y selecciona Bitbucket.
2. En la esquina superior derecha, haz clic en Ajustes.
3. Bajo Conectar Repositorios a Espacios, haz clic en el nombre del repositorio que quieres enlazar.
4. Haz clic en + Añadir Espacio y selecciona un espacio.
5. Repite este paso para añadir más espacios.

Establece tu formato de nombre de rama

Si tu organización utiliza un formato específico para los nombres de las ramas, puedes establecerlo desde la página de Bitbucket en el Centro de aplicaciones. Cuando las personas crean ramas desde 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 tu formato de nombre predeterminado desde Bitbucket en el Centro de aplicaciones:

1. Busca y selecciona Bitbucket.
2. En la esquina superior derecha, haz clic en Ajustes.
3. Bajo Nombre de rama auto-generado, introduce el formato de nombre de rama que prefieras.
4. Haz clic en Guardar.

Enlazar tareas desde Bitbucket

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

Cuando un ID de tarea de ClickUp se incluye en una solicitud de validación, se publicará un comentario con un enlace a la tarea de ClickUp en la solicitud de validación. Un enlace no se mostrará cuando se pegue manualmente una solicitud de validación en una tarea de ClickUp.

El comentario será publicado usando la cuenta de Bitbucket de la persona que configuró el mapeo del repositorio y el espacio.

El ID de tarea debe formatearse usando una de estas opciones:

#{task_id}

CU-{task_id}

{custom_task_id}

#{custom_task_id}

Por ejemplo:

#1abc2de

CU-1abc2de

eng-123

#eng-123

Enlaza tareas desde ClickUp

Enlaza manualmente tareas de ClickUp con commits, ramas y solicitudes de validación de Bitbucket desde tareas de ClickUp. Asegúrate de que la tarea esté ubicada en un espacio que esté enlazado 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 nombres de ramas sugeridos y mensajes de confirmación que puedes copiar al portapapeles. También puedes copiar el ID de la 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 tarea de ClickUp

El feed de actividad de la tarea a veces colapsa elementos de actividad similares para asegurarte de ver los detalles más importantes.

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

• Haz clic en Más actualizaciones para revelar actividades que han estado ocultas.
• Cuando se fusiona una rama, las confirmaciones se muestran como un solo elemento de actividad en el feed de actividad de la tarea.
  • Haz clic en el enlace a todos los commits 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 faltante 

Si no puedes localizar cierta actividad, asegúrate de estar haciendo referencia correctamente al ID de tarea de ClickUp para enlazar actividades en Bitbucket. Puedes usar cualquiera de las siguientes opciones para referenciar tus tareas de ClickUp en commits, nombres de ramas y solicitudes de validación:

#{task_id}

CU-{task_id}

{custom_task_id}

Por ejemplo:

#1abc2de

CU-1abc2de

prefijo-1

Puedes enlazar manualmente tareas de ClickUp con commits, ramas y solicitudes de validación de Bitbucket desde la tarea de ClickUp.

Previsualizaciones de enlaces de Bitbucket

Cuando pegues un enlace de Bitbucket en una tarea de ClickUp, Chat, o Doc, verás la opción de pegarlo como una vista previa, mención o URL.

Crea problemas de Bitbucket, ramas y solicitudes de validación desde ClickUp

Crea nuevas ramas y solicitudes de validación directamente desde tareas. Asegúrate de que la tarea esté ubicada en un espacio que esté enlazado a un repositorio.

Para crear una rama o solicitud de validación:

1. Abre una tarea y haz clic en el icono de Bitbucket.
2. A la derecha, verás nombres de ramas sugeridos y mensajes de confirmación que puedes copiar al portapapeles. También puedes copiar el ID de la 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 validación de Bitbucket
5. Nombra la rama o solicitud de validación.
6. Selecciona un repositorio y completa la información. Añade una rama de origen y una rama de destino si es aplicable.
7. Haz clic en Crear.

Panel de la app de Bitbucket en tareas

Después de pegar tu primer enlace de Bitbucket en una descripción de tarea o comentario, verás un nuevo icono de Bitbucket en la barra lateral derecha de cualquier tarea que resida en espacios que estén conectados a repositorios. Puedes hacer clic en este icono en cualquier momento para ver cada enlace de Bitbucket publicado en la tarea.

La actividad de la tarea 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.

Actualiza los estados de las tareas desde Bitbucket

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

El ID de tarea debe formatearse usando una de estas opciones:

#{task_id}[estado]

CU-{task_id}[estado]

{custom_task_id}[status]

#{custom_task_id}[estado]

Para actualizar un estado de tarea:

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

Por ejemplo: #ud5b[listo]

Todos los formatos listados en la sección Vincular tareas desde Bitbucket de este artículo pueden utilizarse. Para asegurar el formato adecuado, no añadas un espacio entre el ID de la tarea y la información de estado.

Gestiona problemas de Bitbucket, ramas, solicitudes de validación y commits desde ClickUp

Después de enlazar problemas, ramas, solicitudes de validación o confirmaciones, se muestran en el lado derecho de tu tarea cuando haces 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 de Bitbucket. Contacta con el propietario o administrador de tu entorno de trabajo para solicitar una actualización a miembro del entorno de trabajo.

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

Información del problema

Después de que un problema esté vinculado, puedes ver los siguientes detalles:

• La persona que abrió el problema, conocida como el autor
• Cualquier revisor asignado
• Enlace creado
• Repositorio
• El estado del problema.
• URL

Información de la rama

Después de que una rama esté enlazada, 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 validación

Después de que se enlace una solicitud de validación, puedes ver los siguientes detalles:

• La persona que abrió la solicitud de validación, conocida como el autor
• Cualquier revisor asignado
• Asignados
• Cambios de línea
• Enlace creado
• Repositorio
• Rama de origen
• Rama de destino
• El estado de la solicitud de validación
• URL

Información del commit

Después de que se enlace un commit, puedes ver los siguientes detalles:

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

Añade 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 Centro de aplicaciones:

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

Problemas de conexión

A veces, se enlaza la cuenta incorrecta de Bitbucket o hay un problema con la conexión. Para solucionar errores de conexión, intenta desconectar y reconectar tus repositorios o toda la cuenta.

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

Para desconectar un repositorio del Centro de aplicaciones:

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

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

Desconecta la integración de Bitbucket

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

1. Busca y selecciona Bitbucket.
2. Selecciona la pestaña Entorno de trabajo.
   

   Solo los propietarios y administradores pueden desconectar las conexiones del entorno de trabajo.

3. Al lado de Conectado, haz clic en el menú de puntos suspensivos ....
4. Selecciona Desconectar.
5. Para confirmar, haz clic en Desconectar.