Vincule espaços diretamente com projetos do GitLab para sempre saber quais trabalhos estão relacionados.

Tarefas em espaços com um projeto conectado podem ser vinculadas a commits, branches e solicitações de mesclagem.

O que você vai precisar

• A integração com o GitLab está disponível em todos os planos do ClickUp.
• Somente os proprietários e administradores do espaço de trabalho podem adicionar projetos do Gitlab na Central de Aplicativos.
• Proprietários de espaço de trabalho e administradores podem conectar Espaços aos seus projetos, permitindo que membros adicionem seu trabalho do GitLab a tarefas.
• Somente os proprietários e administradores do espaço de trabalho podem criar conexões de espaço de trabalho. Múltiplas conexões de espaço de trabalho são permitidas.
• Membros e superiores podem criar conexões pessoais.

• Convidados e membros limitados não podem usar a integração com o GitLab.

Tipos de conexão

Os recursos e comandos disponíveis dependem do tipo de conexão que você usa.

Os comandos do ClickUp para o GitLab estão disponíveis apenas para conexões pessoais. Os dados não estão vinculados às conexões do Espaço de trabalho. Quando um usuário tem uma conexão pessoal ativada e executa um comando no GitLab, ele verá uma lista de opções, como listas de projetos, às quais está autorizado a visualizar no GitLab.

Configure a integração

Existem três passos necessários para configurar a integração do GitLab no ClickUp:

1. Conectar GitLab.
2. Anexe projetos do GitLab ao seu Espaço de trabalho.
   

   Projetos são necessários para que o ClickUp possa vincular automaticamente solicitações de mesclagem às respectivas tarefas do ClickUp.

3. Vincule projetos do GitLab aos espaços do ClickUp.
4. Opcionalmente, você pode definir um formato de nome de branch personalizado.

Passo 1: Conectar GitLab

Para conectar o GitLab a partir da Central de Aplicativos:

1. Busque e selecione GitLab.
2. Dependendo do tipo de conexão que deseja, selecione a aba Pessoal ou Espaço de trabalho.
3. Escolha como deseja autorizar:
   • Conta do GitLab: Autorize usando sua conta do GitLab.com.
   • Versão auto-hospedada: Autorize usando uma URL personalizada do GitLab.
4. Clique em Avançar.
5. Autorize o ClickUp.
6. Clique em Feito.

Etapa 2: Anexe projetos do GitLab ao seu Espaço de trabalho

Apenas o proprietário da conexão pode adicionar projetos. Anexar um projeto não dá aos usuários do ClickUp acesso ao código-fonte do seu repositório.

Para garantir que todos os projetos do GitLab sejam exibidos na Central de Aplicativos, defina permissões individuais para cada projeto em vez de usar permissões de grupo.

Para adicionar um projeto a um Espaço de trabalho:

1. Na Central de Aplicativos, procure e selecione GitLab.
2. No canto superior direito, clique em Configurações.
3. Em Conectar Projetos aos Espaços, clique em Adicionar projeto.
4. Selecione o projeto que deseja adicionar.
5. Repita os passos acima para adicionar mais projetos.

Se você não estiver vendo os projetos corretos, certifique-se de ter feito login na conta certa. Um proprietário do espaço de trabalho ou administrador deve selecionar cada projeto para conectar. Projetos vinculados podem ser visualizados na Central de Aplicativos.

Etapa 3: Vincular projetos do GitLab aos Espaços do ClickUp

Após adicionar projetos ao seu espaço de trabalho, um administrador pode adicionar cada projeto a um ou mais espaços. Cada espaço do ClickUp pode ter vários projetos adicionados.

Você pode adicionar ou remover projetos dos Espaços a qualquer momento.

Para vincular um projeto a um Espaço:

1. Na Central de Aplicativos, procure e selecione GitLab.
2. No canto superior direito, clique em Configurações.
3. Em Conectar Projetos aos Espaços, clique no nome do projeto que deseja vincular.
4. Clique em Adicionar Espaço e selecione um Espaço. Repita este passo para adicionar mais Espaços.

Defina seu formato de nome de branch

Se sua organização usa um formato específico para nomes de branch, você pode definir isso na página do GitLab na Central de Aplicativos. Quando as pessoas criam branches a partir de tarefas do ClickUp, será usado este formato.

O formato padrão é: :taskId:_:taskName:_:username:

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

As opções disponíveis são mostradas na tabela a seguir:

Para definir seu formato de nome padrão do GitLab na Central de Aplicativos:

