Lokalisierung und Übersetzung von Workflow-Status-Labels

Die Lokalisierung steuert die menschenlesbaren Bezeichnungen für die Workflow-Status und Beleg-Typen von Belegen. Die internen Schlüssel bleiben stabil, während Sie den sichtbaren Text je Sprache übersetzen, mit einem automatischen Rückgriff auf die Standardsprache, wenn eine Übersetzung fehlt. Dieser Artikel erläutert den Bezeichnungskatalog und den Aktualisierungsablauf.

Erforderliche Berechtigung

Das Lesen von Bezeichnungen erfordert settings:manage. Das Speichern von Bezeichnungen erfordert außerdem settings:manage und die Rolle SystemAdmin — eine benutzerdefinierte Rolle, die nur die Berechtigung besitzt, erhält beim Speichern eine 403-Antwort (UNAUTHORIZED).

Was übersetzt werden kann

Der Katalog umfasst zwei Gruppen stabiler interner Schlüssel:

Workflow-Status: Draft, Submitted, In Review, Needs Clarification, Rejected, Approved und Paid.
Beleg-Typen: fuel, maintenance_repair, toll, insurance, leasing, parking, washing und other.

Sie übersetzen die Bezeichnung; Sie ändern niemals den Schlüssel. Regeln, Übergänge und Berichte verwenden weiterhin die internen Schlüssel, sodass eine übersetzte Bezeichnung rein darstellend ist.

Standardsprache und Rückgriff

Die Standardsprache ist Englisch (en). Wenn Sie Bezeichnungen für eine Sprache anfordern, gibt die Plattform die angeforderte Übersetzung für jeden Schlüssel zurück. Hat ein Schlüssel keine Übersetzung in dieser Sprache, greift sie auf die Standardbezeichnung zurück; gibt es auch keinen Standard, greift sie auf den rohen Schlüssel zurück. Wann immer ein Rückgriff verwendet wird, enthält die Antwort die Meldung "Translation unavailable, showing default", damit Sie wissen, dass einige Bezeichnungen noch nicht lokalisiert sind.

Hinweis: Sprachcodes werden auf die neutrale Sprache normalisiert. Eine Anfrage für de-DE wird als de behandelt, sodass Sie einen deutschen Satz pflegen statt eines pro Region.

Bezeichnungen aktualisieren

Öffnen Sie den Lokalisierungsbereich der Belege-Konfiguration (unter /admin/belege-configuration).
Wählen Sie die Sprache aus, die Sie bearbeiten.
Geben Sie für jeden Schlüssel die übersetzte Bezeichnung ein.
Markieren Sie einen Eintrag als Standard, wenn er als Rückgriff für andere Sprachen dienen soll.
Speichern. Sie müssen mindestens eine Bezeichnung übermitteln.

Jeder übermittelte Eintrag trägt einen internen Schlüssel, einen Sprachcode, eine Bezeichnung und ein optionales Standard-Kennzeichen. Vorhandene Einträge für denselben Schlüssel und dieselbe Sprache werden an Ort und Stelle aktualisiert; neue werden erstellt. Nur anerkannte Schlüssel werden akzeptiert — ein nicht unterstützter Schlüssel wird mit einem Validierungsfehler abgewiesen.

Tipp: Pflegen Sie zuerst einen vollständigen Standardsatz (Englisch). Da andere Sprachen auf den Standard zurückgreifen, garantiert ein vollständiger Standardsatz, dass kein Benutzer jemals einen rohen internen Schlüssel sieht.

Auditing

Jeder Speichervorgang erfasst Telemetriedaten und ein Audit-Ereignis (vom Typ localization-update), das mit der aktiven Konfigurationsversion verknüpft ist und festhält, wer die Änderung vorgenommen hat, wann und welche Einträge übermittelt wurden. Dies gibt Ihnen einen nachvollziehbaren Verlauf von Bezeichnungsänderungen neben Konfigurationsänderungen.

Warnung: Wenn der Lokalisierungsspeicher nicht verfügbar ist, geben Lese- und Schreibvorgänge einen 503 mit "Localization store is not available" zurück. Das bedeutet in der Regel, dass das zugrunde liegende Schema noch nicht bereitgestellt wurde; wenden Sie sich an Ihren Plattformadministrator, statt es erneut zu versuchen.