Hablemos sobre .Net y Azure

Mes: febrero 2021

Personalización de idiomas en Azure AD B2C (Parte 1)

Este post forma parte de una serie de artículos donde estaré compartiendo todo lo necesario para utilizar, configurar y sacar el mayor provecho de Azure AD B2C.

Continuando con la personalización de la marca e identidad que hicimos en el post anterior, donde configuramos y personalizamos los atributos de usuario, te contaré cómo hacer nuestra experiencia de usuario multi idioma.

En esta primera parte veremos los conceptos principales, aprenderemos cómo funciona y cómo utilizar múltiples idiomas. En la parte 2 nos enfocaremos en los atributos de usuario personalizados.

IMPORTANTE: vamos a construir sobre la base del post anterior, con lo cual es recomendable tener claros los conceptos y pasos allí detallados.

Contexto y Requerimientos

En un contexto totalmente globalizado como el actual, es habitual que las aplicaciones web crucen las fronteras para alcanzar usuarios cuyo idioma principal difiere del idioma original. Es por esto, que la mayoría de las aplicaciones de hoy en día se diseñan para soportar múltiples idiomas.

Azure AD B2C soporta 36 idiomas e incluye la posibilidad de configurar un idioma totalmente personalizado si fuese requerido. Además podemos agregar nuestras propias traducciones para todos aquellos atributos de usuario personalizados que hayamos agregado.

¿Cómo funcionan los idiomas en Azure AD B2C?

Al iniciar el flujo de usuario, podemos indicar como parte de los parámetros query-string el idioma que queremos utilizar, Azure AD B2C hará la traducción correspondiente. Si no se especifica en forma explícita un idioma entonces se utilizará el idioma requerido por el browser, si el browser utiliza un idioma no soportado, finalmente se utilizará el idioma configurado como predeterminado o de facto.

Tener en cuenta que cada idioma se configura a nivel de Flujo de Usuario y debe haber siempre un idioma predeterminado o de facto.

Todos los atributos de usuario estándares tienen su traducción correspondiente en todos los idiomas soportados. No obstante, tendremos que proveer traducciones manualmente para todos aquellos atributos de usuarios personalizados.

Configuración de idioma en Azure AD B2C

Lo primero que debemos realizar es navegar hasta nuestro flujo de usuario e ir a la sección Idiomas, una vez allí habilitar la personalización de idiomas.

Flujo de Usuario – Habilitar personalización de idiomas

Una vez habilitada la opción de personalización, podremos seleccionar la lista de idiomas disponibles. Como mencionamos anteriormente, siempre debe haber un idioma seleccionado como predeterminado, en este caso es el idioma Inglés.

Idioma – Habilitar idioma

Para habilitar y/o configurar otro idioma sólo basta con seleccionar el idioma deseado, en este caso Español, y marcar la opción Habilitado.

Tenemos la posibilidad de seleccionar este idioma como predeterminado o de facto y en la sección de Archivos de Recursos de nivel de página podemos personalizar como traducir cada elemento (lo veremos en la parte 2).

Una vez guardados los cambios, el idioma Español estará disponible.

Idioma – Habilitar ui_locales

Para probar o verificar esta configuración, tenemos que ejecutar el flujo de usuario. Esta vez la sección de localización estará disponible.

Activar la opción Especificar ui_locales nos permite seleccionar un idioma en forma explícita, caso contrario se utiliza el idioma predeterminado, en este caso Inglés.

Copiando y pegando en un block de notas la URL que se genera con cada idioma podemos comparar y analizar como funciona ui_locales.

¿Cómo funciona ui_locales?

ui_locales consiste en un parámetro que se adiciona a la URL de conexión del flujo de usuario que es usado por Azure AD B2C para traducir cada página al idioma correspondiente.

Comparando las URLs que copiamos y pegamos anteriormente podemos observar los distintos valores que va tomando el parámetro (generalmente es el último parámetro de la URL), incluso podemos modificar manualmente y utilizar un valor inexistente como en los siguientes ejemplos:

Flujo de Usuario – Comparación URLs

Debido a que el idioma predeterminado configurado hasta el momento es Inglés, tanto en el caso de un idioma inexistente como en el caso de un idioma deshabilitado se comportarán idénticamente al idioma Inglés.

Para en el caso implícito (donde no se incluye el parámetro ui_locales), depende del idioma configurado localmente para el usuario. En mi caso, el idioma configurado en mi computadora es Inglés.

Navegando a cada una de las URLs anteriores, podemos observar lo siguiente:

  • Español (ui_locales=es)
