Collega gli Spazi direttamente con i repository (repo) di Bitbucket per sapere sempre quale lavoro è correlato.

I titolari e gli amministratori dell'area di lavoro possono collegare gli Spazi ai loro repo, consentendo ai membri di aggiungere il proprio lavoro su Bitbucket alle attività.

Le attività negli Spazi con un repo collegato possono essere associate a commit, branch e pull request.

Cosa ti serve

• L'integrazione con Bitbucket è disponibile su tutti i piani ClickUp.
• Solo i titolari e gli amministratori dell'area di lavoro possono creare connessioni all'area di lavoro. Sono consentite più connessioni all'area di lavoro.
• I membri e i ruoli superiori possono creare connessioni personali.
• Gli ospiti e i membri con accesso limitato non possono usare l'integrazione con Bitbucket.
• Solo gli amministratori del repository possono aggiungere repository Bitbucket a ClickUp.
• Solo i titolari e gli amministratori dell'area di lavoro possono aggiornare le impostazioni dell'area di lavoro nell'App Center.
• Solo i titolari e gli amministratori dell'area di lavoro possono aggiungere e collegare repository agli Spazi.

Tipi di connessione

Le funzionalità e i comandi disponibili dipendono dal tipo di connessione che utilizzi.

I comandi ClickUp per Bitbucket sono disponibili solo per le connessioni personali. I dati non sono collegati alle connessioni dell'area di lavoro. Quando un utente ha una connessione personale attiva ed esegue un comando Bitbucket, visualizza un elenco di opzioni, come gli elenchi di repository, che è autorizzato a vedere in Bitbucket.

Configura l'integrazione

Per configurare l'integrazione con Bitbucket in ClickUp sono necessari tre passaggi:

1. Connetti Bitbucket.
2. Collega i repository Bitbucket alla tua Area di lavoro. I repository sono necessari affinché ClickUp possa collegare automaticamente le pull request alle rispettive attività di ClickUp.
3. Collega i repository Bitbucket agli Spazi di ClickUp.

Puoi facoltativamente impostare un formato personalizzato per i nomi dei branch. Questo formato viene utilizzato nel pannello dell'app delle attività per creare branch direttamente da ClickUp.

Passaggio 1: connetti Bitbucket

Per connettere Bitbucket dall'App Center:

1. Cerca e seleziona Bitbucket.
2. A seconda del tipo di connessione desiderata, seleziona la scheda Personale o Area di lavoro.
3. Scegli come vuoi autorizzare:
   • Account Bitbucket: autorizza tramite il tuo account bitbucket.org.
   • Versione self-hosted: autorizza tramite un URL Bitbucket personalizzato.

     

4. Fai clic su Avanti.
5. Autorizza ClickUp.
6. Fai clic su Fine.

Passaggio 2: collega i repository Bitbucket alla tua Area di lavoro

Solo il titolare della connessione può aggiungere repository.

Il collegamento di un repository non concede agli utenti di ClickUp l'accesso al codice sorgente del repository.

Per aggiungere un repository a un'Area di lavoro:

1. Nell'App Center, cerca e seleziona Bitbucket.
2. In alto a destra, fai clic su Impostazioni.
3. Nella sezione Connetti repository agli Spazi, fai clic su Aggiungi repository.
4. Seleziona il repository che vuoi aggiungere.
5. Ripeti i passaggi precedenti per aggiungere altri repository.

Se non vedi i repository corretti, assicurati di aver effettuato l'accesso all'account giusto. Il titolare o un amministratore dell'Area di lavoro deve selezionare ogni repository da connettere. I repository collegati sono visibili nell'App Center.

Passaggio 3: collega i repository Bitbucket agli Spazi di ClickUp

Dopo aver aggiunto i repository alla tua Area di lavoro, un amministratore può aggiungere ogni repository a uno o più Spazi. Ogni Spazio di ClickUp può avere più repository aggiunti.

Puoi aggiungere o rimuovere repository dagli Spazi in qualsiasi momento.

Per collegare un repository a uno Spazio:

1. Nell'App Center, cerca e seleziona Bitbucket.
2. In alto a destra, fai clic su Impostazioni.
3. Nella sezione Connetti repository agli Spazi, fai clic sul nome del repository che vuoi collegare.
4. Fai clic su + Aggiungi Spazio e seleziona uno Spazio.
5. Ripeti questo passaggio per aggiungere altri Spazi.

Imposta il formato del nome del branch

Se la tua organizzazione utilizza un formato specifico per i nomi dei branch, puoi impostarlo dalla pagina Bitbucket nell'App Center. Quando le persone creano branch dalle attività di ClickUp, verrà utilizzato questo formato.

Il formato predefinito è: :taskId:_:taskName:_:username:

Ad esempio: CU-ae27de_Auto-generated-naming_John-smith

