Integra airfocus con Azure DevOps

Vantaggi dell'utilizzo dell'integrazione di Azure DevOps

• Importare gli elementi di lavoro Azure DevOps in airfocus.
• Spingi airfocus elementi in Azure DevOps (come qualsiasi tipo di elemento di lavoro).
• Filtraggio flessibile (tramite Azure DevOps Issue Search).
• Mappatura flessibile per campi di sistema e personalizzati con direzioni di sincronizzazione configurabili per campo.
• Mappare direttamente le descrizioni DevOps di Azure a airfocus descrizioni.
• Visualizza le tue iterazioni (sprint) in airfocus per avere un contesto sul valore e le priorità aziendali.

Imposta l'integrazione

Le integrazioni in airfocus si collegano sempre a uno specifico airfocus Workspace. Puoi aggiungere più integrazioni Azure DevOps a un dato workspace (ad esempio, da diversi progetti Azure DevOps o per diversi tipi di elementi di lavoro).

Per configurare l'integrazione Azure DevOps, segui questi passaggi:

1. Iscriviti a airfocus o accedi al tuo account esistente. 
2. Crea un nuovo spazio di lavoro in airfocus oppure seleziona quello con cui vuoi integrare Azure DevOps.
3. Clicca su Estensioni dall'angolo in alto a destra della pagina.
4. Seleziona Gestisci integrazioni.
   
5. Clicca su Connetti dalla tessera "Azure DevOps".

Da qui, i passaggi variano a seconda del tipo di istanza. Leggi le sezioni qui sotto per i passaggi di ciascuno.

Connettiti al tuo account Azure DevOps Cloud

Per continuare a configurare l'integrazione di un account Azure DevOps Cloud, segui questi passaggi:

1. Seleziona Azure Cloud nel selezionatore di type di istanza.
2. Clicca su Procedi.

Verrai reindirizzato ad Azure DevOps per autenticare i tuoi permessi di accesso e, dopo aver effettuato l'accesso al tuo account, verrai reindirizzato alla pagina delle integrazioni airfocus del tuo workspace.

Assicurati di avere attivata l'impostazione "Accesso alle applicazioni di terze parti via OAuth" nella schermata delle policy organizzative di Azure DevOps per garantire un'integrazione di successo.

Connettiti al tuo account Azure DevOps Server (on-premise)

Per continuare a configurare l'integrazione di un account Azure DevOps Cloud, segui questi passaggi:

1. Seleziona Azure On-Premises nel selezionatore di type di istanza.
2. Clicca su Procedi.
3. Inserisci i dettagli per connetterti alla tua istanza di Azure DevOps Server.
   • URL base: inserisci la prima parte del tuo URL del server Azure DevOps (tutto ciò che precede fino alla fine del tuo dominio/indirizzo IP e prima della prima barra a rovescia). Per esempio: https://198.254.533.325. L'URL deve essere accessibile dai nostri server, quindi qui non puoi usare URL ospitati localmente.
   • Token di accesso personale: ottieni il tuo token di accesso personale andando alla sezione token di accesso personale delle impostazioni di sicurezza degli utenti di Azure DevOps. Per maggiori dettagli, consultare la sezione "Ottieni un token di accesso personale" qui sotto.
   • Nome dell'organizzazione: Inserisci il nome esatto dell'organizzazione Azure DevOps che vuoi sincronizzare con airfocus.
4. Clicca su Procedi per collegare il tuo airfocus Team alla tua organizzazione Azure DevOps.

Ottieni un token di accesso personale

Per ottenere il tuo token di accesso personale in Azure DevOps, segui questi passaggi:

1. Apri le impostazioni di sicurezza ADO.
2. Seleziona i token di accesso personale dal menu di navigazione sul lato sinistro della pagina.
3. Clicca + Nuovo Gettone dalla parte superiore della pagina.
4. Crea un nuovo token con almeno le seguenti autorizzazioni:
   • Elementi di lavoro (lettura e scrittura)
   • Progetto e Team (leggi)
   • I token di accesso personale possono essere configurati per essere validi per una durata massima di 1 anno. Ricorda di mantenere aggiornata la validità del tuo token per garantire che l'integrazione con airfocus possa funzionare senza interruzioni.
5. Clicca su Crea.
6. Copia il token e incollalo nelle impostazioni delle tue integrazioni in airfocus.

Configura i tuoi filtri di integrazione

Per configurare i tuoi filtri di integrazione:

1. Seleziona il progetto Azure DevOps con cui vuoi integrarti. Aggiungi le seguenti informazioni così airfocus sa dove spingere i dati:
   • Organizzazione
   • Progetto
   • Area
2. Opzionalmente, includere gli elementi di lavoro di tutte le sottoaree dell'area selezionata selezionando la casella accanto a "Includere elementi di lavoro di tutte le sottoaree dell'area selezionata".

Puoi inoltre specificare quali elementi di lavoro vuoi sincronizzare usando il campo Ricerca Problemi di Azure DevOps nelle impostazioni di integrazione. Offre una ricerca veloce e flessibile su tutti i tuoi lavori e su tutti i tuoi progetti (ad esempio, t:epic AND s:new).