Inicio de sesión – Español
  • Inglés (ui_locales=en)
  • Inexistente o no habilitado (ui_locales=xx)
  • Implícito (sin ui_locales)
Inicio de sesión – Inglés y por defecto

Podemos apreciar como absolutamente todo el formulario se traduce sin ningún tipo de problemas en forma automática. Sin embargo, el Registro de usuario o Sign Up tiene una traducción parcial para el idioma Inglés:

Registro de Usuario – Sin configuración de traducción
  • Los atributos de usuario estándar (cómo Dirección de Email) aparecen correctamente traducidos al Inglés como es esperado
  • Los atributos de usuario personalizados (cómo habilidades) aparecen es Español incluso cuando el idioma seleccionado es Inglés.

Hemos hecho un muy buen progreso, y no sólo aprendimos como configurar distintos idiomas sino que también aprendimos como funciona la traducción de Azure AD B2C, pero todavía nos falta un paso más para poder tener una traducción completa.

Conclusiones

  • ¡Gran variedad de idiomas disponibles! 36 opciones a disposición cubren un espectro muy amplio de opciones listas para usar.
  • ¡Flexibilidad! Seleccionar entre un idioma u otro, o incluso utilizar el idioma configurado localmente para el usuario es tan simple como agregar un parámetro extra en la URL de conexión.

Próximos pasos…

En la parte 2 de este artículo te voy a contar cómo traducir atributos de usuario personalizados. ¡¡¡No te lo pierdas!!!

Si necesitas asesoramiento o ayuda, si tenés dudas o no sabes cómo comenzar, o te interesa conocer/aprender sobre otros servicios de Azure, contáctame y vemos juntos como encontrar la solución que necesitas.

Azure AD B2C: Personalizando nuestra marca

Este post forma parte de una serie de artículos donde estaré compartiendo todo lo necesario para utilizar, configurar y sacar el mayor provecho de Azure AD B2C.

Continuando con lo que vimos en el post anterior, donde configuramos y personalizamos los atributos de usuario, te contaré cómo personalizar el estilo del flujo de usuario para aplicarle nuestra marca y lucir nuestros logos y fondos de pantalla.

IMPORTANTE: vamos a construir sobre la base del post anterior, con lo cual es recomendable tener claros los conceptos y pasos allí detallados.

Contexto y Requerimientos

Cuando se trata de una plataforma web, ya sea un e-commerce, un blog o una página de presentación, uno de los aspectos más importantes es la identidad del sitio. Esto se suele ver reflejado a través de la paleta colores, logotipos y fondos de pantalla (backgrounds).

Inicio de sesión estándar
Inicio de sesión estándar

Hasta el momento las páginas de Inicio de Sesión y Registro tienen el estilo estándar que Azure AD B2C provee, el cual no tiene ninguna relación con la identidad de nuestro sitio web.

Es por eso que uno de los primeros requerimientos a satisfacer para una salida a producción aceptable es aplicar nuestros logos y fondos (backgrounds), de forma que los usuarios no perciban diferencia alguna entre Azure AD B2C y el sitio original.

En este post nos vamos a enfocar en los aspectos básicos del diseño, como son los logos y el fondo de pantalla. En futuros posts, veremos cómo podemos crear algo totalmente personalizado, incluyendo HTML y CSS.

Personalización

Ahora sí, hagamos lo que más nos gusta y pongamos las manos a trabajar.

Personalizar marca de empresa
Personalizar marca de empresa

Para comenzar debemos dirigirnos a la sección de Personalización de marca de empresa. Si es la primera vez que accedemos, veremos la opción Configurar. Si ya tenemos configuradas personalizaciones, veremos como opción Nuevo idioma. Esto se debe a que podemos tener tantas personalizaciones como idiomas disponibles, por ejemplo, el fondo de pantalla podría contener texto específico según el idioma del usuario.

Sobre la derecha veremos un panel para configurar cada elemento disponible. Veamos de que se trata cada uno.

Elementos

