Creazione ticket da CSV

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. 13/06/2025)

In Jira Product Discovery, soltanto gli utenti con ruolo "Autore" possono caricare i CSV.

1. Compilare il file CSV

Nella prima riga del file CSV vanno inseriti i nomi dei campi Jira: ogni intestazione di colonna corrisponde quindi a un campo.
I valori inseriti nelle righe successive corrispondono ai valori di quel campo.

CSV -> Ticket

Nel file devono essere inseriti e compilati:

I campi obbligatori (LINK CAMPI OBBLIGATORI)
Ulteriori campi eventualmente necessari al tuo ticket

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

Regole di compilazione

Alcuni campi richiedono un formato o una struttura specifica. Compilarli in modo errato può causare errori o far scartare il valore da Jira.

🗒️ Campi con valori da menù a tendina ("Dropdown")

Per tutti i campi Dropdown (es. Priorità, Tipo Attività Ricavo, Activity Type ecc.), inserire nel file CSV esattamente il valore così come appare nel menù a tendina di Jira (rispettando maiuscole, spazi, punteggiatura)

🌳 Campo "Principale"

Il campo Principale serve a indicare il parent del ticket che stai creando. Jira userà questo valore per strutturare la gerarchia (Vedi pag.4 di Guida Introduttiva a Jira Cloud_v0).

1. Caso 1: Creazione di un ticket con parent già esistente in Jira
  Esempio: vuoi creare un nuovo Task e assegnargli come parent un Epic già esistente in Jira.
  
  Come fare:
  - Aggiungi una colonna con intestazione "Principale"
  - Nella colonna "Principale" inserisci la key dell'Epic (es. E10P-30).
2. Caso 2: Creazione contemporanea di un ticket e dei ticket parent
  Esempio: vuoi creare da zero un Epic, un Task subordinato e relativo Sottotask.
  
  Come fare:
  - Aggiungi una colonna con intestazione "Principale".
  - Aggiungi una colonna con intestazione "ID ticket".
  - Nella colonna "ID ticket" assegna un numero progressivo (es. 1, 2, 3, …) a ogni ticket che farà da parent. Questo numero fungerà da key fittizia e temporanea del ticket in questione.
  - Nella colonna "Principale" assegna l'ID ticket del parent a ogni ticket child, come se fosse una vera key Jira:
  
  Questo metodo permette a Jira di costruire correttamente la gerarchia anche se i ticket non esistono ancora.

🎫 Campo "Tipo ticket"

Nel campo Tipo ticket indicare il tipo corretto di ticket che si vuole creare (Vedi pag.4 di Guida Introduttiva a Jira Cloud_v0).

🕐 Campo "Stima originale"

Nel campo "Stima originale" il valore deve essere inserito in secondi.

Jira convertirà automaticamente il valore nel formato più leggibile (minuti, ore, giorni o settimane) in base alla durata inserita.

Esempi:

3600 → 1 ora
28800 → 1 giorno lavorativo (8 ore)
144000 → 1 settimana lavorativa (5 giorni)

Assicurarsi di inserire solo valori numerici, senza testo o unità di misura.

👥 Campi utente e "Tempo Team"

Nei campi che richiedono l'inserimento di un utente (es. Assegnatario, Richiedente) inserire l’indirizzo e-mail dell’utente.
Il campo "Richiedente" se non compilato riporterà in automatico il soggetto che caricherà il CSV.

Per il campo "Tempo Team", inserire invece l’ID del Team. L’ID è visibile nell’URL della pagina del Tempo Team stesso: corrisponde al valore riportato alla fine dell’indirizzo web:

ID Tempo Team

⭐ Campo "Service Type"

Il campo "Service Type" prevede due valori, uno principale e uno secondario.

Durante l'importazione tramite CSV, Jira permette di inserire solo il valore principale. Per questo motivo, nel CSV è necessario inserire esclusivamente il primo valore.

Esempio:

Se il valore da inseire nel campo "Service Type" è "Rilievi -> Auto", nel CSV dovrà essere inserito solamente "Rilievi".

Dopo aver completato l'importazione del CSV, aggiungere massivamente il secondo valore utilizzando Sheet (Vedi Guida rapida all’utilizzo di JXL Sheets):

Creare uno sheet con il filtro necessario.
Aggiungere la colonna "Service Type"
Aggiungere manualmente a un ticket a scelta il secondo valore del campo "Service Type"
Copiare con CTRL+C il valore completo del campo "Service Type" del ticket appena modificato.
Selezionare tutti i ticket che dovranno avere lo stesso valore.
Incollare con CTRL+V il valore copiato nelle celle del campo "Service Type" dei ticket selezionati.
Ripetere l'operazione per eventuali ulteriori valori del campo "Service Type"

Esempio compilazione CSV ai seguenti link:
- EsempioCSV_Jira 2.0_creazione Iniziative-EpicPregresso
- EsempioCSV_Jira 2.0_creazione Iniziative-Epic-Task da lavorare
- EsempioCSV_Jira 2.0_creazione Iniziative-Task-Sottotask da lavorare_SM

2. Accedere alla schermata di importazione

🔹🔵 Da Jira Cloud

Accedi allo Spazio di riferimento e seleziona il tab "Tutti i ticket".
Clicca sulle opzioni della pagina.
Nel menu che si apre, seleziona "Importa i ticket da un file CSV".

🟣 Da Jira Product Discovery

Accedi allo Spazio Discovery di riferimento e seleziona "+ Crea".
Seleziona l'icona di importazione in alto a destra.
Conferma l'uscita nel popup che si apre automaticamente

Caricamento CSV Jira Discovery

3. Importare il file CSV

Carica il CSV e l'eventuale file .txt di configurazione*.
-> Cicca il tasto Avanti.
Seleziona lo spazio Jira e modifica le impostazioni come di seguito:
- Codifica file: UTF-8
- Delimitatore: ;
- Formato data: dd/MM/yyyy
  -> Clicca il tasto Avanti.
Mappa i campi del CSV con quelli di Jira: dovrai associare ogni colonna del CSV a un campo Jira.
Spunta le caselle "Mappa valore campo".
-> Clicca il tasto Avanti.
Clicca su "Convalida" per controllare che non ci siano errori.
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 per velocizzare importazioni future.