Enlaza espacios directamente con proyectos de GitLab para siempre saber qué trabajo está relacionado.

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

Qué necesitas

• La integración con GitLab está disponible en todos los planes de ClickUp.
• Solo los propietarios y administradores del entorno de trabajo pueden añadir proyectos de GitLab en el Centro de aplicaciones.
• Los propietarios de entornos de trabajo y administradores pueden conectar espacios a sus proyectos, permitiendo a los miembros añadir su trabajo de GitLab a tareas.
• Solo los propietarios y administradores del entorno de trabajo pueden crear conexiones de entorno de trabajo. Se permiten múltiples conexiones de entornos de trabajo.
• Miembros y superiores pueden crear conexiones personales.

• Los invitados y miembros limitados no pueden usar la integración de GitLab.

Tipos de conexión

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

Los comandos de ClickUp para GitLab solo están disponibles para conexiones personales. Los datos no están enlazados a las conexiones del entorno de trabajo. Cuando un usuario tiene una conexión personal activada y ejecuta un comando de GitLab, verá una lista de opciones, como listas de proyectos, a las que está autorizado a acceder en GitLab.

Configura la integración

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

1. Conectar GitLab.
2. Adjunta proyectos de GitLab a tu entorno de trabajo.
   

   Se requieren proyectos para que ClickUp pueda enlazar automáticamente las solicitudes de fusión con sus respectivas tareas de ClickUp.

3. Enlaza proyectos de GitLab con espacios de ClickUp.
4. Opcionalmente, puedes establecer un formato de nombre de rama personalizado.

Paso 1: Conectar GitLab

Para conectar GitLab desde el Centro de aplicaciones:

1. Busca y selecciona GitLab.
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 GitLab: Autoriza usando tu cuenta de GitLab.com.
   • Versión autoalojada: Autoriza usando una URL de GitLab personalizada.
4. Haz clic en Siguiente.
5. Autoriza a ClickUp.
6. Haz clic en Terminado.

Paso 2: Vincula proyectos de GitLab a tu entorno de trabajo

Solo el propietario de la conexión puede añadir proyectos. Adjuntar un proyecto no da a los usuarios de ClickUp acceso a la base de código de tu repositorio.

Para asegurar que todos los proyectos de GitLab se muestren en el Centro de aplicaciones, establece permisos individuales para cada proyecto en lugar de usar permisos de grupo.

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

1. En el Centro de aplicaciones, busca y selecciona GitLab.
2. En la esquina superior derecha, haz clic en Ajustes.
3. Bajo Conectar proyectos a espacios, haz clic en Añadir proyecto.
4. Selecciona el proyecto que deseas añadir.
5. Repite los pasos anteriores para añadir más proyectos.

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

Paso 3: Vincula proyectos de GitLab a espacios de ClickUp

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

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

Para vincular un proyecto a un espacio:

1. En el Centro de aplicaciones, busca y selecciona GitLab.
2. En la esquina superior derecha, haz clic en Ajustes.
3. Bajo Conectar proyectos a espacios, haz clic en el nombre del proyecto que deseas vincular.
4. Haz clic en Añadir espacio y selecciona un espacio. Repite este paso para añadir más espacios.

Establece el formato de nombre de tu rama

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

1. Busca y selecciona GitLab.
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.

Vincula tareas desde GitLab

ClickUp asocia automáticamente nueva actividad de GitLab con tareas si incluyes un ID de tarea válido de ClickUp en cualquier parte del título de la solicitud de fusión, la descripción de la solicitud de fusió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 fusión, se publicará un comentario con un enlace a la tarea de ClickUp en la solicitud de fusión. Un enlace no se mostrará cuando se pegue manualmente una solicitud de fusión en una tarea de ClickUp.

El comentario se publicará usando la cuenta de GitLab de la persona que configuró el mapeo del proyecto 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

Enlaza tareas desde ClickUp

También puedes vincular manualmente tareas de ClickUp con commits, ramas y solicitudes de fusión de GitLab desde la tarea de ClickUp. Asegúrate de que la tarea esté ubicada en un espacio que esté vinculado a un proyecto.

Para enlazar una tarea:

1. Abre una tarea y haz clic en el icono de GitLab a la derecha.
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 GitLab.
   
4. Pega un enlace.
5. En la esquina inferior derecha, haz clic en Añadir.

Actividad de tarea de ClickUp

El feed de actividad de tareas a veces colapsa elementos de actividad similares para asegurarse de que ves los detalles más importantes.

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

• Haz clic en Más actualizaciones para revelar actividades que han estado ocultas.
• Cuando se fusiona una rama, 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 menú.
  • Haz clic en una confirmación individual para abrirla en GitLab.
• Filtrar la actividad de la tarea por elementos de Git.

