Link Espaços diretamente com projetos do GitLab para que você sempre saiba qual trabalho está relacionado.

Tarefas em Espaços com um projeto conectado podem ser vinculadas a commits, branches e merge requests.

O que você precisará

• A integração com o GitLab está disponível em todos os planos do ClickUp.
• Somente proprietários e administradores do Workspace podem adicionar projetos do GitLab no App Center.
• Proprietários e administradores do Workspace podem conectar Espaços aos seus projetos, permitindo que os membros adicionem seu trabalho do GitLab a tarefas.
• Somente proprietários e administradores do Workspace podem criar conexões do Workspace. Múltiplas conexões do Workspace são permitidas.
• Membros e acima 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 Workspace. Quando um usuário tem uma conexão pessoal habilitada e executa um comando do GitLab, ele verá uma lista de opções, como listas de projetos, que ele está autorizado a visualizar no GitLab.

Tipo de conexão	Descrição	Recursos	Comandos
Conexão pessoal	Conecte sua conta do GitLab com sua conta de usuário do ClickUp. Os dados na sua conta do GitLab não estarão disponíveis para mais ninguém através do ClickUp.	Visualizar links do GitLab no ClickUp: As prévias de links permitem que você veja visualizações ao vivo e sincronizadas de links diretamente no ClickUp. Painel de aplicativos na visualização de tarefas: Visualize links do GitLab de um lugar central nas tarefas.	Abrir GitLab: Abra o GitLab em uma nova aba do navegador. Criar nova branch do GitLab: Crie uma nova branch do GitLab a partir do ClickUp. Criar nova merge request do GitLab: A maneira mais rápida de criar uma merge request do GitLab. Criar nova issue do GitLab: Crie uma nova issue do GitLab a partir do ClickUp.
Conexão do Workspace	O proprietário ou administradores do Workspace podem habilitar o GitLab como uma conexão do Workspace.	Sincronizar atividade com tarefas: Sincronize a atividade do GitLab com tarefas do ClickUp para garantir que sua equipe esteja sempre atualizada sobre os projetos. Atualizar status da tarefa a partir do GitLab: Altere os status das tarefas sem sair do GitLab. Visualizar links do GitLab no ClickUp: As prévias de links permitem que você veja visualizações ao vivo e sincronizadas de links diretamente no ClickUp. Painel de aplicativos na visualização de tarefas: Visualize links do GitLab de um lugar central nas tarefas.

Configurar a integração

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

1. Conectar o GitLab.
2. Anexar projetos do GitLab ao seu Workspace.

   Projetos são necessários para que o ClickUp possa vincular automaticamente as merge requests às suas respectivas tarefas do ClickUp.

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

Etapa 1: Conectar o GitLab

Para conectar o GitLab a partir do App Center:

1. Pesquise e selecione GitLab.
2. Dependendo do tipo de conexão que você deseja, selecione a aba Pessoal ou Workspace.
3. Escolha como você 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 Próximo.
5. Autorize o ClickUp.
6. Clique em Concluído.

Etapa 2: Anexar projetos do GitLab ao seu Workspace

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

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

Para adicionar um projeto a um Workspace:

1. No App Center, pesquise 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 você deseja adicionar.
5. Repita as etapas acima para adicionar mais projetos.

Se você não vê os projetos corretos, certifique-se de que você está conectado à conta certa. Um proprietário ou administrador do Workspace deve selecionar cada projeto para conectar. Projetos vinculados podem ser visualizados no App Center.

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

Após adicionar projetos ao seu Workspace, 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. No App Center, pesquise 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 você deseja vincular.
4. Clique em Adicionar Espaço e selecione um Espaço. Repita esta etapa para adicionar mais Espaços.

Defina o formato do nome da sua branch

Se sua organização usa um formato específico para nomes de branches, você pode defini-lo na página do GitLab no App Center. Quando as pessoas criarem branches a partir de tarefas do ClickUp, esse formato será utilizado.

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:

Valor	Descrição
:username:	O nome de usuário da conta do ClickUp que criou a branch. Espaços são substituídos por um _.
:taskId:	O ID da tarefa do ClickUp onde a branch é criada. Inclui o prefixo necessário.
:taskName:	O nome da tarefa onde a branch é criada. Espaços são substituídos por um _.

Para definir seu formato de nome padrão do GitLab no App Center:

1. Pesquise e selecione GitLab.
2. No canto superior direito, clique em Configurações.
3. Em Nome da branch auto-gerada, insira seu formato de nome de branch preferido.
4. Clique em Salvar.

Vincular tarefas do GitLab

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

