Informazioni dettagliate e automazione con Projects

Completato

Vedremo ora in che modo usare Projects per ottenere informazioni dettagliate e come semplificare le attività con l'automazione.

Informazioni dettagliate con Projects

In questa sezione si apprenderà:

  • Informazioni dettagliate e la loro potenziale utilità.
  • Grafici e grafici storici correnti.
  • Creazione e personalizzazione di grafici.

Informazioni dettagliate e la loro potenziale utilità

Insights con Projects consentono di visualizzare, creare e personalizzare grafici che usano elementi aggiunti al progetto come dati di origine. Quando si crea un grafico, si impostano i filtri, il tipo di grafico e le informazioni visualizzate. Il grafico è disponibile per chiunque possa visualizzare il progetto. È possibile generare due tipi di grafici: grafici correnti e grafici cronologici. Di seguito verranno descritte in dettaglio le differenze tra i due.

Grafici correnti

È possibile creare grafici correnti per visualizzare gli elementi del progetto. Ad esempio, è possibile creare grafici per mostrare il numero di elementi assegnati a ogni individuo o il numero di problemi assegnati a ogni iterazione futura.

È possibile usare filtri per manipolare i dati usati per creare il grafico. È, ad esempio, possibile creare un grafico che mostra la quantità di lavoro in arrivo disponibile, ma limitare tali risultati a determinate etichette o assegnatari.

Screenshot con un esempio di grafico a barre corrente che tiene traccia del numero di ore trascorse per sette fasi di iterazione. Colore codificato per quantità di tempo dedicato a bug, feedback, back-end e lavoro dell'interfaccia utente.

Grafici cronologici

Con GitHub Team e GitHub Enterprise Cloud sono disponibili grafici storici per le organizzazioni. I grafici cronologici sono grafici basati sul tempo che consentono di visualizzare le tendenze e lo stato di avanzamento del progetto. È possibile visualizzare il numero di elementi nel tempo, raggruppati per stato e altri campi. Il grafico Burn up predefinito mostra lo stato degli elementi nel tempo, consentendo di visualizzare lo stato e di individuare criteri spot.

Screenshot di esempio relativo a un grafico cronologico a linee ad area in pila che mostra lo stato di avanzamento nel mese di luglio.

Screenshot con un esempio di un grafico storico a linee ad area impilate che mostra il numero di ore impiegate per attività, in corso e completate nel mese di luglio.

Creare e personalizzare grafici

Per creare un nuovo grafico, seguire questi passaggi:

  1. Passare al progetto.
  2. Nella parte superiore destra, selezionare il pulsante grafico a linee. Quando si passa il puntatore del mouse sul pulsante, appare l'etichetta Insights.
  3. Nel menu a sinistra, selezionare Nuovo grafico.
  4. Filtrare per parola chiave o campo per modificare i dati usati per creare il grafico.
  5. A destra della casella di testo del filtro, selezionare Salva.

Ora che è stato creato un nuovo grafico, è possibile personalizzarlo in base alle proprie esigenze.

  1. Nel menu a sinistra, selezionare il grafico da configurare.
  2. Sul lato destro della pagina, selezionare Configura per aprire un pannello.
  3. Selezionare l'elenco a discesa Layout per cambiare il tipo di grafico da usare.
  4. Selezionare l'elenco a discesa Asse X e scegliere il campo da usare.
  5. Facoltativamente, selezionare Raggruppa per per raggruppare gli elementi sull'asse X. Scegliere il campo da usare o Nessuno per disabilitare il raggruppamento.

Automazione con Projects

Si può consentire a GitHub di eseguire alcune operazioni automatizzando il progetto. Esistono tre modi diversi per effettuare questa operazione:

  • Flussi di lavoro automatizzati predefiniti
  • API GraphQL
  • GitHub Actions con flussi di lavoro

Il modo più semplice per automatizzare il progetto è costituito dai flussi di lavoro predefiniti. GraphQL e Actions offrono un maggiore controllo sulla personalizzazione dell'automazione. Nelle sezioni seguenti si apprenderà come usare l'automazione predefinita del progetto e verrà esaminata brevemente l'automazione con l'API GraphQL e GitHub Actions.

Configurare flussi di lavoro predefiniti

I flussi di lavoro predefiniti consentono di mantenere il controllo di tutto il lavoro. Il progetto accetta i problemi o le richieste pull e appena creati e li inserisce automaticamente nel progetto con uno stato Todo. Di seguito è indicato come abilitarli:

  1. Nell'angolo superiore destro del progetto, selezionare il menu a tre puntini e scegliere Flussi di lavoro.

    Screenshot del menu Workflows (Flussi lavoro) in Projects che contiene le opzioni Workflows (Flussi di lavoro), Archived items (Elementi archiviati) e Settings (Impostazioni) con l'opzione Workflows evidenziata.

  2. Nella colonna di sinistra selezionare Item added to project (Elemento aggiunto al progetto) nella sezione Default workflows (Flussi di lavoro predefiniti).

    Screenshot del menu per abilitare i flussi di lavoro una volta eseguita un'azione.

    Screenshot del menu per abilitare i flussi di lavoro una volta eseguita un'azione. Le opzioni includono Item added to Project (Elemento aggiunto al progetto), Item reopened (Elemento riaperto), Item closed (Elemento chiuso), Code changes requested (Richieste modifiche al codice), Code review approved (Revisione del codice approvata), Pull request merged (Merge delle richieste pull eseguito) con l'opzione Item added to Project evidenziata.

  3. Selezionare il pulsante Modifica per apportare modifiche al flusso di lavoro.

  4. Nella sezione Quando un elemento viene aggiunto al progetto, assicurarsi che siano selezionati sia i problemi che le richieste pull.

  5. Nella sezione Imposta valore, selezionare Status:Todo.

  6. Selezionare Salva e attiva il flusso di lavoro.

Congratulazioni: il progetto è stato automatizzato.

GitHub Actions con flussi di lavoro

GitHub Actions consente la massima personalizzazione dell'automazione del progetto. È possibile usare GitHub Actions per automatizzare le attività di gestione dei progetti creando flussi di lavoro. Ogni flusso di lavoro contiene una serie di attività che vengono eseguite automaticamente ogni volta che si esegue il flusso di lavoro. Un flusso di lavoro di esempio attiva la creazione di un problema che aggiunge un'etichetta, lascia un commento e sposta il problema in una bacheca del progetto.

La creazione di un problema attiva un flusso di lavoro che aggiunge un'etichetta, lascia un commento e sposta il problema in una bacheca del progetto.

Per altre informazioni sull'automazione dei flussi di lavoro per il progetto, vedere l'articolo Automazione dei progetti con azioni, alla fine di questo modulo.

API GraphQL

Se si usa GraphQL in GitHub, è possibile usare questa API per sviluppare l'automazione per il progetto. Per altre informazioni sull'uso dell'API GraphQL, vedere l'articolo Uso dell'API GraphQL per agestire progetti, alla fine di questo modulo.