Vincule espaços diretamente com repositórios do Bitbucket para sempre saber quais trabalhos estão relacionados.

Proprietários de espaços de trabalho e administradores podem conectar espaços aos seus repositórios, permitindo que membros adicionem seus trabalhos do Bitbucket a tarefas.

Tarefas em espaços com um repositório conectado podem ser vinculadas com commits, branches e solicitações de pull.

O que você vai precisar

• A integração com o Bitbucket está disponível em todos os planos do ClickUp.
• Apenas proprietários e administradores do espaço de trabalho podem criar conexões do Espaço de trabalho. São permitidas múltiplas conexões de Espaço de trabalho.
• Apenas administradores de repositório podem adicionar repositórios Bitbucket ao ClickUp.
• Apenas os proprietários e administradores do espaço de trabalho podem atualizar as configurações do espaço de trabalho na Central de Aplicativos.
• Somente os proprietários do espaço de trabalho e administradores podem adicionar e vincular repositórios aos espaços.
• Membros e superiores podem criar conexões pessoais.
• Convidados não podem usar a integração com Bitbucket.

Tipos de conexão

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

Comandos do ClickUp para Bitbucket 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 do Bitbucket, ele verá uma lista de opções, como listas de repositórios, que ele está autorizado a visualizar no Bitbucket.

Configure a integração

Existem três passos para configurar a integração do Bitbucket no ClickUp:

1. Conecte o Bitbucket.
2. Anexe repositórios Bitbucket ao seu Espaço de trabalho.
   

   Repositórios são necessários para que o ClickUp possa vincular automaticamente solicitações de pull aos respectivos tarefas do ClickUp.

3. Vincule repositórios do Bitbucket aos Espaços do ClickUp.

Você pode opcionalmente definir um formato de nome de branch personalizado. Esse formato é usado no painel de aplicativos da tarefa para criar branches diretamente do ClickUp.

Passo 1: Conectar Bitbucket

Para conectar o Bitbucket a partir da Central de Aplicativos:

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

Passo 2: Anexe repositórios do Bitbucket ao seu espaço de trabalho

Somente o proprietário da conexão pode adicionar repositórios. 

Anexar um repositório não concede aos usuários do ClickUp acesso ao código-fonte do seu repositório.

Para adicionar um repositório a um espaço de trabalho:

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

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

Etapa 3: Vincule repositórios do Bitbucket aos Espaços do ClickUp

Após adicionar repositórios ao seu Espaço de trabalho, um administrador pode adicionar cada repositório a um ou mais Espaços. Cada Espaço ClickUp pode ter vários repositórios adicionados.

Você pode adicionar ou remover repositórios dos Espaços a qualquer momento.

Para vincular um repositório a um Espaço:

1. Na Central de Aplicativos, procure e selecione Bitbucket.
2. No canto superior direito, clique em Configurações.
3. Em Conectar Repositórios aos Espaços, clique no nome do repositório que deseja vincular.
4. Clique em + Adicionar Espaço e selecione um Espaço.
5. Repita este passo 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 configurá-lo a partir da página do Bitbucket na Central de Aplicativos. Quando as pessoas criam branches a partir de tarefas do ClickUp, esse formato será utilizado.

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

Por exemplo: CU-ae27de_Nomeação-automática_John-smith

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

Para definir seu formato de nome padrão do Bitbucket no Centro de Aplicativos:

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

Vincule tarefas do Bitbucket

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

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

O comentário será postado usando a conta do Bitbucket da pessoa que configurou o mapeamento do repositório e do espaço.

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

#{task_id}

CU-{task_id}

{custom_task_id}

#{custom_task_id}

Por exemplo:

#1abc2de

CU-1abc2de

eng-123

#eng-123

Vincule tarefas do ClickUp

Vincule manualmente tarefas ClickUp com commits, branches e solicitações de pull do Bitbucket a partir de tarefas ClickUp. Certifique-se de que a tarefa esteja localizada em um espaço que está vinculado a um repositório.

Para vincular uma tarefa:

1. Abra a tarefa.
2. Na barra lateral direita, clique no ícone do Bitbucket .
   

   À 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 Bitbucket.
   
4. Cole o link.
5. No canto inferior direito, clique em Adicionar.

Atividade da tarefa ClickUp

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

Você pode tomar as seguintes ações para localizar atividades do Bitbucket:

