Integrazione di Azure DevOps

Introduzione all'integrazione di Azure DevOps

Viva Goals si integra con Microsoft Azure DevOps per aggiornare automaticamente i risultati e i progetti chiave in Viva Goals. Il risultato chiave e lo stato di avanzamento del progetto vengono aggiornati automaticamente in base agli elementi di lavoro di Azure DevOps connessi. È possibile usare l'integrazione di Azure DevOps per

• Tenere traccia automaticamente dello stato di avanzamento per un risultato chiave
• Tenere traccia automaticamente dello stato di avanzamento per un indicatore KPI dell'iniziativa
• Tenere traccia automaticamente dello stato di avanzamento e delle attività per un'iniziativa.
  • Questo approccio aggiorna lo stato di avanzamento dell'iniziativa, sincronizza i dettagli dell'elemento di lavoro di Azure DevOps con Viva Goals attività dell'iniziativa e, se usato con l'estensione Viva Goals Azure DevOps, Viva Goals superficie dei dettagli di allineamento OKR direttamente negli elementi di lavoro collegati di Azure DevOps.

Risultati (OKR) e output (iniziative)

Uno dei vantaggi fondamentali degli OKR (obiettivi e risultati chiave) è la distinzione tra risultati e output. Gli OKR e i risultati chiave sono incentrati sull'impatto sulla guida (risultati), mentre Viva Goals iniziative sono incentrate sugli output, il lavoro che è previsto per ottenere i risultati chiave. Entrambe sono metriche importanti da tenere traccia, ma misurano cose diverse.

Anche se è possibile integrare sia Viva Goals risultati chiave che le iniziative con gli elementi di lavoro di Azure DevOps, è importante comprendere la differenza. Azure DevOps è incentrato principalmente sul monitoraggio del lavoro, quindi è più comune integrare le iniziative Viva Goals con Azure DevOps. Esistono alcuni esempi in cui può essere utile tenere traccia dello stato di avanzamento dei risultati chiave in base agli elementi di lavoro di Azure DevOps.

Quando usare l'integrazione di Azure DevOps

Esistono tre modi per usare l'integrazione di Azure DevOps con i flussi di lavoro Viva Goals.

1. Tenere traccia dello stato di avanzamento di un'iniziativa con le attività: Oltre a tenere traccia dello stato di avanzamento dell'iniziativa in base agli elementi di lavoro di Azure DevOps, questo approccio consente un'esperienza utente multipiattaforma. I dettagli dell'elemento di lavoro di Azure DevOps vengono sincronizzati con le visualizzazioni dell'iniziativa Viva Goals. L'allineamento del lavoro di Azure DevOps a Viva Goals OKR può essere visualizzato direttamente all'interno degli elementi di lavoro di Azure DevOps collegati tramite l'estensione Azure DevOps.
2. Tenere traccia dello stato di avanzamento di un'iniziativa con indicatori KPI: Questo approccio consente di tenere traccia dello stato dell'iniziativa in base allo stato degli elementi di lavoro di Azure DevOps. Un singolo valore numerico viene sincronizzato con Viva Goals.
3. Tenere traccia dello stato di avanzamento per un risultato chiave: Questo approccio consente di tenere traccia dello stato degli elementi di lavoro KR in base allo stato degli elementi di lavoro di Azure DevOps. Un singolo valore numerico viene sincronizzato con Viva Goals.

Come configurare l'integrazione di Azure DevOps

