Traducciones de la interfaz

Las traducciones de la interfaz te permiten administrar textos reutilizables de la interfaz, como botones, etiquetas y mensajes, desde el Studio.

Cada traducción de la interfaz usa una clave estable, como button.save o nav.home, y guarda un valor por configuración regional.

Abrir las traducciones de la interfaz

Para trabajar con las traducciones de la interfaz:

Abre tu proyecto en el Studio.
Ve a Localización → Traducciones de la interfaz.
Elige la configuración regional que quieres editar en el selector de configuración regional del proyecto.

La página lista las claves de traducción en una tabla y te permite editar una configuración regional a la vez.

Cuando editas una configuración regional que no es la predeterminada, la tabla también muestra el valor de la predeterminada como referencia.

Puedes buscar por clave o por valor traducido.

Editar valores

Para actualizar valores:

Abre Localización → Traducciones de la interfaz.
Selecciona la configuración regional que quieres editar.
Actualiza los valores en la tabla.
Haz clic en Guardar cambios o usa Ctrl/Cmd + S.

Si necesitas deshacer ediciones sin guardar, haz clic en Descartar para restaurar los últimos valores guardados de la configuración regional actual.

Agregar y eliminar claves

Usa Agregar clave cuando necesites un identificador reutilizable nuevo para un texto de la interfaz.

Las claves deben:

empezar con una letra o un número
usar solo letras, números, puntos y guiones bajos
permanecer estables para que tu frontend pueda seguir referenciándolas

Ejemplos:

button.save
nav.home
checkout_error

Eliminar una clave quita esa clave y todos sus valores localizados en cada configuración regional del entorno actual.

Copiar valores de otra configuración regional

Usa Herramientas → Copiar valores de otro idioma para copiar los valores guardados de una configuración regional a la actual, para todas las claves de traducción de la interfaz de este entorno.

Esto sirve cuando:

una configuración regional nueva debe empezar a partir de una traducción existente
quieres duplicar una configuración regional anterior antes de afinar el texto

Exportar CSV

Usa Herramientas → Exportar CSV para descargar todas las claves del entorno actual.

Puedes exportar de dos formas:

Solo la configuración regional actual: crea un archivo de dos columnas con key y el ID de API de la configuración regional actual
Todos los idiomas en un archivo: crea una columna key más una columna por configuración regional

Al exportar todas las configuraciones regionales, la predeterminada aparece primero y el resto se ordena por ID de API de la configuración regional.

Importar CSV

Usa Herramientas → Importar CSV para actualizar muchas claves a la vez.

El diálogo de importación admite dos formatos.

Con una fila de encabezado

Usa key como encabezado de la primera columna. Cada encabezado de columna adicional debe coincidir con un ID de API de configuración regional del entorno actual.

key,en,fr
button.save,Save,Enregistrer
nav.home,Home,Accueil

Si el archivo incluye encabezados de configuración regional desconocidos, el Studio te avisa y te permite continuar importando solo las columnas de configuraciones regionales que coinciden.

Sin fila de encabezado

Cuando La primera fila es el encabezado está desactivado, cada fila debe contener dos columnas:

la clave
el valor de la configuración regional actual

button.save,Save
nav.home,Home

Opciones de importación

El diálogo de importación también incluye estas opciones:

Agregar claves faltantes: crea claves que todavía no existen
Quitar claves que no están en el archivo: elimina las claves que faltan en el archivo subido

Si la misma clave aparece más de una vez en el CSV, gana la última fila.

Después de una importación correcta, la página muestra un resumen de cuántas claves se agregaron, actualizaron o quitaron.

Permisos

Las traducciones de la interfaz usan permisos separados para ver, crear, editar y eliminar claves.

En los roles integrados:

Propietario y Administrador pueden ver, agregar, editar, importar, exportar y eliminar claves
Editor puede ver, agregar, editar, importar y exportar, pero no puede eliminar claves
Colaborador y Revisor pueden ver, editar y exportar, pero no pueden agregar ni eliminar claves
Lector tiene acceso de solo lectura y puede exportar archivos CSV

Los roles personalizados pueden otorgar el mismo acceso al activar las capacidades de traducción de la interfaz que necesites.

Entregar traducciones de la interfaz por GraphQL

Tus aplicaciones pueden leer las traducciones de la interfaz a través de la API GraphQL.

El campo uiTranslations devuelve pares de clave y valor de una configuración regional:

query {
  uiTranslations {
    key
    value
  }
}

De forma predeterminada, la consulta devuelve los valores de la configuración regional predeterminada del proyecto. Cuando el esquema expone enumeraciones de configuración regional, también puedes pasar el argumento opcional locale para solicitar otra.

Consulta la API GraphQL para la guía de entrega, la autenticación y ejemplos de consultas.