1. Busque e selecione GitLab.
2. No canto superior direito, clique em Configurações.
3. Em Nome de branch gerado automaticamente, insira o formato de nome de branch preferido.
4. Clique em Salvar.

Vincule tarefas do GitLab

O ClickUp automaticamente associa novas atividades do GitLab com tarefas se você incluir um ID da tarefa válido do ClickUp em qualquer parte do título da solicitação de mesclagem, descrição da solicitação de mesclagem, nome do branch ou mensagem de commit.

Quando um ID de tarefa do ClickUp é incluído em uma solicitação de mesclagem, um comentário com um link para a tarefa do ClickUp será postado na solicitação de mesclagem. Um link não será exibido ao colar manualmente uma solicitação de mesclagem em uma tarefa do ClickUp.

O comentário será postado usando a conta do GitLab da pessoa que configurou o mapeamento do projeto e do Espaço.

O ID da tarefa deve ser formatado usando uma destas opções:

#{task_id}

CU-{task_id}

{custom_task_id}

#{custom_task_id}

Por exemplo:

#1abc2de

CU-1abc2de

eng-123

#eng-123

Vincular tarefas do ClickUp

Você também pode vincular manualmente tarefas ClickUp com commits, branches e solicitações de mesclagem do GitLab a partir da tarefa ClickUp. Certifique-se de que a tarefa esteja localizada em um espaço que está vinculado a um projeto.

Para vincular uma tarefa:

1. Abra uma tarefa e clique no ícone do GitLab à direita.
2. À direita, você verá nomes de branches sugeridos e mensagens de commit que você pode copiar para sua área de transferência. Você também pode copiar o ID da tarefa daqui.
3. No canto inferior direito, clique em Adicionar link do GitLab.
   
4. Cole um link.
5. No canto inferior direito, clique em Adicionar.

Atividade da tarefa ClickUp

O feed de atividades da tarefa às vezes colapsa itens de atividade semelhantes para garantir que você veja os detalhes mais importantes.

Você pode realizar as seguintes ações para localizar atividades do GitLab:

• Clique em Mais atualizações para revelar atividades que foram ocultadas.
• Quando um branch é mesclado, os commits aparecem como um item de atividade único no feed de atividades da tarefa.
  • Clique no link para todos os commits para abrir um menu.
  • Clique em um commit individual para abri-lo no GitLab.
• Filtrar atividade da tarefa por itens do Git.

Atividade ausente 

Se não conseguir localizar certa atividade, certifique-se de que está referenciando corretamente o ID da tarefa ClickUp para vincular atividades no GitLab. Você pode usar qualquer uma dessas três opções para referenciar suas tarefas ClickUp em commits, nomes de branches e solicitações de mesclagem:

#{task_id}

CU-{task_id}

{custom_task_id}

Por exemplo:

#1abc2de

CU-1abc2de

prefixo-1

Você pode vincular manualmente tarefas do ClickUp a commits, branches e solicitações de mesclagem do GitLab a partir da tarefa do ClickUp.

Previsões de link do GitLab

Quando você cola um link do GitLab em uma tarefa do ClickUp, Chat, ou Doc, você verá a opção de colá-lo como uma prévia, menção ou URL.

Crie problemas, branches e solicitações de mesclagem do GitLab a partir do ClickUp

Você também pode criar novos problemas, branches e solicitações de mesclagem diretamente das tarefas. Certifique-se de que a tarefa esteja localizada em um espaço que está vinculado a um projeto.

Para criar um problema, branch ou solicitação de mesclagem:

1. Abra uma tarefa e clique no ícone do GitLab.
2. À direita, você verá nomes de branches sugeridos e mensagens de commit que você pode copiar para sua área de transferência. Você também pode copiar o ID da tarefa daqui.
3. No canto inferior direito, clique em Adicionar link do GitLab.
4. Escolha uma das seguintes opções:
   • Novo Branch do GitLab
   • Nova Solicitação de Mesclagem do GitLab
   • Novo Problema do GitLab
5. Nomeie o branch, a solicitação de mesclagem ou o problema.
6. Selecione um projeto e preencha as informações. Adicione um branch de origem e um branch de destino, se aplicável.
7. No canto inferior direito, clique em Criar.

Painel do aplicativo GitLab nas tarefas

Após colar seu primeiro link do GitLab em uma descrição de tarefa ou comentário, você verá um novo ícone GitLab na barra lateral direita de qualquer tarefas que estejam em Espaços conectados a projetos. Você pode clicar neste ícone a qualquer momento para ver todos os links do GitLab postados na tarefa.

A atividade da tarefa do GitLab utiliza o nome de usuário do ClickUp da pessoa, ou seu nome de usuário do GitLab, caso ela não tenha uma conta no ClickUp.

