.JSON - Phrase Strings

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

Extensions de fichier	.json
Extension d'API	strings_json
Importer	oui
Export	oui
Prise en charge des formes plurielles	oui
Prise en charge de la description	oui
Prise en charge de l'état	oui
Prise en charge des métadonnées	oui
Options de format	ignore_translation_state export_translation_state export_description export_tags export_system_tags export_max_characters_allowed custom_metadata_columns export_use_ordinal_rules

Le format JSON de Phrase Strings fournit un moyen structuré de stocker et de gérer les traductions, en intégrant des métadonnées, le suivi de l'état et l'intégration au flux de travaux pour une fonctionnalité améliorée.

Ce format inclut des métadonnées telles que les détails de localisation, les limites de caractères, les descriptions, le type de forme plurielle et les états de traduction. La fonctionnalité de prise en charge de l'état permet un meilleur suivi de la progression de la traduction et une intégration avec des flux de travail automatisés.

Définitions des champs

Objet clé

L'objet clé contient des métadonnées et des paramètres pour chaque clé de traduction.

Champ	Obligatoire	Type	Description
`nom`	oui	Chaîne	Identifiant unique pour la clé.
`description`	non	Chaîne	Une brève explication de l'objectif de la clé.
`pluriel`	non	Booléen	Indique si la clé prend en charge la mise au pluriel.
`use_ordinal_rules`	non	Booléen	Indique si les formes plurielles de la clé sont ordinales. La valeur par défaut est `false` si elle est omise. Utilisé lors de l'importation et de l'exportation.
`max_characters_allowed`	non	Entier/Null	Nombre maximal de caractères autorisés. `null` signifie aucune limite.
`tags`	non	Tableau	Catégorisation tags pour le filtrage et l'organisation.
`metadata`	non	Objet	Stocke des métadonnées supplémentaires sous forme de paires clé-valeur. Il peut être ajouté ou mis à jour mais pas retiré. Pour retirer des métadonnées, définissez sa valeur sur une chaîne vide.

Objet de traductions

L'objet de traductions contient des traductions localisées pour une clé donnée.

Champ	Obligatoire	Type	Description
`paramètre linguistique`	oui	Chaîne	Le nom ou l'identifiant du locale tel que configuré dans Projet/Langues. Cette valeur détermine la correspondance lors de l'importation. S'il ne correspond pas exactement à un nom de langue existant, la traduction ne sera pas importée.
`locale_code`	non	Chaîne	Le code de langue du locale (par ex., en-US, fr-FR).
`contenu`	oui	Chaîne/Objet	Le contenu traduit. S'il est au pluriel, un objet mappant les formes plurielles basées sur le paramètre `use_ordinal_rules` de la clé.
`état`	non	Chaîne	L'état de la traduction. États de traduction pris en charge : non traduit non vérifié traduit révisé

Options de format

Identifiant	ignore_translation_state
Type	booléen
Chargement	oui
Téléchargement	non
Par défaut	false
Description	Si vrai, ignore les valeurs d'état dans les traductions importées, ce qui signifie que le fichier téléchargé ne remplacera pas les états de traduction existants.

Identifiant	export_translation_state
Type	booléen
Charger	non
Télécharger	Oui
Par défaut	vrai
Description	Inclut les valeurs d'état dans les traductions exportées ; si défini sur faux, les informations d'état seront omises du fichier exporté.

Identifiant	export_system_tags
Type	booléen
Charger	non
Télécharger	Oui
Par défaut	false
Description	Si vrai, exporte les tags système avec les clés et les traductions.

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

Identifiant	export_description
Type	booléen
Charger	non
Télécharger	Oui
Par défaut	vrai
Description	Exporte la description de la clé.

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

Identifiant	custom_metadata_columns
Type	hash
Chargement	non
Télécharger	Oui
Par défaut	[vide]
Description	HashMap de valeurs de 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 = Index de colonne (1, 2, 3, etc.) où se trouve la propriété dans le fichier importé/où la propriété doit se trouver dans le fichier exporté.

Identifiant	export_use_ordinal_rules
Type	booléen
Charger	non
Télécharger	Oui
Par défaut	false
Description	Si vrai, le champ `use_ordinal_rules` est affiché dans le fichier téléchargé. Si vous téléchargez des fichiers via l'interface utilisateur, utilisez l'option correspondante Ajouter le type pluriel pour chaque clé.

Exemple de code

{
  "welcome_message": {
    "key": {
      "description": "Message affiché sur l'écran d'accueil",
      "plural": false,
      "max_characters_allowed": 100,
      "tags": ["UI", "greeting"],
      "metadata": {
        "created_by": "admin",
        "created_at": "2024-06-20T12:34:56Z"
      }
    },
    "translations": [
      {
        "locale": "Anglais (États-Unis)",
        "locale_code": "en-US",
        "contenu": "Bienvenue dans notre application !"
        "state": "reviewed"
      },
      {
        "locale": "Français (France)",
        "locale_code": "fr-FR",
        "content": "Bienvenue dans notre application !",
        "state": "translated"
      }
    ]
  }
}

Formes plurielles

Ce format utilise des catégories nommées pour identifier les différentes pluralisations d'une clé. Les catégories suivantes sont réservées aux formes plurielles :

.zéro | .un | .deux | .quelques | .beaucoup | .autre

Exemples de noms de clés pluralisées correctement identifiées, persistantes et marquées :

inbox.messages.notification.one
inbox.messages.notification.other

L'utilisation de la forme plurielle est configurée via le champ use_ordinal_rules. Si use_ordinal_rules est faux ou non défini, les règles de pluralisation cardinales s'appliqueront.

Exemple d'entrée

{
  "rank": {
    "use_ordinal_rules": true,
    "values": {
      "one": "1re place",
      "two": "2e place",
      "few": "3e place",
      "other": "%dᵉ place"
    }
  }