Guida al Formato Corretto

Come preparare i tuoi file CSV e Excel per Replay

Scarica file di esempio

Scarica i file di esempio per vedere esattamente il formato accettato da Replay.

Scarica CSV di esempio Scarica Excel di esempio

Regole del formato

1. Riga di intestazione obbligatoria

La prima riga del file deve contenere i nomi delle colonne. Ogni colonna deve avere un nome univoco.

ID	Nome	Email	Importo
001	Mario Rossi	mario@example.com	1500.50
002	Anna Bianchi	anna@example.com	2300.00

2. Colonna chiave con valori unici

Deve esistere una colonna con valori univoci (come un ID o codice). Questa colonna viene usata per confrontare le righe tra versioni diverse.

Corretto

ID
001
002
003

Sbagliato - Duplicati

ID
001
001
003

Sbagliato - Vuoti

ID
001
(vuoto)
003

3. Formato CSV

Per i file CSV, il delimitatore viene rilevato automaticamente (virgola, punto e virgola, tab).

ID;Nome;Email;Importo
001;Mario Rossi;mario@example.com;1500.50
002;Anna Bianchi;anna@example.com;2300.00

4. Formato Excel (.xlsx)

FormatGuide_Rule4Intro

Un solo foglio: il file deve contenere un unico foglio di lavoro

FormatGuide_Rule4_NoMerged

Tabella pulita: intestazione nella prima riga, dati nelle righe successive

Non protetto: il file non deve essere protetto da password

5. Compatibilità tra versioni

Quando carichi una nuova versione di un progetto, il file deve avere esattamente le stesse colonne (stesso nome e ordine) della versione precedente.

Se cambi il nome di una colonna, aggiungi o rimuovi colonne, Replay non potrà confrontare i dati.

Errori comuni e come risolverli

File non valido

Il file caricato non sembra essere una tabella valida. Potrebbe essere corrotto, protetto da password o in un formato non riconosciuto.

Soluzione: Assicurati che il file sia un CSV valido (separato da virgola o punto e virgola) oppure un file Excel .xlsx non protetto. Consulta la pagina "Formato corretto" per esempi.

Celle unite nel file Excel

Il file Excel contiene celle unite (merged cells). Le celle unite rendono impossibile interpretare correttamente la struttura tabellare. Seleziona tutte le celle e usa "Unisci e centra" per separarle prima di caricare il file.

Soluzione: Apri il file Excel, seleziona tutto (Ctrl+A), vai su Home → Unisci e centra (deseleziona) per separare tutte le celle unite. Poi salva e ricarica il file.

Troppi fogli nel file Excel

Il file Excel contiene più fogli di lavoro. Replay supporta solo file con un singolo foglio. Rimuovi i fogli extra o crea un nuovo file con un solo foglio contenente i tuoi dati.

Soluzione: Apri il file Excel, elimina i fogli extra e lascia solo il foglio con i dati da confrontare. In alternativa, copia i dati in un nuovo file Excel con un solo foglio.

Schema colonne non corrispondente

Le colonne del file caricato non corrispondono a quelle del progetto. Il file deve avere esattamente le stesse colonne (stesso nome e stesso ordine) della versione baseline.

Soluzione: Verifica che il file abbia le stesse colonne del progetto. Controlla che non ci siano colonne rinominate, aggiunte o rimosse.

Valori duplicati nella colonna chiave

La colonna chiave contiene valori ripetuti. Ogni valore nella colonna chiave deve essere unico per identificare univocamente ogni riga.

Soluzione: Rimuovi o correggi i valori duplicati nella colonna chiave. Se necessario, aggiungi un suffisso per rendere ogni valore unico.

Valori mancanti nella colonna chiave

La colonna chiave contiene celle vuote o senza valore. Ogni riga deve avere un valore nella colonna chiave per poter confrontare le versioni.

Soluzione: Compila tutte le celle vuote nella colonna chiave. Ogni riga deve avere un identificatore univoco.

File troppo grande

Il file supera la dimensione massima consentita di 10 MB. Prova a ridurre il numero di righe o a rimuovere colonne non necessarie.

Soluzione: Dividi il file in parti più piccole o rimuovi le colonne non necessarie per ridurre la dimensione.

Formato non supportato

Il formato del file non è supportato. Replay accetta solo file CSV (.csv) e Excel (.xlsx).

Soluzione: Salva il file in formato CSV (.csv) o Excel (.xlsx). Se hai un file .xls (vecchio formato Excel), salvalo come .xlsx.

Limiti

Parametro	Limite
Dimensione file	10 MB
Numero massimo righe	100.000
Numero massimo colonne	100
Fogli Excel	1 1 (solo un foglio)
Formati accettati	CSV (.csv), Excel (.xlsx)