Collega direttamente gli spazi ai progetti GitLab per avere sempre chiaro il lavoro correlato.

Attività negli spazi con un progetto collegato possono essere associate a commit, rami e richieste di unione.

Cosa ti serve

• L'integrazione con GitLab è disponibile su tutti i piani ClickUp.
• Solo i titolari dell'area di lavoro e gli amministratori possono aggiungere progetti Gitlab nel App Center.
• I titolari e gli amministratori dell'area di lavoro possono collegare gli Spazi ai loro progetti, permettendo ai membri di aggiungere il loro lavoro di GitLab alle attività.
• Solo i titolari dell'area di lavoro e gli amministratori possono creare connessioni nell'area di lavoro. Sono consentite più connessioni nell'area di lavoro.
• I membri e superiori possono creare connessioni personali.

• Ospiti e membri con accesso limitato non possono utilizzare l'integrazione con GitLab.

Tipi di connessione

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

I comandi di ClickUp per GitLab sono disponibili solo per connessioni personali. I dati non sono collegati alle connessioni del Workspace. Quando un utente ha una connessione personale attiva e esegue un comando GitLab, vedrà un elenco di opzioni, come gli elenchi di progetti, a cui è autorizzato ad accedere in GitLab.

Configura l'integrazione

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

1. Connetti GitLab.
2. Collega i progetti GitLab al tuo spazio di lavoro.
   

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

3. Collega i progetti GitLab agli spazi di ClickUp.
4. Opzionalmente, puoi impostare un formato personalizzato per il nome del ramo.

Passo 1: Connetti GitLab

Per collegare GitLab dal Centro App:

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

Passaggio 2: Collega i progetti GitLab al tuo spazio di lavoro

Solo il titolare della connessione può aggiungere progetti. Allegare un progetto non concede agli utenti di ClickUp l'accesso al codice del tuo repository.

Per garantire che tutti i progetti GitLab siano visualizzati nell'App Center, imposta autorizzazioni individuali per ogni progetto invece di utilizzare autorizzazioni di gruppo.

Per aggiungere un progetto a un'area di lavoro:

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

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

Passaggio 3: Collega i progetti GitLab agli spazi di ClickUp

Dopo aver aggiunto progetti al tuo spazio di lavoro, un amministratore può aggiungere ciascun progetto a uno o più spazi. Ogni spazio di ClickUp può avere più progetti aggiunti.

Puoi aggiungere o rimuovere progetti dagli spazi in qualsiasi momento.

Per collegare un progetto a uno spazio:

1. Nell'App Center, cerca e seleziona GitLab.
2. In alto a destra, clicca su Impostazioni.
3. Sotto Collega progetti agli spazi, clicca sul nome del progetto che desideri collegare.
4. Clicca su Aggiungi Spazio e seleziona uno Spazio. Ripeti questo passaggio per aggiungere altri Spazi.

Imposta il formato del nome del ramo

Se la tua organizzazione utilizza un formato specifico per i nomi dei rami, puoi impostarlo dalla pagina di GitLab nel Centro App. Quando le persone creano rami 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 seguente tabella:

Per impostare il tuo formato di nome predefinito da GitLab nel Centro App:

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

Collega attività da GitLab

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

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

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

L'ID 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

Puoi anche collegare manualmente le attività di ClickUp con i commit, i rami e le richieste di unione di GitLab dall'attività di ClickUp. Assicurati che l'attività sia situata in uno spazio collegato a un progetto.

Per collegare un'attività:

1. Apri un'attività e clicca sull'icona GitLab a destra.
2. A destra, vedrai i nomi dei rami suggeriti e i messaggi di commit che puoi copiare negli appunti. Puoi anche copiare l'ID attività da qui.
3. Nell'angolo in basso a destra, clicca su Aggiungi link GitLab.
   
4. Incolla un link.
5. Nell'angolo in basso a destra, clicca su Aggiungi.

Attività dell'attività di ClickUp

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

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

• Clicca Altre aggiornamenti per mostrare attività che erano state nascoste.
• Quando un ramo viene unito, i commit vengono visualizzati come un unico elemento di attività nel feed di attività dell'attività.
  • Clicca il link a tutti i commit per aprire un menu.
  • Clicca su un commit individuale per aprirlo in GitLab.
