Collega la tua strategia di prodotto in airfocus con l'esecuzione dello sviluppo in Jira grazie a questa potente integrazione bidirezionale. Puoi importare gli elementi di lavoro in airfocus e spingere gli elementi di airfocus—inclusi epici e funzionalità—in Jira, permettendoti di monitorarne il stato da airfocus collegando al contempo i flussi di lavoro di gestione prodotto, i framework di prioritizzazione e le roadmap con lo sviluppo quotidiano tramite una sincronizzazione dei dati senza interruzioni. Continua a leggere per scoprire come configurare e configurare questa integrazione.
Vantaggi
Collega i tuoi flussi di lavoro di product management, i framework di prioritizzazione e le roadmap con lo sviluppo quotidiano sincronizzando i tuoi dati senza soluzione di continuità tra airfocus e Jira. L'integrazione è compatibile con Jira Cloud, Jira Server e Jira Data Center.
- Importare problemi di Jira (come oggetti) in airfocus.
- Spingi gli oggetti airfocus in Jira (come qualsiasi tipo di problema).
- Sincronizzazione bidirezionale e filtraggio flessibile (JQL personalizzato).
- Mappatura del campo flessibile.
- Visualizza i tuoi punteggi di priorità di airfocus su Jira per avere un contesto sul valore e le priorità aziendali.
- Capacità di vedere direttamente le relazioni genitore-figlio in airfocus.
Requisiti
- A airfocus: L'utente deve avere i permessi "Full" sullo spazio di lavoro per cui vuole configurare l'integrazione con Jira.
- Su Jira: sono necessari permessi "Administrator" per stabilire il collegamento applicativo tra la tua istanza Jira e airfocus Team.
- Se il collegamento dell'applicazione tra l'istanza Jira e il team airfocus è già stato stabilito, qualsiasi utente Jira con almeno il permesso "Create_Issue" per un progetto può configurare nuove integrazioni per quell'istanza.
- La nostra integrazione con Jira è compatibile con Jira Cloud, Jira Server e Jira Data Center. Supportiamo tutte le versioni di Jira Server elencate nella Politica di Fine Vita del Supporto Atlassian. Le versioni precedenti a quelle elencate hanno raggiunto la Fine della Vita (EOL) e possono funzionare, ma non sono supportate.
Configurare l'integrazione con Jira
- Iscriviti a airfocus o accedi al tuo account esistente.
- Crea un nuovo spazio di lavoro in airfocus oppure scegli quello con cui vuoi integrare Jira.
- Devi autorizzare la tua istanza Jira solo una volta per airfocus Team.
- Puoi aggiungere più integrazioni Jira a un dato workspace (ad esempio, da diversi progetti o istanze Jira).
- Clicca su Estensioni dall'angolo in alto a destra del tuo spazio di lavoro.
- Seleziona Gestisci integrazioni.
- Clicca su Collega sulla tessera "Jira".
- Seleziona Collega una nuova istanza Jira dal menu a tendina che appare.
- Inserisci l'URL della base della tua istanza Jira (ad esempio, https://airfocustest.atlassian.net/ o https://jira.mycompany.com).
- Clicca su Procedi.
- Copia l'"Application URL". Ti servirà questo per i prossimi passi in Jira.
- Clicca sul centro link applicazioni Jira per aprire il Centro Link Applicazioni Jira.
- Devi essere un amministratore in Jira per accedere a questa pagina.
I passi successivi variano per Jira Cloud e Jira Server/Data Center. Dai un'occhiata alla sezione qui sotto per vedere il tuo caso e continuare.
Crea un link applicativo in Jira Cloud
- In Jira Cloud, clicca sull'icona Impostazioni nell'angolo in alto a destra
- Seleziona le app Jira.
- Sotto la sezione "Integrazioni" sul lato sinistro, clicca su Link applicazione.
- Clicca sul pulsante Crea link in alto a destra della pagina.
- Seleziona l'opzione "Link applicazione diretta".
- Incolla il tuo URL airfocus come "Application URL".
- Clicca su Next.
- Digita un nome per l'applicazione e assicurati che il tipo di applicazione sia impostato come "Generic Application".
- Utilizzando le informazioni fornite in airfocus, copia e incolla il Nome del Fornitore di Servizi, la chiave Consumer, il segreto condiviso, l'URL del Token Richiede, l'URL del token di accesso e l'URL di Autorizzazione in Jira.
- Seleziona la casella accanto a "Crea link in arrivo".
- Clicca su Continua.
- Utilizzando le informazioni fornite su airfocus, copia e incolla la Chiave del Consumatore, il Nome del Consumatore e la Chiave Pubblica in Jira.
- Clicca su Continua.
- Torna a airfocus e clicca su Termina configurazione.
Ti reindirizzeremo al passaggio di autorizzazione oAuth che airfocus permette di usare il tuo utente Jira per sincronizzare gli elementi tra i due. Clicca su Consenti per autorizzare airfocus a sincronizzarsi con il tuo account.
Crea un link applicativo su Jira Server o Jira Data Center
- Fare clic su Crea collegamento in alto a destra,
- Seleziona il prodotto Atlassian.
- Incolla il tuo URL airfocus come "Application URL".
-
Clicca su Continua per confermare.
- Compila i valori forniti nell'interfaccia airfocus .
- Clicca su Continua.
- Copia i valori del Passo 3.
- Fare clic su Continua.
- Ora dovresti vedere una conferma su Jira.
- Torna a airfocus e clicca su Termina configurazione.
Ti reindirizzeremo al passaggio di autorizzazione oAuth che airfocus permette di usare il tuo utente Jira per sincronizzare gli elementi tra i due. Clicca su Consenti per autorizzare airfocus a sincronizzarsi con il tuo account.
Configura il filtraggio di integrazione
- Seleziona il progetto che vuoi sincronizzare. È possibile digitare per filtrare l'elenco dei progetti.
- I progetti che puoi vedere ma per cui non hanno i permessi CREATE_ISSUES sono contrassegnati come tali (disponibili solo per Jira Cloud).
- Il nome della tua integrazione viene creato automaticamente in base al progetto. Puoi anche cambiarlo in seguito.
- Seleziona il tipo di problema che vuoi sincronizzare.
- Poiché i campi possono variare tra i tipi di issue (a seconda della versione di Jira e del tipo di progetto, ad esempio gestito da team o gestito dall'azienda), questo filtra i campi che puoi mappare a quelli effettivamente disponibili nel tipo di issue selezionato.
- Se vuoi sincronizzare più tipi di problemi, ti consigliamo di configurare una sola integrazione ciascuno, sia nello stesso spazio di lavoro sia tra più spazi di lavoro. Puoi collegare integrazioni da altri workspace (ad esempio per Epic o Sub-Task) tramite airfocus gerarchia.
- Puoi anche filtrare ulteriormente i problemi sincronizzati fornendo una query JQL nel filtro dei problemi (leggi di più su JQL qui).
Mappa airfocus e campi Jira
Usa la mappatura per definire come le informazioni in Jira dovrebbero essere mappate in informazioni di airfocus. Se cambi un problema o un elemento in un sistema, l'altro sistema verrà regolato di conseguenza.
Puoi, ad esempio, definire come gli stati di Jira debbano essere mappati ai campi a selezione singola di airfocus e/o come le etichette di Jira debbano essere mappate ai campi multi-selezione di airfocus.
Ci sono anche molte altre opzioni per mappare diversi campi personalizzati e di sistema Jira ai tuoi campi di airfocus.
Quando dai un'occhiata alle opzioni di mappatura dei campi, vedrai che due campi sono sempre mappati di default: nomi degli oggetti e descrizioni degli oggetti.
Puoi definire per ciascuno dei tuoi campi se vuoi una sincronizzazione unidirezionale o una bidirezionale tra il campo in Jira e airfocus.
Puoi impostare le direzioni di mappatura per tutti i campi contemporaneamente (per quanto tecnicamente possibile) con il pulsante "Imposta direzione".
Di default, la direzione di mappatura è impostata da Jira a solo airfocus e può essere modificata dall'utente in base a ciò che è disponibile per la mappatura.
Quando configuri una nuova mappatura per uno dei tuoi campi, scoprirai che puoi mappare campo Jira a campo di airfocus solo se entrambe le estremità hanno lo stesso tipo di campo.
Quando si seleziona un campo nel menu a tendina, solo i campi che corrispondono al tipo di campo saranno visualizzati nel menu a tendina all'altro capoluogo.
Dopo aver selezionato i due campi che si desidera mappare, è possibile selezionare le opzioni del campo e il modo in cui devono essere mappati.
Panoramica di tutti i tipi di campi mappabili
Campi del sistema Jira mappabile:
| JIRA | airfocus | Jira → airfocus | airfocus → Jira |
| Nome del numero | Nome dell'oggetto | ✅ | ✅ |
| Descrizione del numero | Descrizione dell'oggetto | ✅ | ⚠️ |
| Stato | Campo di scelta singola stato/personalizzato | ✅ | ✅ |
| Etichette | Campo multi-selezione personalizzato | ✅ | ✅ |
| Creazione | Campo di data personalizzato | ✅ (solo data) | ❌ |
| Aggiornato | Campo di data personalizzato | ✅ (solo data) | ❌ |
| Criteri di accettazione | ❌ | ❌ | ❌ |
| Assegnatari | Persone/Assegnati | ⚠️ | ⚠️ |
| Autore della segnalazione | Persone/Assegnati | ⚠️ | ⚠️ |
| Allegati | Allegati | ❌ | ❌ |
| (Inizio/Scadenza) Campo data (come coppia) | Campo personalizzato per intervallo di date | ✅ | ✅ |
| Campo Data (Inizio/Scadenza) | Campo di data personalizzato | ✅ | ✅ |
| Dipendenze | Dipendenze | ✅ | ✅ |
| Versione correttiva | Campo multi-selezione personalizzato | ✅ | ❌ |
| Versione correttiva | Milestone (multi-selezione) | ✅ | ✅ |
| Versione correttiva | Periodo di tempo | ✅ | ❌ |
| Versione correttiva (più recente) | Campo personalizzato a selezione singola | ✅ | ❌ |
| Versione correttiva (più recente) | Campo multi-selezione personalizzato | ✅ | ❌ |
| Data di uscita della versione fissa | Campo di data personalizzato | ✅ | ❌ |
| ID del numero | ID articolo | ❌ | ❌ |
| Tipo di problema | Campo personalizzato a selezione singola | ✅ | ❌ |
| Campi multi-selezione | Campo multi-selezione personalizzato | ✅ | ✅ |
| Campo di priorità | Campo personalizzato a selezione singola | ✅ | ✅ |
| Sprint | Campo di periodo temporale | ✅ | ❌ |
| Sprint (ID) | Campo multi-selezione personalizzato | ✅ | ❌ |
| Sprint (nome) | Campo di testo personalizzato | ✅ | ❌ |
| Sprint (date) | Campo personalizzato per intervallo di date | ✅ | ❌ |
| Sprint (l'ultimo aggiornato) | Campo personalizzato a selezione singola | ✅ | ❌ |
| Team Field | Campo personalizzato a selezione singola | ✅ | ✅ |
⚠️ Avviso riguardo alla sincronizzazione bidirezionale per il campo descrizione: Il processo di sincronizzazione bidirezionale potrebbe comportare lievi cambiamenti nel contenuto e nella formattazione delle descrizioni di Jira. Questo perché non tutti gli stili di Jira sono ancora supportati nativamente in airfocus.
⚠️ Avvertenze riguardanti la mappatura dei campi delle persone: La logica di mappatura si basa sui nomi visualizzati. Quindi "Kirsten" in Jira NON corrisponde a "Kirst" in airfocus, anche se entrambi gli account usano lo stesso indirizzo email.
Nel caso in cui Jira permette un solo valore su un campo persone (ad esempio, possono avere solo un assegnato), una sincronizzazione con airfocus favorisce il primo valore per il campo persone mappato con airfocus. Ad esempio, un biglietto in Jira assegnato a "Julian" sovrascriverà un elemento in airfocus assegnato a "Julian e Nikita". Nikita sarà rimossa e solo Julian rimarrà assegnato.
Campi personalizzati Jira mappabili:
| JIRA | airfocus | Jira → airfocus | airfocus → Jira | airfocus ↔ Jira |
| Campo a selezione singola | Campo personalizzato a selezione singola | ✅ | ✅ | ✅ |
| Campi multi-selezione | Campo multi-selezione personalizzato | ✅ | ✅ | ✅ |
| Campo di data | Campo data personalizzato (intervallo di date se multiplo) | ✅ | ✅ | ✅ |
| Campo di testo (escluso il testo arricchito) | Campo di testo personalizzato | ✅ | ✅ | ✅ |
| Campo di testo arricchito | Campo descrizione dell'oggetto / airfocus descrizione | ✅ | ⚠️ | ⚠️ |
| Campo numerico | Campo numerico personalizzato | ✅ | ✅ | ✅ |
| Campo numerico | Punteggio delle Valutazioni Prioritarie | ❌ | ✅ | ❌ |
| Etichette | Campo multi-selezione personalizzato | ✅ | ✅ | ✅ |
Risoluzione del problema: trova il campo della tua data
Abbiamo bisogno di almeno due campi di data (oltre alle versioni fisse) per poterli mappare a un campo di intervallo di date airfocus.
La nostra integrazione può rilevare i campi di data solo se sono visibili sul tipo di problema sincronizzato (schermo). Devi assicurarti che almeno due campi di data siano sul tipo di problema (schermo) su Jira e che almeno un campo di intervallo di date sia disponibile per la mappatura sul tuo airfocus workspace.
Come appare questo in Jira:
- per Jira Cloud Teammanaged, vai nelle impostazioni del progetto > tipi di problema e trascina il campo dalla barra laterale destra all'elenco dei campi al centro.
- per Jira Cloud gestito dall'azienda (e Jira Server), vai nelle impostazioni del progetto > problemi > schermate e modifica la schermata del tipo di problema che stai sincronizzando. Puoi aggiungere campi aggiuntivi per la data in fondo.
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 Jira.
Generazione automatica del valore del campo
Attiva "Auto-crea opzioni di campo" per aggiungere automaticamente nuovi campi creati in Jira all'airfocus quando vengono aggiunti a un oggetto.
Nota: Il generatore di campo auto-creazione non è sensibile alla maiuscolina.
Come mappare il punteggio di focus con Jira
Con airfocus'integrazione di Jira, puoi usare airfocus per la prioritizzazione e la roadmapping, mentre gli sviluppatori (e altri) usano Jira per la pianificazione quotidiana dello sviluppo.
Di default, mostriamo già i dati airfocus come punteggi di priorità, corsie e Linea del tempo in Jira. Questo articolo di aiuto descrive come puoi mappare il punteggio di focus dell'airfocus con un campo personalizzato su Jira (che puoi anche filtrare in Jira).
Mappando il punteggio di focus airfocus con il tuo progetto Jira, potrai mostrare la tua metrica prioritaria numero uno esattamente dove lavorano le persone – su ogni carta di uscita sincronizzata di Jira e sulla copertina della carta di emissione. In questo modo allineerai tutto il Team e ti concentrerai su quali compiti contano.
Per visualizzare il punteggio di airfocus focus in Jira, devi mapparelo con un campo personalizzato di Jira. Il campo personalizzato deve avere il tipo di campo "Campo Numero". Configurare tutto richiede circa 3 minuti.
Ecco come:
- All'interno di Jira, clicca sull'icona dell'ingranaggio nell'angolo in alto a destra per aprire le impostazioni.
- Problemi di clic.
- Seleziona Campi personalizzati dal menu di navigazione sul lato sinistro.
- Clicca su Crea campo personalizzato dall'angolo in alto a destra.
- Seleziona il campo Numero come tipo di campo.
- Digita un nome e una descrizione (opzionale).
- Clicca su Crea.
- Associa il nuovo campo personalizzato agli schermi (del tuo progetto sincronizzato)
- Torna alle impostazioni di integrazione di Jira in airfocus e seleziona il campo personalizzato appena creato dal menu a tendina
Il punteggio airfocus focus ora apparirà per i tuoi problemi Jira
Se vuoi anche mostrare il punteggio di focus sulle copertine delle tue carte, segui questi passaggi:
- Clicca sull'icona a tre puntini nell'angolo in alto a destra della tua Tavola.
- Seleziona le impostazioni di Tavola.
- Fare clic su Layout scheda dal menu di navigazione sul lato sinistro.
- Seleziona il campo personalizzato del punteggio di concentrazione dal menu a discesa.
- Clicca su Aggiungi.
- Ora troverai anche il punteggio di focus sulla Tavola.
Configura impostazioni aggiuntive
- Quando "Archivia problemi sconosciuti" è attivato, gli elementi importati in precedenza verranno archiviati in airfocus se non sono più presenti in Jira (o semplicemente non corrispondono più al filtro JQL).
- Quando è abilitato il "Sincronizzazione automatica", la tua integrazione si sincronizzerà automaticamente ogni 10 minuti e ogni volta che accedi allo spazio di lavoro.
- Clicca su Visualizza log per visualizzare i log delle attività di integrazione con Jira e vedere quali modifiche sono state apportate prima dell'ultima sincronizzazione.
Tipi di link degli oggetti della mappa
Puoi sincronizzare i tipi di link degli oggetti—come "Blocchi", "Duplicati" e "Relativi a"—tra Jira e airfocus utilizzando la sincronizzazione bidirezionale o unidirezionale. Quando la sincronizzazione bidirezionale (bidirezionale) è configurata per un tipo di collegamento, qualsiasi aggiornamento su una piattaforma si riflette automaticamente sull'altra, permettendo di visualizzare le dipendenze da Linea del tempo e roadmap senza duplicazioni manuali. Per flussi di lavoro più specifici, puoi impostare sincronizzazioni unidirezionali o consolidare i tuoi dati mappando più tipi di link Jira a un unico tipo di link airfocus .
Per mappare i tipi di link degli oggetti, segui questi passaggi:
- Clicca su Estensioni dall'angolo in alto a destra di qualsiasi pagina di airfocus.
- Seleziona Gestisci integrazioni.
- Sotto "Integrazioni attive", seleziona Jira.
- Sotto "Mappatura del tipo di link dell'elemento", clicca + Aggiungi mappatura del tipo di link.
- Usando i menu a tendina, seleziona un tipo di link per Jira a sinistra e un tipo di link per airfocus a destra.
- Clicca sull'icona della freccia sotto "Direzione" per cambiare se la sincronizzazione è bidirezionale o unidirezionale.
- Opzionalmente, clicca + Aggiungi tipo di link per aggiungere un ulteriore tipo di link Jira da mappare a un singolo tipo di link airfocus .
- Se aggiungi un tipo di link aggiuntivo, quando airfocus sincronizza con Jira, si sincronizzerà solo con il tipo di link principale.
- Clicca su Aggiorna e sincronizza dalla parte inferiore della pagina.
Le relazioni e le dipendenze degli oggetti ora si sincronizzeranno tra Jira e airfocus secondo le impostazioni che hai configurato.
Sincronizzazione gerarchica
La sincronizzazione della gerarchia per Jira ti permette di sincronizzare automaticamente le relazioni genitore-figlio dal tuo progetto Jira a airfocus. Questo ti permette di fare lavoro di product management su airfocus avendo a disposizione l'ultima gerarchia di Jira senza dover passare da airfocus a Jira.
Per configurare/abilitare la sincronizzazione della gerarchia per Jira, 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 problemi Jira 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 qualcosa nell'integrazione.
Per impostare la sincronizzazione della gerarchia, segui questi passaggi:
- 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.
- In fondo alla pagina delle impostazioni di integrazione di Jira, attiva il widget "Collegamento automatico degli oggetti".
- Puoi scegliere qualsiasi spazio di lavoro che soddisfi i seguenti requisiti:
- L'altro workspace ha una relazione gerarchica con quello attuale.
- L'altro spazio di lavoro ha l'integrazione di Jira con la stessa istanza di Jira.
- 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 Jira:
- 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.
- L'API di Jira non rivela i figli di un'epica, il che significa che impedisce airfocus di rilevare se una Jira epica ha problemi con i figli. Per vedere le relazioni dei bambini su airfocus, l'epic deve già essere sincronizzato con airfocus quando si sincronizzano le questioni dei bambini affinché tutte le relazioni vengano riflesse correttamente su airfocus.
La sincronizzazione della gerarchia per Jira può essere configurata anche all'interno dello stesso workspace, se più tipi di problemi di Jira sono sincronizzati allo stesso airfocus workspace (tramite una singola o più integrazioni) e ha abilitato 'Consentire relazioni di gerarchia all'interno di questo workspace' nella scheda Gerarchia delle impostazioni Workspace.
Un utente richiede almeno l'accesso di lettura al progetto Jira collegato per abilitare la sincronizzazione della gerarchia per Jira.
Nota riguardo alla sincronizzazione della gerarchia per gli utenti di data center/on-premise Jira:
- La gerarchia di airfocus non è in sintonia con le iniziative on-premise di Jira. Solo epici, storie, compiti e sotto-compiti.
- La gerarchia di airfocus si sincronizza con tutti i livelli di Jira Cloud, inclusi iniziative, epici, storie, compiti e sotto-compiti.
Informazioni aggiuntive
Collega più progetti Jira
Per collegare un altro progetto Jira dalla stessa istanza Jira al tuo workspace, non devi ripetere il processo di autenticazione. Da ora in poi puoi aggiungere un'altra integrazione di progetti Jira nella pagina delle integrazioni. La configurazione richiederà solo di selezionare l'istanza e avviare subito la mappatura.
Indirizzi IP statici da inserire nella whitelist per l'integrazione con Jira Server
Se stai integrando con un sistema di deployment on-premise come Jira Server, il tuo team IT potrebbe dover consentire la lista airfocus nel firewall così airfocus poter creare connessioni al server per creare record. Puoi fare la connessione tramite la porta 443.
Il team su https://app.airfocus.com o https://app.us.airfocus.com usa questi indirizzi IP:
- 46.101.71.101
- 46.101.69.142
Squadra in 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
Risoluzione dei problemi
- Controlla che i permessi dell'utente che cerca di collegare airfocus a Jira corrispondano ai requisiti.
- Controlla eventuali avvisi o campi mancanti nella sezione mappa dei campi.
- Clicca sul pulsante "Debug" in basso nelle impostazioni di integrazione. Durante la sincronizzazione, vengono chiamati diversi endpoint API. Se uno dei due fallisce, è difficile capire quale. La finestra di debug mostra tutte le chiamate e i loro risultati, per facilitarti la ricerca di una configurazione errata.
- Elimina e reinstalla l'integrazione. Suggerimento: la configurazione del link dell'app per collegare airfocus a Jira è rimasta.
- Contatta il nostro fantastico team di customer success per ulteriore supporto.
Dai un feedback su questo articolo
Hai un feedback su questo articolo? Raccontaci della tua esperienza qui.