Configurar personalización de marca
  1. Idioma: Si es la primera personalización que realizamos esta opción estará deshabilitada con el texto Predeterminado, de lo contrario podremos seleccionar de una lista el idioma correspondiente.
  2. Imagen de fondo: Es el fondo de pantalla. Prestar especial atención a las características que debe tener: 1920 x 1080, tamaño máximo de 300 KB y en formato .png, .jpg o .jpeg.
  3. Logotipo/Banner: Imagen para mostrar en la pantalla de inicio de sesión y registro. Características: 280 x 60, tamaño máximo de 10 KB y en formato .png, .jpg o .jpeg.
  4. Sugerencia del nombre de usuario: Este campo lo dejaremos vacío ya que no lo usaremos, es de utilidad cuando utilizamos nombre de usuario en lugar de email para registrar usuario.
  5. Texto de la página de inicio de sesión: Este campo lo dejaremos vacío ya que no lo usaremos, es de utilidad para usuarios de Windows 10 y Azure AD.
  6. Color de fondo de la página de inicio de sesión: Es el color a utilizar en caso de que las imágenes no puedan ser cargadas (por ejemplo, por problemas de conexión).
  7. Imagen de logotipo cuadrado: Este campo lo dejaremos vacío ya que no lo usaremos, es de utilidad para usuarios de Windows 10 y Azure AD.
  8. Imagen de logotipo cuadrado, tema oscuro: Este campo lo dejaremos vacío ya que no lo usaremos, es de utilidad para usuarios de Windows 10 y Azure AD.
  9. Mostrar la opción para mantener la sesión iniciada: Este campo lo dejaremos con su valor por defecto, es de utilidad para usuarios de Windows 10 y Azure AD.

Validación

Flujo de validación de cambios
Flujo de validación de cambios

Ya estamos listos para validar los cambios que realizamos. Para esto tenemos que navegar hasta la sección Flujos de usuario, seleccionar el flujo de usuario que creamos cuando dimos los primeros pasos y finalmente ejecutar la opción Ejecutar flujo de usuario.

Sobre el panel que se despliega a la derecha, presionamos el botón para ejecutar con las opciones por defecto.

Inicio de sesión actualizado

¡¡¡Increíble!!! Nuestra página de inicio de sesión ahora luce con un estilo propio haciendo que la experiencia de usuario sea mucho más natural y fluida.

Estamos muy cerca de tener una versión productiva, con estilo propio y con atributos de usuario a nuestra medida y necesidad. Solo nos queda un sólo tópico para analizar (por ahora) y son las plantillas predeterminadas.

Plantillas predeterminadas

Azure AD B2C ofrece 3 plantillas predeterminadas listas para usar. Estas plantillas mantienen el mismo estilo (fondo de pantalla y logotipo) que vimos en el apartado anterior, pero cambian (sutilmente) cuestiones de diseño como la orientación y el estilo de los controles como cuadros de texto y botones.

Selección de plantilla
Selección de plantilla

Para seleccionar cambiar o configurar el estilo de plantilla predeterminado, debemos navegar hasta la sección Diseños de Página del Flujo de Usuario y luego clicar sobre la acción Plantilla. Sólo basta con seleccionar la plantilla deseada y esperar a que se apliquen los cambios.

Comparemos los 3 estilos disponibles:

Azul Océano
Azul Océano
  • Azul océano: Esta es la plantilla predeterminada y por consiguiente la más utilizada. Es posiblemente la más moderna.
Gris pizarra
  • Gris pizarra: Muy similar a la plantilla anterior, cambia un poco el ordenamiento y el estilo de los campos de entrada de texto.
Clásico
Clásico
  • Clásico: Esta plantilla fue la primera (y en un comienzo la única) disponible. Responde al antiguo estilo de las plataformas de Microsoft/Azure.

Estas tres plantillas son las que están disponibles al momento de escribir el artículo, pero como todos los productos de Azure, se encuentran en continua mejora. Es posible que se agreguen o eliminen plantillas en el futuro.

Conclusiones

  • ¡Diseños simples y aceptables! A pesar de que los cambios que realizamos son muy básicos, con solo unos clics podemos darle identidad a nuestra experiencia de usuarios.
  • ¡Sin necesidad de HTML ni CSS! Si bien en muchos casos vamos a necesitar aplicar un diseño mucho más personalizado utilizando HTML, CSS y hasta quizás JavaScript, solo con un par de imágenes son suficientes para tener un MVP (Mínimo Producto Viable) o incluso una primer versión productiva de nuestra aplicación

Próximos pasos…

En el próximo artículo te voy a contar cómo configurar distintos idiomas, incluyendo las traducciones para los atributos de usuario personalizados adicionales como Nivel de Inglés y Experiencia. ¡¡¡No te lo pierdas!!!

IMPORTANTE: a modo de ejemplo, tomé dos imágenes de la web que en principio son libres y no tienen derecho de autor. Si no es así y crees que el autor podría no autorizar su uso, te invito a que me dejes un mensaje para solicitar la autorización pertinente o indicarme dejar de utilizar las imágenes cuanto antes.

© 2021 Facu The Rock

Tema por Anders NorenArriba ↑