Collega direttamente gli spazi ai repository di Bitbucket (repos) per avere sempre chiaro quale lavoro è correlato.

I titolari e gli amministratori dell'area di lavoro possono collegare gli spazi ai loro repository, permettendo ai membri di aggiungere il loro lavoro di Bitbucket alle attività.

Le attività negli spazi con un repository collegato possono essere associate a commit, rami e richieste pull.

Cosa ti serve

• L'integrazione con Bitbucket è disponibile su ogni piano di ClickUp.
• Solo i titolari dell'area di lavoro e gli amministratori possono creare connessioni nell'area di lavoro. È consentita la connessione a più aree di lavoro.
• 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 nel App Center.
• Solo i titolari dell'area di lavoro e gli amministratori possono aggiungere e collegare repository agli spazi.
• I membri e superiori possono creare connessioni personali.
• Gli ospiti non possono utilizzare l'integrazione con Bitbucket.

Tipi di connessione

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

I comandi di ClickUp per Bitbucket sono disponibili solo per connessioni personali. I dati non sono collegati alle connessioni dell'area di lavoro. Quando un utente ha una connessione personale attiva e esegue un comando Bitbucket, vedrà un elenco di opzioni, come l'elenco dei repository, a cui è autorizzato ad accedere in Bitbucket.

Configura l'integrazione

Ci sono tre passaggi per configurare l'integrazione di Bitbucket in ClickUp:

1. Connetti Bitbucket.
2. Collega i repository Bitbucket al tuo spazio di lavoro.
   

   I repository sono necessari affinché ClickUp possa collegare automaticamente le richieste pull alle rispettive attività di ClickUp.

3. Collega i repository di Bitbucket agli spazi di ClickUp.

Puoi opzionalmente impostare un formato personalizzato per il nome del ramo. Questo formato è utilizzato nel pannello dell'app delle attività per creare rami direttamente da ClickUp.

Passo 1: Connetti Bitbucket

Per collegare Bitbucket dall'App Center:

1. Cerca e seleziona Bitbucket.
2. A seconda del tipo di connessione che desideri, seleziona la scheda Personale o Spazio di lavoro.
3. Scegli come vuoi autorizzare:
   • Account Bitbucket: Autorizza utilizzando il tuo account di bitbucket.org.
   • Versione auto-ospitata: Autorizza utilizzando un URL Bitbucket personalizzato.
4. Fai clic su Avanti.
5. Autorizza ClickUp.
6. Clicca su Terminato.

Passaggio 2: Collega i repository di Bitbucket al tuo area di lavoro

Solo il titolare della connessione può aggiungere repository. 

Collegare un repository non dà agli utenti di ClickUp accesso al codice del repository.

Per aggiungere un repository a un'area di lavoro:

1. Nell'App Center, cerca e seleziona Bitbucket.
2. In alto a destra, clicca su Impostazioni.
3. Sotto Collega Repository agli Spazi, clicca Aggiungi repository.
4. Seleziona il repository che desideri aggiungere.
5. Ripeti i passaggi sopra per aggiungere altri repository.

Se non vedi i repository corretti, assicurati di aver effettuato l'accesso con l'account giusto. Un titolare dell'area di lavoro o un amministratore deve selezionare ogni repository da collegare. I repository collegati possono essere visualizzati nell'App Center.

Passaggio 3: Collega i repository di Bitbucket agli spazi di ClickUp

Dopo aver aggiunto repository al tuo spazio di lavoro, un amministratore può aggiungere ogni repository a uno o più spazi. Ogni spazio di lavoro 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, clicca su Impostazioni.
3. Sotto Collega repository agli spazi, clicca sul nome del repository che desideri collegare.
4. Clicca + Aggiungi Spazio e seleziona uno Spazio.
5. Ripeti questo passaggio per aggiungere altri spazi.

Imposta il formato del nome del tuo ramo

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

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

Ad esempio: CU-ae27de_Nome-automatico_John-smith

