Traducciones

Los textos visibles en los distintos módulos del Portal de Datos, así como los mensajes de la aplicación, pueden personalizarse mediante la configuración de traducciones para cada idioma disponible en Anjana Data Platform. Siempre que se añadan nuevos textos o se incorpore un nuevo idioma es necesario registrar las traducciones correspondientes en la plataforma.

Estructura de la tabla de Internacionalización

Cada registro de la tabla de Internacionalización representa una clave de traducción para un idioma y se compone de los siguientes campos:

• Interna: indica si la traducción es texto interno introducido por Anjana Data Platform (true) o texto de configuración propia de la organización —atributos, menús, roles, etc.— (false). Las traducciones internas no pueden eliminarse.

• Uso: campo descriptivo que permite clasificar las traducciones por grupos funcionales. Puede quedar vacío.

• Clave (key): clave de la traducción.

  • Es el valor que se muestra al usuario cuando no existe traducción configurada para el idioma seleccionado.

  • No se recomienda emplear como key los nombres de los objetos del metamodelo (campo name de Object Sub-Types).

• Lista de idiomas con su texto de traducción:

  • Cada texto es la traducción que verá el usuario si selecciona el idioma indicado en la cabecera de la columna.

  • Dos claves que representen nombres de atributos o valores de metadatos de referencia no pueden compartir el mismo valor de traducción.

Alta de traducciones

Las traducciones de cada clave se configuran en el apartado Internacionalización del Panel de Administración. Para dar de alta una nueva traducción:

1. Pulsar el botón Nueva traducción para abrir el asistente.

2. Rellenar los campos del asistente:

   1. Clave (obligatorio): clave para la que se configura la traducción. Puede corresponder a claves internas de la plataforma o a valores configurados para menús, secciones, atributos, filtros, etc.

   2. Uso: campo descriptivo para clasificar las traducciones por grupos funcionales. Se recomienda definir un estándar que facilite la búsqueda y el filtrado y mantenga un vocabulario común de referencia.

   3. Idioma (inglés y resto de idiomas configurados): texto que recibirá el usuario para esa clave según el idioma establecido en su Área personal.

3. Pulsar Confirmar para guardar la traducción o Cancelar para descartarla.

4. Tras confirmar, se habilita el botón Publicar, necesario para hacer efectivos los cambios. Si se abandona el Panel de Administración sin publicar, los cambios se perderán.

Modificación de una traducción

La modificación de traducciones es una operación habitual cuando se necesita ajustar el texto mostrado al usuario o actualizar la terminología existente. Basta con actualizar el texto del idioma correspondiente desde el apartado Internacionalización del Panel de Administración, mediante una de estas dos opciones:

• Edición directa: modificando el texto en el campo editable.

• Edición mediante asistente: al pulsar el icono del lápiz se abre un asistente que permite editar los textos en los distintos idiomas.

Consideraciones especiales para claves de traducción

Algunos elementos de la configuración de Anjana Data Platform requieren un criterio específico al definir sus claves de traducción.

Infraestructura, Tecnología y Zona (tripletas)

Las claves de traducción (Clave) de los valores posibles de estos atributos deben corresponderse exactamente con las partes de la tripleta configurada en los plugins de Tot, que a su vez deben coincidir con los valores de name de la tabla Attribute Definition Values establecidos en el Portal de Configuración.

Por ejemplo, si en un plugin de Tot se define la tripleta AWS / Amazon S3/ Gold, las claves de traducción (Clave) deben ser las siguientes, con independencia del valor de traducción:

• infrastructure: AWS

• technology: Amazon S3

• zone: Gold

Importante: si durante la importación de metadatos en el wizard de creación, al seleccionar una tripleta, aparece el error "No existe un plugin para extract", es probable que los valores de la tripleta definidos en el YAML del plugin no coincidan con las traducciones seleccionadas. Conviene comprobar que:

• Las claves (Clave) correspondientes a las traducciones seleccionadas en el wizard (value) coinciden con los valores de name de la tabla Attribute Definition Value.

• Los valores de name de la tabla Attribute Definition Value coinciden con los configurados en la ari del YAML del plugin.

Roles

Para traducir los nombres de los roles, la clave de traducción se forma concatenando el prefijo ROLE. con el valor de la columna name de la tabla Roles.

Consulta de traducciones mediante acceso directo a la base de datos — Visión desarrollador

Las traducciones se almacenan en dos colecciones de MongoDB, según sean traducciones internas de la plataforma o propias de la organización:

• anjana.InternalTranslation: traducciones internas de Anjana Data Platform.

• anjana.ExternalTranslation: traducciones de configuración propia de la organización.

Traducciones internas (anjana.InternalTranslation)

Ejemplo de consulta de una traducción cuya clave contenga COMMON.WELCOME:

use anjana
db.InternalTranslation.find({ configKey: RegExp("COMMON.WELCOME") })

Traducciones externas (anjana.ExternalTranslation)

Ejemplo de consulta de una traducción cuya clave contenga ROLE.apiAdmin:

use anjana
db.ExternalTranslation.find({ configKey: RegExp("ROLE.apiAdmin") })