Migrare da Jira a Jalonio, passo dopo passo.

CSV o API: quale metodo scegliere?

• Esportazione CSV: disponibile per i responsabili di progetto (nel proprio progetto) e per chi può creare progetti. Comoda per una prima prova, o se il vostro Jira è raggiungibile solo dalla rete interna.
• Collegamento tramite API: riservato agli amministratori dell’organizzazione. Più completo: recupera anche sprint, tutti i commenti e gli allegati, senza file da gestire. Funziona con Jira Cloud e Jira Data Center.

Prima di iniziare

• Invitate prima il team in Jalonio: le persone di Jira vengono abbinate agli account esistenti tramite indirizzo e-mail o nome.
• Annotate la chiave del progetto Jira (ad esempio PORT): riutilizzandola in Jalonio, PORT-12 resta PORT-12.
• Per l’API, verificate che l’account Jira utilizzato possa consultare il progetto. Un accesso in sola lettura è sufficiente.
• Avvisate il team: dopo l’importazione, il riferimento è Jalonio.

Metodo 1: importare un’esportazione CSV

1. Esportare da Jira. Nei filtri di Jira, cercate i ticket del progetto, poi esportate la ricerca in CSV (tutti i campi). Per gli allegati, preparate se necessario un archivio ZIP dei file.
2. Aprire la schermata di importazione. In Jalonio: «Progetti», poi «Importa da Jira».
3. File e progetto. Caricate il file CSV (50 MB al massimo; codifica e separatore vengono rilevati) ed eventualmente l’archivio ZIP degli allegati: i file vengono abbinati per nome. Scegliete «Nuovo progetto» o «Progetto esistente».
4. Abbinamenti. «Analizza il file»: Jalonio propone un abbinamento per ogni colonna, ogni stato, tipo e priorità, e ogni persona. Tutto è modificabile. Le esportazioni Jira in inglese e in francese sono entrambe riconosciute. Le colonne del titolo («Summary») e della chiave («Issue key») sono obbligatorie.
5. Simulazione. La simulazione non scrive nulla. Verificate i numeri (ticket da creare, da aggiornare, ignorati), i problemi riga per riga e l’anteprima dei primi 10 ticket.
6. Importazione. «Avvia l’importazione»: l’avanzamento è visibile e ricevete una notifica alla fine.
7. Rapporto. Ticket creati, aggiornati, ignorati, allegati non importati. «Scarica il rapporto dettagliato (CSV)» conserva una traccia della migrazione.

Metodo 2: collegarsi a Jira tramite l’API

1. Creare un token in Jira. Jira Cloud: la pagina dei token API del vostro account Atlassian, «Create API token», con una durata breve. Jira Data Center: il vostro profilo, «Personal Access Tokens», con una data di scadenza.
2. Scegliere l’origine. In Jalonio: «Progetti», «Importa da Jira», poi «Collegamento a Jira (API)».
3. Verificare il collegamento. Scegliete Cloud o Data Center, incollate l’indirizzo di Jira, l’indirizzo e-mail dell’account (Cloud) e il token, poi «Verifica il collegamento». Ogni errore è spiegato in parole semplici: credenziali rifiutate, permesso mancante, indirizzo non trovato, certificato non valido.
4. Scegliere i progetti. Il progetto Jira e il progetto Jalonio di destinazione: per impostazione predefinita, un nuovo progetto con lo stesso nome e la stessa chiave, per conservare i numeri.
5. Leggere i ticket. «Leggi i ticket da Jira» mostra l’avanzamento. Se Jira limita il numero di richieste, la lettura rallenta, poi riprende da sola.
6. Concludere come con il CSV. Abbinamenti (sprint compresi), simulazione, importazione e rapporto.

Il token è conservato cifrato per la durata dell’importazione, poi cancellato: alla fine, in caso di errore, o se fate clic su «Annulla e cancella le credenziali». Revocatelo anche in Jira una volta terminata l’importazione.

Cosa viene ripreso, e cosa no

Il tempo impiegato non viene ripreso perché Jalonio non offre il rilevamento dei tempi. La chiave Jira originale resta visibile su ogni ticket e si può trovare con la ricerca.