Creazione ticket da CSV

📑 Sommario

• Requisiti generali
• 1. Compilare il file CSV
  • Regole di compilazione
    • 🔤 Campi di testo
    • 🗒️ Campi con menù a tendina ("Dropdown")
    • 🔢 Campi numerici
    • 📅 Campi data
    • 🌳 Campo "Principale"
    • 🎫 Campo "Tipo ticket"
    • 🕐 Campi di tempo
    • 👥 Campi utente
  • 👥 Campo "Tempo Team"
  • ⭐ Campi cascading
  • 🔁 Campi a valori multipli

• 🔵 Da Jira Cloud
• 🟣 Da Jira Product Discovery

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 di testo 

Sono i campi che accettano testo libero, senza alcun vincolo di formato. Si dividono in due tipologie che nel CSV si compilano nello stesso modo:

• Testo breve - una sola riga (es. Riepilogo)
• Paragrafo - testo esteso su più righe (es. Descrizione, Note)

Due accortezze:

1. Per andare a capo all'interno di un paragrafo, in Excel usa ALT+INVIO: il valore resta in un'unica cella e Jira riprodurrà l'interruzione di riga.
2. Il CSV trasporta solo testo semplice: grassetto, elenchi, tabelle e link formattati non sopravvivono all'importazione. Se servono, si aggiungono dopo direttamente sul ticket.
   

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

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

🔢 Campi numerici

Campi che accettano solo un numero (es. Target Production, Actual Production).

Nella cella va inserito esclusivamente il valore numerico:

• separatore decimale: il punto → 12.5
• nessun separatore delle migliaia → 1250, non 1.250
• nessuna unità di misura e nessun simbolo → 85, non 85% né 85 h

% I campi percentuali (es. Activity Budget Share, Actual Production progress (%)) richiedono una frazione decimale.
Ad esempio, per ottenere 80% sul ticket, nel CSV va scritto 0.8. Scrivendo 80 il ticket riporterebbe 8.000%.

📅 Campi data

Tutti i campi data (es. Data di scadenza, Start date pianificato) si compilano nello stesso formato:

• dd/MM/yyyy → es. 15/09/2026

Il formato dichiarato al punto 2 dell'importazione ("Formato data") deve coincidere con quello effettivamente usato nel file.

🌳 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. 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
      ⚠️ Limite di Atlassian: questa modalità di caricamento richiede il ruolo Administrators nello spazio.
      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).

🕐 Campi di tempo

Per i campi che rappresentano un valore temporale (es. "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

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.

👥 Campo "Tempo Team"

Per l'inserimento del Tempo Team è necessario usare il formato "{"id": x}", sostituendo x  con l’ID del Team.
L’ID è visibile nell’URL della pagina del Tempo Team stesso: corrisponde al valore riportato alla fine dell’indirizzo web: 

 Ad esempio, per il Demo Team la dicitura corretta da inserire nel CSV sarà "{"id": 54}":

⭐ Campi cascading

I campi cascading (es. "Service Type") prevedono 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 inserire nel campo "Service Type" è "Rilievi -> Drone", 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):

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

🔁 Campi a valori multipli

Sono i campi che possono contenere più valori contemporaneamente. Qui la regola non riguarda il formato del valore ma la struttura del file, ed è la stessa per tutti:
Non si separano i valori con virgole o punti e virgola dentro la stessa cella. Si aggiungono più colonne con la stessa identica intestazione, una per ciascun valore: in fase di mappatura Jira le riconosce come lo stesso campo e le unisce sul ticket.

Esempi:

Esempio compilazione CSV ai seguenti link:
 - EsempioCSV_Jira 2.0