Zum Inhalt springen

Internationalisierung und Lokalisierung im Jitterbit App Builder

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

Kultur

Die Lokalisierungsunterstützung des App Builders 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?

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

  1. Der App Builder versucht, die Kultur des Benutzers automatisch zu bestimmen. Der 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 Builders 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.

Kultur und Hintergrundjobs

Bei der Ausführung von Hintergrundjobs hängt die effektive Kultur davon ab, wie der Job in die Warteschlange gestellt 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 in die Warteschlange gestellt 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 der vorhandenen 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.

Datums- und Zeitformat überschreiben

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

Seit App Builder 4.60 können Administratoren dieses Verhalten überschreiben, indem sie systemweite Formatzeichenfolgen konfigurieren, die für alle Benutzer gelten, unabhängig von deren individueller 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 ihrem konfigurierten Kultur- oder Gebietsschema.

Formatzeichenfolgen

Systemweite Datums- und Zeitformate verwenden .NET-Formatzeichenfolgen, denselben Standard, der auch von kulturspezifischen Formaten 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 Daten- 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 Datum-Steuerung verwendet die bootstrap-datetimepicker Bibliothek, die eine andere Syntax für Formatzeichenfolgen als .NET erwartet. Der App Builder ordnet die konfigurierten .NET-Formatzeichenfolgen automatisch dem erwarteten Format der Bibliothek zu. Es sind keine zusätzlichen Konfigurationen erforderlich.

Konfigurationsschritte

Um systemweite Datums- und Zeitformate zu konfigurieren:

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

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

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

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

  5. Geben Sie die gewünschten Formatzeichenfolgen in Datumsformat überschreiben, Uhrzeitformat überschreiben und/oder Datum-Uhrzeit-Format überschreiben ein.

Hinweis

Diese Einstellungen werden in der Konfiguration des App Builders gespeichert und überstehen Upgrades. Dies ist der empfohlene Ansatz, um ein konsistentes Datumsformat für alle Benutzer anzuwenden, anstelle des vorherigen Workarounds, die Datenbank direkt zu ändern.

Bekannte Probleme und Einschränkungen

Accept-Language Qualitätswerte

Der Accept-Language-Header ermöglicht es Benutzeragenten, Sprachpräferenzen durch Zuweisung eines "Qualitätswerts" zu gewichten. 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.