Localize sua carga de trabalho

A localização é o processo de adaptação de um produto para atender a outros mercados alterando o idioma ou o conteúdo. Localizar sua carga de trabalho permite que você alcance um público-alvo mais amplo e ofereça aos seus clientes a melhor experiência, mais personalizada. Por exemplo, uma carga de trabalho localizada é mais atraente para um usuário cujo idioma padrão não é inglês no hub de carga de trabalho do Microsoft Fabric.

A imagem a seguir mostra um exemplo de uma carga de trabalho localizada no hub de carga de trabalho.

Para uma carga de trabalho do Fabric, a localização envolve dois aspectos:

• Traduzindo texto no iframe, independentemente do shell do Fabric, usando a linguagem do portal do Fabric.

• Habilitando a tradução de palavras-chave que são usadas no shell do Fabric, como o nome da carga de trabalho, os nomes dos itens e as descrições da carga de trabalho. Atualmente, essas cadeias de caracteres são encontradas diretamente nos arquivos de manifesto (product.json e item.json).

  Para obter uma descrição de todas as cadeias de caracteres localizadas, consulte os destinos de Localização mais adiante neste artigo.

Idiomas com suporte

O Fabric atualmente oferece suporte aos seguintes 44 idiomas:

Você pode optar por fornecer alguns ou todos esses idiomas. O único idioma necessário é inglês (EUA), pois é o idioma padrão do Fabric.

Estrutura do pacote

Todas as cadeias de caracteres no manifesto devem ser substituídas por chaves. Um valor para cada chave está em um arquivo separado.

Por exemplo, se o product.json manifesto tiver sido iniciado anteriormente da seguinte maneira:

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

Seu product.json manifesto agora deve ser algo semelhante a este exemplo:

{
    "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 dar suporte à localização, seu pacote deve ter a seguinte estrutura:

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 localidade tem sua própria pasta em assets/locales. Cada localidade contém um único arquivo. translations.json Esse arquivo contém um dicionário de pares chave/valor. Por exemplo, o arquivo translations.json para o inglês pode conter:

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

Enquanto o arquivo translation.json para o espanhol pode conter:

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

Comportamento padrão

• Conforme declarado anteriormente, o único idioma obrigatório para uma carga de trabalho localizada é o inglês.
• Se uma carga de trabalho for localizada, todos os destinos de localização deverão ser fornecidos como chaves no arquivo translations.json para o inglês.
• Não é necessário traduzir todas as chaves nos outros idiomas fornecidos. Qualquer chave que não seja traduzida utilizará, por padrão, a tradução em inglês fornecida. Por exemplo, se o nome da sua carga de trabalho deve sempre estar em inglês, não é necessário fornecer uma tradução em nenhum outro idioma.
• O Fabric dá suporte a cargas de trabalho localizadas e não localizadas. Se algum arquivo de imagem estiver diretamente na assets pasta, a suposição é que a carga de trabalho não estácalizada.
• Para que uma carga de trabalho seja tratada como localizada, ela deve ter apenas dois subdiretórios na assets pasta: images e locales. Nenhum outro arquivo pode estar na assets pasta.

Destinos de localização

Todas as seguintes propriedades são localizadas: displayName, , fullDisplayName, displayNamePlural, description, , introduction, title, , tooltipe slogan.

Nos arquivos de manifesto do produto e do item, essas propriedades correspondem aos seguintes atributos:

Idioma do portal do Fabric

O workloadClient código fornece uma API para recuperar as configurações de carga de trabalho, que contêm o idioma atual do portal do Fabric. Por exemplo:

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

Com o código fornecido currentLanguageLocale , você pode continuar a localizar sua carga de trabalho usando qualquer estrutura desejada. Por exemplo, o repositório de carga de trabalho de exemplo usa a biblioteca i18next para traduzir o conteúdo de uma barra de mensagens que notifica o usuário do idioma atual.