• Clique em Mais atualizações para revelar atividades que foram ocultadas.
• Quando um branch é mesclado, os commits são exibidos como um único item de atividade no feed de atividades da tarefa.
  • Clique no link para todos os commits para abrir um modal.
  • Clique em um commit individual para abri-lo no Bitbucket.
• Filtre a atividade da tarefa por Itens do Git.
  

Atividade ausente 

Se você não conseguir localizar certas atividades, certifique-se de que está referenciando corretamente o ID de tarefa do ClickUp para vincular atividades no Bitbucket. Você pode usar qualquer uma das seguintes opções para referenciar suas tarefas do ClickUp em commits, nomes de branches e solicitações de pull:

#{task_id}

CU-{task_id}

{custom_task_id}

Por exemplo:

#1abc2de

CU-1abc2de

prefixo-1

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

Previsões de link do Bitbucket

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

Crie problemas, branches e solicitações de pull do Bitbucket a partir do ClickUp

Crie novos branches e solicitações de pull diretamente das tarefas. Certifique-se de que a tarefa esteja localizada em um espaço que esteja vinculado a um repositório.

Para criar um branch ou solicitação de pull:

1. Abra uma tarefa e clique no ícone Bitbucket.
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 Bitbucket.
4. Escolha uma das seguintes opções:
   • Novo Branch Bitbucket
   • Nova Solicitação de Pull no Bitbucket
5. Nomeie a branch ou solicitação de pull.
6. Selecione um repositório e preencha as informações. Adicione um branch de origem e um branch de destino, se aplicável.
7. Clique em Criar.

Painel de aplicativos do Bitbucket em tarefas

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

A atividade da tarefa Bitbucket usa o nome de usuário do ClickUp da pessoa, ou o nome de usuário do Bitbucket se ela não tiver uma conta ClickUp.

Atualize os status das tarefas a partir do Bitbucket

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

O ID da tarefa deve ser formatado usando uma das seguintes 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 do commit ou solicitação de pull.
2. Inclua o status atualizado da tarefa entre colchetes.

Por exemplo: #ud5b[pronto]

Todos os formatos listados na seção Vincular tarefas do Bitbucket 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, branches, solicitações de pull e commits do Bitbucket a partir do ClickUp

Após você vincular problemas, branches, solicitações de pull ou commits, eles aparecem no lado direito da sua tarefa quando você clica no ícone do Bitbucket. 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 Bitbucket. Entre em contato com o proprietário ou administrador do seu Espaço de trabalho para solicitar um upgrade para membro do Espaço de trabalho.

Uma vez que um item do Bitbucket é vinculado, 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
• Qualquer revisor atribuído
• Link criado
• Repositório
• Status do problema.
• URL

Informações do branch

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

• A pessoa que criou o branch, conhecida como autor
• Criador do link
• Repositório
• URL

Informações da solicitação de pull

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

• A pessoa que abriu a solicitação de pull, conhecida como autor
• Qualquer revisor atribuído
• Responsáveis
• Mudanças de linha
• Link criado
• Repositório
• Branch de origem
• Branch de destino
• O status da solicitação de pull
• 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
• Mudanças de linha
• Link criado
• Repositório
• URL

Adicione sua conta do Bitbucket ao ClickUp

Configure uma conexão pessoal usando sua conta do Bitbucket.

Para adicionar sua conta Bitbucket a partir da Central de Aplicativos:

1. Procure e selecione Bitbucket.
2. Clique em Conectar.
3. Faça login no Bitbucket e autorize o ClickUp.
4. Clique em Feito.

Problemas de conexão

Às vezes, a conta Bitbucket errada é vinculada ou há um problema com a conexão. Para corrigir erros de conexão, tente desconectar e reconectar seus repositórios ou conta inteira.

Essas ações não afetam a capacidade de ninguém de acessar repositórios usando sua conta do Bitbucket através do Bitbucket.

Para desconectar um repositório da Central de Aplicativos:

1. Procure e selecione Bitbucket.
2. No canto superior direito, clique em Configurações.
3. Em Repositórios, clique no menu reticências ... à direita do repositório.
4. Clique em Excluir do ClickUp.

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

Desconecte a integração do Bitbucket

Se você não precisar mais acessar arquivos do Bitbucket no ClickUp, pode desconectar a integração a partir da Central de Aplicativos:

1. Procure e selecione Bitbucket.
2. Selecione a aba Espaço de trabalho.
   

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

3. Ao lado de Conectado, clique no menu reticências ....
4. Selecione Desconectar.
5. Para confirmar, clique em Desconectar.