Localización en Wisej.NET

Localización en Wisej.NET, módulo uno. GlobalDesk es un servicio de soporte escrito para una única oficina, y convertirlo en una aplicación que puedan usar varias oficinas empieza por dos trabajos separados.

El inglés fijado en el código es solo la mitad del problema. Construir un importe poniendo un símbolo de dólar delante de un número deja grabada en el código la convención de un solo país, y ningún archivo de traducción deshará eso jamás. Wisej.NET usa aquí el modelo estándar de .NET: archivos de recursos, CultureInfo y ResourceManager.

El nombre de una cultura une un idioma con una región. El inglés por sí solo es únicamente idioma, mientras que inglés de Estados Unidos, alemán de Alemania y francés de Canadá añaden convenciones regionales. El idioma decide las palabras que muestras; la cultura decide cómo se escriben las fechas, los números y los importes.

Los archivos de recursos se apilan. Una búsqueda prueba primero el archivo más específico, después el de solo idioma y por último el neutro. Como el archivo neutro es la última parada, tiene que estar completo: lo que falte ahí ya no tiene nada a lo que recurrir.

En el código, eso significa doce claves semánticas en el archivo de recursos neutro y un ResourceManager construido a partir del nombre base y el ensamblado. Un ayudante devuelve la clave entre corchetes cuando no encuentra nada, así que un hueco aparece como algo que puedes leer en pantalla y no como una etiqueta vacía que nadie nota.

Ahora, la reescritura. Un método pone las palabras en pantalla buscando cada rótulo por su clave. Un segundo formatea una fecha, un número y un importe usando la cultura actual en el momento de mostrarlos, lo que mantiene los valores almacenados intactos y neutros.

Al ejecutarlo, todos los rótulos se resuelven menos uno, y ese se dibuja como su clave entre corchetes. El hueco se ve, en lugar de quedar en silencio. Añade la clave que falta y los tres valores de vista previa se formatean según la cultura bajo la que se ejecuta esta sesión.

Dos navegadores contra un mismo proceso de servidor, uno en inglés y otro en alemán, muestran el mismo código, las mismas claves y el mismo decimal almacenado dibujados de dos maneras. Eso funciona porque la cultura pertenece a la sesión y nunca a un campo estático compartido por todos.

Laboratorio uno: construye el panel de GlobalDesk sobre un archivo de recursos neutro, añade el ayudante de texto que marca las claves que faltan, añade el panel de vista previa de cultura y escribe la nota que separa los datos de la presentación.

Módulo dos: localizar una pantalla que se dibujó en lugar de escribirse. El editor de clientes de GlobalDesk se compuso en el diseñador de Visual Studio, y el alemán necesita palabras distintas y, resulta, también una geometría distinta.

Los rótulos que viven solo en el diseñador son inalcanzables para un traductor. Un rótulo alemán no cabrá en un botón dimensionado para el inglés. Y ensanchar todos los botones para el idioma más largo que puedas llegar a publicar arruina el diseño para el idioma que de verdad lee la mayoría de tus usuarios.

Seis pasos. Termina primero el diseño neutro. Marca el formulario como localizable. Elige el idioma. Cambia solo lo que difiere. Ejecuta la aplicación bajo esa cultura. Y devuelve después el diseñador a neutro antes de hacer cualquier cambio estructural, porque las ediciones estructurales pertenecen solo al diseño neutro.

El código generado del diseñador conserva únicamente los valores neutros, y el autoajuste, el anclaje y el acoplamiento hacen el trabajo de diseño. El texto, el tamaño y la posición alemanes se escriben en cambio en archivos de recursos generados, y por eso a un traductor se le pueden entregar archivos en lugar de un entorno de desarrollo.

La cultura actual pertenece a la sesión, nunca a un campo estático. Y como los recursos del diseñador se leen al crear un control, cambiar la cultura no repinta una pantalla que ya existe. Hay que quitar el editor, descartarlo y construirlo de nuevo antes de que vuelva a leer sus recursos.

Decide la capa antes de añadir la cadena. El texto, el tamaño, la posición, los colores y las imágenes que pertenecen a una pantalla diseñada van en los recursos del diseñador de esa pantalla. Todo lo que genere el código, y todo lo que compartan varias pantallas, va en cambio en el archivo de recursos compartido.

