Enumeraciones de uso frecuente

CGS S.L. - Manual de referencia

Munigex gestiona diversos tipos de listas de datos, ya internacionalizadas o no, pero de uso frecuente. Ejemplos típicos de listas pequeñas pueden ser las duplas "Sí/no", "Verdadero/Falso" o la terna "Hombre/Mujer/Empresa"... Pero también puede gestionar listas muy grandes y con muchas traducciones.

Estas listas son para el asistente de combinación, para ofrecer listas de valores cerrados al usuario o para utilizar sus valores en los documentos combinados.

Ejemplo del problema

Supongamos que deseamos crear una plantilla en donde el usuario, en este caso el funcionario, deba elegir un tipo de persona según el siguiente listado:

Valor	Tipo de persona (es)	Tipo de persona (eu)
0	Ente jurídico	Erakunde juridikoa
1	Hombre	Gizonezkoa
2	Mujer	Emakumezkoa

Se pueden gestionar listas de unos pocos elementos de texto como la anterior por medio de sus fórmulas para luego poder reutilizarlas.

Las listas se gestionarán como ternas (Valor, Titulo, TextoLargo) donde:

Valor: Valor que hace de clave y sirve igual en todos los idiomas del elemento de la tabla. Puede ser una cadena de texto también.
Título: Texto corto de no más de 120 caracteres con una descripción del valor. Esta descripción puede venir en varios idiomas. Si no se especifica el idioma, Munigex guarda este texto como valor de referencia en caso de dudas de traducción.
TextoLargo: Texto largo de tamaño técnicamente ilimitado pero se recomienda no pasar de 20000 caracteres (5 páginas A4 de texto). También puede venir en varios idiomas. Además Munigex guarda el texto de referencia de este "Texto Largo".

Posibles utilidades de las enumeraciones

Se pueden explotar por medio de fórmulas para cualquier objetivo. Entre otros:

Simplificar la gestión de las variables. Por ejemplo, el par "Sí/No" se puede reutilizar muchas veces.
Crear listas de valores para cuadros desplegables que aparecerán en el asistente de combinación de Munigex. Dependiendo del idioma del usuario saldrán en un idioma u otro.
Rellenar con facilidad los documentos multilingües a partir de un código de enumeración. Las enumeraciones de Munigex permite asociar un texto muy largo de forma implícita con cada valor de la enumeración.
Almacenar la información codificada y por tanto más compacta. Munigex no almacena los textos al combinar como hace con otros datos sino que solo guarda los códigos.
Mejorar la calidad de las traducciones por personal especializado al estar separadas la lógica del idioma en que se haga la documentación y la propia traducción. La aplicación concentra todos los datos traducibles para facilitar estas operaciones.

Nombres de listas

Munigex pueden gestionar muchas listas de este tipo. Por convenio las llamaremos "enumeraciones" y para que sean fácilmente tratables tienen cada una de ellas un código nemónico que a su vez sirve de nombre para aludirlas. Así, la lista de tipos de personas se llama "enTIPOSPERSONA"

Un ejemplo de fórmula de acceso a una de esta listas, por medio de las fórmulas de Munigex, para rellenar un cuadro desplegable puede ser el siguiente:

Copy

Entorno.Enums["enTIPOSPERSONA"].Listar())

Que devuelve la lista de tipos de persona en el idioma del usuario activo.

Para obtener el valor de uno de los valores de la lista en varios idiomas se puede hacer...

Copy

Dupla=Entorno.Enums["enTIPOSPERSONA"][2];   //Obtenemos el valor 2
NombreTipoEus=Dupla["eu-ES"].Titulo;        //"Emakumezkoa" en euskera
NombreTipoCas=Dupla["es-ES"].Titulo;        //"Mujer" en español

La variable Entorno sirve para poder acceder a todas las enumeraciones. La clase que maneja estas enumeraciones es CGSSL.Munigex.Lib.EntornoEnumColeccionDAL