Integrazione di Azure DevOps

  • Articolo

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 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 dettagli di allineamento OKR vengono visualizzati direttamente negli elementi di lavoro collegati di Azure DevOps.

Per altre informazioni sul funzionamento dell'integrazione di Azure DevOps durante la connessione a risultati chiave, metriche delle iniziative e attività di iniziativa, vedere di seguito.

Risultati (OKR) e output (iniziative)

Uno dei principi fondamentali degli OKR è la distinzione tra risultati e output. Gli OKR e i risultati chiave sono incentrati sulla guida dell'impatto (ad esempio, i risultati), mentre Viva Goals iniziative sono incentrate sugli output, il lavoro pianificato 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. I dettagli su ognuna di queste funzionalità sono descritti di seguito:

  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 e l'allineamento del lavoro di Azure DevOps a Viva Goals GLI OKR possono essere visualizzati direttamente all'interno degli elementi di lavoro collegati di Azure DevOps tramite l'estensione Azure DevOps (presto disponibile)
  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 del tenant e dell'organizzazione Viva Goals. Gli amministratori globali 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).

Nota

Una volta abilitata, qualsiasi utente dell'organizzazione che abbia le autorizzazioni per creare/modificare un OKR e/o un'iniziativa può configurare l'integrazione tra Viva Goals e Azure DevOps.

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 di Azure DevOps collegati.

  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: è consigliabile 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
    • Selezionare 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. Scegliere Avanti.
  6. Selezionare Salva.

Verrà ora visualizzata l'icona di Azure DevOps accanto all'iniziativa. Dovrebbero essere visualizzati anche i dettagli dell'elemento di lavoro Di Azure DevOps 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 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 dell'iniziativa. È possibile scegliere di misurare lo stato di avanzamento in base a un tipo di elemento di lavoro specifico (ad esempio, il tipo a cui ci si connette direttamente o a uno dei relativi tipi figlio) o a tutti gli elementi di lavoro (ad esempio, connessi e figlio).
  5. Selezionare il campo ADO da usare per tenere traccia dello stato dell'iniziativa.
  6. Selezionare Avanti.
  7. Selezionare Salva.

Verrà ora visualizzata l'icona di Azure DevOps accanto all'iniziativa. Dovrebbero essere visualizzati anche i dettagli dell'elemento di lavoro Di Azure DevOps 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 i passaggi precedenti, non solo lo stato di avanzamento dell'iniziativa Viva Goals verrà aggiornato automaticamente, ma verranno abilitate le funzionalità seguenti:

  • 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 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 consente di visualizzare gli elementi di lavoro di Azure DevOps all'interno di Viva Goals visualizzazioni dell'iniziativa, né di incorporare Viva Goals negli 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 (ad esempio, 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: è consigliabile includere l'organizzazione di Azure DevOps e le iniziative nel nome per un facile riferimento futuro.
    • Selezionare l'organizzazione Azure DevOps
    • Selezionare il progetto Azure DevOps
    • Selezionare 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. Selezionare Salva.

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

Se si usa il metodo 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 dell'iniziativa. È possibile scegliere di misurare lo stato di avanzamento in base a un tipo di elemento di lavoro specifico (ad esempio, il tipo a cui ci si connette direttamente o a uno dei relativi tipi figlio) o a tutti gli elementi di lavoro (ad esempio, connessi e figlio).
  5. Selezionare il campo ADO da usare per tenere traccia dello stato dell'iniziativa.
  6. Selezionare Avanti.
  7. Selezionare Salva.

Verrà ora visualizzata l'icona di Azure DevOps accanto all'iniziativa. Viva Goals aggiornerà 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 consente di visualizzare gli elementi di lavoro di Azure DevOps all'interno di Viva Goals, né di incorporare Viva Goals negli 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 (ad esempio, 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. Selezionare Salva.

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

Se si usa il metodo 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 (ad esempio, il tipo a cui ci si connette direttamente o a uno dei relativi tipi figlio) o a tutti gli elementi di lavoro (ad esempio, connessi e figlio).
  5. Selezionare il campo ADO da usare per tenere traccia dello stato dei risultati della chiave.
  6. Selezionare Avanti.
  7. Selezionare Salva.

Verrà ora visualizzata l'icona di Azure DevOps accanto al risultato della chiave. Viva Goals aggiornerà 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:

Tenere traccia dello stato di avanzamento per Metrica percentuale Metrica numero
Numero di elementi di lavoro Percentuale degli elementi di lavoro completati degli elementi di lavoro totali per la query o il tipo di elemento di lavoro specificato. Numero di elementi di lavoro per la query o il tipo di elemento di lavoro specificato.
Punti storia Percentuale dei punti del brano per gli elementi di lavoro completati rispetto ai punti del brano totali per gli elementi di lavoro per la query o il tipo di elemento di lavoro specificato. Somma dei punti del brano per gli elementi di lavoro per il tipo di query o di elemento di lavoro specificato.
Sforzo Percentuale di lavoro per gli elementi di lavoro completati rispetto al lavoro totale per gli elementi di lavoro per la query o il tipo di elemento di lavoro specificato. Somma dell'impegno per gli elementi di lavoro per la query o il tipo di elemento di lavoro specificato.
Stima originale Percentuale delle ore di stima originali totali per gli elementi di lavoro completati rispetto alle ore di stima originali totali per tutti gli elementi di lavoro per la query o il tipo di elemento di lavoro specificato. Somma delle ore di stima originali per gli elementi di lavoro per la query o il tipo di elemento di lavoro specificato.
Lavoro rimanente N/D Ore lavorative rimanenti totali per gli elementi di lavoro per la query o il tipo di elemento di lavoro specificato.
Lavoro completato Percentuale delle ore di lavoro totali completate per gli elementi di lavoro completati rispetto alle ore lavorative totali completate per tutti gli elementi di lavoro per la query o il tipo di elemento di lavoro specificato. Ore di lavoro totali completate per gli elementi di lavoro per la query o il tipo di elemento di lavoro specificato.
Campi personalizzati Percentuale di completamento del campo personalizzato numerico associato in ADO per il tipo di query o elemento di lavoro specificato. Somma totale del campo personalizzato numerico associato in ADO per il tipo di query o elemento di lavoro specificato.

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 i vincoli di indirizzo IP o altri criteri di accesso condizionale siano da biasimare. In questo caso è necessario verificare se i criteri di convalida enable Microsoft Entra ID CAP sono abilitati nell'organizzazione Azure DevOps. Per altri dettagli, fare riferimento alla documentazione di Azure DevOps.

Soluzioni

Sono disponibili due opzioni: è possibile disattivare i criteri di convalida Enable Microsoft Entra ID CAP nell'organizzazione Azure DevOps. Che 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"?
    1. 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.