Actividad faltante 

Si no puedes localizar cierta actividad, asegúrate de que estás haciendo referencia correctamente al ID de tarea de ClickUp para enlazar la actividad en GitLab. Puedes usar cualquiera de estas tres opciones para referenciar tus tareas de ClickUp en commits, nombres de ramas y solicitudes de fusión:

#{task_id}

CU-{task_id}

{custom_task_id}

Por ejemplo:

#1abc2de

CU-1abc2de

prefijo-1

Puedes vincular manualmente tareas de ClickUp a commits, ramas y solicitudes de fusión de GitLab desde la tarea de ClickUp.

Previsualizaciones de enlaces de GitLab

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

Crea incidencias, ramas y solicitudes de fusión de GitLab desde ClickUp

También puedes crear nuevos problemas, ramas y solicitudes de fusión directamente desde las tareas. Asegúrate de que la tarea esté ubicada en un espacio que esté vinculado a un proyecto.

Para crear un problema, rama o solicitud de fusión:

1. Abre una tarea y haz clic en el icono de GitLab.
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 GitLab.
4. Elija una de las siguientes opciones:
   • Nueva rama de GitLab
   • Nueva solicitud de fusión de GitLab
   • Nuevo problema en GitLab
5. Nombra la rama, solicitud de fusión o problema.
6. Selecciona un proyecto y completa la información. Añade una rama de origen y una rama de destino si es aplicable.
7. En la esquina inferior derecha, haz clic en Crear.

Panel de la App de GitLab en tareas

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

La actividad de la tarea de GitLab utiliza el nombre de usuario de ClickUp de la persona, o su nombre de usuario de GitLab si no tiene una cuenta de ClickUp.

Actualiza los estados de las tareas desde GitLab

Puedes actualizar el estado de una tarea de ClickUp cuando vinculas un commit, envías un commit o creas una solicitud de fusión. ClickUp detecta automáticamente la nueva actividad en GitLab y la asocia con tareas si incluyes un ID de tarea válido en cualquier parte del título de la solicitud de fusión, la descripción de la solicitud de fusión, el nombre de la rama o el mensaje del 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 un estado de tarea:

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

Por ejemplo: #ud5b[ready]

Todos los formatos listados en la sección Enlazar tareas desde GitLab 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 del estado.

Gestiona problemas de GitLab, ramas, solicitudes de fusión y confirmaciones desde ClickUp

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

Una vez que vinculas un elemento de GitLab, la siguiente información se muestra 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
• Proyecto
• El estado del problema
• URL

Información de la rama

Después de que una rama esté vinculada, puedes ver los siguientes detalles:

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

Información de solicitud de fusión

Después de que una solicitud de fusión esté enlazada, puedes ver los siguientes detalles:

• La persona que abrió la solicitud de fusión, conocida como el autor
• Cualquier revisor asignado
• Proyecto
• El estado de la solicitud de fusión
• URL

Información de la confirmación

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

• La persona que creó la confirmación, conocida como el autor
• Cambios en la línea
• Proyecto
• URL

Añade tu cuenta de GitLab a ClickUp

Los miembros del entorno de trabajo pueden vincular sus cuentas de GitLab con su cuenta de ClickUp de antemano o cuando crean una rama o solicitud de fusión.

Para añadir tu cuenta de GitLab desde el Centro de aplicaciones:

1. Busca y selecciona GitLab.
2. Al lado de Crear una conexión personal, haz clic en Conectar.
3. Inicia sesión en GitLab y autoriza a ClickUp.
4. Haz clic en Terminado.

Ver solicitudes de fusión en vista Lista o Tabla.

Añade la columna de solicitudes de validación a cualquier vista Lista o vista Tabla para ver rápidamente tus solicitudes de fusión de GitLab.

Problemas de conexión

A veces, se vincula la cuenta incorrecta de GitLab o hay un problema con la conexión. En este escenario, puedes intentar desconectar y reconectar tus proyectos o toda la cuenta.

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

Para desconectar un proyecto:

1. Desde el Centro de aplicaciones, selecciona GitLab.
2. En la esquina superior derecha, haz clic en Ajustes.
3. Bajo Proyecto, haz clic en el menú elipsis ... a la derecha del proyecto.
4. Haz clic en Eliminar de ClickUp.

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

Desconecta la integración de GitLab

Si ya no necesitas acceder a archivos de GitLab en ClickUp, puedes desconectar la integración de tu entorno de trabajo.

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

En el Centro de aplicaciones:

1. Busca y selecciona GitLab.
2. Selecciona la pestaña Entorno de trabajo.
3. Al lado de Conectado, haz clic en el menú elipsis ....
4. Selecciona Desconectar.
5. Para confirmar, haga clic en Desconectar.