.XLSX - Foglio di calcolo 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 Queste opzioni possono essere specificate quando un file viene caricato e/o Scarica. A seconda del metodo di caricare/Scarica (API, CLI, sincronizzazione Repo ecc.), possono essere specificate nei parametri di query `caricare`, `Scarica` o nel file di configurazione `phrase.yml`.	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 le impostazioni locali. Sebbene il layout di un file .XLSX possa differire in base a specifiche impostazioni, 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, è possibile importare meta-informazioni come commentare, tag e il massimo carattere consentito per le traduzioni.

Se un file viene caricato con più fogli o schede, verrà rilevato solo il primo foglio. Salvare i fogli o le schede in file separati se il contenuto è richiesto per le impostazioni locali

Il parametro locale_mapping (di tipo hashmap) è richiesto per specificare quale colonna nel documento corrisponde a ciascuna impostazioni locali. Per esempi, vedere l'esempio del file di configurazione e la documentazione API per i caricamenti.

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 commentare/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	integer
Caricamento	Sì
Download	No
Predefinito	1
Descrizione	Indice della prima riga che contiene contenuto di 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 carattere della chiave insieme a chiavi e traduzioni.

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

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

Esempio di struttura

key_name	en_US	de-DE*	commentare*	Tag*	max_characters*
app_title	Il mio Progetto	Mein Projekt	Questo è il titolo principale	app, titolo	30
saluto	Ciao 'utente'!	Hallo 'User'!	Sii educato

*colonne facoltative

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

commentare: per aggiungere una descrizione alla chiave
tag: per aggiungere tag alle singole chiavi nel file
max_characters: per impostare un limite di carattere 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: \"./en.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:
                  en: B