Le opzioni disponibili sono mostrate nella tabella seguente:

Per impostare il formato del nome predefinito da Bitbucket nell'App Center:

1. Cerca e seleziona Bitbucket.
2. In alto a destra, fai clic su Impostazioni.
3. Nella sezione Nome branch generato automaticamente, inserisci il formato del nome del branch che preferisci.
4. Fai clic su Salva.

Collega le attività da Bitbucket

ClickUp associa automaticamente la nuova attività di Bitbucket alle attività se includi un ID attività ClickUp valido in qualsiasi parte del titolo della pull request, della descrizione della pull request, del nome del branch o del messaggio di commit.

Quando un ID attività di ClickUp è incluso in una pull request, nella pull request verrà pubblicato un commento con un collegamento all'attività di ClickUp. Il collegamento non viene visualizzato quando si incolla manualmente una pull request in un'attività di ClickUp.

Il commento verrà pubblicato utilizzando l'account Bitbucket della persona che ha configurato il repository e la mappatura degli Spazi.

L'ID attività deve essere formattato utilizzando una delle seguenti opzioni:

#{task_id}

CU-{task_id}

{custom_task_id}

#{custom_task_id}

Ad esempio:

#1abc2de

CU-1abc2de

eng-123

#eng-123

Collega le attività da ClickUp

Collega manualmente le attività di ClickUp con commit, branch e pull request di Bitbucket dalle attività di ClickUp. Assicurati che l'attività si trovi in uno Spazio collegato a un repository.

Per collegare un'attività:

1. Apri l'attività.
2. Nella barra laterale destra, fai clic sull'icona di Bitbucket. Sulla destra vedrai i nomi di branch suggeriti e i messaggi di commit che puoi copiare negli appunti. Puoi anche copiare l'ID dell'attività da qui.
3. Nell'angolo in basso a destra, fai clic su Aggiungi link Bitbucket.

   

4. Incolla il link.
5. Nell'angolo in basso a destra, fai clic su Aggiungi.

Attività delle attività ClickUp

Il feed delle attività a volte raggruppa elementi simili per mostrarti i dettagli più importanti.

Puoi eseguire le seguenti azioni per individuare l'attività di Bitbucket:

• Fai clic su Altri aggiornamenti per visualizzare le attività nascoste.
• Quando un branch viene unito, i commit vengono visualizzati come un singolo elemento nel feed delle attività.
  • Fai clic sul link a tutti i commit per aprire un modale.
  • Fai clic su un singolo commit per aprirlo in Bitbucket.
• Filtra le attività per Elementi Git.

  

Attività mancanti

Se non riesci a individuare una determinata attività, verifica di fare riferimento correttamente all'ID attività ClickUp per collegare l'attività in Bitbucket. Puoi usare una delle seguenti opzioni per fare riferimento alle tue attività ClickUp su commit, nomi di branch e pull request:

#{task_id}

CU-{task_id}

{custom_task_id}

Ad esempio:

#1abc2de

CU-1abc2de

prefix-1

Puoi collegare manualmente le attività ClickUp con commit, branch e pull request di Bitbucket dall'attività ClickUp.

Anteprime dei link Bitbucket

Quando incolli un link Bitbucket a metà di una frase o all'interno di testo già presente, viene visualizzata un'anteprima del link in linea su cui puoi passare il mouse per ulteriori dettagli.

Quando incolli un link Bitbucket su una nuova riga, puoi scegliere di visualizzarlo in linea, come anteprima live o come URL normale.

Le anteprime dei link funzionano nelle descrizioni delle attività, nei commenti, nei Documenti e nei messaggi della Chat. Per modificare manualmente il tipo di anteprima di un link, passa il mouse su di esso e fai clic sull'icona dei puntini di sospensione ….

Crea problemi, branch e pull request di Bitbucket da ClickUp

Crea nuovi branch e pull request direttamente dalle attività. Assicurati che l'attività si trovi in uno Spazio collegato a un repository.

Per creare un branch o una pull request:

1. Apri un'attività e fai clic sull'icona di Bitbucket.
2. Sulla destra vedrai i nomi di branch suggeriti e i messaggi di commit che puoi copiare negli appunti. Da qui puoi anche copiare l'ID dell'attività.
3. Nell'angolo in basso a destra, fai clic su Aggiungi link Bitbucket.
4. Scegli una delle seguenti opzioni:
   • Nuovo branch Bitbucket
   • Nuova pull request Bitbucket
5. Assegna un nome al branch o alla pull request.
6. Seleziona un repository e compila le informazioni. Aggiungi un branch sorgente e un branch di destinazione, se applicabile.
7. Fai clic su Crea.

Pannello app Bitbucket nelle attività

