.XLSX - Spreadsheet Excel (Strings)

Le contenu est traduit de l’anglais par Phrase Language AI.

Extensions de fichiers	.xlsx
Extension d'API	xlsx
Import	oui
Export	oui
Prise en charge des formes plurielles	oui
Prise en charge de la description	oui
Options de format	key_name_column comment_column tag_column first_content_row enable_pluralization export_tags export_max_characters_allowed custom_metadata_columns translation_columns

.XLSX est un format de fichier largement utilisé pour la localisation. Bien que la mise en page d'un fichier .XLSX puisse différer en fonction des paramètres spécifiques, elle suit généralement la convention d'une colonne par langue. Pour traduire .XLSX, fournissez au moins la colonne du nom de la clé et une colonne de traduction. Par défaut, le contenu est supposé commencer à la première ligne. Avec les clés et la traduction, des méta-informations comme des commentaires, des tags et le nombre maximum de caractères autorisés pour les traductions peuvent être importés.

Si un fichier est téléchargé avec plusieurs feuilles ou onglets, seule la première feuille sera détectée. Enregistrez les feuilles ou onglets dans des fichiers individuels si le contenu est requis pour la localisation

Le paramètre paramètres_régionaux (de type hashmap) est requis pour spécifier quelle colonne dans le document correspond à chaque paramètre régional. Pour des exemples, voir l'exemple de fichier de configuration et la documentation_API pour les uploads.

Options de format

Identifiant	key_name_column
Type	chaîne
Chargement	oui
Téléchargement	non
Par défaut	[vide]
Description	Colonne contenant le nom/identification de la clé.

Identifiant	comment_column
Type	chaîne
Chargement	oui
Téléchargement	non
Par défaut	[vide]
Description	Colonne contenant le commentaire/la description pour une clé.

Identifiant	tag_column
Type	chaîne
Chargement	oui
Téléchargement	non
Par défaut	[vide]
Description	Index de la colonne contenant un tag pour la clé.

Identifiant	first_content_row
Type	entier
Chargement	oui
Téléchargement	non
Par défaut	1
Description	Index de la première ligne contenant le contenu de traduction.

Identifiant	enable_pluralization
Type	booléen
Chargement	oui
Téléchargement	non
Par défaut	vrai
Description	active la détection des clés pluralisées. Toutes les clés correspondantes persisteront sous forme de clés pluralisées.

Identifiant	export_tags
Type	booléen
Charger	non
Télécharger	Oui
Par défaut	false
Description	Exporte des tags avec les clés et les traductions.

Identifiant	export_max_characters_allowed
Type	booléen
Charger	non
Télécharger	Oui
Par défaut	false
Description	Exporte la limite de caractères de la clé avec les clés et les traductions.

Identifiant	custom_metadata_columns
Type	hash
Chargement	oui
Téléchargement	Oui
Par défaut	[vide]
Description	Un hashmap de valeurs métadonnées_personnalisées qui doivent être importées ou exportées: Clé = Nom de la propriété de métadonnées personnalisées, tel que défini dans Phrase Strings. Valeur = Identifiant de colonne (A, B, C, etc.) où la propriété se trouve dans le fichier importé/où la propriété devrait se trouver dans le fichier exporté.

Identifiant	translation_columns
Type	hash
Chargement	oui
Téléchargement	Oui
Par défaut	[vide]
Description	Identifiant/Nom de langue = Colonne de la propriété de métadonnées personnalisées, tel que défini dans Phrase Strings. Valeur = Identifiant de colonne (A, B, C, etc.) où la propriété se trouve dans le fichier importé/où la propriété devrait se trouver dans le fichier exporté.

Exemple de structure

key_name	en_US	de-DE*	commentaire*	tags*	max_characters*
app_title	Mon Projet	Mein Projekt	Ceci est le titre principal	app, titre	30
salutation	Salut 'Utilisateur' !	Hallo 'Utilisateur' !	Soyez poli

*colonnes optionnelles

Le fichier tableur a besoin d'au moins la colonne clé et une langue pour être téléchargé. En plus des langues supplémentaires, les colonnes suivantes peuvent être ajoutées pour ajouter des informations méta :

commentaire : pour ajouter une description à la clé
tags : pour ajouter des tags aux clés individuelles dans le fichier
max_characters : pour définir une limite de caractères pour une clé lors du chargement

Exemple de configuration

Un exemple pour la section push dans un .phraseapp.yml pour les fichiers XLSX.

push:
    sources:
        - fichier : "./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 : o