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

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

Lo que necesitarás

• La integración con GitLab está disponible en todos los planes de ClickUp.
• Solo los propietarios y administradores del entorno de trabajo pueden agregar proyectos de GitLab en el Centro de apps.
• Los propietarios y administradores de entornos de trabajo pueden conectar espacios a sus proyectos, permitiendo a los miembros agregar 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 entorno de trabajo.
• Miembros y superiores pueden crear conexiones personales.

• Invitados y miembros limitados no pueden usar la integración con GitLab.

Tipos de conexión

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

Los comandos de ClickUp para GitLab están disponibles solo 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 GitLab, verá una lista de opciones, como listas de proyectos, a las que tiene autorización para 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.
   

   Los proyectos son necesarios para que ClickUp pueda vincular automáticamente las solicitudes de fusión con sus respectivas tareas de ClickUp.

3. Vincula proyectos de GitLab a espacios de ClickUp.
4. Opcionalmente, puedes establecer un formato de nombre de ramificación personalizado.

Paso 1: Conectar GitLab

Para conectar GitLab desde el Centro de apps:

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 deseas autorizar:
   • Cuenta de GitLab: Autoriza usando tu cuenta de GitLab.com.
   • Versión autoalojada: Autorización usando una URL personalizada de GitLab.
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 agregar proyectos. Adjuntar un proyecto no otorga a los usuarios de ClickUp acceso a la base de código de tu repositorio.

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

Para agregar un proyecto a un entorno de trabajo:

1. En el Centro de apps, 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 agregar.
5. Repita los pasos anteriores para agregar más proyectos.

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

Paso 3: Vincula proyectos de GitLab a espacios de ClickUp

Después de agregar 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 múltiples proyectos agregados.

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

Para vincular un proyecto a un espacio:

1. En el Centro de apps, 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 Agregar Espacio y selecciona un Espacio. Repite este paso para agregar más Espacios.

Establezca el formato de nombre de su ramificación

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

1. Busca y selecciona GitLab.
2. En la esquina superior derecha, haz clic en Ajustes.
3. Bajo nombre de ramificación auto-generado, ingrese el formato de nombre de ramificación que prefiera.
4. Haz clic en Guardar.

Vincular tareas de GitLab

ClickUp asocia automáticamente la 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 un ID de tarea de ClickUp se incluye 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á al pegar 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 proyecto y el mapeo de 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 desde ClickUp

También puedes vincular manualmente tareas de ClickUp con confirmaciones, ramificaciones 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 vincular una tarea:

1. Abre una tarea y haz clic en el ícono 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 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 Agregar.

Actividad de tarea de ClickUp

El feed de actividad de tareas 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 GitLab:

• Haz clic en Más actualizaciones para revelar actividades que han estado ocultas.
• Cuando se fusiona una ramificación, las confirmaciones 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.
• 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 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

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 a confirmaciones, ramificaciones y solicitudes de fusión de GitLab desde la tarea de ClickUp.

Previsualizaciones de enlaces de GitLab

Cuando pegues 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 problemas de GitLab, ramificaciones y solicitudes de fusión 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, una ramificación o una 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 commit 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 GitLab.
4. Elige una de las siguientes opciones:
   • Nueva rama de GitLab
   • Nueva solicitud de fusión de GitLab
   • Nuevo problema en GitLab
5. Nombra la ramificación, solicitud de fusión o problema.
6. Selecciona un proyecto y completa la información. Agrega una ramificación de origen y una ramificación 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 su primer enlace de GitLab en una descripción de tarea o comentario, verá un nuevo icono de GitLab en la barra lateral derecha de cualquier tarea que se encuentre en espacios conectados a proyectos. Puede 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 una confirmación, empujas una confirmación o creas una solicitud de fusión. ClickUp automáticamente detecta 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 ramificación o el mensaje de confirmación.

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. Agrega el ID de tarea de ClickUp en cualquier parte del mensaje de la confirmación o solicitud de fusió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 GitLab de este artículo pueden utilizarse. Para asegurar el formato adecuado, no agregues un espacio entre el ID de la tarea y la información del estado.

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

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

Una vez que vincules 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 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 del enlace
• Proyecto
• URL

Información de solicitud de fusión

Después de que una solicitud de fusión esté vinculada, 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é vinculada, puedes ver los siguientes detalles:

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

Agrega 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 ramificación o solicitud de fusión.

Para agregar tu cuenta de GitLab desde el Centro de apps:

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.

Visualiza solicitudes de fusión en vista Lista o Tabla

Agrega la columna de Solicitudes de Validación a cualquier vista Lista o vista Tabla para ver rápidamente tus solicitudes de fusión en 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 proyectos usando su cuenta de GitLab a través de GitLab.

Para desconectar un proyecto:

1. Desde el Centro de apps, 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 a continuación incluye instrucciones para desconectar tu cuenta completa.

Desconectar la integración de GitLab

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

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

Desde el Centro de apps:

1. Busca y selecciona GitLab.
2. Selecciona la pestaña 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.