Skip to main content

CSV: Jira Cloud

🔷 Requisiti generali

  • Formato del file: .csv con codifica UTF-8
  • ⚠️ È possibile creare max 250 ticket alla volta (CSV max 251 righe)
  • Formato delle date: dd/MM/yyyy (es. 06/05/2025)
  • Importazione da effettuare via Jira Cloud: "Importa issues da CSV"

🔷 Come compilare il file CSV

1. Campi da compilare

Ogni intestazione di colonna nel file CSV corrisponde al nome del campo in Jira.

Nel file CSV devono essere compilati solo:

  • I campi obbligatori (indicati separatamente)
  • I campi eventualmente necessari al tuo ticket

Il campo "Richiedente" se non compilato riporterà in automatico il soggetto che caricherà il CSV.

⚠️ Non inserire colonne inutili: Jira tenterà comunque di leggerle e potrebbe generare errori.

2. Campi con valori da menù a tendina ("Dropdown")

Per tutti i campi Dropdown (es. Priorità, Cluster, Regione interessata, ecc.):

  • Devi scrivere esattamente il valore così come appare nel menù a tendina di Jira (rispettando maiuscole, spazi, punteggiatura) — vedi Note template.
  • Valori scritti in modo diverso da quelli presenti in Jira verranno scartati.

🔷 Campo "Principale" – cosa significa e come usarlo

Il campo "Principale" serve per indicare a quale altro ticket è subordinato quello che stai creando.

Caso 1: Creazione di un'intera struttura da zero

Esempio: stai creando da zero un Epic, dei Task collegati e relativi Sottotask.

Come fare:

  • Inserisci una colonna aggiuntiva chiamata "Issuekey" nel file CSV ("Issuekey" è un identificatore fittizio usato solo per l'importazione).
  • Nella colonna "Issuekey" assegna un numero progressivo (es. 1, 2, 3, …) a ogni riga.
  • Nel campo Principale: per ogni Task o Sottotask che dipende da un altro ticket, inserisci il numero dell'Issuekey di riferimento come se fosse una vera key Jira.

Questo metodo permette a Jira di costruire correttamente la gerarchia anche se i ticket non esistono ancora.

Caso 2: Aggiungere ticket a ticket già esistenti in Jira

Esempio: vuoi collegare un nuovo Task a un Epic già creato.

Come fare:

  • Nel campo Principale, inserisci direttamente la KEY dell'Epic già esistente (es. E18P-1).

🔷 Tipo ticket e gerarchia

Indica il tipo corretto di ticket nel campo Tipo ticket (es. Epic, Task, Sottotask). Jira userà questo per strutturare la gerarchia — assicurati che il valore sia corretto e supportato dal tuo progetto.

Tipo di progetto1° livello2° livello3° livello
Servizio: RilieviEpicRilievi / ChangeRequest_RSottotask / Bug_sottotask
Servizio: ProgettazioneEpicProgettazione / ChangeRequest_prgSottotask / Bug_sottotask
Servizio: DL/PMOEpicDLPMO / ChangeRequest_DLSottotask / Bug_sottotask
Servizio: AltriEpicAltro / ChangeRequest_ASottotask / Bug_sottotask
Servizio: RobotEpicRobot / ChangeRequest_RBSottotask / Bug_sottotask

🔷 Caricamento CSV in Jira

  1. Accedi al Progetto di riferimento in Jira Cloud.
  2. Seleziona dalla barra di navigazione del progetto → clicca sulle opzioni in alto a destra.
  3. Nel menu che si apre, seleziona "Importa ticket dai file CSV".
  4. Carica il CSV (e l'eventuale file di configurazione salvato in precedenza) e modifica le impostazioni.
  5. Mappa i campi del CSV con quelli di Jira: Jira ti chiederà di associare ogni colonna del CSV a un campo Jira.
  6. Convalida e conferma l'avvio dell'importazione. ✅ Jira creerà un ticket per ogni riga del file.

🕒 L'importazione può richiedere qualche minuto. Al termine, vedrai un messaggio di successo con un link per visualizzare i ticket creati e salvare il file di configurazione appena utilizzata.


📋 Note sul template – Campi e obbligatorietà

Nome CampoTipo di CampoObbligatorio EPICObbligatorio TASK (ChangeRequest)Obbligatorio SOTTOTASK (Bug_Sottotask)
Tipo ticketVedi Tabella gerarchia✅ Sì✅ Sì✅ Sì
RiepilogoTesto breve✅ Sì✅ Sì✅ Sì
PrincipaleChiave ticket principaleNo✅ Sì✅ Sì
Regione interessataDropdownNoNoNo
ProvinciaDropdownNoNoNo
ComuneTesto breveNoNoNo
Data di scadenzaData (dd/MM/yyyy)No✅ Sì✅ Sì
Stima OriginaleDurata in secondiNoNo✅ Sì
RichiedenteMail aziendaleNoNoNo
AssegnatarioMail aziendaleNo✅ Sì✅ Sì
Tipo Attività RicavoDropdown✅ Sì (vedi file controller)
Activity TypeDropdown✅ Sì
Production UnitsDropdown✅ Sì (alcune tipologie)✅ Sì
Target ProductionNumero✅ Sì✅ Sì
DescrizioneTesto lungoNoNoNo
PrioritàDropdownNoNoNo
Fornitore-ProviderDropdownNo

📋 Valori campi Dropdown

Priorità

  • Not Prioritized
  • Very High
  • High
  • Medium
  • Low

Fornitore-Provider

I valori per questo campo non sono ancora stati definiti. Se necessario, contattare il supporto Jira per inserire i fornitori necessari.

Regione interessata

Abruzzo, Basilicata, Calabria, Campania, Emilia-Romagna, Friuli-Venezia Giulia, Lazio, Liguria, Lombardia, Marche, Molise, Piemonte, Puglia, Sardegna, Sicilia, Toscana, Trentino-Alto Adige, Umbria, Valle d'Aosta, Veneto

Provincia

Agrigento, Alessandria, Ancona, Aosta, Arezzo, Ascoli Piceno, Asti, Avellino, Bari, Barletta-Andria-Trani, Belluno, Benevento, Bergamo, Biella, Bologna, Bolzano, Brescia, Brindisi, Cagliari, Caltanissetta, Campobasso, Carbonia-Iglesias, Caserta, Catania, Catanzaro, Chieti, Como, Cosenza, Cremona, Crotone, Cuneo, Enna, Fermo, Ferrara, Firenze, Foggia, Forlì-Cesena, Frosinone, Genova, Gorizia, Grosseto, Imperia, Isernia, L'Aquila, La Spezia, Latina, Lecce, Lecco, Livorno, Lodi, Lucca, Macerata, Mantova, Massa-Carrara, Matera, Messina, Milano, Modena, Monza-Brianza, Napoli, Novara, Nuoro, Ogliastra, Olbia-Tempio, Oristano, Padova, Palermo, Parma, Pavia, Perugia, Pesaro-Urbino, Pescara, Piacenza, Pisa, Pistoia, Pordenone, Potenza, Prato, Ragusa, Ravenna, Reggio Calabria, Reggio Emilia, Rieti, Rimini, Roma, Rovigo, Salerno, Sassari, Savona, Siena, Siracusa, Sondrio, Sud Sardegna, Taranto, Teramo, Terni, Torino, Trapani, Trento, Treviso, Trieste, Udine, Varese, Venezia, Verbano-Cusio-Ossola, Vercelli, Verona, Vibo Valentia, Vicenza, Viterbo