Collega spazi direttamente con i repository GitHub per essere sempre aggiornato sul lavoro correlato.

I proprietari dello spazio di lavoro e gli amministratori possono collegare gli Spazi ai loro repository, permettendo ai membri di aggiungere il loro lavoro su Github alle attività.

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

Cosa ti serve

• L'integrazione GitHub è disponibile su ogni piano ClickUp.
• Solo gli amministratori del repository possono aggiungere repository GitHub a ClickUp. Una volta aggiunti, gli amministratori dello spazio di lavoro possono aggiungere quei repository agli spazi di ClickUp!
• Solo i proprietari e gli amministratori dello spazio di lavoro possono aggiornare le configurazioni dello spazio di lavoro nella Central de Aplicativos .
• Solo i proprietari dello spazio di lavoro e gli amministratori possono aggiungere e collegare repository agli spazi.
• Solo i proprietari e gli amministratori dello spazio di lavoro possono creare connessioni dello spazio di lavoro. È consentita la connessione a più spazi di lavoro.
• Membri e superiori possono creare connessioni personali.
• Gli ospiti non possono utilizzare l'integrazione con GitHub.

• La Ricerca Connessa nello Spazio è disponibile nel piano Business e superiori.

• La Ricerca Connessa Personale non è disponibile per l'integrazione con GitHub.

Esempio pratico

Il team di ingegneria della tua app mobile e il team di sviluppo del sito web lavorano in repository e Spazi separati, all'interno della stessa organizzazione GitHub e dello stesso Spazio di lavoro ClickUp.

Per iniziare con l'integrazione:

1. Il proprietario dello spazio di lavoro o l'amministratore crea una connessione GitHub nello spazio di lavoro.
2. Il gestore dell'app mobile collega il repository app-mobile di GitHub allo spazio di sviluppo dell'app mobile.
3. Il gestore del sito web collega il repository GitHub del sito web allo spazio marketing sito web.
4. Le attività negli spazi sviluppo app mobile e sito web di marketing ora mostrano l'icona di GitHub, permettendo a entrambi i team di collegare le loro attività con commit, rami e richieste pull di GitHub.

Configura l'integrazione

Ci sono quattro passaggi per configurare l'integrazione con GitHub in ClickUp:

1. Collega GitHub.
2. Collega i repository GitHub al tuo area di lavoro.
3. Collega i repository GitHub agli spazi di ClickUp.
4. Opzionalmente, puoi impostare un formato personalizzato per il nome del branch.

Passo 1: Connetti GitHub

Per impostare una connessione area di lavoro per GitHub, devi essere il proprietario o l'amministratore di un'area di lavoro.

Puoi configurare una connessione GitHub dalla Central di Applicazioni o dal centro di comando.

Nell'App Center:

1. Cerca e seleziona GitHub.
2. Clicca sulla scheda Area di lavoro.
   

   Puoi anche impostare una connessione personale per creare pull request e branch da ClickUp. Le connessioni personali possono essere utilizzate anche per collegare richieste pull, rami e commit esistenti direttamente dalle attività di ClickUp. 

3. Clicca su Connetti.
4. Accedi al tuo account GitHub per autorizzare l'accesso.

Dal Centro di comando:

1. Sotto la barra di ricerca, clicca su App.
2. Sotto GitHub, clicca su Connetti.
3. In Connessioni dell'area di lavoro, clicca su Connetti.
4. Accedi al tuo account GitHub per autorizzare l'accesso.

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

I proprietari e gli amministratori dello spazio di lavoro possono scegliere quali repository GitHub collegare al loro spazio di lavoro ClickUp. Il proprietario o l'amministratore deve essere anche un amministratore del repository GitHub.

Collegare un repo non concede agli utenti di ClickUp l'accesso al codice sorgente del tuo repo.

Per aggiungere un repository a un'area di lavoro:

1. Apri GitHub nel Centro di Applicazioni.
2. Clicca su Impostazioni dello Spazio di lavoro.
3. Accanto a Collega repository a ClickUp, clicca su Aggiungi repository.
4. Seleziona tutti i repository che vuoi aggiungere.

Se non vedi i repository corretti, potresti esserti autenticato con l'account GitHub sbagliato.

Passaggio 3: Collega i repository GitHub agli spazi ClickUp

Dopo aver aggiunto repositori al tuo Spazio di lavoro, puoi aggiungere ogni repositorio a uno o più Spazi. Ogni Spazio ClickUp può avere più repositori aggiunti.

Puoi aggiungere o rimuovere repository dagli spazi in qualsiasi momento.

Per collegare un repository a uno spazio:

1. Apri GitHub nel Centro di Applicazioni.
2. Clicca su Impostazioni dello Spazio di lavoro.
3. Clicca sul nome del repository che vuoi collegare.
4. Clicca su + Aggiungi spazio.
5. Ripeti per gli altri spazi che desideri collegare.

Passo 4: Imposta il formato del nome del tuo branch

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

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

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

Le opzioni disponibili sono mostrate nella tabella seguente:

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

1. Clicca su Impostazioni dello Spazio di lavoro.
2. Sotto Nome del ramo auto-generato, inserisci il formato del nome del ramo che preferisci.
3. Fai clic su Salva.

