Zum Inhalt springen

Internationalisierung und Lokalisierung im Jitterbit App Builder

App Builder unterstützt Internationalisierung und Lokalisierung. Insbesondere kann App Builder Daten und numerische Werte in einem regionsspezifischen Format darstellen. Zum Beispiel kann App Builder das Datum 2023-05-16 für einen Benutzer in einer US-Englisch-Lokalisierung (en-US) als 5/16/2023 oder für einen Benutzer in einer deutschen Lokalisierung (de-DE) als 16.05.2023 darstellen.

Kultur

Die Lokalisierungsunterstützung von App Builder basiert auf dem Konzept der Kultur von Microsoft .NET. Eine Kultur bietet Regeln für die Datums- und Zahlenformatierung für eine bestimmte Region. Kulturen sind den IETF-Sprach-Tags zugeordnet.

Wie wird die Kultur des Benutzers bestimmt?

App Builder kann die bevorzugte Kultur des Benutzers auf eine der folgenden Arten bestimmen:

  1. App Builder versucht, die Kultur des Benutzers automatisch zu bestimmen. App Builder analysiert den Accept-Language-Header, der vom Browser bereitgestellt wird. Der Wert wird mit einer App Builder-Kultur abgeglichen.

  2. Die Kultur kann explizit im Benutzerkonto des App Builder festgelegt werden. Dies kann von einem Administrator oder von den Benutzern selbst erfolgen, wenn die Selbstbedienung aktiviert wurde.

  3. Der Benutzeragent kann die Kultur festlegen, indem er $culture={language-tag} an die URL-Abfragezeichenfolge anhängt.

  4. Wenn die Kultur auf andere Weise nicht bestimmt werden kann, wird die Standard-Systemkultur verwendet. Siehe Standardkultur festlegen.

Kultur und Hintergrundjobs

Bei der Ausführung von Hintergrundjobs hängt die effektive Kultur davon ab, wie der Job eingereiht wird.

  • Wenn der Job von einem Benutzer geplant wird (d.h. durch Klicken auf einen Button), wird die bevorzugte Kultur des Benutzers verwendet.

  • Wenn der Job nach einem Zeitplan eingereiht wird, wird die Kultur des Dienstbenutzerkontos verwendet.

Erweiterbarkeit

Kulturen werden von der Laufzeitumgebung definiert. Entwickler können keine neuen Kulturen registrieren. Entwickler können jedoch eine Liste vorhandener Kulturen abrufen, indem sie das öffentliche Datenobjekt Culture abfragen.

So überprüfen und bearbeiten Sie Sprache, Gebietsschema und Zeitzonen

  1. Öffnen Sie das Aktionsmenü.

  2. Klicken Sie auf Benutzerprofil anzeigen. Ein Dialog öffnet sich.

  3. Der Dialog zeigt Felder, in denen Sie die Einstellungen für Lokalisierung und Zeitzone bearbeiten können:

    localization.png

    Hinweis

    Wenn Sie Ihre Sprache aktualisieren, müssen Sie das Browserfenster aktualisieren, um die aktualisierten Informationen zu sehen.

Standardkultur festlegen

Standardmäßig verwendet der App Builder en-US als Systemkultur. Ab App Builder 4.61 können Administratoren dies auf jede unterstützte Kultur ändern.

Hinweis

Die Standardkultur gilt nur, wenn die Kultur eines Benutzers nicht auf andere Weise bestimmt werden kann. Sie überschreibt keine Kulturen, die auf einzelnen Benutzerkonten oder über die URL-Abfragezeichenfolge festgelegt sind.

Um die Standard-Systemkultur festzulegen:

  1. Melden Sie sich als Administrator beim App Builder an.

  2. Navigieren Sie zu IDE > Zusätzliche Einstellungen.

  3. Klicken Sie im Verwalten-Panel auf Parameter. Ein Dialog öffnet sich.

  4. Klicken Sie auf Mehr > Globale Datums-/Uhrzeitüberschreibung. Ein weiterer Dialog öffnet sich.

  5. Geben Sie ein IETF-Sprach-Tag im Feld Standardkultur ein (zum Beispiel pt-BR oder de-DE).

    default culture

Datums- und Zeitformat überschreiben

Standardmäßig formatiert der App Builder Daten und Zeiten gemäß den Kultur-Einstellungen jedes Benutzers.

Ab App Builder 4.60 können Administratoren dieses Verhalten überschreiben, indem sie systemweite Formatzeichenfolgen konfigurieren, die für alle Benutzer gelten, unabhängig von ihrer individuellen Kultur.

Hinweis

Systemweite Formatzeichenfolgen haben Vorrang vor kulturspezifischen Formaten. Wenn ein systemweites Format festgelegt ist, sehen alle Benutzer Daten und Zeiten in diesem Format, unabhängig von ihrer konfigurierten Kultur oder ihrem Gebietsschema.

Format-Strings

Systemweite Datum- und Uhrzeitformate verwenden .NET-Format-Strings, denselben Standard, der auch für kulturspezifische Formate verwendet wird. Die folgenden Einstellungen sind verfügbar:

Einstellung Beschreibung Beispielwert
DateFormat Format für Datumswerte. MM/dd/yyyy
TimeFormat Format für Zeitwerte. HH:mm:ss
DateTimeFormat Format für kombinierte Datum- und Zeitwerte. MM/dd/yyyy HH:mm:ss

Wenn eine Einstellung leer gelassen wird, fällt der App Builder auf das Format zurück, das durch die Kultur des Benutzers definiert ist.

Hinweis

Die Date-Steuerung verwendet die bootstrap-datetimepicker Bibliothek, die eine andere Syntax für Format-Strings als .NET erwartet. Der App Builder ordnet die konfigurierten .NET-Format-Strings automatisch dem erwarteten Format der Bibliothek zu. Es sind keine zusätzlichen Konfigurationen erforderlich.

Konfigurationsschritte

Um systemweite Datum- und Uhrzeitformate zu konfigurieren:

  1. Melden Sie sich als Administrator im App Builder an.

  2. Navigieren Sie zu IDE > Zusätzliche Einstellungen.

  3. Klicken Sie im Verwalten-Panel auf Parameter. Ein Dialog öffnet sich.

  4. Klicken Sie auf Mehr > Globale Datum/Uhrzeit-Überschreibung. Ein weiterer Dialog öffnet sich.

  5. Geben Sie die gewünschten Format-Strings in Datumformat überschreiben, Zeitformat überschreiben und/oder Datum-Uhrzeit-Format überschreiben ein.

Tipp

Diese Einstellungen werden in der App Builder-Konfiguration gespeichert und überstehen Upgrades. Dies ist der empfohlene Ansatz, um ein konsistentes Datumsformat für alle Benutzer anzuwenden, und ersetzt die vorherige Notlösung, die Datenbank direkt zu ändern.

Bekannte Probleme und Einschränkungen

Accept-Language Qualitätswerte

Der Accept-Language-Header ermöglicht es Benutzeragenten, Sprachpräferenzen zu gewichten, indem ein "Qualitätswert" zugewiesen wird. Der App Builder berücksichtigt den Qualitätswert nicht. Stattdessen verwendet der App Builder das erste Sprach-Tag.

Kalender

Der App Builder unterstützt nur den gregorianischen Kalender.