Ejecutando en alemán, los rótulos se recortan dentro de un ancho de botón que se midió contra el inglés, hasta que el tamaño se anula solo para el alemán. Quien lo demuestra es el navegador, no la superficie de diseño, porque la superficie de diseño te está mostrando el diseño neutro.

Cambiar la cultura de la sesión mientras la aplicación se ejecuta deja el editor abierto en inglés. Se queda así hasta que la acción de recrear lo descarta y construye uno nuevo, que entonces lee sus recursos bajo la nueva cultura. Esa es la regla del momento de creación, vista en directo.

Laboratorio dos: haz localizable el editor de clientes, añade una variante alemana con una anulación de tamaño y otra de posición, evita que los rótulos se recorten y demuestra la regla del momento de creación.

Localización en Wisej.NET, módulo tres: la capa de recursos compartida. Este es el texto que no pertenece a ningún control diseñado, junto con las etiquetas que Wisej.NET dibuja para sí mismo, dentro de GlobalDesk.

El módulo dos tradujo los rótulos de la pantalla. La confirmación de guardado, los mensajes de validación, la línea de estado y el resultado que devuelve un servicio siguen siendo literales en inglés metidos en el código, y la localización del diseñador no llega a ninguno de ellos, porque no hay ningún control que los posea.

El archivo de recursos neutro contiene todas las claves. El archivo alemán vive a su lado con exactamente las mismas claves y solo los valores traducidos. Una búsqueda recorre desde la cultura más específica hasta el archivo de solo idioma y luego el neutro, y toma la primera coincidencia que encuentra, que es lo que hace segura una traducción parcial.

Un único ResourceManager, construido a partir del nombre base y el ensamblado, está detrás de un pequeño ayudante que devuelve la clave entre corchetes en lugar de una cadena vacía cuando falta un valor.

Mantén cada frase entera. Guarda la frase completa con un marcador de posición y después formatéala para la cultura actual, en vez de concatenar fragmentos traducidos en el código.

Tres capas, tres dueños. Los recursos del diseñador llevan el texto propio de una pantalla. El archivo de cadenas compartido lleva el texto de producto que se usa en cualquier sitio. Y un archivo de recursos aparte anula las etiquetas que suministra el propio Wisej.NET, como los botones de un diálogo estándar.

El servicio de guardado devuelve una clave en lugar de una frase en inglés, y el editor es el único sitio que convierte un resultado en palabras. La línea de log se queda en un solo idioma a propósito, porque a un desarrollador que lee un log a las tres de la madrugada no le ayuda un mensaje traducido.

Ejecútalo en inglés, después en alemán, y abre luego un cuadro de mensaje cuyo botón de confirmación viene de tu anulación de etiqueta de sistema y no del valor por omisión del framework. Borra una clave del archivo alemán y la búsqueda recurre al valor neutro en lugar de mostrar un hueco en blanco.

Lo que entregas es el archivo alemán con claves idénticas, una frase formateada a partir de un marcador de posición, un servicio que devuelve una clave en lugar de prosa, una etiqueta de sistema de Wisej anulada y la nota que explica los tres tipos de texto.

Laboratorio tres: añade el archivo de cadenas en alemán, formatea la frase con marcador de posición para la cultura activa, devuelve una clave de resultado desde el servicio de guardado y anula una etiqueta de sistema.

Módulo cuatro. GlobalDesk ya tiene recursos en alemán, una variante de diseñador en alemán y una etiqueta de sistema en alemán. Para lo que todavía no tiene respuesta es para en qué idioma debe ejecutarse esta sesión concreta.

La cultura de una sesión puede venir de la preferencia del propio navegador, de un valor fijo en la configuración de la aplicación, de un parámetro en la dirección o de un selector que maneja el usuario. Gane el que gane, decídelo una sola vez al empezar la sesión, en lugar de volver a deducirlo en cada pantalla.

La propiedad de cultura actual es la cultura de la sesión actual. Un campo estático que guardara una cultura sería en cambio la cultura de todo el proceso del servidor, y por tanto la de cualquier otro usuario conectado a él, que es el error más caro de todo este tema.

Poner la cultura en automático hace que cada sesión arranque desde la preferencia del navegador. Poner un nombre fijo la ancla a una sola configuración regional, que es lo correcto para una prueba o para un producto que se vende en un único mercado. El selector asigna una cultura obtenida por su nombre.

