Localización de cargas de trabajo

La localización es el proceso de adaptación de un producto para atender a otros mercados cambiando el idioma o el contenido. La localización de cualquier carga de trabajo le permite no solo llegar a un público más amplio, sino también ofrece a sus clientes una experiencia personalizada inmejorable. Por ejemplo, una carga de trabajo localizada es más atractiva para un usuario cuyo idioma predeterminado no es inglés en el centro de cargas de trabajo de Microsoft Fabric.

En la imagen siguiente se muestra un ejemplo de una carga de trabajo localizada en el centro de cargas de trabajo.

Para una carga de trabajo de Fabric, la localización implica dos aspectos:

• Traducir texto dentro del iframe, independientemente del shell de Fabric, mediante el lenguaje del portal de Fabric.

• Habilitación de la traducción de palabras clave que se usan en el shell de Fabric, como el nombre de la carga de trabajo, los nombres de elementos y las descripciones de la carga de trabajo. Estas cadenas se encuentran actualmente directamente en los archivos de manifiesto (product.json y item.json).

  Para obtener una descripción de todas las cadenas que se han localizado, consulte los objetivos de localización más adelante en este artículo.

Idiomas compatibles

En la actualidad, Fabric admite los siguientes 44 idiomas:

Puede optar por proporcionar algunos o todos estos idiomas. El único idioma necesario es inglés (EE. UU.), ya que es el idioma predeterminado de Fabric.

Estructura del paquete

Todas las cadenas del manifiesto deben reemplazarse por claves. El valor de cada clave se encuentra en un archivo independiente.

Por ejemplo, si el product.json manifiesto se iniciaba anteriormente de la siguiente manera:

{
    "name": "Product",
    "displayName": "Fabric Sample Workload",
    "fullDisplayName": "Fabric Sample Workload",
    "description": "Sample Workload Description",
    "favicon": "assets/briefcase.png",
    "icon": {
      "name": "assets/briefcase.png"
    },
    "homePage": {
...

El product.json manifiesto debe ser ahora algo parecido a este ejemplo:

{
    "name": "Product",
    "displayName": "Workload_Display_Name",
    "fullDisplayName": "Workload_Display_Name_Full",
    "description": "Workload_Description",
    "favicon": "assets/images/briefcase.png",
    "icon": {
      "name": "assets/images/briefcase.png"
    },
    "homePage": {
        ...

Para admitir la localización, el paquete debe tener la siguiente estructura:

FE/
└── assets/
    ├── images/
    |   └── # the images and icons that were previously under the assets folder directly
    └── locales/
        ├── en-US/
        |   └── translations.json
        ├── es/
        |   └── translations.json
        ├── de/
        |   └── translations.json
        ├── fr/
        |   └── translations.json
        └── # more locales

Cada localización tiene su propia carpeta dentro de assets/locales. Cada configuración regional contiene un único archivo, translations.json. Este archivo contiene un diccionario de pares clave-valor. Por ejemplo, el archivo translations.json de inglés podría contener:

{
    "Workload_Display_Name" : "Fabric Sample Workload",
    "Workload_Display_Name_Full" : "Fabric Sample Workload",
    "Workload_Description": "Sample Workload Description"
}

Mientras que el archivo translation.json de español podría contener:

{
    "Workload_Display_Name" : "Carga de trabajo de muestra",
    "Workload_Display_Name_Full" : "Carga de trabajo de muestra",
    "Workload_Description": "Descripción del producto"
}

Comportamiento predeterminado

• Como se indicó anteriormente, el único idioma necesario para las cargas de trabajo localizadas es el inglés.
• Si se localiza una carga de trabajo, todos los destinos de localización deben proporcionarse como claves en el archivo translations.json de inglés.
• Los restantes idiomas que se proporcionen no son necesarios para traducir todas las claves. Las claves que se dejan sin traducir tienen como valor predeterminado la traducción en inglés proporcionada. Por ejemplo, si el nombre de una carga de trabajo siempre debe estar en inglés, no es necesario proporcionar una traducción en ningún otro idioma.
• Fabric admite cargas de trabajo localizadas y no localizadas. Si algún archivo de imagen se encuentra directamente en la assets carpeta , se supone que la carga de trabajo no está localizada.
• Para que una carga de trabajo se trate como localizada, solo debe tener dos subdirectorios en la assets carpeta: images y locales. Ningún otro archivo puede estar en la assets carpeta .

Destinos de localización

Todas las siguientes propiedades están localizadas: displayName, fullDisplayName, displayNamePlural, description, introduction, title, tooltip y slogan.

En los archivos de manifiesto de producto y elemento, esas propiedades corresponden a los atributos siguientes:

Idioma del portal de Fabric

El workloadClient código proporciona una API para recuperar la configuración de la carga de trabajo, que contiene el idioma actual del portal de Fabric. Por ejemplo:

export async function callLanguageGet(workloadClient: WorkloadClientAPI): Promise<string> {
    const settings = await workloadClient.settings.get();
    return settings.currentLanguageLocale;
}

Con el código proporcionado currentLanguageLocale , puede continuar con la localización de la carga de trabajo mediante cualquier marco que desee. Por ejemplo, el repositorio de cargas de trabajo de ejemplo usa la biblioteca i18next para traducir el contenido de una barra de mensajes que notifica al usuario del idioma actual.