Lokalisieren Ihrer Workload

Lokalisierung ist der Prozess der Anpassung eines Produkts an andere Märkte durch Ändern der Sprache oder des Inhalts. Durch die Lokalisierung Ihrer Workload können Sie eine breitere Zielgruppe erreichen und Ihren Kunden die beste, auf sie persönlich zugeschnittene Erfahrung bieten. Beispielsweise ist eine lokalisierte Workload für einen Benutzer attraktiver, dessen Standardsprache nicht englisch im Microsoft Fabric Workload Hub ist.

Die folgende Abbildung zeigt ein Beispiel für eine lokalisierte Workload im Workload Hub.

Bei einer Fabric-Workload umfasst die Lokalisierung zwei Aspekte:

• Übersetzen von Text innerhalb des iframes unabhängig von der Fabric-Shell mithilfe der Fabric-Portalsprache.

• Aktivieren der Übersetzung von Schlüsselwörtern, die in der Fabric-Shell verwendet werden, z. B. arbeitslastenname, Elementnamen und Workloadbeschreibungen. Diese Zeichenfolgen befinden sich derzeit direkt in den Manifestdateien (product.json und item.json).

  Eine Beschreibung aller lokalisierten Zeichenfolgen finden Sie weiter unten in diesem Artikel unter Lokalisierungsziele .

Unterstützte Sprachen

Fabric unterstützt derzeit die folgenden 44 Sprachen:~

Sie können auswählen, ob Sie einige oder alle diese Sprachen bereitstellen möchten. Die einzige erforderliche Sprache ist Englisch (USA), da es sich um die Standardsprache von Fabric handelt.

Paketstruktur

Alle Zeichenfolgen im Manifest müssen durch Schlüssel ersetzt werden. Ein Wert für jeden Schlüssel befindet sich in einer separaten Datei.

Beispiel: Wenn Ihr product.json Manifest zuvor wie folgt gestartet wurde:

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

Ihr product.json Manifest sollte nun etwa wie in diesem Beispiel aussehen:

{
    "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": {
        ...

Um die Lokalisierung zu unterstützen, muss Ihr Paket über die folgende Struktur verfügen:

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

Jeder Standort verfügt über einen eigenen Ordner unter assets/locales. Jedes Locale enthält eine einzelne Datei, translations.json. Diese Datei enthält ein Wörterbuch mit Schlüssel-Wert-Paaren. Beispielsweise könnte die Datei translations.json für Englisch Folgendes enthalten:

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

Dagegen könnte die Datei „translation.json“ für Spanisch Folgendes enthalten:

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

Standardverhalten

• Wie bereits erwähnt, ist Englisch die einzige erforderliche Sprache für eine lokalisierte Workload.
• Wenn eine Workload lokalisiert ist, müssen alle Lokalisierungsziele als Schlüssel in der Datei translations.json für Englisch bereitgestellt werden.
• Bei den anderen bereitgestellten Sprachen müssen nicht alle Schlüssel übersetzt werden. Alle Schlüssel, die nicht übersetzt werden, verwenden standardmäßig die bereitgestellte englische Übersetzung. Wenn Ihr Workloadname beispielsweise immer in Englisch sein soll, müssen Sie keine Übersetzung in einer anderen Sprache angeben.
• Fabric unterstützt lokalisierte und nicht lokalisierte Workloads. Wenn sich Bilddateien direkt im assets Ordner befinden, wird davon ausgegangen, dass die Arbeitsauslastung nicht lokalisiert ist.
• Damit eine Workload als lokalisiert behandelt werden kann, darf sie nur über zwei Unterverzeichnisse im assets Ordner verfügen: images und locales. Keine anderen Dateien können sich im Ordner assets befinden.

Lokalisierungsziele

Alle folgenden Eigenschaften werden lokalisiert: displayName, , fullDisplayName, displayNamePlural, description, , introduction, title, und tooltipslogan.

In den Produkt- und Elementmanifestdateien entsprechen diese Eigenschaften den folgenden Attributen:

Sprache des Fabric-Portals

Der workloadClient Code stellt eine API zum Abrufen der Workloadeinstellungen bereit, die die aktuelle Sprache des Fabric-Portals enthalten. Zum Beispiel:

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

Mit dem bereitgestellten currentLanguageLocale Code können Sie ihre Workload mithilfe eines beliebigen Frameworks lokalisieren. Das Beispiel-Workload-Repository verwendet beispielsweise die Bibliothek i18next, um den Inhalt einer Meldungsleiste zu übersetzen, die den Benutzer über die aktuelle Sprache benachrichtigt.