Suscríbete una sola vez al evento de cambio de cultura y deja que un único manejador haga todo el trabajo de reparación. Vuelve a aplicar los rótulos que salen de los recursos, reformatea la fecha, el número y el importe, y reconstruye el editor localizado en el diseñador, de modo que todos los tipos de texto acaben siendo coherentes.

Cuatro tipos de texto, cuatro destinos distintos. Los controles creados después del cambio lo siguen por su cuenta. Los rótulos que ya están en pantalla hay que volver a aplicarlos. Los valores formateados hay que recalcularlos. Y las pantallas localizadas en el diseñador hay que recrearlas, porque sus recursos se leyeron cuando se construyeron.

Se elige el alemán, y el título, la navegación y las tres vistas previas formateadas cambian. El editor se queda en inglés hasta que se ejecuta la llamada de recreación. Ese hueco, entre las partes que siguen el cambio de inmediato y las que no, es el defecto que este módulo existe para evitar.

Un parámetro de idioma en la dirección abre una sesión en alemán mientras el siguiente navegador se queda en inglés. Dos culturas vivas en un mismo proceso al mismo tiempo es exactamente el comportamiento que un campo de cultura estático destruiría para las dos.

Laboratorio cuatro: pon la cultura en automático, añade el selector de idioma, escribe el manejador de cambio de cultura que vuelve a aplicar los rótulos y reformatea los valores, y recrea el editor.

Localización en Wisej.NET, módulo cinco. GlobalDesk ya habla árabe. Este módulo trata de conseguir que además se lea como el árabe, que es un problema de diseño y no de traducción.

El módulo cuatro terminó con las palabras. Una sesión en árabe todavía empieza por el borde equivocado de la pantalla, así que la mirada aterriza en lo último en vez de en lo primero. Y los rótulos alemanes ya se recortan dentro de un panel que se midió contra el inglés.

Dos propiedades con dos trabajos distintos. La propiedad RightToLeft cambia la dirección dentro de un control, y así es como se voltean el texto y su alineación. La propiedad RightToLeftLayout refleja los hijos directos de un contenedor, y así es como se voltea la disposición en sí.

Un único ajuste decide por toda la aplicación. Configurar la dirección como automática la deriva de la cultura de la sesión, así que ninguna pantalla necesita comprobar por su cuenta un nombre de cultura. Una comprobación así en una pantalla es una comprobación que alguien se olvidará de añadir en la siguiente.

El reflejo solo se ve bien si el diseño puede moverse. El acoplamiento, el anclaje, el autoajuste, un diseño de contenedor y unos tamaños mínimos sensatos sustituyen a las posiciones fijas en píxeles. Y una excepción deliberada de izquierda a derecha mantiene legible algo como un código de cliente, porque un identificador no es prosa.

Después, pruébalo en serio: un texto corto, una traducción bastante más larga, una ventana estrecha, una cultura de derecha a izquierda y contenido mixto, como una etiqueta en árabe junto a un código de producto en alfabeto latino. Cada uno de esos casos rompe una suposición distinta.

En el navegador, el selector elige el árabe, la dirección de la aplicación sigue a la cultura de la sesión y una única propiedad de contenedor refleja el panel. Aquí no hay estado global: la dirección, igual que la cultura, pertenece solo a esta sesión.

La pasada pseudolocalizada deja al descubierto lo que el inglés escondía, y el diseño reconstruido deja de recortar. La cuadrícula de contactos se comprueba y su comportamiento se documenta en lugar de darse por hecho, porque una cuadrícula tiene sus propias reglas de columnas y de alineación que verificar.

Laboratorio cinco: añade el árabe con dirección automática, refleja las dos pantallas con sus hijos heredando, añade una excepción comentada de izquierda a derecha, haz el diseño a prueba de recortes y escribe la lista de cinco casos de prueba.

Módulo seis. GlobalDesk ya tiene cuatro archivos de recursos. Añadir el italiano con dos pestañas del editor significa comparar listas de claves a ojo, y la persona que habla italiano no puede abrir la solución.

Tres cosas se rompen en este punto: comparar archivos a ojo, responder cuánta traducción queda, y entregarle las cadenas a alguien que nunca ha abierto un archivo de recursos y que no debería tener que hacerlo.

