Esta sección recoge la gestión de los idiomas disponibles en Anjana Data Platform y describe cómo configurar la internacionalización de la plataforma desde el nuevo Panel de Administración. La internacionalización parte de la activación de los idiomas que cada organización desee poner a disposición de sus usuarios.
De forma predeterminada, la plataforma incluye activados el español y el inglés de Estados Unidos (en-US). Tras dar de alta un nuevo idioma es imprescindible configurar sus traducciones correspondientes, ya que solo así la aplicación resulta completamente accesible en dicho idioma.
Alta de un nuevo idioma
El alta de un nuevo idioma se realiza desde el apartado Internacionalización del Panel de Administración, pulsando el botón Nuevo idioma. Al hacerlo, se abre un asistente que guía en la configuración y habilitación del idioma.
Pasos a seguir:
-
Pulsar el botón Nuevo idioma, situado en la parte superior derecha, para abrir el asistente.
-
Seleccionar el idioma deseado en el desplegable Selecciona un idioma. Es posible escribir su nombre para facilitar la búsqueda.
-
De forma opcional, marcar las siguientes casillas del asistente:
-
Marcar por defecto: establece el idioma como predeterminado de la plataforma. -
Idioma activo: mantiene el idioma activado tras guardarlo, de modo que quede disponible para su selección en el Área personal y en los atributos de tipo international.
-
-
Pulsar Confirmar para guardar el registro o Cancelar para descartarlo.
-
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.
Importante: aunque se publiquen los cambios sobre los nuevos idiomas, no serán visibles para los usuarios hasta que inicien sesión de nuevo.
Notas:
-
La plataforma incluye automáticamente la iconografía asociada a cada idioma.
-
Tras añadir un nuevo idioma en la tabla de Internacionalización es necesario incluir los valores de sus traducciones.
-
No se recomienda activar un idioma hasta haber poblado todas las claves de traducción asociadas.
-
Es necesario pulsar Publicar cada vez que se incorporen nuevas traducciones para que puedan consultarse en el apartado de Internacionalización.
Acciones sobre un idioma existente
Una vez creado un idioma, la plataforma permite las siguientes acciones sobre él:
-
Marcar como idioma por defecto (1), que reemplaza al idioma establecido como predeterminado hasta ese momento.
-
Activar o desactivar (2), que determina si el idioma está disponible para los usuarios de la plataforma.
-
Editar (3), que abre una ventana desde la que pueden realizarse las acciones anteriores.
-
Eliminar (4), que borra el idioma junto con sus traducciones asociadas. Esta opción no está disponible para el idioma English (United States), que únicamente puede deshabilitarse.
La modificación de un idioma existente debe realizarse con precaución y se efectúa mediante el icono de edición disponible en la cabecera de la tabla de Internacionalización.
Notas:
-
Tras realizar cualquier cambio es necesario pulsar Publicar para que se aplique y sea visible en el Portal de Datos.
-
La modificación de un idioma no afecta a los objetos gobernados, pero sí a la visualización de sus metadatos.
Importante: la activación, desactivación o eliminación de un idioma puede afectar a los usuarios que estén editando metadatos en las plantillas (de forma manual, vía Excel, MCP o API). Por ello se recomienda planificar actuaciones controladas, con ventanas de intervención y guías para los usuarios. Entre las recomendaciones destacan:
-
Congelar (freeze) las actividades de edición de metadatos durante la activación, desactivación o eliminación de idiomas.
-
Para los trabajos en curso vía Excel, descargar la última versión tras la intervención.
-
Recomendar a los usuarios cerrar sesión y volver a iniciarla tras la activación, desactivación o eliminación de idiomas.
Consulta de idiomas mediante acceso directo a la base de datos — Visión desarrollador
Los idiomas añadidos en la Internacionalización se almacenan en la colección anjana.Language de DocumentDB. La siguiente tabla describe sus campos:
|
Campo |
Tipo de dato |
Descripción / Restricciones |
|---|---|---|
|
_id |
UUID |
Identificador del idioma en DocumentDB. |
|
legacyId |
Int32 |
Identificador original en SQL; uso interno para la migración. |
|
i18nCode |
String |
Código estándar i18n. Debe ser único. |
|
description |
String |
Nombre del idioma. |
|
defaultLang |
Boolean |
Indica si el idioma está marcado como predeterminado. Solo puede haber uno marcado como predeterminado. |
|
active |
Boolean |
Indica si el idioma está activado para su uso en la plataforma. |
|
created_at |
Date |
Fecha de creación. |
|
modified_at |
Date |
Fecha de actualización. |
A continuación se muestra un ejemplo de consulta de un idioma en la colección:
use anjana
db.Language.find({ "i18nCode": "es-ES" })