Una cadena localizada es una propiedad de texto que guarda un valor distinto para cada idioma que admite tu tenant. Úsala para todo lo que lee un usuario final y que debería cambiar según el idioma de la interfaz — el nombre de un producto, el título de un artículo, la etiqueta de una categoría.

Es un tipo de propiedad propio, que eliges al diseñar el modelo. Una cadena (String) normal guarda un solo valor y ya está. Una cadena localizada guarda un valor por idioma — por ejemplo Title = "Benvinguda" en catalán y "Welcome" en inglés, en la misma instancia.

Cómo funciona el valor

Una cadena localizada lleva todos los idiomas a la vez:

  • El idioma por defecto del tenant es la versión canónica. Es la que se muestra cuando no aplica ninguna otra, y es obligatoria — una instancia no puede tener una cadena localizada con solo una traducción que no sea la de por defecto.
  • Cada idioma admitido puede tener su propio texto. Los idiomas que dejes vacíos simplemente no tienen entrada; el lector recae en el de por defecto.
  • Cuando alguien cambia el idioma de visualización, la versión correspondiente aparece de inmediato. No se vuelve a pedir nada — todos los idiomas viajan juntos con la instancia.

Así, un Title con "Welcome" (en) / "Benvinguda" (ca) / "Bienvenida" (es) muestra la palabra correcta en el instante en que el lector cambia de idioma, sin recargar.

Editar una cadena localizada

El editor muestra un único campo para el idioma de visualización activo, etiquetado con su código (por ejemplo Title (ES)). Escribe ahí para fijar el valor de ese idioma.

Junto al campo hay un botón 🌐. Abre un diálogo con un campo por cada idioma admitido, así puedes rellenar o revisar todas las traducciones en un solo sitio. Deja un idioma en blanco para quitar su versión; el idioma por defecto debe conservar un valor.

Filtrar

Cuando filtras una lista por una cadena localizada, la coincidencia se hace en todos los idiomas — es un OR. Buscar "welcome" en Title encuentra la instancia tanto si "welcome" está en el texto inglés, en el catalán o en cualquier otro idioma. No hace falta saber en qué idioma se introdujo un valor para encontrarlo.

Cadena localizada vs cadena

Elige el tipo por lo que es el campo, no por si hoy eres multiidioma o no.

Usa cadena cuando… Usa cadena localizada cuando…
El valor es el mismo en todos los idiomas. El valor es texto para personas que debería traducirse.
Es un código, slug, identificador, URL o correo. Es un nombre, título, etiqueta o descripción que la gente lee.
Es interno y nunca se muestra traducido. El idioma de la interfaz debería cambiar lo que ve el lector.

Una cadena es más ligera y simple — sigue usándola para códigos y texto orientado a máquinas. Recurre a la cadena localizada solo donde la traducción importa de verdad; no puedes filtrar ni validar una cadena "por idioma" porque solo tiene un valor, y no quieres ese sobrecoste donde no aporta nada.

Dónde encontrarla

Cuando añades o editas una propiedad de un modelo, elige cadena localizada como tipo. A partir de entonces, cada formulario de instancia muestra el editor localizado descrito arriba, y los idiomas admitidos provienen de la configuración de idiomas de tu tenant (véase Tenants).