.JSON - Phrase Strings

Contenuti tradotti automaticamente dall'inglese con Phrase Language AI.

Estensioni dei file	.json
Estensione API	strings_json
Importa	Sì
Esporta	Sì
Supporto forme plurali	Sì
Supporto descrizione	Sì
Supporto stato	Sì
Supporto metadati	Sì
Opzioni di formato	ignore_translation_state export_translation_state export_description export_tags esportare_tag_sistema export_max_characters_allowed custom_metadata_columns export_use_ordinal_rules

Il formato JSON di Phrase Strings fornisce un modo strutturato per archiviare e gestire le traduzioni, incorporando metadati, tracciamento dello stato e integrazione del flusso di lavoro per una funzionalità migliorata.

Questo formato include metadati come dettagli di localizzazione, limiti di carattere, descrizioni, tipo di forma plurale e stati di traduzione. La funzionalità di supporto dello stato consente un migliore tracciamento dell'avanzamento della traduzione e l'integrazione con flussi di lavoro automatizzati.

Definizioni dei campi

Oggetto chiave

L'oggetto chiave contiene metadati e impostazioni per ogni chiave di traduzione.

Campo	Richiesto	Tipo	Descrizione
`name`	Sì	Stringa	Identificatore univoco per la chiave.
`description`	No	Stringa	Una breve spiegazione dello scopo della chiave.
`plural`	No	Booleano	Specifica se la chiave supporta la pluralizzazione.
`use_ordinal_rules`	No	Booleano	Indica se le forme plurali della chiave sono ordinali. Predefinito su `false` se omesso. Utilizzato durante l'importare e l'esportare.
`max_characters_allowed`	No	Intero/Null	Numero massimo di caratteri consentito. `null` significa nessun limite.
`tags`	No	Array	Categorizzazione tag per il filtraggio e l'organizzazione.
`metadata`	No	Oggetto	Memorizza metadati aggiuntivi come coppie chiave-valore. Può essere aggiunto o aggiornato ma non rimosso. Per rimuovere i metadati, impostare il relativo valore su una stringa vuoto.

Oggetto Traduzioni

L'oggetto delle traduzioni contiene traduzioni localizzate per una data chiave.

Campo	Richiesto	Tipo	Descrizione
`impostazioni locali`	Sì	Stringa	Il nome o l'identificatore delle impostazioni locali come configurato in Progetto/Lingue. Questo valore determina la corrispondenza durante l'importare. Se non presenta una corrispondenza esatta con un nome di lingua esistente, la traduzione non verrà importata.
`locale_code`	No	Stringa	Il codice della lingua delle impostazioni locali (ad es. en-US, fr-FR).
`contenuto`	Sì	Stringa/Oggetto	Il contenuto tradotto. Se pluralizzato, un oggetto che mappa le forme plurali in base all'impostazione `use_ordinal_rules` della chiave.
`stato`	No	Stringa	Lo stato della traduzione. Stati di traduzione supportati: non tradotto non verificato tradotto revisionato

Opzioni di formato

Identificatore	ignore_translation_state
Tipo	booleano
Caricamento	Sì
Download	No
Predefinito	false
Descrizione	Se true, ignora i valori di stato nelle traduzioni importate, il che significa che il file caricato non sovrascriverà gli stati di traduzione esistenti.

Identificatore	export_translation_state
Tipo	booleano
Caricamento	No
Download	Sì
Predefinito	vero
Descrizione	Include i valori di stato nelle traduzioni esportate; se impostato su false, le informazioni sullo stato verranno omesse dal file esportato.

Identificatore	esportare_tag_sistema
Tipo	booleano
Caricamento	No
Download	Sì
Predefinito	false
Descrizione	Se true, esporta i tag di sistema insieme alle chiavi e alle traduzioni.

Identificatore	export_tags
Tipo	booleano
Caricamento	No
Download	Sì
Predefinito	false
Descrizione	Se true, esporta i tag insieme alle chiavi e alle traduzioni.

Identificatore	export_description
Tipo	booleano
Caricamento	No
Download	Sì
Predefinito	vero
Descrizione	Esporta la descrizione della chiave.

Identificatore	export_max_characters_allowed
Tipo	booleano
Caricamento	No
Download	Sì
Predefinito	vero
Descrizione	Esporta il limite di carattere della chiave insieme alle chiavi e alle traduzioni.

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

Identificatore	export_use_ordinal_rules
Tipo	booleano
Caricamento	No
Download	Sì
Predefinito	false
Descrizione	Se true, il campo `use_ordinal_rules` viene visualizzato nel file scaricato. Se si scaricano file tramite l'interfaccia utente, usare l'opzione corrispondente Aggiungere il tipo plurale per ogni chiave.

Campione di codice

{
  "welcome_message": {
    "key": {
      "description": "Messaggio visualizzato nella schermata di benvenuto",
      "plural": false,
      "max_characters_allowed": 100,
      "tags": ["UI", "greeting"],
      "metadata": {
        "created_by": "admin",
        "created_at": "2024-06-20T12:34:56Z"
      }
    },
    "translations": [
      {
        "locale": "Inglese (Stati Uniti)",
        "locale_code": "en-US",
        "content": "Benvenuto nella nostra applicazione!",
        "state": "reviewed"
      },
      {
        "locale": "Francese (Francia)",
        "locale_code": "fr-FR",
        "content": "Bienvenue dans notre application !",
        "state": "translated"
      }
    ]
  }
}

Forme plurali

Questo formato utilizza categorie denominate per identificare le diverse pluralizzazioni di una chiave. Le categorie seguenti sono riservate alle forme plurali:

.zero | .one | .two | .few | .many | .other

Esempi di nomi per chiavi pluralizzate correttamente identificate, persistenti e contrassegnate:

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

L'uso della forma plurale è configurato tramite il campo usare_regole_ordinali. Se usare_regole_ordinali è falso o non impostato, verranno applicate le regole di pluralizzazione cardinale.

Esempio di input

{
  "rank": {
    "use_ordinal_rules": true,
    "values": {
      "one": "1° posto",
      "two": "2° posto",
      "few": "3° posto",
      "other": "%d° posto"
    }
  }