Atualize os status das tarefas a partir do GitLab

Você pode atualizar o status de uma tarefa do ClickUp quando você vincula um commit, faz um push de um commit ou cria uma solicitação de mesclagem. O ClickUp automaticamente detecta novas atividades do GitLab e as associa com tarefas se você incluir um ID de tarefa válido em qualquer parte do título da solicitação de mesclagem, descrição da solicitação de mesclagem, nome do branch ou mensagem de commit.

O ID da tarefa deve ser formatado usando uma destas opções:

#{task_id}[status]

CU-{task_id}[status]

{custom_task_id}[status]

#{custom_task_id}[status]

Para atualizar o status de uma tarefa:

1. Adicione o ID da tarefa do ClickUp em qualquer parte da mensagem de commit ou solicitação de mesclagem.
2. Inclua o status atualizado da tarefa entre colchetes.

Por exemplo: #ud5b[pronto]

Todos os formatos listados na seção Vincular tarefas do GitLab deste artigo podem ser usados. Para garantir a formatação adequada, não adicione um espaço entre o ID da tarefa e as informações de status.

Gerencie problemas do GitLab, branches, solicitações de mesclagem e commits a partir do ClickUp

Após vincular problemas, branches, solicitações de mesclagem ou commits, eles aparecerão no lado direito da sua tarefa quando você clicar no ícone do GitLab. Use o menu de reticências ... para copiar o link ou excluir o item.

Se você ingressou no Espaço de trabalho como convidado, não poderá usar a integração com o GitLab. Contate o proprietário do seu Espaço de trabalho ou administrador para solicitar um upgrade para membro do Espaço de trabalho.

Uma vez que você vincule um item do GitLab, as seguintes informações são exibidas em sua tarefa do ClickUp:

Informações do problema

Após um problema ser vinculado, você pode ver os seguintes detalhes:

• A pessoa que abriu o problema, conhecida como autor
• Projeto
• Status do problema
• URL

Informações do branch

Após uma branch ser vinculada, você pode ver os seguintes detalhes:

• A pessoa que criou o branch, conhecida como autor
• Criador do link
• Projeto
• URL

Informações da solicitação de mesclagem

Após uma solicitação de mesclagem ser vinculada, você pode ver os seguintes detalhes:

• A pessoa que abriu a solicitação de mesclagem, conhecida como autor
• Quaisquer revisores atribuídos
• Projeto
• O status da solicitação de mesclagem
• URL

Informações de commit

Após um commit ser vinculado, você pode ver os seguintes detalhes:

• A pessoa que criou o commit, conhecida como autor
• Alterações de linha
• Projeto
• URL

Adicione sua conta do GitLab ao ClickUp

Membros do espaço de trabalho podem vincular suas contas do GitLab às suas contas do ClickUp antecipadamente ou quando criam um branch ou solicitação de mesclagem.

Para adicionar sua conta do GitLab a partir da Central de Aplicativos:

1. Busque e selecione GitLab.
2. Ao lado de Criar uma conexão pessoal, clique em Conectar.
3. Faça login no GitLab e autorize o ClickUp.
4. Clique em Feito.

Visualize solicitações de mesclagem na visualização de Lista ou Tabela.

Adicione a coluna de Solicitações de Pull a qualquer visualização de Lista ou visualização de Tabela para visualizar rapidamente suas solicitações de mesclagem no GitLab.

Problemas de conexão

Às vezes, a conta errada do GitLab é vinculada ou há um problema com a conexão. Neste cenário, você pode tentar desconectar e reconectar seus projetos ou conta inteira.

Essas ações não impactam a capacidade de ninguém de acessar projetos usando sua conta do GitLab através do GitLab.

Para desconectar um projeto:

1. Da Central de Aplicativos, selecione GitLab.
2. No canto superior direito, clique em Configurações.
3. Em Projeto, clique no menu de reticências ... à direita do projeto.
4. Clique em Excluir do ClickUp.

A seção abaixo inclui instruções para desconectar sua conta inteira.

Desconecte a integração com o GitLab

Se você não precisar mais acessar arquivos do GitLab no ClickUp, pode desconectar a integração do seu espaço de trabalho.

Apenas proprietários e administradores podem desconectar conexões do Espaço de trabalho.

Da Central de Aplicativos:

1. Busque e selecione GitLab.
2. Selecione a aba Espaço de trabalho.
3. Ao lado de Conectado, clique no menu de reticências ....
4. Selecione Desconectar.
5. Para confirmar, clique em Desconectar.