.JSON - Phrase Strings

El contenido se traduce automáticamente del inglés por Phrase Language AI.

Extensiones de archivo	.json
Extensión API	strings_json
Importación	Sí
Exportación	Sí
Compatibilidad con formularios plurales	Sí
Compatibilidad con descripción	Sí
Soporte de estado	Sí
Soporte de metadatos	Sí
Opciones de formato	ignore_translation_state export_translation_state export_description export_tags export_system_tags export_max_characters_allowed custom_metadata_columns export_use_ordinal_rules

El formato JSON de Phrase Strings proporciona una forma estructurada de almacenar y gestionar traducciones, incorporando metadatos, seguimiento de estado e integración de flujo de trabajo para una funcionalidad mejorada.

Este formato incluye metadatos como detalles de localización, límites de carácter, descripciones, tipo de forma plural y estados de traducción. La función de soporte de estado permite un mejor seguimiento del progreso de la traducción y la integración con flujos de trabajo automatizados.

Definiciones de campo

Objeto clave

El objeto clave contiene metadatos y configuración para cada clave de traducción.

Campo	Requerido	Tipo	Descripción
`nombre`	Sí	Cadena	Identificador único para la clave.
`description`	No	Cadena	Una breve explicación del propósito de la clave.
`plural`	No	Booleano	Especifica si la clave admite pluralización.
`use_ordinal_rules`	No	Booleano	Indica si las formas plurales de la clave son ordinales. El valor predeterminado es `false` si se omite. Se utiliza durante la importación y exportación.
`max_characters_allowed`	No	Entero/Nulo	Número máximo de caracteres permitido. `null` significa sin límite.
`tags`	No	Formación	Etiquetas de categorización para filtrado y organización.
`metadatos`	No	Objeto	Almacena metadatos adicionales como pares clave-valor. Se puede agregar o actualizar, pero no eliminar. Para eliminar metadatos, establece su valor en una cadena vacía.

Objeto de traducciones

El objeto de traducciones contiene traducciones localizadas para una clave dada.

Campo	Requerido	Tipo	Descripción
`localización`	Sí	Cadena	El nombre o identificador de la localización tal como está configurado en proyecto/idiomas. Este valor determina la coincidencia durante la importación. Si no hay una concordancia exacta con un nombre de idioma existente, la traducción no se importará.
`locale_code`	No	Cadena	El código de idioma de la localización (p. ej., en-US, fr-FR).
`contenido`	Sí	Cadena/Objeto	El contenido traducido. Si está pluralizado, un objeto que asigna formas plurales según la configuración de `use_ordinal_rules` de la clave.
`estado`	No	Cadena	El estado de la traducción. Estados de traducción admitidos: no traducido sin verificar traducido revisado

Opciones de formato

Identificador	ignore_translation_state
Tipo	Booleano
Carga	Sí
Descarga	No
Por defecto	false
Descripción	Si es verdadero, ignora los valores de estado en las traducciones importadas, lo que significa que el archivo cargado no sobrescribirá los estados de traducción existentes.

Identificador	export_translation_state
Tipo	Booleano
Carga	No
Descarga	Sí
Por defecto	true
Descripción	Incluye valores de estado en las traducciones exportadas; si se establece en falso, la información de estado se omitirá del archivo exportado.

Identificador	export_system_tags
Tipo	Booleano
Carga	No
Descarga	Sí
Por defecto	false
Descripción	Si es verdadero, exporta etiquetas del sistema junto con las claves y traducciones.

Identificador	export_tags
Tipo	Booleano
Carga	No
Descarga	Sí
Por defecto	false
Descripción	Si es verdadero, exporta etiquetas junto con claves y traducciones.

Identificador	export_description
Tipo	Booleano
Carga	No
Descarga	Sí
Por defecto	true
Descripción	Exporta la descripción de la clave.

Identificador	export_max_characters_allowed
Tipo	Booleano
Carga	No
Descarga	Sí
Por defecto	true
Descripción	Exporta el límite de carácter de la clave junto con las claves y traducciones.

Identificador	custom_metadata_columns
Tipo	hash
Carga	No
Descarga	Sí
Por defecto	[vacío]
Descripción	HashMap de valores de metadatos personalizados que necesitan ser importados o exportados: Clave = Nombre de la propiedad de metadatos personalizados, como se define en Phrase Strings. Valor = Índice de columna (1, 2, 3, etc.) donde la propiedad está en el archivo importado/donde la propiedad debería estar en el archivo exportado.

Identificador	export_use_ordinal_rules
Tipo	Booleano
Carga	No
Descarga	Sí
Por defecto	false
Descripción	Si es verdadero, el campo `use_ordinal_rules` se muestra en el archivo descargado. Si descarga archivos a través de la IU, usar la opción correspondiente Agregar tipo plural para cada clave.

Ejemplo de código

{
  "welcome_message": {
    "key": {
      "description": "Mensaje mostrado en la pantalla de bienvenida",
      "plural": false,
      "max_characters_allowed": 100,
      "tags": ["UI", "greeting"],
      "metadata": {
        "created_by": "admin",
        "created_at": "2024-06-20T12:34:56Z"
      }
    },
    "translations": [
      {
        "locale": "Inglés (Estados Unidos)",
        "locale_code": "en-US",
        "content": "¡Bienvenido a nuestra aplicación!",
        "state": "reviewed"
      },
      {
        "locale": "French (France)",
        "locale_code": "fr-FR",
        "content": "¡Bienvenido a nuestra aplicación!"
        "state": "translated"
      }
    ]
  }
}

Formularios plurales

Este formato utiliza categorías nombradas para identificar las diferentes pluralizaciones de una clave. Las siguientes categorías están reservadas para las formas plurales:

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

Nombres de ejemplo para claves pluralizadas correctamente identificadas, persistentes y marcadas:

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

El uso de la forma plural se configura a través del campo use_ordinal_rules. Si use_ordinal_rules es falso o no está establecido, se aplicarán las reglas de pluralización cardinal.

Ejemplo de entrada

{
  "rank": {
    "use_ordinal_rules": true,
    "values": {
      "one": "1.er puesto",
      "two": "2.º puesto",
      "few": "3.er puesto",
      "other": "%d.º puesto"
    }
  }