Unterstützung mehrerer Sprachen in D3 Visualisierung Dashboard
Die Erweiterung D3 Visualization unterstützt mehrere Sprachen, sodass Zeichenfolgeparameter in der Konfigurationsdatei eines Dashboards, wie Diagrammtitel und Fehlermeldungen, für bestimmte Sprachen oder Umgebungen lokalisierbar sind. Konfigurationstexte, z.B. die Daten, die die Legende eines Steuerelements befüllen, können nicht über die Konfigurationsdatei übersetzt werden, da die Daten vom zugehörigen WSI an das Dashboard übergeben werden. Die Applikation D3 Visualisierung stellt mehrere Sprachdateien bereit, Sie können aber auch bei Bedarf eigene Dateien erstellen.
Die Unterstützung mehrerer Sprachen wird wie folgt erreicht:
- Mit einer im Ordner i18n befindlichen JSON-Ressourcendatei mit Schlüssel-Wert-Paaren und
- durch Angabe des Sprachkulturnamens (en-US, de-DE, ar-AE, usw.):
- Ein D3 Visualisierung Dashboard in Desigo CC gehostet - Die Standard-Ländereinstellung des angemeldeten Benutzers wird angewendet.
- Ein D3 Visualisierung Dashboard in einem Browser gehostet - Der sprachspezifische Parameter &Local=[language-code] muss der URL der Datei
dashboardconfig.JSONwie folgt manuell hinzugefügt werden:Dashboardconfig.JSON&local=fr-CA
JSON-Datei mit Schlüssel-Wert-Paar
Zeichenfolgenparameter in der Konfigurationsdatei eines Dashboards werden einem "Schlüssel" in der zugehörigen sprachspezifischen JSON-Datei mit dem Schlüssel-Wert-Paar (KVP - Key-Value Pair) zugeordnet. In der Sprachdatei ist der Schlüssel mit einem "Wert" verknüpft. Wenn die Konfigurationsdatei auf einen gültigen Schlüsseleintrag trifft, wird der Wert dieses Schlüssels auf den Parameter angewendet und im Dashboard angezeigt. KVP-Dateien werden unter Verwendung von Konventionen für den Sprachkulturnamen als JSON-Dateien gespeichert, z.B. en-US.JSON, fr-CA.JSON, usw.
Sie haben beispielsweise ein Dashboard und möchten die Diagrammtitel für einen französisch-kanadischen Benutzer lokalisieren:
- In der Konfigurationsdatei des D3 Visualisierung Dashboards ist im Abschnitt Stil der folgende
ChartTitle-Parameter für ein Balkendiagramm folgendermassen zugeordnet: ChartTitle = “BARChartTitle”- In einer bestehenden KVP-Datei
fr-CA.JSONist der Schlüssel (“BARChartTitle”) mit dem Wert verknüpft (“Barre vertical Chart”): “BarChartTitle”: “Barre Verticale Chart”
Dementsprechend zeigt das Dashboard den Balkendiagrammtitel für den Benutzer in Französisch an: Barre Verticale Chart.
Wenn die Website in Desigo CC gehostet wird, wird die Länderauswahl des angemeldeten Benutzers automatisch für alle Zeichenfolgenparameter ausgewählt.
Speicherort der KVP-Dateien
Für die am häufigsten verwendeten Zeichenfolgenparameter stehen mehrere Standard-KVP-Sprachdateien zur Verfügung. Wenn die Datei für eine bestimmte Sprache fehlt, muss die KVP-Datei erstellt werden.
In der Systemmanagement-Konsole (SMC) hat jede Dashboard-Applikation eine Dateistruktur, die auf der Website bereitgestellt wird, und alle KVP-Dateien müssen sich in der folgenden Dashboard-Ressourcendatei i18n befinden:
Project> [Project Name] > Websites> [Website Name] > [Dashboard Name]> i18n> [Language-Culture-Name.JSON]
KVP-Datei mit einer Dashboard-Konfigurationsdatei verknüpfen
In Desigo CC wird die Standard-Sprachkultureinstellung des angemeldeten Benutzers angewendet. Wenn die Dashboard-Applikation in einem Browser angezeigt wird, muss der den Sprachcode festlegende Parameter &Local=[language-code] der URL der Datei dashboardconfig.JSON manuell hinzugefügt werden.
Zum Beispiel:
Dashboardconfig.JSON&local=fr-CA
Beispiel einer KVP-Datei
Im Ordner i18n werden zwei beispielhafte KVP-Dateien bereitgestellt, die zur Lokalisierung der Zeichenfolgeneigenschaften einer Dashboard-Applikation verwendet werden können.
Kopieren Sie den Text aus der Beispieldatei und fügen Sie ihn in eine Textdatei ein, um eine eigene länderspezifische JSON-Datei zu erstellen.