Importazione di schede da CSV

L’importatore CSV trasforma un foglio di calcolo in Schede, una Scheda per ogni riga. Si trova in Schede → Importa Schede e ti guida nella scelta di un modello, nella mappatura delle colonne ai campi, nella selezione di una cartella di destinazione e nell’esecuzione dell’importazione con avanzamento in tempo reale.

Formato CSV

Prepara una riga di intestazione, una Scheda per ogni riga, e mantieni una colonna per il nome della Scheda. Il pannello Formato CSV della barra laterale suggerisce alcune colonne di esempio (Nome, Descrizione, Stato, Proprietario) e Scarica CSV di esempio fornisce un file da cui partire. Sono accettati solo file .csv («Solo file CSV») e «questo importatore presuppone che ogni riga del file CSV rappresenti una singola scheda».

Altri due suggerimenti sul formato:

• Una colonna fornisce il nome della Scheda e deve contenere un valore in ogni riga che desideri importare. Quando ne trova una, DICE suggerisce una colonna Nome/Titolo; in caso contrario, seleziona la prima colonna.
• Durante la generazione di un modello, i tipi delle colonne (testo, data, numero) vengono rilevati automaticamente dai dati, quindi mantieni coerenti i valori di ciascuna colonna.

Scegli una modalità di importazione

La sezione Modalità di importazione offre due percorsi:

• Crea un nuovo modello e importa — «Carica un CSV, genera automaticamente un modello, controllalo e poi esegui l’importazione». È la scelta migliore per una prima importazione: DICE deduce un modello dalle colonne.
• Importa in un modello esistente — «Scegli prima un modello, quindi mappa i campi e importa le schede». Disponibile quando è presente almeno un modello; Scarica esempio genera un CSV corrispondente ai campi del modello selezionato.

Importazione con un nuovo modello

1. Carica CSV — fai clic per caricare il file oppure trascinalo e rilascialo. Il file viene analizzato sul posto e viene mostrato il numero di righe («N righe pronte per la mappatura»).
2. Controlla il Generatore di modelli — viene mostrato il modello dedotto, con Nome del modello e Descrizione del modello precompilati in base al nome del file, oltre ai Campi dati rilevati.
3. In Nome e descrizione della Scheda, conferma la Colonna del nome e la Colonna della descrizione, facoltativa. Queste colonne sono elencate nei Campi dati come Nome della Scheda / Descrizione della Scheda e contrassegnate con Non creato come campo, perché ogni Scheda contiene già queste proprietà.
4. Fai clic su Crea modello. Il modello viene salvato nel tuo Team e puoi procedere con la destinazione e l’importazione («Modello creato. Continua con la destinazione e l’importazione.»).

Poiché il modello è stato generato dal CSV, la mappatura delle colonne viene applicata automaticamente («Questo modello è stato generato dal CSV caricato, quindi la mappatura dei campi viene applicata automaticamente.»). Il pannello Mappatura automatica delle colonne riepiloga le origini del nome e della descrizione; usa Torna al modello per modificarle.

Importazione in un modello esistente

1. In Seleziona modello, scegli il modello che deve ricevere le righe importate.
2. Carica CSV — «Carica un file CSV per iniziare la mappatura e l’importazione». Il pannello mostra le Righe CSV accanto ai Campi del modello selezionato.
3. Fai clic su Continua con la mappatura dei campi.

Destinazione e mappatura dei campi

Il passaggio Destinazione e mappatura dei campi consente di controllare ciò che viene creato:

