Nota
Questa funzionalità è in accesso anticipato ed è disponibile solo per clienti selezionati.
L'integrazione del controllo del codice sorgente di Command collega i tuoi repository GitHub a Command by Asana, mantenendo l'attività delle richieste di pull sincronizzata con i tuoi ticket. Dopo aver collegato un repository e il tuo account GitHub personale, gli stati dei ticket possono essere aggiornati in base agli eventi delle richieste di pull, i revisori possono ricevere notifiche nella posta in arrivo e i commenti possono essere sincronizzati tra GitHub e Command.
Configurazione dell'integrazione di GitHub per il tuo dominio
Un amministratore di dominio abilita le integrazioni degli agenti di programmazione per tutta l'organizzazione.
- Passa alla modalità Command.
- Nel pannello laterale, seleziona Amministratore. Questa opzione viene visualizzata solo per gli amministratori del dominio.
- Accanto a GitHub, clicca su Connetti.
- GitHub si apre in una finestra separata. Seleziona l'organizzazione o i repository in cui desideri installare l'app, quindi clicca su Installa e autorizza la connessione.
- Torna ad Asana. Una volta collegata l'integrazione del repository, il comando diventa Disconnetti e le impostazioni di automazione diventano disponibili.
Configurazione degli account GitHub dei singoli utenti
- Vai alle impostazioni del tuo profilo
- Passa alla sezione App.
- Clicca su Collega accanto ad Account GitHub personale per collegare il tuo account GitHub. Questa connessione associa i commenti di GitHub al tuo utente del dominio Asana.
Come configurare le regole di automazione
Dopo aver collegato GitHub, configura le regole di automazione che aggiornano gli stati dei ticket in base agli eventi delle richieste pull. Nelle impostazioni dello spazio del team, vai alla Sezione Integrazioni, quindi usa i menu a discesa Seleziona per scegliere lo stato del ticket per ogni evento:

- Quando viene aperta una bozza di pull request, aggiorna lo stato a…
- Quando viene aperta una richiesta pull, aggiorna lo stato a…
- Quando una richiesta pull ha una richiesta di revisione o un'attività, aggiorna lo stato a…
- Quando una richiesta pull è pronta per il merge, aggiorna lo stato a...
- Quando una richiesta pull viene unita, aggiorna lo stato a…
Per esempio, puoi configurare una richiesta pull aperta per spostare un ticket in In revisione. Dopo che si è verificato un evento di richiesta pull, attendi alcuni secondi affinché lo stato del ticket e le informazioni sulla richiesta pull collegata vengano aggiornati.
Collegamento delle richieste pull ai ticket
Esistono due modi per collegare una richiesta pull a un ticket Command:
- Aggiungi l'ID del ticket al titolo della richiesta pull. Includi l'ID del ticket di Command direttamente nel titolo, ad esempio [CODE-620] Risolvi il bug di accesso.
- Usa una parola chiave nella descrizione della richiesta pull. Aggiungi una parola chiave supportata seguita da uno o più URL o ID di ticket. Le parole chiave supportate includono:
attività, attività, ticket, ticket, rif., rif., riferimenti, parte di, correlato a, contribuisce a, per e per. Puoi includere più URL o ID di ticket dopo una parola magica per collegare la richiesta pull a più di un ticket.
Dopo aver creato la richiesta pull, l'integrazione la collega al ticket e applica l'automazione dello stato configurata. I revisori possono ricevere notifiche nella posta in arrivo su Asana e i commenti vengono sincronizzati tra GitHub e il ticket collegato.
Visualizzazione delle richieste pull collegate
Le richieste pull collegate vengono visualizzate nella sezione Controllo della versione di un ticket. Puoi cliccare su qualsiasi richiesta pull per visualizzare i dettagli del revisore, il tempo di revisione, lo stato di revisione corrente e i link alla richiesta pull. Gli stati possono includere Modifiche richieste o In sospeso.
Puoi collegare più richieste pull a un ticket in modo che il tuo team possa monitorare le relative modifiche al codice in un unico posto.
Protezione dello stato forward-only
L'integrazione utilizza la protezione solo in avanti per gli aggiornamenti dello stato dei ticket. Un evento GitHub può far avanzare un ticket nel suo flusso di lavoro, ma non può farlo tornare indietro dopo che è stato raggiunto uno stato successivo.
Per esempio, se un ticket è già in stato In revisione e colleghi una bozza di richiesta pull configurata per spostare i ticket in stato Non iniziato, il ticket rimane in stato In revisione. La bozza della richiesta pull è ancora collegata, ma lo stato non torna indietro.
I commenti delle richieste pull collegate vengono visualizzati nel ticket di Command associato. Quando colleghi il tuo account GitHub personale, i tuoi commenti su GitHub vengono attribuiti al tuo utente del dominio Asana.
I commenti sincronizzati includono il testo del commento, il titolo della richiesta pull e i link al commento e alla richiesta pull. I commenti di più richieste pull collegate possono apparire sullo stesso ticket.