Vincula espacios directamente con repositorios de Bitbucket (repos) para siempre saber qué trabajo está relacionado.

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

Tareas en Espacios con un repo conectado pueden vincularse con confirmaciones, ramificaciones y solicitudes de validación.

Lo que necesitarás

• La integración con Bitbucket está disponible en cada plan de ClickUp.
• Solo los propietarios del entorno de trabajo y los administradores pueden crear conexiones de entorno de trabajo. Se permiten múltiples conexiones de entorno de trabajo.
• Los miembros y superiores pueden crear conexiones personales. 
• Invitados y miembros limitados no pueden usar la integración de Bitbucket.
• Solo los administradores de repositorios 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 apps.
• Solo los propietarios del entorno de trabajo y los administradores pueden agregar y vincular repositorios a espacios.

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 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 está autorizado a ver en Bitbucket.

Configura la integración

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

1. Conectar 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 espacios de ClickUp.

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

Paso 1: Conectar Bitbucket

Para conectar Bitbucket desde el Centro de apps:

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 deseas autorizar:
   • Cuenta de Bitbucket: Autoriza usando tu cuenta de bitbucket.org.
   • Versión autohospedada: Autoriza usando una URL personalizada de Bitbucket.
     
4. Haz clic en Siguiente.
5. Autoriza 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. 

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

Para agregar un repositorio a un entorno de trabajo:

1. En el Centro de apps, busca y selecciona Bitbucket.
2. En la parte superior derecha, haz clic en Ajustes.
3. Bajo Conectar Repositorios a Espacios, haz clic en Agregar repositorio.
4. Selecciona el repositorio que deseas agregar.
5. Repite los pasos anteriores para agregar más repositorios.

Si no ves los repositorios correctos, asegúrate de haber iniciado sesión en la cuenta adecuada. Un propietario del entorno de trabajo o administrador debe seleccionar cada repositorio para conectar. Los repositorios vinculados se pueden ver en el Centro de apps.

Paso 3: Vincula los repositorios de Bitbucket a 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 de ClickUp puede tener varios repositorios añadidos.

Puedes agregar o eliminar repositorios de los espacios en cualquier momento.

Para vincular un repositorio a un espacio:

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

Establece el formato de nombre de tu ramificación

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

1. Busca y selecciona Bitbucket.
2. En la parte superior derecha, haz clic en Ajustes.
3. Bajo Nombre de rama auto-generado, ingresa tu formato de nombre de rama preferido.
4. Haz clic en Guardar.

Vincular tareas desde Bitbucket

ClickUp automáticamente asocia la nueva actividad de Bitbucket con las tareas si incluyes un ID de tarea válido de ClickUp en cualquier parte del título de la solicitud de validación, la descripción de la solicitud de validación, el nombre de la rama o el 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á al pegar manualmente una solicitud de validación en una tarea de ClickUp.

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

El ID de tarea debe estar formateado 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

Vincula tareas de ClickUp

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

3. En la esquina inferior derecha, haz clic en Agregar enlace de Bitbucket.
   
4. Pega el enlace.
5. En la esquina inferior derecha, haz clic en Agregar.

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 realizar las siguientes acciones para localizar la actividad de Bitbucket:

• Haz clic en Más actualizaciones para revelar actividad que ha estado oculta.
• Cuando se fusiona una ramificación, los commits se muestran como un único elemento de actividad en el feed de actividad de la tarea.
  • Haz clic en el enlace a todos los commits para abrir un cuadro de diálogo modal.
  • Haz clic en un commit individual para abrirlo 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 vincular la actividad 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

Lo siento, pero no proporcionaste el contenido que necesitas traducir. Por favor, envíame el texto y estaré encantado de ayudarte con la traducción y adaptación al español latinoamericano.

Puedes vincular manualmente tareas de ClickUp con confirmaciones, ramificaciones y solicitudes de validación de Bitbucket desde la tarea de ClickUp.

Previsualizaciones de enlaces de Bitbucket

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

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

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

Para crear una ramificación o una solicitud de validación:

1. Abre una tarea y haz clic en el ícono 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 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 en Bitbucket
5. Nombra la ramificación o solicitud de validación.
6. Selecciona un repositorio y completa la información. Agrega una ramificación de origen y una de destino si aplica.
7. Haz clic en Crear.

Panel de la app de Bitbucket en tareas

Después de pegar tu primer enlace de Bitbucket en la descripción de una tarea o comentario, 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 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 estados de 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 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 de commit.

El ID de tarea debe estar formateado usando una de estas opciones:

#{task_id}[estado]

CU-{task_id}[estado]

{custom_task_id}[estado]

#{custom_task_id}[estado]

Para actualizar el estado de una tarea:

1. Añade el ID de tarea de ClickUp en cualquier parte del mensaje de la confirmación o solicitud de validación.
2. Incluye el estado actualizado de la tarea 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 agregue un espacio entre el ID de tarea y la información de estado.

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

Después de vincular problemas, ramificaciones, 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 a tu propietario del entorno de trabajo o administrador para solicitar una actualización a miembro del entorno de trabajo.

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

Información del problema

Después de que se vincula un problema, 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 ramificación

Después de que una ramificación esté vinculada, puedes ver los siguientes detalles:

• La persona que creó la ramificación, conocida como el autor
• Creador de enlaces
• Repositorio
• URL

Información de la solicitud de validación

Después de que se vincule 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 en la línea
• Enlace creado
• Repositorio
• Ramificación de origen
• Ramificación objetivo
• El estado de la solicitud de validación
• URL

Información de confirmaciones

Después de que se vincule un compromiso, puedes ver los siguientes detalles:

• La persona que creó la confirmación, conocida como el autor
• Cambios en la 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 apps:

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 vincula 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 repos usando su cuenta de Bitbucket a través de Bitbucket.

Para desconectar un repositorio desde el Centro de apps:

1. Busca y selecciona Bitbucket.
2. En la esquina superior derecha, haz clic en Ajustes.
3. Bajo Repositorios, haz clic en el menú elipsis ... 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 archivos de Bitbucket en ClickUp, puedes desconectar la integración desde el Centro de apps:

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ú elipsis ....
4. Selecciona Desconectar.
5. Para confirmar, haz clic en Desconectar.