• 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 GitLab. Puoi utilizzare una di queste tre opzioni per fare riferimento alle tue attività di ClickUp nei commit, nei nomi dei rami e nelle richieste di unione:

#{task_id}

CU-{task_id}

{custom_task_id}

Ad esempio:

#1abc2de

CU-1abc2de

prefisso-1

Puoi collegare manualmente le attività di ClickUp ai commit, rami e richieste di unione di GitLab direttamente dall'attività di ClickUp.

Anteprime dei link GitLab

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

Crea problemi, rami e richieste di unione di GitLab da ClickUp

Puoi anche creare nuovi problemi, rami e richieste di unione direttamente dalle attività. Assicurati che l'attività si trovi in uno spazio collegato a un progetto.

Per creare un problema, un ramo o una richiesta di unione:

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

Pannello dell'app GitLab nelle attività

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

L'attività di GitLab utilizza il nome utente di ClickUp della persona, o il suo nome utente di GitLab se non ha un account ClickUp.

Aggiorna gli stati delle attività da GitLab

Puoi aggiornare lo stato di un'attività di ClickUp quando colleghi un commit, effettui un commit o crei una richiesta di unione. ClickUp rileva automaticamente le nuove attività di GitLab e le associa alle attività se includi un ID attività valido in qualsiasi parte del titolo della richiesta di unione, nella descrizione della richiesta di unione, nel nome del ramo o nel messaggio di commit.

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

#{task_id}[stato]

CU-{task_id}[status]

{custom_task_id}[stato]

#{custom_task_id}[stato]

Per aggiornare lo stato di un'attività:

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

Per esempio: #ud5b[pronto]

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

Gestisci problemi, rami, richieste di unione e commit di GitLab da ClickUp

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

Se ti sei unito allo spazio di lavoro come ospite, non potrai utilizzare l'integrazione con GitLab. Contatta il titolare dello spazio di lavoro o l'amministratore per richiedere un aggiornamento a membro dello spazio di lavoro.

Una volta collegato un elemento di GitLab, 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
• Progetto
• Lo stato del problema
• URL

Informazioni sul ramo

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

• La persona che ha creato il ramo, conosciuta come autore
• Creatore del collegamento
• Progetto
• URL

Informazioni sulla richiesta di unione

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

• La persona che ha aperto la richiesta di unione, conosciuta come autore
• Eventuali revisori assegnati
• Progetto
• Lo stato della richiesta di unione
• URL

Informazioni sul commit

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

• La persona che ha creato il commit, noto come autore
• Modifiche alla linea
• Progetto
• URL

Aggiungi il tuo account GitLab a ClickUp

I membri dell'area di lavoro possono collegare i loro account GitLab al loro account ClickUp in anticipo o quando creano un ramo o una richiesta di unione.

Per aggiungere il tuo account GitLab dal Centro App:

1. Cerca e seleziona GitLab.
2. Accanto a Crea una connessione personale, clicca su Connetti.
3. Accedi a GitLab e autorizza ClickUp.
4. Clicca su Terminato.

Visualizza le richieste di unione in vista Elenco o vista Tabella

Aggiungi la colonna delle richieste pull a qualsiasi vista Elenco o vista Tabella per visualizzare rapidamente le tue richieste di unione su GitLab.

Problemi di connessione

A volte, l'account GitLab sbagliato è collegato o c'è un problema con la connessione. In questo scenario, puoi provare a disconnettere e riconnettere i tuoi progetti o l'intero account.

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

Per scollegare un progetto:

1. Dal App Center, seleziona GitLab.
2. Nell'angolo in alto a destra, clicca Impostazioni.
3. Sotto Progetto, clicca sul menu puntini di sospensione ... a destra del progetto.
4. Clicca su Elimina da ClickUp.

La sezione sottostante include istruzioni per disconnettere l'intero account.

Disconnetti l'integrazione con GitLab

Se non hai più bisogno di accedere ai file GitLab in ClickUp, puoi disconnettere l'integrazione dal tuo spazio di lavoro.

Solo i titolari e gli amministratori possono disconnettere le connessioni dell'area di lavoro.

Nell'App Center:

1. Cerca e seleziona GitLab.
2. Seleziona la scheda Area di lavoro.
3. Accanto a Connesso, clicca sul menu puntini di sospensione ....
4. Seleziona Disconnetti.
5. Per confermare, clicca su Scollega.