Filtri comuni

• Per filtrare per tipo di elemento di lavoro Azure DevOps:
  • T:epic
  • T:Caratteristica
  • t:storia
  • t:compito

Per estrarre elementi con un tag Azure DevOps specifico

• tag:tag abc

Per recuperare elementi con una specifica iterazione Azure DevOps.

• Iterazione:Iterazione ABC

Leggi di più sulla ricerca avanzata qui.

Configura la mappatura del campo

Usa la mappatura per definire come le informazioni in Azure DevOps dovrebbero essere mappate a airfocus (e viceversa). I nomi degli elementi (obbligatori) e le descrizioni degli oggetti (opzionali) sono sempre mappati di default quando si configura una nuova integrazione.

Come impostare le direzioni di mappatura

Definisci per ciascuno dei tuoi campi se vuoi avere una sincronizzazione unidirezionale o bidirezionale tra il campo in Azure DevOps e airfocus.

Imposta le direzioni di mappatura per tutti i campi contemporaneamente con il menu a tendina "Imposta direzione".

Di default, la direzione della mappatura è impostata da Azure DevOps su solo airfocus e può essere modificata dall'utente in base a ciò che è disponibile per la mappatura.

Come aggiungere una nuova mappatura di campo

Quando selezioni un campo nel menu a tendina, solo i campi che corrispondono al tipo di campo sono mostrati nel menu a tendina all'altro capoluogo.

Dopo aver selezionato due campi da mappare, puoi selezionare le opzioni dei campi e come dovrebbero essere mappate:

Campi di auto-mappatura

Quando mappi campi con molte opzioni, attiva "Auto-mappa opzioni dei campi" per risparmiare tempo. Questo mappa automaticamente campi con gli stessi valori sia in airfocus che in Azure DevOps.

Generazione automatica del valore del campo

Attiva "Auto-crea opzioni di campo" per aggiungere automaticamente nuovi campi creati in Azure DevOps a airfocus quando vengono aggiunti a un elemento. 

Nota: Il generatore di campo auto-create non è distinto dalla maiuscola e minuscolo.

Panoramica di tutte le opzioni di mappatura del campo attualmente disponibili

Note

1. ⚠️ Se la descrizione è sincronizzata in entrambe le direzioni, questo può portare airfocus a apportare lievi cambiamenti nel contenuto e nella formattazione delle descrizioni DevOps di Azure. Questo perché non tutti gli stili Azure DevOps sono ancora supportati nativamente in airfocus.
2. La mappatura in questa direzione non può essere supportata se il campo target in ADO è configurato come solo lettura.
3. Questo include solo i campi numerici personalizzati di ADO. Mentre qualsiasi campo numerico di sistema deve essere implementato separatamente (come ad esempio Priorità o Sforzo). Pertanto, se un campo numerico di sistema non è esplicitamente menzionato in questa tabella, significa che non è ancora supportato.
4. Le picklist con valori personalizzati consentiti non sono adatte per la mappatura ai campi di selezione a focus dell'airfocus, perché in questo caso la quantità di opzioni di selezione è dinamica e può cambiare frequentemente nel tempo, il che richiederebbe di riconfigurare la mappatura di integrazione ogni volta che appare un nuovo valore nella picklist. Ecco perché mappiamo queste picklist a campi di testo o numeri regolari nell'airfocus, così che ogni nuovo valore sul lato ADO sia sempre automaticamente sincronizzato con quello dell'airfocus.
5. Questo include campi data-ora personalizzati, oltre ai campi di sistema Data di Inizio, Data Target, Data di Consegna, Data di Risoluzione e Data di Cambio di Stato.
6. ⚠️ Al momento airfocus non supporta i campi data-ora (con la parte ora), ma solo i campi data. Pertanto, mappare i campi data-ora ADO nei campi di data di airfocus in entrambe le direzioni comporta la perdita della parte oraria sul lato ADO - l'ora verrà resettata dall'airfocus alle 00:00:00.
7. Al momento, ADO non dispone di campi di intervallo di date integrati. Tuttavia, è possibile mappare una coppia di qualsiasi campo data-ora ADO supportato in un campo di airfocus a distanza di date.
8. Mappare il campo Stack Rank da airfocus a Azure DevOps può portare a comportamenti inaspettati. La documentazione Microsoft sconsiglia di non aggiornare manualmente questo campo, poiché Azure DevOps calcola dinamicamente la classificazione degli stack dietro le quinte per mantenere le priorità di backlog. È meglio usarlo come sincronizzazione unidirezionale da ADO a airfocus.

Sincronizzazione gerarchica

La sincronizzazione gerarchica per Azure DevOps ti permette di sincronizzare automaticamente le relazioni padre-figlio dal tuo progetto Azure DevOps a airfocus (per ora unidirezionale). Questo ti permette di fare lavoro di product management su airfocus avendo a disposizione l'ultima gerarchia Azure DevOps senza dover passare da airfocus a Azure DevOps.

