--- title: "File e formati" description: "Scopri tutti i formati di file supportati da AI Glot, i limiti di dimensione per ciascuno, quali elementi strutturali vengono preservati nella traduzione e come preparare un export pronto per essere reimportato." canonical: "https://ai-glot.com/docs/it/platform/files-and-formats" updated: "2026-08-31" --- # File e formati AI Glot supporta dodici famiglie di formati. Qualunque sia il file caricato, la promessa non cambia: i testi cambiano, la struttura resta invariata, così che il file possa essere reinserito esattamente da dove proviene. ## Cosa puoi caricare I limiti di dimensione si applicano **per singolo formato**, non globalmente. Un limite adatto a un foglio di calcolo risulterebbe eccessivamente permissivo per un file di localizzazione, dove anche pochi megabyte rappresentano già un catalogo enorme. | Formato | Estensioni | Limite | | --------------- | ---------------- | -----: | | CSV | `.csv` | 60 MB | | Excel | `.xlsx` | 50 MB | | Archivio | `.zip` | 20 MB | | XLIFF | `.xlf`, `.xliff` | 12 MB | | Risorse Android | `.xml` | 12 MB | | Risorse .NET | `.resx` | 12 MB | | JSON | `.json`, `.arb` | 8 MB | | YAML | `.yaml`, `.yml` | 4 MB | | gettext | `.po`, `.pot` | 4 MB | | iOS strings | `.strings` | 4 MB | | Proprietà Java | `.properties` | 4 MB | | Sottotitoli | `.srt` | 4 MB | Un file che supera il limite viene rifiutato prima che venga salvato anche un solo byte: caricare un file troppo grande non costa nulla, se non il tempo di accorgersene. > **Info: L'estensione determina il parser** > > Byte identici denominati `strings.xml` o `export.csv` vengono elaborati da parser differenti. `.xml` gestisce sia i file `strings.xml` di Android sia i payload in stile .NET. Il rilevamento dei contenuti stabilisce quale utilizzare ed entrambi condividono il limite di 12 MB. `.arb` è il formato JSON di Flutter e viene gestito come JSON. ## Cosa viene preservato nel ciclo di elaborazione La struttura non è un dettaglio secondario: è ciò che rende fruibile il risultato finale. Ogni famiglia di formati prevede regole precise su cosa debba rimanere inalterato. | Famiglia | Elementi preservati fedelmente | | ------------------------ | --------------------------------------------------------------------------------------------------------- | | CSV, Excel | Ordine delle colonne, identificatori, prezzi, URL, righe vuote, spazi bianchi | | JSON, YAML | Ogni chiave, livello di nidificazione, ordine degli array, rientro (indentazione) e variabile interpolata | | XLIFF | Unità di localizzazione, segnaposto (placeholder) e markup inline | | gettext | ID messaggio, contesti e forme plurali | | Android, iOS, .NET, Java | Chiavi di risorsa e relativi specificatori di formato | | Sottotitoli | Numerazione delle battute e timecode | | Archivio | Struttura delle cartelle e ogni nome file al suo interno | Le chiavi costituiscono la struttura, non il testo. Un file JSON tradotto può essere reintrodotto direttamente nel repository perché nulla al di fuori dei valori è stato modificato. ## Limite di caratteri per cella Ogni singolo valore sorgente selezionato per la traduzione può contenere fino a **50.000 caratteri Unicode**. Suddividi i contenuti HTML o redazionali più lunghi in più righe o campi più piccoli prima del caricamento. Poiché un valore tradotto è spesso più lungo del testo di partenza, AI Glot riserva un margine di archiviazione superiore al limite di input per il file finale. ![Area di caricamento](/docs/screenshots/platform/translation-upload-empty.webp) _Inizia con il trascinamento o la selezione del file_ ## Preparare l'esportazione di un foglio di calcolo CSV ed Excel sono i due formati solitamente creati a mano, nonché quelli in cui un'esportazione poco accurata rischia di creare i maggiori problemi in seguito. 1. **Mantieni identificatori stabili** Includi la chiave utilizzata dal sistema di destinazione per abbinare le righe (ad esempio un ID prodotto o un ID record) ed escludila dalla richiesta di traduzione. 2. **Assegna nomi univoci alle colonne** Sostituisci le intestazioni vuote o duplicate prima del caricamento. Gestire `description_en` e `description_fr` è molto più semplice rispetto ad avere due colonne chiamate entrambe `description`. 3. **Esporta il CSV in formato UTF-8** Seleziona l'opzione CSV UTF-8 nel tuo software per fogli di calcolo. Rinominare l'estensione di un file non ne converte i contenuti; tuttavia, non è più necessario effettuare conversioni poiché i file `.xlsx` sono supportati direttamente. 4. **Conserva una copia dell'originale** La struttura viene preservata, ma il file di esportazione originale resta il punto di ripristino più sicuro qualora il sistema di destinazione dovesse rifiutare l'importazione per vincoli specifici propri. ## Specifiche per i file CSV | Requisito | Comportamento supportato | | ------------------------- | -------------------------------------------------------------------------------------------- | | Codifica | UTF-8 rigoroso | | Delimitatore | Virgola o punto e virgola, rilevati automaticamente | | Terminatori di riga | LF, CRLF o CR | | Utilizzo delle virgolette | RFC 4180, inclusi virgole e ritorni a capo all'interno dei campi | | Intestazioni | Ogni colonna deve avere un'intestazione univoca e non vuota | | Righe | Almeno una riga di dati; ogni riga deve corrispondere al numero di colonne dell'intestazione | ## File rifiutati Il browser applica le stesse regole strutturali del motore di traduzione prima ancora che inizi l'upload; in questo modo, un file non conforme viene segnalato all'istante anziché dopo diversi minuti. Vengono rifiutati i file vuoti, con codifica UTF-8 non valida, con virgolette non chiuse o senza escape, con intestazioni vuote o duplicate, privi di righe di dati, con un numero di colonne non corrispondente, con estensione non supportata o che superano il limite dimensionale del formato. Tramite API, questi stessi rifiuti vengono restituiti con i codici di errore [`unsupported_format`](/docs/api/errors#unsupported_format) e [`file_too_large`](/docs/api/errors#file_too_large).