Le opzioni disponibili sono mostrate nella seguente tabella:

Per impostare il formato del nome predefinito da Bitbucket nel Centro App:

1. Cerca e seleziona Bitbucket.
2. In alto a destra, clicca su Impostazioni.
3. Sotto Nome del ramo auto-generato, inserisci il formato del nome del ramo che preferisci.
4. Fai clic su Salva.

Collega attività da Bitbucket

ClickUp associa automaticamente le nuove attività di Bitbucket alle attività se includi un valido ID attività  di ClickUp in qualsiasi parte del titolo della richiesta pull, della descrizione della richiesta pull, del nome del ramo o del messaggio di commit.

Quando un ID attività di ClickUp è incluso in una richiesta pull, verrà pubblicato un commento con un link all'attività di ClickUp nella richiesta pull. Un link non verrà visualizzato quando si incolla manualmente una richiesta pull in un'attività di ClickUp.

Il commento sarà pubblicato utilizzando l'account Bitbucket della persona che ha configurato il mapping del repository e dello spazio.

L'ID dell'attività deve essere formattato utilizzando una di queste opzioni:

#{task_id}

CU-{task_id}

{custom_task_id}

#{custom_task_id}

Ad esempio:

#1abc2de

CU-1abc2de

eng-123

#eng-123

Collega attività da ClickUp

Collega manualmente le attività di ClickUp con i commit, i rami e le richieste pull 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, clicca sull'icona Bitbucket .
   

   A destra, vedrai suggeriti nomi di rami e messaggi di commit che puoi copiare negli appunti. Puoi anche copiare l'ID dell'attività da qui.

3. Nell'angolo in basso a destra, clicca su Aggiungi collegamento Bitbucket.
   
4. Incolla il collegamento.
5. Nell'angolo in basso a destra, clicca su Aggiungi.

Attività dell'attività di ClickUp

Il feed delle attività delle task a volte comprime elementi di attività simili per garantire che tu possa vedere i dettagli più importanti.

Puoi intraprendere le seguenti azioni per localizzare l'attività di Bitbucket:

• Clicca su Altri aggiornamenti per rivelare attività che sono state nascoste.
• Quando un ramo viene unito, i commit vengono visualizzati come un singolo elemento di attività nel feed di attività dell'attività.
  • Clicca sul link a tutti i commit per aprire una modalità.
  • Clicca su un commit individuale per aprirlo in Bitbucket.
• Filtra l'attività dell'attività per elementi Git.
  

Attività mancante 

Se non riesci a localizzare certe attività, assicurati di fare riferimento correttamente all'ID attività di ClickUp per collegare le attività in Bitbucket. Puoi utilizzare una delle seguenti opzioni per fare riferimento alle tue attività di ClickUp nei commit, nei nomi dei branch e nelle richieste pull:

#{task_id}

CU-{task_id}

{custom_task_id}

Ad esempio:

#1abc2de

CU-1abc2de

prefisso-1

Puoi collegare manualmente le attività di ClickUp con i commit, i rami e le richieste pull di Bitbucket dall'attività di ClickUp.

Anteprime del collegamento Bitbucket

Quando incolli un link Bitbucket in un'attività di ClickUp, Chat, o Doc, vedrai l'opzione per incollarlo come anteprima, menzione o URL.

Crea problemi, rami e richieste pull di Bitbucket da ClickUp

Crea nuovi rami e richieste pull direttamente dalle attività. Assicurati che l'attività sia situata in uno spazio che è collegato a un repository.

Per creare un ramo o una richiesta pull:

1. Apri un'attività e clicca sull'icona Bitbucket.
2. A destra, vedrai suggeriti nomi di rami e messaggi di commit che puoi copiare negli appunti. Puoi anche copiare l'ID dell'attività da qui.
3. Nell'angolo in basso a destra, clicca su Aggiungi collegamento Bitbucket.
4. Scegli una delle seguenti opzioni:
   • Nuovo ramo Bitbucket
   • Nuova richiesta pull Bitbucket