Una herramienta de gestión de recursos pone las claves en las filas y cada idioma en las columnas, así que un hueco es una celda en blanco y no algo de lo que tengas que darte cuenta. Wisej.NET guarda su texto en archivos de recursos estándar de .NET, así que no hace falta ningún soporte especial.

Lo que la herramienta escribe es un archivo de recursos italiano corriente: exactamente las claves del archivo neutro, los valores traducidos, un comentario en las que resultaron ambiguas y una entrada dejada vacía a propósito para poder demostrar el respaldo.

La ronda en sí tiene una forma. Añade el idioma, filtra para ver solo las entradas sin traducir, redacta los valores, marca el nombre de producto como invariante para que nadie lo traduzca, y después revisa. En esta ronda la revisión se gana su sitio: el borrador había intercambiado dos marcadores de posición.

La traducción automática produce un borrador, no un resultado. Revisa la terminología, los marcadores de posición, la puntuación, los aceleradores de teclado y los nombres de producto, y lee la diferencia en el control de versiones antes de confirmar la ronda, igual que con cualquier otro cambio en la aplicación.

Fíate del filtro, pero después demuéstralo de forma independiente. Sáltate las claves invariantes, compara cada búsqueda italiana con el valor neutro y lista todas las claves que siguen recurriendo al inglés, en lugar de dar por hecho que la columna está completa.

Ejecutando en italiano, los rótulos vienen del archivo de recursos traducido, mientras que la fecha, la cantidad y el importe se formatean para la cultura activa en el momento en que se muestran. Son dos mecanismos separados haciendo dos trabajos separados.

Un desarrollador y dos idiomas pueden vivir dentro del editor. Un equipo con varios idiomas quiere la herramienta de gestión de recursos. Y los traductores que no son desarrolladores necesitan una ronda de exportación e importación, o un servicio de gestión de traducciones.

Laboratorio seis: completa una columna italiana sin ninguna clave sin traducir, comenta tres claves ambiguas, marca las invariantes, revisa la diferencia del archivo de recursos y escribe la nota del flujo de trabajo.

Localización en Wisej.NET, módulo siete: el proyecto final. GlobalDesk ya habla dos idiomas. Lo que pregunta producción es algo distinto: si además se comporta de forma predecible mientras lo hace.

Cuatro preguntas que la aplicación tiene que responder igual siempre. De dónde viene una cadena determinada. Qué cultura está activa ahora mismo. Qué pasa cuando falta una clave. Y qué le hace un cambio de idioma a las pantallas que ya están abiertas.

Separa primero el texto por dueño. Tus propias cadenas de producto. Las etiquetas de sistema que suministra Wisej.NET, anuladas en su propio archivo de recursos. Y el texto de diagnóstico, que se queda en un solo idioma para los desarrolladores, porque un log lo lee el equipo y no el cliente.

Un servicio de localización centraliza esas decisiones sin reemplazar nada de lo que .NET ya hace. Un único ResourceManager. Una búsqueda que devuelve la clave entre corchetes en lugar de nada. Y un formateo que lee la cultura actual en cada llamada, en vez de capturarla una vez y quedársela.

Después, saca el idioma de la pantalla y del modelo. Mantén la fecha como fecha y el importe como decimal, devuelve un estado como valor de enumeración y no como palabra traducida, y deja que el servicio convierta todo eso en el rótulo que el usuario acaba leyendo.

Probar aquí es una matriz escrita, no un vistazo a una pantalla. Neutra, traducida, una región que recurre a su idioma, una clave que falta, valores formateados, un cambio en tiempo de ejecución, cadenas deliberadamente largas, derecha a izquierda, y las propias etiquetas de sistema del framework.

La pasada pseudolocalizada alarga cada valor y lo envuelve entre corchetes. Todo lo que siga apareciendo en inglés normal nunca llegó a un archivo de recursos, y todo lo que se recorte bajo el texto más largo se recortará también en alemán. Los dos hallazgos salen gratis de la misma ejecución.

La demostración son cuatro pruebas: rótulos en alemán junto a valores formateados por la cultura, un diálogo de sistema de Wisej en el mismo idioma, una clave que falta que recurre visiblemente a mostrarse como su propia clave, y por último el diseño reflejado de derecha a izquierda.

Laboratorio siete: construye el servicio de localización, devuelve valores en vez de palabras desde el dominio, produce el conjunto pseudolocalizado, completa la matriz de pruebas y publica conservando las carpetas de cultura.