L'integrazione di Azure DevOps deve essere abilitata da un amministratore Viva Goals. Viva Goals amministratori devono prima abilitare l'integrazione di Azure DevOps per il tenant (Abilitare le integrazioni in Viva Goals | Microsoft Learn). Una volta abilitato a livello di tenant, un amministratore dell'organizzazione Viva Goals deve abilitarlo per l'organizzazione (panoramica dell'amministrazione di Viva Goals Integrations).

Come abilitare l'integrazione di Azure DevOps con le iniziative

Questo metodo è l'approccio consigliato per allineare il lavoro in Azure DevOps a OKRsin Viva Goals. Oltre a tenere traccia dello stato di avanzamento dell'iniziativa in base agli elementi di lavoro di Azure DevOps, questo approccio consente un'esperienza utente multipiattaforma. I dettagli dell'elemento di lavoro di Azure DevOps vengono sincronizzati con le visualizzazioni dell'iniziativa Viva Goals e, se usato con l'estensione Viva Goals Azure DevOps, l'allineamento del lavoro di Azure DevOps a Viva Goals OKR viene visualizzato direttamente all'interno degli elementi di lavoro collegati di Azure DevOps.

1. Selezionare Aggiungi iniziativa in Viva Goals o modificare un'iniziativa esistente.

2. Selezionare Risultato.

3. Selezionare Aggiungi attività.

4. Selezionare Automaticamente da un'origine dati.

5. Selezionare Azure DevOps dall'elenco delle integrazioni disponibili.

6. Selezionare la connessione di Azure DevOps appropriata. Se è necessario creare una nuova connessione ad Azure DevOps, è necessario accedere ad Azure DevOps per creare una connessione dati. È necessaria una nuova connessione per ogni progetto Azure DevOps. Dopo l'accesso:

   • Specificare un nome di connessione: è possibile includere l'organizzazione e il progetto di Azure DevOps nel nome per informazioni di riferimento future.
   • Selezionare l'organizzazione Azure DevOps.
   • Selezionare il progetto Azure DevOps.
   • Seleziona Avanti.

7. Selezionare il metodo di connessione:

   • Query condivisa: consente di connettersi a una query esistente salvata in Azure DevOps.
   • Elementi di lavoro: consente di connettersi a uno o più elementi di lavoro di un tipo di elemento di lavoro specifico. Questo approccio consente di connettersi direttamente agli elementi di lavoro padre che contengono il lavoro di supporto; gli elementi di lavoro figlio vengono inclusi automaticamente.

Se si usa il metodo connect to Shared Query

1. Selezionare il metodo di query condiviso .
2. Cercare e selezionare la query condivisa che contiene gli elementi di lavoro di Azure DevOps.
3. Selezionare il tipo di elemento di lavoro da usare per calcolare lo stato di avanzamento dell'iniziativa. È possibile scegliere tra qualsiasi tipo di elemento di lavoro nella query o tutti gli elementi di lavoro nella query condivisa.
4. Selezionare il campo Azure DevOps che si vuole usare per tenere traccia dello stato dell'iniziativa. Viva Goals stato dell'iniziativa viene calcolato come % di completamento del tipo di elemento di lavoro scelto.
5. Selezionare Avanti.
6. Selezionare Salva.

L'icona di Azure DevOps viene ora visualizzata accanto all'iniziativa. I dettagli dell'elemento di lavoro di Azure DevOps vengono ora visualizzati anche nelle visualizzazioni dell'iniziativa Viva Goals. Viva Goals sincronizza automaticamente i dettagli dell'elemento di lavoro e aggiorna l'avanzamento dell'iniziativa una volta all'ora in base al campo ADO per i tipi di elemento di lavoro selezionati all'interno della query condivisa.

Se si usa il metodo Connect to Work Items (Connetti agli elementi di lavoro)

1. Selezionare il metodo degli elementi di lavoro .
2. Selezionare il tipo di elemento di lavoro a cui connettersi: è consigliabile scegliere il tipo di elemento di lavoro padre nella gerarchia di Azure DevOps che contiene il lavoro in corso. L'integrazione includerà automaticamente gli elementi di lavoro figlio.
3. Cercare e selezionare gli elementi di lavoro specifici del tipo scelto.
4. Selezionare il tipo di elemento di lavoro da usare per calcolare lo stato di avanzamento dell'iniziativa. È possibile scegliere di misurare lo stato di avanzamento in base a un tipo di elemento di lavoro specifico (il tipo a cui ci si connette direttamente o a uno dei relativi tipi figlio) o a tutti gli elementi di lavoro (connessi e figlio).
5. Selezionare il campo ADO da usare per tenere traccia dello stato dell'iniziativa.
6. Seleziona Avanti.
7. Seleziona Salva.

L'icona di Azure DevOps viene ora visualizzata accanto all'iniziativa. I dettagli dell'elemento di lavoro di Azure DevOps vengono ora visualizzati anche nelle visualizzazioni dell'iniziativa Viva Goals. Viva Goals sincronizza automaticamente i dettagli dell'elemento di lavoro e aggiorna l'avanzamento dell'iniziativa una volta all'ora in base al campo Azure DevOps per i tipi di elemento di lavoro selezionati.

Dopo aver completato questi passaggi, l'avanzamento dell'iniziativa Viva Goals viene aggiornato automaticamente regolarmente. Inoltre, i dettagli dell'elemento di lavoro di Azure DevOps vengono visualizzati nelle visualizzazioni dell'iniziativa Viva Goals, insieme ai collegamenti ipertestuali ai dettagli dell'elemento di lavoro di Azure DevOps. Se è stata abilitata l'estensione Viva Goals Azure DevOps, l'allineamento completo tra GLI OKR e gli elementi di lavoro di Azure DevOps è accessibile da una scheda Viva Goals all'interno degli elementi di lavoro collegati di Azure DevOps.

Come usare l'integrazione di Azure DevOps con gli indicatori KPI dell'iniziativa

Usare questo metodo quando si desidera aggiornare l'avanzamento dell'iniziativa Viva Goals con un singolo valore numerico. Questo approccio non presenta gli elementi di lavoro di Azure DevOps all'interno di Viva Goals visualizzazioni dell'iniziativa. Questo metodo non può incorporare Viva Goals all'interno degli elementi di lavoro di Azure DevOps.

1. Selezionare Aggiungi iniziativa in Viva Goals o modificare un'iniziativa esistente.

2. Selezionare Risultato.

3. Selezionare Aggiungi metrica e immettere i dettagli necessari (nome, tipo, unità, inizio, valori di destinazione).

   • Per le metriche in base alla percentuale, lo stato di avanzamento dell'iniziativa viene calcolato in base alla % del valore del campo ADO selezionato per gli elementi di lavoro completati rispetto agli elementi di lavoro totali.
   • Per le metriche non basate su percentuale (numerico, valuta), lo stato dell'iniziativa è un conteggio del valore del campo ADO selezionato per gli elementi di lavoro completati o, facoltativamente, totali.

4. Selezionare Stato.

5. Selezionare Automaticamente da un'origine dati.

6. Selezionare Azure DevOps dall'elenco delle integrazioni disponibili.

7. Selezionare la connessione di Azure DevOps appropriata. Se è necessario creare una nuova connessione ad Azure DevOps, è necessario accedere ad Azure DevOps per creare una connessione dati. È necessaria una nuova connessione per ogni progetto Azure DevOps. Dopo l'accesso:

   • Specificare un nome di connessione: è possibile includere l'organizzazione e le iniziative di Azure DevOps nel nome per un facile riferimento futuro.
   • Selezionare l'organizzazione Azure DevOps.
   • Selezionare il progetto Azure DevOps.
   • Seleziona Avanti.

8. Selezionare il metodo di connessione:

   • Query condivisa: consente di connettersi a una query esistente archiviata in Azure DevOps
   • Elementi di lavoro: consente di connettersi a uno o più elementi di lavoro di un tipo di elemento di lavoro specifico. Questo approccio consente di connettersi direttamente agli elementi di lavoro padre che contengono il lavoro di supporto; gli elementi di lavoro figlio vengono considerati automaticamente.

Se si usa il metodo connect to Shared Query

1. Selezionare il metodo di query condiviso .
2. Cercare e selezionare la query condivisa che contiene gli elementi di lavoro di Azure DevOps.
3. Selezionare il tipo di elemento di lavoro da usare per calcolare lo stato di avanzamento dell'iniziativa. È possibile scegliere tra qualsiasi tipo di elemento di lavoro nella query o tutti gli elementi di lavoro nella query.
4. Selezionare il campo Azure DevOps che si vuole usare per tenere traccia dello stato dell'iniziativa.
5. Scegliere Avanti.
6. Seleziona Salva.

Verrà ora visualizzata l'icona di Azure DevOps accanto all'iniziativa. Viva Goals aggiorna automaticamente lo stato di avanzamento una volta all'ora.

Se si usa il metodo Connect to Work Items (Connetti agli elementi di lavoro)

1. Selezionare il metodo degli elementi di lavoro .
2. Selezionare il tipo di elemento di lavoro a cui connettersi. È consigliabile scegliere il tipo di elemento di lavoro "padre" nella gerarchia di Azure DevOps che contiene il lavoro eseguito. L'integrazione include automaticamente gli elementi di lavoro figlio. Ad esempio, connettersi a una funzionalità che è l'elemento padre delle attività rispetto alla connessione a ogni singola attività.
3. Cercare e selezionare gli elementi di lavoro specifici del tipo scelto.
4. Selezionare il tipo di elemento di lavoro da usare per calcolare lo stato di avanzamento dell'iniziativa. È possibile scegliere di misurare lo stato di avanzamento in base a un tipo di elemento di lavoro specifico (il tipo a cui ci si connette direttamente o a uno dei relativi tipi figlio) o a tutti gli elementi di lavoro (connessi e figlio).
5. Selezionare il campo ADO da usare per tenere traccia dello stato dell'iniziativa.
6. Seleziona Avanti.
7. Seleziona Salva.

Verrà ora visualizzata l'icona di Azure DevOps accanto all'iniziativa. Viva Goals aggiorna automaticamente questa iniziativa una volta all'ora.

Come usare l'integrazione di Azure DevOps con un risultato chiave

Usare questo metodo quando si desidera aggiornare lo stato di avanzamento del risultato della chiave Viva Goals con un singolo valore numerico. Questo approccio non presenta gli elementi di lavoro di Azure DevOps all'interno di Viva Goals, né questo metodo ha la possibilità di incorporare Viva Goals all'interno degli elementi di lavoro di Azure DevOps.

1. Selezionare Aggiungi risultato chiave in Viva Goals o modificare un risultato di chiave esistente.

2. Selezionare Aggiungi metrica e immettere i dettagli necessari (nome, tipo, unità, inizio, valori di destinazione).

   • Per le metriche in base alla percentuale, lo stato di avanzamento dei risultati chiave viene calcolato in base alla % del valore del campo ADO selezionato per gli elementi di lavoro completati rispetto agli elementi di lavoro totali.
   • Per le metriche non basate su percentuale (numerico, valuta), lo stato del risultato chiave è un conteggio del valore del campo ADO selezionato per gli elementi di lavoro completati o, facoltativamente, totali.

3. Selezionare Stato.

4. Selezionare Automaticamente da un'origine dati.

5. Selezionare Azure DevOps dall'elenco delle integrazioni disponibili.

6. Selezionare la connessione di Azure DevOps appropriata. Se è necessario creare una nuova connessione ad Azure DevOps, è necessario accedere ad Azure DevOps per creare una connessione dati. È necessaria una nuova connessione per ogni progetto Azure DevOps. Dopo l'accesso:

   • Specificare un nome di connessione: è consigliabile includere l'organizzazione e l'iniziativa di Azure DevOps nel nome per un facile riferimento futuro.
   • Selezionare l'organizzazione Azure DevOps.
   • Selezionare il progetto Azure DevOps.
   • Scegliere Avanti.

7. Selezionare il metodo di connessione:

   • Query condivisa: consente di connettersi a una query esistente archiviata in Azure DevOps
   • Elementi di lavoro: consente di connettersi a uno o più elementi di lavoro di un tipo di elemento di lavoro specifico. Questo approccio consente di connettersi direttamente agli elementi di lavoro "padre" che contengono il lavoro di supporto; gli elementi di lavoro figlio vengono considerati automaticamente.

Se si usa il metodo connect to Shared Query

1. Selezionare il metodo di query condiviso .
2. Cercare e selezionare la query condivisa che contiene gli elementi di lavoro di Azure DevOps.
3. Selezionare il tipo di elemento di lavoro da usare per calcolare lo stato di avanzamento del risultato della chiave. È possibile scegliere tra qualsiasi tipo di elemento di lavoro nella query o tutti gli elementi di lavoro nella query condivisa.
4. Selezionare il campo ADO da usare per tenere traccia dello stato dei risultati della chiave.
5. Scegliere Avanti.
6. Seleziona Salva.

Verrà ora visualizzata l'icona di Azure DevOps accanto al risultato della chiave. Viva Goals aggiorna automaticamente lo stato di avanzamento una volta all'ora.

Se si usa il metodo Connect to Work Items (Connetti agli elementi di lavoro)

1. Selezionare il metodo degli elementi di lavoro .
2. Selezionare il tipo di elemento di lavoro a cui connettersi. È consigliabile scegliere il tipo di elemento di lavoro "padre" nella gerarchia di Azure DevOps che contiene il lavoro eseguito. L'integrazione includerà automaticamente gli elementi di lavoro figlio. Ad esempio, connettersi a una funzionalità che è l'elemento padre delle attività rispetto alla connessione a ogni singola attività.
3. Cercare e selezionare gli elementi di lavoro specifici del tipo scelto.
4. Selezionare il tipo di elemento di lavoro da usare per calcolare lo stato di avanzamento del risultato della chiave. È possibile scegliere di misurare lo stato di avanzamento in base a un tipo di elemento di lavoro specifico (il tipo a cui ci si connette direttamente o a uno dei relativi tipi figlio) o a tutti gli elementi di lavoro (connessi e figlio).
5. Selezionare il campo ADO da usare per tenere traccia dello stato dei risultati della chiave.
6. Seleziona Avanti.
7. Seleziona Salva.

Verrà ora visualizzata l'icona di Azure DevOps accanto al risultato della chiave. Viva Goals aggiorna automaticamente questa iniziativa una volta all'ora in base al campo ADO per i tipi di elemento di lavoro selezionati.

Calcolo dello stato per i campi ADO in Viva Goals

Risoluzione dei problemi di connessione

Per eseguire l'integrazione con Azure DevOps, il servizio Viva Goals deve essere in grado di accedere agli elementi di lavoro nell'organizzazione e nell'iniziativa di Azure DevOps configurati durante la creazione della connessione in Viva Goals. A seconda del modo in cui l'organizzazione gestisce i criteri di accesso condizionale Microsoft Entra e le autorizzazioni di Azure DevOps, Viva Goals potrebbe non essere in grado di accedere alle informazioni.

Errori non consentiti

Se si verificano messaggi di errore non consentiti durante la creazione di una connessione ad Azure DevOps, è probabile che si verifichino vincoli di indirizzo IP o altri criteri di accesso condizionale. In questo caso, è necessario verificare se i criteri di convalida Enable Microsoft Entra ID CAP sono abilitati nell'organizzazione Azure DevOps. Per altre informazioni, vedere la documentazione di Azure DevOps.

Soluzioni

Sono disponibili due opzioni. È possibile disattivare i criteri di convalida Enable Microsoft Entra ID CAP nell'organizzazione Azure DevOps. Ciò richiederebbe e l'amministratore di Azure DevOps oppure è necessario aggiungere gli indirizzi IP in uscita del servizio Viva Goals ai criteri di accesso condizionale per i tenant Microsoft Entra ID.

Domande frequenti (domande frequenti)

1. Quando si connettono le attività dell'iniziativa Viva Goals ad Azure DevOps, perché non vengono visualizzati tutti gli elementi di lavoro nella query condivisa e/o tutti gli elementi di lavoro figlio quando si usa il metodo "connetti all'elemento di lavoro"?

   Se si connette l'iniziativa Viva Goals ad Azure DevOps, Viva Goals non espone tutti gli elementi di lavoro. Ciò che Viva Goals mostra dipende dal modo in cui si sceglie di calcolare l'avanzamento complessivo dell'iniziativa Viva Goals durante il processo di installazione. Se si sceglie di calcolare lo stato di avanzamento dell'iniziativa in base a qualsiasi elemento di lavoro, Viva Goals esporrà effettivamente tutti gli elementi di lavoro di query condivisi o tutti gli elementi figlio, se si è connessi direttamente agli elementi di lavoro.

   Tuttavia, riteniamo che la scelta del tipo di elemento di lavoro "qualsiasi" sia un'eccezione, poiché questo approccio esporrebbe una quantità eccessiva di dettagli dell'elemento di lavoro non necessari all'interno Viva Goals'esperienza utente. Si presuppone che la maggior parte degli utenti scelga di calcolare lo stato di avanzamento in base a un tipo di elemento di lavoro specifico all'interno della query condivisa o a un elemento figlio degli elementi di lavoro connessi. Viva Goals userà questa decisione per limitare ciò che espongono nell'esperienza utente Viva Goals.

   Si supponga, ad esempio, che il lavoro di Azure DevOps stia monitorando funzionalità, storie utente e attività. Si supponga inoltre di scegliere di tenere traccia dello stato di avanzamento Viva Goals'iniziativa in base al completamento della storia utente. Viva Goals mostrerà solo le funzionalità e le storie utente all'interno delle visualizzazioni dell'iniziativa Viva Goals. Gli utenti possono fare rapidamente doppio clic in Azure DevOps per altri dettagli in base alle esigenze.