Zum Inhalt springen

Zeitzonen in Jitterbit App Builder

Übersicht

App Builder unterstützt die Anzeige von DateTime-Feldern in der lokalen Zeitzone des Benutzers. Die Time Zone-Einstellung in App Builder für eine Datenquelle sollte der Zeitzone der Datenquelle entsprechen. Normalerweise wird diese gleich wie die Zeitzone des Computers selbst eingestellt. In jedem Fall sollte die für eine Datenquelle festgelegte Zeitzone der erwarteten Zeitzone entsprechen, die bei der Ausführung einer Now()-Anweisung in der Datenbank zurückgegeben wird.

Vorsicht

Es wird empfohlen, dass der App Builder-Anwendungsserver und die Datenbankserver beide mit derselben Zeitzone konfiguriert sind. Diese Server müssen synchronisiert sein. Zukünftige Versionen von App Builder können sich weigern zu starten, wenn die Uhren zwischen dem Anwendungsserver und dem Datenbankserver nicht synchronisiert sind.

Konfiguration

Es gibt zwei Orte, an denen eine Time Zone konfiguriert werden kann:

  1. Data Source Server
  2. Data Source

Die Time Zone-Einstellung verwendet IANA-Zeitzonen (z. B. America/New_York).

Data Source Server

Durch die Konfiguration einer Data Source Server Time Zone werden alle neu erstellten Data Sources auf diesem Server mit derselben Time Zone konfiguriert. Vorhandene Data Sources sind nicht betroffen.

Konfigurationsschritte

  • Navigiere zu IDE > Data Servers
  • Suche deinen Data Server und klicke auf die entsprechende Schaltfläche Details
  • Gehe zu More > Edge Case
  • Klicke auf Edit
  • Konfiguriere die Default Data Source Time Zone
  • Klicke auf Save

Data Source

Durch die Konfiguration einer Time Zone auf einer Data Source werden alle DateTime-Felder gemäß der lokalen Zeitzone des Benutzers angezeigt.

Konfigurationsschritte

  • Navigiere zu IDE > Data Servers
  • Wähle den entsprechenden Data Server aus
  • Suche die entsprechende Data Source und klicke auf die entsprechende Schaltfläche Details
  • Klicke auf die Schaltfläche Advanced Settings
  • Klicke auf Edit
  • Wähle die entsprechende Time Zone aus
  • Klicke auf Save

Auswirkungen

Alle DateTime-Felder werden in der Zeitzone des Benutzers angezeigt, sobald eine Zeitzone auf einer Data Source festgelegt wurde. Dies wirkt sich auf Folgendes aus:

  • Tabellen-DateTime-Spalten.
  • Business Object DateTime-Spalten.
  • Regel-DateTime-Spalten (Bridges, CRUD, Validations, Webhooks usw.).
  • Seitensteuerelemente, die an eine der oben genannten DateTime-Spalten gebunden sind.
  • Dynamischer Results-Bildschirm für alle oben genannten.

Bei Business Objects und Rules wird die Time Zone der Ziel-Data Source befolgt.

Darüber hinaus berücksichtigen die DateTime-Felder von Full Audit und Audit Lite die Time Zone der Datenquelle. Dies kann zu einer Abweichung von historischen Daten führen. Um dies nahtloser zu handhaben, siehe die Funktion Date migration, die alle vorhandenen Daten in die neue Time Zone migriert.

Bestimmung der Zeitzone des Benutzers

App Builder folgt diesen Schritten in Prioritätsreihenfolge, um die Zeitzone des Benutzers zu bestimmen:

  1. Überprüfe zunächst, ob das Benutzerprofil eine Time Zone-Einstellung hat. Falls ja, verwende diese.
  2. Versuche andernfalls, die Time Zone-Einstellung des Browsers abzurufen.
  3. Versuche zuletzt, die Time Zone Offset-Einstellung des Browsers abzurufen.

Wenn keine der oben genannten Einstellungen verfügbar ist, wird die Zeitzone des Benutzers standardmäßig auf die Zeitzone des App Builder-Anwendungsservers eingestellt.

Wichtige Hinweise

  • Das Festlegen einer Time Zone wirkt sich nicht auf vorhandene Daten innerhalb einer Data Source aus. Wenn DateTime-Daten von einer Zeitzone in eine andere angepasst werden müssen (z. B. Audit-Daten), sollte stattdessen die Funktion Date migration verwendet werden.
  • Die Anpassung von DateTime-Daten an die Zeitzone des Benutzers ist eine rein oberflächliche Änderung. Daten, die an einen Client gehen, werden an die Time Zone des Benutzers angepasst. Daten, die von einem Client an den Server gesendet werden, werden vor der Ausführung von App Builder-Regeln wieder an die Time Zone des Servers angepasst.
  • Darüber hinaus werden DateTime-Daten, die von einer Data Source zu einer anderen CRUD'ed werden, überhaupt nicht angepasst. Auch dies ist rein eine oberflächliche Änderung, die nur die vom Client gesehene DateTime beeinflusst.
  • Beachte, dass der dynamische Results-Bildschirm durch die Time Zone-Einstellung beeinflusst wird. Dies bedeutet, dass ein Entwickler möglicherweise eine andere DateTime im App Builder Results-Bildschirm sieht als in einem direkten Datenbankviewer wie SQL Server Management Studio.

Fehlerbehebung

Weitere Informationen zur Fehlerbehebung finden Sie in der App Builder-Fehlerbehebungsanleitung: