Traducciones

Los textos visibles en los diferentes módulos del Portal de Datos y los mensajes de la aplicación pueden ser customizados mediante la configuración de traducciones para diferentes idiomas. Siempre que se añadan nuevos textos o se incorporen nuevos idiomas, es necesario registrar las traducciones correspondientes en la plataforma.

Tabla Translations del Panel de Configuración (Visión administrador)

Las traducciones visibles en el Portal de Datos (formularios, menús, mensajes, filtros, etc.) se almacenan en la tabla Translations.

Estructura de la tabla Translations

Cada registro representa una clave de traducción en un idioma:

• Id: identificador único del registro. Se asigna automáticamente desde el Panel de configuración.

• key: clave de traducción.

  • La misma key debe existir una vez por cada idioma disponible.

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

• language: código i18n del idioma, debe existir en Languages (p.ej. es-ES, en-US).

• value: texto traducido en el idioma indicado en language.

  • No puede compartir value registros con key diferentes para traducciones de atributos o metadatos de referencia.

• used_for: campo informativo para clasificar/filtrar usos (p.ej. AUDIT, WORKFLOWS); puede quedar vacío.

• internal: flag que indica si la traducción es texto interno de Anjana Data (true) o texto de configuración como atributos, menús, roles, etc. (false).

Traducciones de los idiomas

Los idiomas de la tabla de idiomas tienen sus propias traducciones visibles desde el selector de idiomas del perfil del usuario.

La traducción del código i18n en el campo key (ej.: es-ES) determina el nombre visible del idioma (value) que visualiza un usuario cuando tiene la aplicación en el idioma indicado en language

• Ejemplo: El registro con key= es-Es, language= en-US y value= Spanish sirve para que, cuando un usuario que tiene la aplicación en inglés americano ( language= en-US), vea la traducción Spanish (value= Spanish) junto a la bandera de España.
  

  

• Ejemplo: El registro con key= es-Es, language= es-ES y value= Español sirve para que, cuando un usuario que tiene la aplicación en español ( language= es-ES), vea la traducción Español (value= Español) junto a la bandera de España.
  

  

Consideraciones especiales para claves de traducción

Existen ciertos elementos de la configuración de Anjana Data que requieren un criterio específico a la hora de definir las claves de traducción:

• Infraestructura, Tecnología y Zona (Tripletas)
  Las claves de traducción (key) de los valores posibles de estos atributos deben corresponderse exactamente con las partes de la tripleta configurada en los plugins de Tot. Estos a su vez deben corresponder con los valores de name en la tabla Attribute Definition Values.
  

  

  • Ejemplo: Si en el plugin de Tot de Azure se define la tripleta:

    Virtualizador / Denodo / Territorio
    

    entonces las claves de traducción (key) deben ser las siguiente, independientemente del value:

    • infrastructure: Virtualizador

    • technology: Denodo

    • zone: Territorio

Importante:

Si durante la importación de metadatos en el wizard de creación, al seleccionar una tripleta aparece un error que indica “No existe un plugin para extract” es probable que el motivo sea que los valores de la tripleta en el YAML del plugin no sean los correctos para las traducciones seleccionadas. Es conveniente:

• Revisar que los key de la tabla Languages correspondientes a las traducciones seleccionadas en el wizard (value) corresponden con los valores de name en la tabla Attribute Definition Value

• Revisar que los valores de name de la tabla Attribute Definition Value corresponden con los valores configurados en la ari del YAML del plugin.

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

  • Ejemplo:

    ROLE.architect
    

• Idiomas
  Para traducir los nombres de los idiomas, la clave de traducción debe coincidir con el código i18n definido en la tabla Languages.

  • Ejemplo:

    es-ES
    en-US
    fr-FR
    

Traducciones internas de la plataforma

En Anjana Data existen traducciones internas que se repiten bajo diferentes claves, ya que fueron generadas según la funcionalidad o la pantalla en la que se utilizan.

Por ejemplo, al cambiar la traducción del atributo obligatorio infrastructure, se debe modificar tanto la clave de Infraestructura del wizard de creación, como la de los filtros, la del atributo en la plantilla y la del tooltip en la cabecera del objeto.

Claves de traducción de atributos obligatorios de entidades/relaciones

• Nombre

  • COMMON.NAME

  • NEW_WIZARD_ASSISTANT.CARD_NAME

  • labelTranslationKey y placeHolderTranslationKey del atributo con name = 'name' en anjana.attribute_definition

• Infraestructura

  • NEW_WIZARD_ASSISTANT.INFRASTRUCTURE

  • TOOLTIP.INFRASTRUCTURE

  • labelTranslationKey y placeHolderTranslationKey del atributo con name = 'infrastructure' en anjana.attribute_definition

