.XLSX - Spreadsheet Excel (Strings)

Contenuti tradotti automaticamente dall'inglese con Phrase Language AI.

Estensioni dei file	.xlsx
Estensione API	xlsx
Importa	Sì
Esporta	Sì
Supporto forme plurali	Sì
Supporto descrizione	Sì
Opzioni di formato	key_name_column comment_column tag_column first_content_row enable_pluralization export_tags export_max_characters_allowed custom_metadata_columns translation_columns

.XLSX è un formato di file ampiamente utilizzato per la localizzazione. Sebbene il layout di un file .XLSX possa differire in base a impostazioni specifiche, generalmente segue la convenzione di una colonna per lingua. Per tradurre .XLSX, fornire almeno la colonna del nome della chiave e una colonna di traduzione. Per impostazione predefinita, si presume che il contenuto inizi nella prima riga. Insieme alle chiavi e alla traduzione, possono essere importate informazioni meta come commenti, tag e il numero massimo di caratteri consentiti per le traduzioni.

Se un file viene caricato con più fogli o schede, solo il primo foglio verrà rilevato. Salva fogli o schede in file individuali se il contenuto è necessario per la localizzazione

Il parametro locale_mapping (di tipo hashmap) è necessario per specificare quale colonna nel documento corrisponde a ciascuna impostazione locale. Per esempi, vedere l'esempio del file di configurazione e la documentazione API per gli upload.

Opzioni di formato

Identificatore	key_name_column
Tipo	stringa
Caricamento	Sì
Download	No
Predefinito	[vuoto]
Descrizione	Colonna che contiene il nome/identificazione della chiave.

Identificatore	comment_column
Tipo	stringa
Caricamento	Sì
Download	No
Predefinito	[vuoto]
Descrizione	Colonna che contiene commento/descrizione per una chiave.

Identificatore	tag_column
Tipo	stringa
Caricamento	Sì
Download	No
Predefinito	[vuoto]
Descrizione	Indice della colonna contenente un tag per la chiave.

Identificatore	first_content_row
Tipo	intero
Caricamento	Sì
Download	No
Predefinito	1
Descrizione	Indice della prima riga per contenere il contenuto della traduzione.

Identificatore	enable_pluralization
Tipo	booleano
Caricamento	Sì
Download	No
Predefinito	vero
Descrizione	Abilita il rilevamento di chiavi pluralizzate. Tutte le chiavi corrispondenti verranno mantenute come chiavi pluralizzate.

Identificatore	export_tags
Tipo	booleano
Caricamento	No
Download	Sì
Predefinito	false
Descrizione	Esporta tag insieme a chiavi e traduzioni.

Identificatore	export_max_characters_allowed
Tipo	booleano
Caricamento	No
Download	Sì
Predefinito	false
Descrizione	Esporta il limite di caratteri della chiave insieme a chiavi e traduzioni.

Identificatore	custom_metadata_columns
Tipo	hash
Caricamento	Sì
Download	Sì
Predefinito	[vuoto]
Descrizione	Una hashmap di metadati personalizzati valori che devono essere importati o esportati: Chiave = Nome della proprietà di metadati personalizzati, come definito in Phrase Strings. Valore = Identificatore della colonna (A, B, C, ecc.) dove la proprietà si trova nel file importato/dove la proprietà dovrebbe trovarsi nel file esportato.

Identificatore	translation_columns
Tipo	hash
Caricamento	Sì
Download	Sì
Predefinito	[vuoto]
Descrizione	ID/Nome della lingua = Colonna della proprietà di metadati personalizzati, come definito in Phrase Strings. Valore = Identificatore della colonna (A, B, C, ecc.) dove la proprietà si trova nel file importato/dove la proprietà dovrebbe trovarsi nel file esportato.

Esempio di struttura

key_name	en_US	de-DE*	commento*	tags*	max_characters*
app_title	Il mio progetto	Il mio progetto	Questo è il titolo principale	app, titolo	30
saluto	Ciao 'Utente'!	Hallo 'Utente'!	Essere educati

*colonne opzionali

Il file del foglio di calcolo ha bisogno almeno della colonna chiave e di una lingua per essere caricato. Oltre alle lingue aggiuntive, è possibile aggiungere le seguenti colonne per aggiungere informazioni meta:

commento: per aggiungere una descrizione alla chiave
tag: per aggiungere tag a singole chiavi nel file
max_characters: per impostare un limite di caratteri per una chiave tramite il caricamento

Esempio di configurazione

Un esempio per la sezione push in un .phraseapp.yml per file XLSX.

push:
    sources:
        - file: "./it.xlsx"
          params:
              file_format: xlsx
              update_translations: true
              format_options:
                  key_name_column: A
                  comment_column: C
                  first_content_row: 2
                  tag_column: D
              locale_mapping:
                  it: B