• Cartella — la cartella di destinazione di ogni Scheda importata. Il selettore precompila la cartella usata più di recente; devi selezionarne una prima di eseguire l’importazione.
• Mappatura dei campi — «Mappa ogni campo del modello alla colonna CSV che deve compilarlo». Le mappature suggerite vengono applicate in base alla corrispondenza dei nomi delle colonne; i campi lasciati su Nessuna colonna semplicemente non vengono compilati. Questo passaggio viene omesso quando il modello è stato generato automaticamente dal CSV.
• Nome e descrizione della Scheda — la colonna CSV da cui ogni Scheda ricava il proprio nome (obbligatorio) e, facoltativamente, la propria descrizione. Queste sono proprietà della Scheda, quindi le colonne non vengono archiviate come dati dei campi.
• Archivia anche queste colonne come campi — opzione disattivata per impostazione predefinita. Attivala per conservare i valori del nome e della descrizione anche nei dati dei campi di ogni Scheda. Un campo mappato che viene ignorato lo indica sotto il proprio nome, anche se è Obbligatorio: il nome e la descrizione della Scheda contengono invece il valore.

Sotto la mappatura, l’Anteprima delle Schede importate mostra le prime righe così come verranno importate, un conteggio di quelle pronte («N righe pronte per l’importazione») e segnala le righe per cui l’importazione non riuscirebbe («N righe attualmente non riuscirebbero»), in genere perché manca un valore obbligatorio. Correggi il CSV o la mappatura finché le righe che ti interessano non risultano Pronte.

Ogni riga dell’anteprima si presenta come la pagina della Scheda in cui verrà trasformata: il nome, il modello, la descrizione e infine l’organizzazione, il team e la cartella a cui apparterrà. Vale la pena controllare quest’ultima riga prima dell’importazione: una cartella condivisa con te appartiene a un altro team e le Schede create al suo interno appartengono a quel team, non al tuo.

Esegui l’importazione

Fai clic su Importa N Schede. L’importazione viene eseguita in blocchi con uno Stato dell’importazione aggiornato in tempo reale («Elaborazione di X righe su Y. Blocco A di B.»), quindi viene mostrato un riepilogo: «N schede importate.» e, se applicabile, «Importazione non riuscita per N righe».

Nota

L’importazione CSV avviene riga per riga, non secondo il principio “tutto o niente”: le righe per cui l’importazione non riesce vengono indicate nel riepilogo, mentre quelle importate correttamente vengono comunque create. Se tutte le righe vengono importate correttamente, vieni indirizzato direttamente alla cartella di destinazione.

Un’importazione riuscita registra inoltre un gruppo di attività Scheda importata per ogni Scheda nel feed attività e il modello creato rimane disponibile per importazioni future.

Importazione di un pacchetto di assiemi

Separatamente dall’importazione CSV, DICE può importare un Pacchetto di importazione di assiemi, ovvero un file JSON che descrive in un’unica struttura Schede, assiemi, allegati dei componenti e relazioni. Si trova in Assiemi → Importa pacchetto di assiemi.

Nota

La disponibilità dell’importazione dei pacchetti di assiemi dipende dalla configurazione della tua organizzazione: se non compare nella navigazione, significa che non è abilitata (consulta le Domande frequenti).

1. Incolla il JSON del pacchetto oppure seleziona Carica file.
2. Fai clic su Convalida pacchetto. Il pacchetto viene sottoposto a un’esecuzione di prova per generare un Piano di importazione: il numero di Schede, Assiemi, Schede non appartenenti ad assiemi, Allegati delle Schede e Relazioni delle Schede da creare, oltre a eventuali Problemi bloccanti e Avvisi. Le cartelle, le categorie e le relazioni a cui viene fatto riferimento vengono confrontate con quelle già esistenti e contrassegnate come riutilizza elemento esistente, crea nuovo elemento oppure segnalate come ambigue.
3. Quando il piano indica «Questo pacchetto è pronto per l’importazione.», fai clic su Conferma importazione.

A differenza dell’importazione CSV, l’importazione del pacchetto di assiemi è transazionale: «non viene scritto nulla finché non confermi e l’importazione segue il principio “tutto o niente”». Risolvi tutti i problemi bloccanti prima di confermare. Consulta Assiemi per informazioni sugli assiemi e sui componenti.

Pagine correlate

SchedeModelli e campi compilati dalle importazioni.

CartelleDove vengono inserite le Schede importate.

AssiemiAssiemi, componenti e posizioni.