5. Nominare il ramo o la richiesta pull.
6. Seleziona un repository e compila le informazioni. Aggiungi un ramo sorgente e un ramo di destinazione se applicabile.
7. Fai clic su Crea.

Pannello dell'app Bitbucket nelle attività

Dopo aver incollato il tuo primo link di Bitbucket in una descrizione o commento dell'attività, vedrai una nuova icona Bitbucket nella barra laterale destra di qualsiasi attività che si trova negli spazi collegati ai repository. Puoi cliccare su questa icona in qualsiasi momento per vedere ogni link di Bitbucket postato nell'attività.

L'attività dell'attività di Bitbucket utilizza il nome utente di ClickUp della persona, o il loro nome utente Bitbucket se non hanno un account ClickUp.

Aggiorna gli stati delle attività da Bitbucket

Puoi aggiornare lo stato di un'attività di ClickUp quando colleghi un commit, esegui un push di un commit o crei una richiesta pull. 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 richiesta pull, nella descrizione della richiesta pull o nel messaggio di commit.

L'ID dell'attività deve essere formattato utilizzando una di queste opzioni:

#{task_id}[status]

CU-{task_id}[stato]

{custom_task_id}[status]

#{custom_task_id}[status]

Per aggiornare lo stato di un'attività:

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

Ad esempio: #ud5b[pronto]

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

Gestisci problemi, rami, richieste pull e commit di Bitbucket da ClickUp

Dopo aver collegato problemi, rami, richieste pull o commit, questi vengono visualizzati sul lato destro della tua attività quando clicchi sull'icona Bitbucket. Usa il menu puntini di sospensione ... per copiare il link o eliminare l'elemento.

Se ti sei unito all'area di lavoro come ospite, non potrai utilizzare l'integrazione di Bitbucket. Contatta il titolare o l'amministratore dell'area di lavoro per richiedere un aggiornamento a membro dell'area di lavoro.

Una volta che colleghi un elemento Bitbucket, le seguenti informazioni vengono visualizzate nella tua attività di ClickUp:

Informazioni sul problema

Dopo che un problema è stato collegato, puoi vedere i seguenti dettagli:

• La persona che ha aperto il problema, conosciuta come autore
• Qualsiasi revisore assegnato
• Collegamento creato
• Repository
• Lo stato del problema.
• URL

Informazioni sul ramo

Dopo che un ramo è stato collegato, puoi vedere i seguenti dettagli:

• La persona che ha creato il ramo, conosciuta come autore
• Creazione di link
• Repository
• URL

Informazioni sulla richiesta pull

Dopo che una richiesta pull è stata collegata, puoi vedere i seguenti dettagli:

• La persona che ha aperto la richiesta pull, conosciuta come autore
• Qualsiasi revisore assegnato
• Assegnatari
• Modifiche alle linee
• Collegamento creato
• Repository
• Ramo sorgente
• Ramo di destinazione
• Lo stato della richiesta pull
• URL

Informazioni sul commit

Dopo che un commit è stato collegato, puoi vedere i seguenti dettagli:

• La persona che ha creato il commit, conosciuta come autore
• Modifiche alle linee
• Collegamento creato
• Repository
• URL

Aggiungi il tuo account Bitbucket a ClickUp

Configura una connessione personale utilizzando il tuo account Bitbucket.

Per aggiungere il tuo account Bitbucket dal Centro App:

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

Problemi di connessione

A volte, l'account Bitbucket sbagliato è collegato o c'è un problema con la connessione. Per risolvere gli errori di connessione, prova a disconnettere e riconnettere i tuoi repository o l'intero account.

Queste azioni non influenzano la capacità di nessuno di accedere ai repository utilizzando il proprio account Bitbucket tramite Bitbucket.

Per disconnettere un repository dal Centro App:

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

La sezione sottostante include 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 dal Centro App:

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, clicca sul menu puntini ....
4. Seleziona Disconnetti.
5. Per confermare, clicca su Disconnetti.