Dopo aver incollato il primo link Bitbucket nella descrizione o in un commento di un'attività, vedrai una nuova icona Bitbucket nella barra laterale destra di qualsiasi attività che si trova in Spazi collegati a repository. Puoi fare clic su questa icona in qualsiasi momento per vedere tutti i link Bitbucket pubblicati nell'attività.

L'attività delle attività Bitbucket utilizza il nome utente ClickUp della persona oppure il suo nome utente Bitbucket se non dispone di un account ClickUp.

Aggiorna gli stati delle attività da Bitbucket

Puoi aggiornare lo stato di un'attività ClickUp quando colleghi un commit, esegui il push di un commit o crei una pull request. ClickUp rileva automaticamente le nuove attività di Bitbucket e le associa alle attività se includi un ID attività valido in qualsiasi parte del titolo della pull request, della descrizione della pull request o del messaggio di commit.

L'ID attività deve essere formattato utilizzando una delle seguenti opzioni:

#{task_id}[status]

CU-{task_id}[status]

{custom_task_id}[status]

#{custom_task_id}[status]

Per aggiornare lo stato di un'attività:

1. Aggiungi l'ID attività ClickUp in qualsiasi parte del messaggio di commit o di pull request.
2. Includi lo stato aggiornato dell'attività tra parentesi quadre.

Ad esempio: #ud5b[ready]

Tutti i formati elencati nella sezione Collega attività da Bitbucket di questo articolo possono essere utilizzati. Per garantire la formattazione corretta, non aggiungere uno spazio tra l'ID attività e le informazioni sullo stato.

Gestisci problemi, branch, pull request e commit di Bitbucket da ClickUp

Dopo aver collegato problemi, branch, pull request o commit, questi vengono visualizzati sul lato destro dell'attività quando fai clic sull'icona Bitbucket. Usa il menu puntini di sospensione ... per copiare il link o eliminare l'elemento.

Se hai aderito all'area di lavoro come ospite, non potrai usare l'integrazione con Bitbucket. Contatta il titolare o l'amministratore dell'area di lavoro per richiedere un aggiornamento a membro dell'area di lavoro.

Dopo aver collegato un elemento di Bitbucket, nell'attività ClickUp vengono visualizzate le seguenti informazioni:

Informazioni sul problema

Dopo aver collegato un problema, puoi vedere i seguenti dettagli:

• La persona che ha aperto il problema, nota come autore
• Eventuali revisori assegnati
• Link creato
• Repository
• Lo stato del problema
• URL

Informazioni sul branch

Dopo aver collegato un branch, puoi vedere i seguenti dettagli:

• La persona che ha creato il branch, nota come autore
• Creatore del link
• Repository
• URL

Informazioni sulla pull request

Dopo aver collegato una pull request, puoi vedere i seguenti dettagli:

• La persona che ha aperto la pull request, nota come autore
• Eventuali revisori assegnati
• Assegnatari
• Modifiche alle righe
• Link creato
• Repository
• Branch sorgente
• Branch di destinazione
• Lo stato della pull request
• URL

Informazioni sul commit

Dopo aver collegato un commit, puoi vedere i seguenti dettagli:

• La persona che ha creato il commit, nota come autore
• Modifiche alle righe
• Link creato
• Repository
• URL

Aggiungi il tuo account Bitbucket a ClickUp

Configura una connessione personale usando il tuo account Bitbucket.

Per aggiungere il tuo account Bitbucket dall'App Center:

1. Cerca e seleziona Bitbucket.
2. Fai clic su Connetti.
3. Accedi a Bitbucket e autorizza ClickUp.
4. Fai clic su Fine.

Problemi di connessione

A volte viene collegato l'account Bitbucket errato oppure si verifica un problema con la connessione. Per correggere gli errori di connessione, prova a disconnettere e riconnettere i tuoi repository o l'intero account.

Queste azioni non influiscono sulla capacità di nessuno di accedere ai repository tramite il proprio account Bitbucket attraverso Bitbucket.

Per disconnettere un repository dall'App Center:

1. Cerca e seleziona Bitbucket.
2. Nell'angolo in alto a destra, fai clic su Impostazioni.
3. Sotto Repository, fai clic sul menu puntini di sospensione ... a destra del repository.
4. Fai clic su Elimina da ClickUp.

La sezione seguente include le istruzioni per disconnettere l'intero account.

Disconnetti l'integrazione con Bitbucket

Se non hai più bisogno di accedere ai file di Bitbucket in ClickUp, puoi disconnettere l'integrazione dall'App Center:

1. Cerca e seleziona Bitbucket.
2. Seleziona la scheda Area di lavoro. Solo i titolari e gli amministratori possono disconnettere le connessioni dell'Area di lavoro.
3. Accanto a Connesso, fai clic sul menu puntini di sospensione ....
4. Seleziona Disconnetti.
5. Per confermare, fai clic su Disconnetti.