Cerca file su GitHub usando la Ricerca collegata

Utilizzando una connessione nello spazio di lavoro nel piano Business e superiori, puoi usare Busca conectada do espaço de trabalho per permettere a tutti i membri dello spazio di lavoro di cercare qualsiasi file pubblico dai repository che aggiungi. I file privati non possono essere cercati.

Nell'App Center:

1. Cerca e seleziona GitHub.
2. Clicca sulla scheda Spazio di lavoro.
3. Fai clic sul pulsante di attivazione/disattivazione accanto a Ricerca connessa nell'area di lavoro.
4. Accanto alla connessione all'area di lavoro, clicca su Salva.
5. I file di GitHub nei repository che hai aggiunto verranno visualizzati quando cerchi nella tua area di lavoro.

Aggiungi GitHub al centro di comando

Filtra i risultati di ricerca per file su GitHub aggiungendo GitHub al Centro di comando.

Collega le attività da GitHub

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

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

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

L'ID della tarefa deve essere formattato utilizzando una di queste opzioni:

#{task_id}

CU-{task_id}

{custom_task_id}

#{custom_task_id}

Ad esempio:

#1abc2de

CU-1abc2de

It seems like there might have been a misunderstanding or an error in your request. You've provided "eng-123" which doesn't appear to be a valid input or a request for translation. Could you please provide more details or clarify your request so I can assist you effectively?

#eng-123

Collega tarefa da ClickUp

Puoi anche collegare manualmente le attività di ClickUp con commit, branch e pull request di GitHub direttamente dall'attività di ClickUp. Assicurati che la task sia situata in uno Spazio che è collegato a un repository.

Per collegare una task:

1. Apri un'attività e clicca sull'icona GitHub.
   

   A destra, vedrai suggeriti nomi di branch e messaggi di commit che puoi copiare nella tua area di trasferimento. Puoi anche copiare l'ID della task da qui.

2. Nell'angolo in basso a destra, clicca su Aggiungi link GitHub.
   
3. Incolla un link.
4. Nell'angolo in basso a destra, clicca su Aggiungi.

Crea problemi, branch e richieste di pull su GitHub da ClickUp

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

Per creare un problema, un ramo o una richiesta pull:

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

Pannello GitHub nella vista Attività

Dopo aver incollato il tuo primo link di GitHub nella descrizione dell'attività o in un commento, vedrai comparire una nuova icona GitHub nella barra laterale destra della tua  vista Attività. Puoi cliccare su questa icona in qualsiasi momento per visualizzare tutti i link di GitHub inseriti nell'attività.

L'attività della task su GitHub utilizza il nome utente di ClickUp della persona, o il loro nome utente GitHub se non possiedono un account ClickUp.

Aggiorna gli stati delle attività da GitHub

Puoi aggiornare lo status di una tarefa ClickUp quando colleghi un commit, fai un push di un commit o crei una richiesta di pull. ClickUp rileva automaticamente le nuove attività su GitHub e le associa alle tasse se includi un ID della tarefa valido in qualsiasi parte del titolo della richiesta di pull, della descrizione della richiesta di pull, del nome del branch o del messaggio di commit.

L'ID della tarefa deve essere formattato utilizzando una di queste opzioni:

#{task_id}[status]

CU-{task_id}[status]

{custom_task_id}[stato]

#{custom_task_id}[status]

Per aggiornare lo status di una attività:

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

Ad esempio: #ud5b[pronto]

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

Puoi anche aggiornare gli stati delle attività utilizzando le Automazioni di GitHub!

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

Dopo aver collegato problemi, branch, richieste di pull o commit, questi verranno visualizzati sul lato destro della tua tarefa quando clicchi sull'icona GitHub. Utilizza il menu puntini di sospensione ... per copiare il link o eliminare l'elemento.

Una volta collegato un elemento di GitHub, le seguenti informazioni verranno visualizzate nella tua attività ClickUp:

Informazioni sul problema

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

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

Informazioni sul ramo

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

• La persona che ha creato il branch, conosciuta come autore
• Creatore di link
• Repository
• URL

Informazioni sulla richiesta pull

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

• La persona che ha aperto la richiesta di pull, nota come autore
• Qualsiasi revisore assegnato
• Assegnatari
• Modifiche alla linea
• Link creato
• Repository
• Ramo di origine
• Ramo di destinazione
• Lo stato della richiesta pull
• URL

Informazioni sul commit

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

• La persona che ha creato il commit, conosciuta come l'autore
• File modificati
• Modifiche alla linea
• Link creato
• Repository
• URL

Aggiungi il tuo account GitHub a ClickUp

I membri dello spazio di lavoro possono collegare i loro account GitHub al loro account ClickUp in anticipo o quando creano un branch o una richiesta di pull.

Per aggiungere il tuo account GitHub dalla Central di Applicazioni:

1. Cerca e seleziona GitHub.
2. Clicca sulla scheda Personale.
3. Accanto a Crea una connessione personale, clicca su Connetti.
4. Accedi a GitHub e autorizza ClickUp.

Disconnetti l'integrazione con GitHub

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

1. Cerca e seleziona GitHub.
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, fai clic su Disconnetti.