In qualità di product owner, potremmo ritrovarci nella condizione di dover monitorare l'avanzamento dei lavori su più repository contemporaneamente. Le issue di GitHub sono suddivise, per l'appunto, per repository, ma creando un Project e configurandolo opportunamente, è possibile avere una visione d'insieme di tutti i miei progetti e creare all'occorrenza anche nuove issue, direttamente da quella vista, senza dover cambiare ogni volta pagina.
Queste stesse informazioni, possono essere poi esportate in qualche tool di analytics, come Power BI, per esempio, così che si possano analizzare metriche come il tempo di burndown, la velocity dei team, impedimenti, e così via. Grazie a GraphQL è molto semplice recuperare le informazioni:
gh api graphql -F projectId="$projectId" -f query=' query($projectId: ID!) { node(id: $projectId) { ... on ProjectV2 { items(first: 10) { nodes{ id content{ ...on Issue { id number title repository { name } assignees(first: 5) { nodes { name } } projectItems(first: 50) { edges { node { effort: fieldValueByName(name: "Effort") { ... on ProjectV2ItemFieldNumberValue { number } } } } } } } } } } } }'
Abbiamo infatti solo chiamato la CLI di GitHub, per comodità, per invocare una chiamata all'endpoint GraphQL, passando l'ID del Project creato in GitHub, che raggruppa tutte le issue che ci interessano.
A questo punto, parte fondamentale della query sta nel recuperare i nodi, ovvero le proprietà, contenute nell'oggetto Issue. E' qui che poi possiamo ottenere le informazioni base come il titolo, la descrizione e l'ID dell'item stesso, piuttosto che proprietà più complesse, come il repository (che di fatto arriva da un altro oggetto), o gli assegnatari di quell'attività specifica (che arrivano da un altro oggetto GraphQL e che sono un array di elementi, perchè l'assegnazione può essere multipla). Allo stesso tempo, grazie alla funzione di fieldValueByName, possiamo ottenere anche valori custom, come ad esempio l'effort, che fa parte del project ma non del work item.
Questi dati, una volta recuperati, ci forniranno un JSON, che potrà essere in seguito analizzato con tutti gli strumenti del caso.
Commenti
Per inserire un commento, devi avere un account.
Fai il login e torna a questa pagina, oppure registrati alla nostra community.
Approfondimenti
Usare una container image come runner di GitHub Actions
Gestire i null nelle reactive form tipizzate di Angular
Eseguire una GroupBy per entity in Entity Framework
Code scanning e advanced security con Azure DevOps
Evitare la script injection nelle GitHub Actions
Creare gruppi di client per Event Grid MQTT
Estrarre dati randomici da una lista di oggetti in C#
Eseguire le GitHub Actions offline
Generare token per autenicarsi sulle API di GitHub
Utilizzare Azure AI Studio per testare i modelli AI
Le novità di Angular: i miglioramenti alla CLI