Quando um ID de tarefa do ClickUp é incluído em uma merge request, um comentário com um link para a tarefa do ClickUp será postado na merge request. Um link não será exibido ao colar manualmente uma merge request 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 dessas 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 do ClickUp com commits, branches e merge requests do GitLab a partir da tarefa do ClickUp. Certifique-se de que a tarefa esteja localizada em um Espaço que esteja vinculado a um projeto.

Para vincular uma tarefa:

1. Abra uma tarefa e clique no ícone GitLab à direita.
2. À direita, você verá nomes de branches sugeridos e mensagens de commit que 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 do ClickUp

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

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

• Clique em Mais atualizações para revelar atividades que foram ocultadas.
• Quando uma branch é mesclada, os commits são exibidos como um único item de atividade no feed de atividade 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 você não consegue localizar certa atividade, certifique-se de que está referenciando corretamente o ID da tarefa do ClickUp para vincular a atividade no GitLab. Você pode usar qualquer uma dessas três opções para referenciar suas tarefas do ClickUp em commits, nomes de branches e merge requests:

#{task_id}

CU-{task_id}

{custom_task_id}

Por exemplo:

#1abc2de

CU-1abc2de

prefix-1

Você pode vincular manualmente tarefas do ClickUp a commits, branches e merge requests do GitLab a partir da tarefa do ClickUp.

Pré-visualizações de links 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.

Criar issues, branches e merge requests do GitLab a partir do ClickUp

Você também pode criar novas issues, branches e merge requests diretamente a partir das tarefas. Certifique-se de que a tarefa esteja localizada em um Espaço que esteja vinculado a um projeto.

Para criar uma issue, branch ou merge request:

1. Abra uma tarefa e clique no ícone GitLab.
2. À direita, você verá nomes de branches sugeridos e mensagens de commit que 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:
   • Nova branch do GitLab
   • Nova merge request do GitLab
   • Nova issue do GitLab
5. Nomeie a branch, merge request ou issue.
6. Selecione um projeto e preencha as informações. Adicione uma branch de origem e uma branch de destino, se aplicável.
7. No canto inferior direito, clique em Criar.

Painel do aplicativo do GitLab nas tarefas

Depois que você cola seu primeiro link do GitLab na descrição ou comentário de uma tarefa, você verá um novo ícone GitLab na barra lateral direita de qualquer tarefa que esteja em Espaços que estão 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 usa o nome de usuário do ClickUp da pessoa, ou seu nome de usuário do GitLab se ela não tiver uma conta do ClickUp.

Atualizar 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 merge request. O ClickUp automaticamente capta nova atividade do GitLab e a associa a tarefas se você incluir um ID de tarefa válido em qualquer parte do título da merge request, descrição da merge request, nome da branch ou mensagem de commit.

O ID da tarefa deve ser formatado usando uma dessas 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 merge request.
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.

Gerenciar issues, branches, merge requests e commits do GitLab a partir do ClickUp

Depois de vincular issues, branches, merge requests ou commits, eles são exibidos no lado direito da sua tarefa quando você clica no ícone GitLab. Use o menu reticências … para copiar o link ou excluir o item.

Se você se juntou ao Workspace como convidado, não poderá usar a integração com o GitLab. Entre em contato com o proprietário ou administrador do seu Workspace para solicitar uma atualização para membro do Workspace.

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

Informações da issue

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

• A pessoa que abriu a issue, conhecida como autor
• Projeto
• O status da issue
• URL

Informações da branch

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

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

Informações da merge request

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

• A pessoa que abriu a merge request, conhecida como autor
• Quaisquer revisores designados
• Projeto
• O status da merge request
• URL

Informações do 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 Workspace podem vincular suas contas do GitLab à sua conta do ClickUp com antecedência ou quando criarem uma branch ou merge request.

Para adicionar sua conta do GitLab a partir do App Center:

1. Pesquise 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 Concluído.

Visualizar merge requests na visualização de Lista ou Tabela

Adicione a coluna Pull Requests a qualquer visualização de Lista ou visualização de Tabela para visualizar rapidamente suas merge requests do GitLab.

Problemas de conexão

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

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

Para desconectar um projeto:

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

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

Desconectar a integração do GitLab

Se você não precisa mais acessar arquivos do GitLab no ClickUp, pode desconectar a integração do seu Workspace.

Somente proprietários e administradores podem desconectar conexões do Workspace.

Do App Center:

1. Pesquise e selecione GitLab.
2. Selecione a aba Workspace.
3. Ao lado de Conectado, clique no menu reticências ….
4. Selecione Desconectar.
5. Para confirmar, clique em Desconectar.

---

Ficou com alguma dúvida? Acione o suporte oficial a qualquer momento.

Para soluções completas de implantação, treinamento ou licenciamento no Brasil, conte com a Audatia, parceira oficial do ClickUp. Descubra como podemos ajudar →