Per configurare/abilitare la sincronizzazione della gerarchia per Azure DevOps, avrai bisogno di:

• Due o più spazi di lavoro con la gerarchia airfocus abilitata tra di loro OPPURE uno spazio di lavoro che consente relazioni di gerarchia all'interno dello stesso spazio di lavoro.
• Due o più tipi di work item Azure DevOps sincronizzati con airfocus.
• Se hai due integrazioni in due workspace, sincronizza un singolo tipo di elemento per ciascun workspace.
• Se hai due integrazioni in un unico workspace, sincronizza un singolo tipo di elemento per ciascuna delle integrazioni in quell'unico workspace.

Un utente ha bisogno di accesso completo allo spazio di lavoro per poter modificare qualsiasi cosa nelle impostazioni di integrazione.

Per impostare la sincronizzazione della gerarchia, segui questi passaggi:

1. Nelle impostazioni dello spazio di lavoro in airfocus, assicurati che la gerarchia airfocus prodotto sia abilitata con un altro o all'interno del tuo spazio di lavoro attuale.
   
2. In fondo alla pagina delle impostazioni di integrazione Azure DevOps, attiva il widget "Collegamento automatico degli oggetti".
   
3. Per garantire che la gerarchia venga mantenuta, assicurarsi che gli spazi di lavoro soddisfino quanto segue:
   • L'altro spazio di lavoro ha un'integrazione nella stessa organizzazione Azure DevOps.
   • L'utente ha pieno accesso all'altro spazio di lavoro.
   • L'altro spazio di lavoro è nello stesso airfocus Team.

Una volta abilitata la sincronizzazione della gerarchia, puoi vedere direttamente le relazioni padre-figlio in airfocus.

Nota quanto segue quando abiliti la sincronizzazione della gerarchia per Azure DevOps:

• L'integrazione aggiunge solo le relazioni tra gli elementi sincronizzati, non gli elementi aggiuntivi. Ciò significa che gli elementi devono essere sincronizzati già dalla rispettiva integrazione prima che i collegamenti gerarchici vengano sincronizzati.
• La sincronizzazione gerarchica per Azure DevOps può essere configurata anche all'interno dello stesso workspace, se più tipi di elementi di lavoro Azure DevOps sono sincronizzati con lo stesso airfocus workspace (tramite una singola o più integrazioni) e ha attivato 'Consentire relazioni gerarchiche all'interno di questo workspace' nella scheda Gerarchia nelle impostazioni Workspace.

Un utente dovrebbe richiedere almeno l'accesso di lettura al progetto Azure DevOps connesso per abilitare la sincronizzazione della gerarchia per Azure DevOps.

Impostazioni aggiuntive

• Quando è abilitato "Archive unknown issues", gli elementi importati in precedenza vengono archiviati in airfocus se non sono più presenti in Azure DevOps o non rientrano più nei filtri impostati per l'integrazione.
• Quando è abilitata la "Sincronizzazione automatica", la tua integrazione si sincronizza automaticamente ogni 10 minuti e ogni volta che accedi allo spazio di lavoro.
• Clicca su View log per visualizzare i log delle attività di integrazione Azure DevOps e vedere quali modifiche sono state apportate prima dell'ultima sincronizzazione.
  

Per salvare le impostazioni e importare i tuoi oggetti su airfocus, clicca su Aggiorna e sincronizza.

Indirizzi IP statici da inserire nella whitelist per la tua integrazione Azure DevOps

Squadra su https://app.airfocus.com o https://app.us.airfocus.com  Usa questi indirizzi IP:

• 46.101.71.101
• 46.101.69.142

Squadra su https://airfocus.app, Usa questi indirizzi IP:

• 100.24.176.163
• 34.204.246.112
• 54.227.154.184
• 35.156.253.227
• 18.159.159.136
• 18.199.183.125

Informazioni importanti

• Per creare/autenticare una nuova integrazione con Azure DevOps, l'account Azure DevOps utilizzato deve avere accesso a livello amministrativo.
• Modificare un'integrazione esistente su airfocus richiede solo che l'utente abbia permessi completi sullo spazio di lavoro.
• Anche se l'utente airfocus non ha accesso all'account Azure DevOps usato per la configurazione iniziale, l'account Azure DevOps deve mantenere gli stessi permessi per garantire che l'integrazione funzioni in ogni momento.
• Se una sincronizzazione bidirezionale era stata attivata in precedenza, verrà applicata a tutte le mappature dove possibile. Altrimenti sarà impostato come una sola via da Azure DevOps a airfocus.
• Se "Mostra descrizione Azure DevOps" era attivata, l'integrazione sincronizzerà la descrizione solo con il campo speciale di sola lettura fino al 31 marzo 2023. Gli utenti devono migrare manualmente alla nuova mappatura del campo descrittivo nella sezione mappa del campo delle loro integrazioni. Dal 1° aprile 2023, il campo speciale di descrizione (e il suo interruttore) non sarà più disponibile.

Dai un feedback su questo articolo