• Tecnología

  • NEW_WIZARD_ASSISTANT.TECHNOLOGY

  • TOOLTIP.TECHNOLOGY

  • labelTranslationKey y placeHolderTranslationKey del atributo con name = 'technology' en anjana.attribute_definition

• Zona

  • NEW_WIZARD_ASSISTANT.ZONE

  • TOOLTIP.ZONE

  • labelTranslationKey y placeHolderTranslationKey del atributo con name = 'zone' en anjana.attribute_definition

• Localización

  • NEW_WIZARD_ASSISTANT.PATH

  • TOOLTIP.PATH

  • labelTranslationKey y placeHolderTranslationKey del atributo con name = 'path' en anjana.attribute_definition

• Unidad Organizativa

  • CONTAINER

  • GRAPH.NODE_ORGANIZATIONAL_UNIT

  • MODAL.ORGANIZATIONAL_UNIT

  • TOOLTIP.ORGANIZATIONAL_UNIT

  • FILTERS.ORGANIZATIONAL_UNIT

  • labelTranslationKey y placeHolderTranslationKey del atributo con name = 'organizationalUnit' en anjana.attribute_definition

• Posición

  • COMMON.POSITION

  • labelTranslationKey y placeHolderTranslationKey del atributo con name = 'position' en anjana.attribute_definition

• Nombre físico

  • COMMON.PHYSICAL_NAME

  • labelTranslationKey y placeHolderTranslationKey del atributo con name = 'physicalName' en anjana.attribute_definition

• Origen

  • COMMON.SOURCE

  • FORM_RELATION.SOURCE

  • RELATION.SOURCE

  • SOURCE

  • labelTranslationKey y placeHolderTranslationKey del atributo con name = 'source' en anjana.attribute_definition

• Destino

  • FORM_RELATION.DESTINATION

  • RELATION.DESTINATION

  • FILTERS.DESTINATION

  • DESTINATION

  • labelTranslationKey y placeHolderTranslationKey del atributo con name = 'destination' en anjana.attribute_definition

Alta de una traducción en la tabla Translations

El alta de una nueva traducción implica añadir en la tabla Translations un registro.

Para dar de alta una capa desde el Panel de configuración:

1. Pulsar el botón New en la esquina superior derecha.

2. Completar los campos:

   • Key: clave de traducción declarada en la tabla correspondiente (Menu, Sections, Attribute Definitons…) (ej.: FILTERS.DOMINIO).

   • Language: código i18n del idioma para el que se configura la traducción (ej.: es-ES).

   • usedFor: texto informativo para clasificar/filtrar usos (ej.: vacío).

   • internal: flag que indica si la traducción es interna o configuración de la organización. (ej.: en este caso es configuración propia false).

   • value: texto visible para el usuario cuando selecciona el idioma indicado en language.(ej.: Dominio).

3. Pulsar en Save para guardar la capa o en Cancel para descartar.

Modificación de una traducción en la tabla Translations

La modificación de traducciones es una operación habitual cuando se necesita ajustar el texto mostrado al usuario o actualizar terminología ya existente.

• Campos editables:
  Los campos value, usedFor e internal pueden modificarse en cualquier momento sin restricciones. Estos cambios no afectan a la estructura del sistema, únicamente actualizan el texto visible en el Portal de Datos o la clasificación de la traducción.

• Campos no recomendados para edición:
  No es recomendable modificar los campos key o languagesi antes no se han modificado los campos correspondientes de las tablas de configuración (Menu, Sections, Attribute Definition, Roles, …).

Configuración de Traducciones mediante acceso directo a la base de datos (Visión desarrollador)

Las traducciones se almacenan en la tabla portuno.translations.

Ejemplo de configuración de claves de traducción:

INSERT INTO portuno.translations
(id_translations, config_key, "language", used_for, value, internal)
VALUES
  (346, 'COMMON.NAME', 'en-US', NULL, 'Name', true),
  (347, 'COMMON.NAME', 'es-ES', NULL, 'Nombre', true),
  (402, 'WORKFLOWS.TABLE.HEADER_TITLE.NAME', 'en-US', NULL, 'Object name', true),
  (403, 'WORKFLOWS.TABLE.HEADER_TITLE.NAME', 'es-ES', NULL, 'Nombre del objeto', true),
  (550, 'FORM_FIELD.PLACEHOLDER.ENTER_NAME', 'en-US', NULL, 'Enter your name...', true),
  (551, 'FORM_FIELD.PLACEHOLDER.ENTER_NAME', 'es-ES', NULL, 'Introduzca su nombre...', true),
  (582, 'FULL_HISTORY.TABLE.HEADER_TITLE.OBJ_NAME', 'en-US', NULL, 'Object Name', true),
  (583, 'FULL_HISTORY.TABLE.HEADER_TITLE.OBJ_NAME', 'es-ES', NULL, 'Nombre del objeto', true);