Betriebspläne im Jitterbit Integration Studio

Einführung

Jeder Operation kann so konfiguriert werden, dass er automatisch ausgeführt wird, indem ein Zeitplan angewendet wird. Zeitpläne enthalten Informationen darüber, wann ein Operation automatisch aktiviert wird. Sie können praktisch jeden Zeitplantyp definieren, den Sie benötigen, z. B. jeden Freitag um 17 Uhr, den letzten Freitag jedes Quartals oder jede Stunde eines einzelnen Tages.

Wenn für einen nach einem Zeitplan ausgeführten Operation Vorgangsaktionen konfiguriert sind werden auch sämtliche nachlegende Operationen entsprechend ausgeführt.

Zeitpläne können direkt erstellt und angewendet werden in Integration Studio, wie auf dieser Seite beschrieben, oder sie können über die Projekte erstellt und angewendet werden in der Management Console, wo Sie auch eine Liste aller Zeitpläne sehen können, die den Vorgängen innerhalb eines Projekts zugewiesen sind, oder Zeitpläne aktivieren oder deaktivieren können.

Wenn Sie einen Zeitplan bereitstellen, der bereits in der Harmony Cloud bereitgestellt wurde, werden Ihnen Optionen zur Auswahl der zu verwendenden Zeitpläne angezeigt. Dies wird unter Zeitpläne und Projektvariablen auswählen beschrieben in Projektbereitstellung.

Zu den weiteren Möglichkeiten zum Ausführen von Vorgängen gehören das manuelle Ausführen von Vorgängen oder die Verwendung eines API Triggers, wie unter Bereitstellung und Ausführung von Vorgängen beschrieben.

Einen neuen Zeitplan erstellen oder einen vorhandenen Zeitplan öffnen

Auf Betriebspläne kann über den Projektbereich, die Operation oder die Design-Canvas zugegriffen werden, je nachdem, ob Sie einen neuen Zeitplan erstellen oder einen vorhandenen Zeitplan bearbeiten. Nachdem Sie einen Zeitplan erstellt oder einen vorhandenen Zeitplan zum Bearbeiten geöffnet haben, lesen Sie Operation konfigurieren weiter unten auf dieser Seite zur Konfiguration.

Ein neuer Zeitplan kann über die Tab Komponenten des Projektbereichs mithilfe der Option Neu erstellen in der Kategorie Zeitpläne erstellt werden (siehe Aktionsmenü der Tab Komponenten im Projektbereich Tab Komponenten). Neue Zeitpläne werden mit dem Standardnamen Neuer Zeitplan erstellt. Nachfolgende neue Zeitpläne mit Standardnamen werden mit einer in Klammern angehängten Nummer versehen.

Ein bestehender Zeitplan kann über die Tab Komponenten des Projektfensters mithilfe der Option Anzeigen/Bearbeiten einer Zeitplankomponente bearbeitet werden (siehe Aktionsmenü im Projektbereich Tab Komponenten).

Um einen vorhandenen Zeitplan zu bearbeiten, der bereits einer Operation zugewiesen ist, klicken Sie auf das Zeitplansymbol in der Operation, um die Tab Zeitpläne der Operation anzuzeigen.

Auf die Tab Zeitpläne der Operation Einstellungen kann auch von diesen Orten aus zugegriffen werden:

• Die Tab Workflows im Projektbereich (siehe Aktionsmenü Komponentenaktionen im Projektbereich Tab Workflows).
• Die Tab Komponenten des Projektbereichs (siehe Aktionsmenü der Tab „Komponenten“ und Aktionsmenü im Projektbereich Tab Komponenten).
• Die Design-Canvas (siehe Aktionsmenü „Komponentenaktionen“ in Entwurfsfläche).

Konfigurieren von Operation

Auf der Tab Zeitpläne der Operation können vorhandene Zeitpläne, die entweder in Integration Studio oder in der Management Console können auf Vorgänge angewendet werden. Von hier aus können Sie auch neue Zeitpläne erstellen, vorhandene Zeitpläne bearbeiten und Zeitpläne von Vorgängen trennen. Jede Option wird unten beschrieben.

• Bedingung: Das erste Menü sollte bereits die Auswahl Nach Zeitplan anzeigen, was darauf hinweist, dass die Bedingung, unter der der Operation ausgelöst wird, ein Zeitplan ist. Derzeit können keine anderen Bedingungen festgelegt werden.

• Zeitplan: Verwenden Sie dieses Menü, um den vorhandenen Zeitplan auszuwählen, den Sie auf den Operation anwenden möchten. Wenn der Zeitplan, den Sie verwenden möchten, noch nicht vorhanden ist, klicken Sie auf den Link Neuen Zeitplan erstellen, um einen neuen Zeitplan zu erstellen. Diese Option wird weiter unten erläutert.

• Zuweisen: Klicken Sie auf Zuweisen, um den ausgewählten Zeitplan auf die Operation anzuwenden. Beachten Sie, dass auf jede Operation nur ein Zeitplan angewendet werden kann und dass der zugewiesene Zeitplan erst wirksam wird, wenn das Projekt bereitgestellt wurde.

  Wenn einem Operation ein Zeitplan zugewiesen ist, werden die Felder Zeitplan, Zuweisen und Neuen Zeitplan erstellen durch Optionen zum Festlegen der Zeitplanrichtlinie und eine Zusammenfassung des zugewiesenen Zeitplans ersetzt. Darüber hinaus wird ein Auf der Design-Canvas des Operation wird ein Zeitplansymbol angezeigt. Wenn Sie darauf klicken, wird der Bildschirm mit den Operation erneut geöffnet.

  Tipp

  Wenn Sie einen Zeitplan auf eine Operation anwenden, empfiehlt es sich, eine Bei Fehler-Operation festzulegen, um eine Email Benachrichtigung zum geplanten Operation auszulösen.

  

• Planungsrichtlinie: Legen Sie die Planungsrichtlinie fest, entweder Immer ausführen oder Überspringen, wenn bereits ausgeführt:

  • Immer ausführen: Wählen Sie diese Option aus, um den Operation planmäßig auszuführen, falls ein vorheriger Operation noch ausgeführt wird. Diese Option sollte nur ausgewählt werden, wenn Sie eine besondere Anforderung haben. Wenn Sie diese Option verwenden, stellen Sie sicher, dass parallele Vorgänge nicht nachteilig sind, indem möglicherweise dieselben Quelldatensätze mehrfach verarbeitet werden.

  • Überspringen, wenn bereits ausgeführt: Wählen Sie diese Option aus, um eine geplante Ausführung des Operation zu überspringen, falls eine vorherige Ausführung desselben Operation noch ausgeführt wird (Standard).

• Zugewiesener Zeitplan: Wenn einem Operation ein Zeitplan zugewiesen ist, wird eine Zusammenfassung des zugewiesenen Zeitplans mit diesen Optionen angezeigt:

  • Bearbeiten: Um den zugewiesenen Zeitplan zu bearbeiten, klicken Sie auf das Bearbeiten-Symbol, um den Zeitplankonfigurationsbildschirm zu öffnen und die erforderlichen Änderungen vorzunehmen. Auf vorhandene Zeitpläne kann auch über den Projektbereich zugegriffen werden. Um einen Zeitplan auf der Tab Komponenten zu bearbeiten, bewegen Sie den Mauszeiger über den Zeitplannamen und klicken Sie dann auf das Klicken Sie auf das Aktionsmenü und wählen Sie im Menü Anzeigen/Bearbeiten aus.

    Notiz

    Wenn derselbe Zeitplan anderen Vorgängen zugewiesen wird, wirken sich die Änderungen auf den Zeitplan aller Vorgänge aus, denen er zugewiesen ist.

  • Entfernen: Um den Zeitplan von der Operation zu trennen, klicken Sie auf das Symbol „Entfernen“. Beachten Sie, dass der Zeitplan selbst nicht gelöscht wird, sondern lediglich die Zuordnung zum Operation aufgehoben wird.

• Neuen Zeitplan erstellen: Um einen neuen Zeitplan zu erstellen, klicken Sie auf den Link Neuen Zeitplan erstellen. Dadurch wird der Zeitplankonfigurationsbildschirm geöffnet.

  Notiz

  Der Zeitplan wird erst erstellt, nachdem Sie den neuen Zeitplan konfiguriert und gespeichert haben. Nachdem der Zeitplan erstellt wurde, müssen Sie ihn aus dem Menü Verfügbarer Zeitplan auswählen und auf Zuweisen klicken, um ihn auf den Operation anzuwenden.

  

  • Zeitplanname: Geben Sie einen Namen für den Zeitplan ein. Sie können dem Zeitplan einen Namen geben, der die Häufigkeit des Zeitplans widerspiegelt oder, wenn er für einen bestimmten Operation verwendet wird, den Zweck des Zeitplans widerspiegelt (z. B. „Alle 5 Minuten“ oder „Kontaktsynchronisierung“). Der Name darf nicht mit einem Leerzeichen beginnen oder enden.

  • Vorkommen: Wählen Sie über das Menü eine von drei Optionen für die Tage aus, an denen der Zeitplan die ihm zugewiesenen Operation einleiten soll:

    • Täglich: Der Zeitplan aktiviert den Operation jeden Tag oder alle paar Tage. Wenn diese Option ausgewählt ist, können folgende Felder konfiguriert werden:

      • Alle [#] Tage: Geben Sie die Anzahl der Tage zwischen den Operation ein.

    • Wöchentlich: Der Zeitplan aktiviert den Operation an einer bestimmten Anzahl von Wochentagen. Wenn diese Option ausgewählt ist, können folgende Felder konfiguriert werden:

      • Alle [#] Woche(n): Geben Sie die Anzahl der Wochen zwischen den Operation ein.
      • [So, Mo, Di, Mi, Do, Fr, Sa]: Klicken Sie, um den/die Wochentag(e) auszuwählen, an dem/denen der Operation ausgeführt werden soll. Es muss mindestens ein Tag ausgewählt werden.

    • Monatlich: Der Zeitplan aktiviert den Operation monatlich. Wenn diese Option ausgewählt ist, wählen Sie eine von zwei Optionen, die zur Konfiguration verfügbar werden:

      • Tag [#] jedes [#] Monats: Geben Sie den Tag des Monats und die Anzahl der Monate zwischen den Operation ein.
      • Der [1., 2., 3., 4. oder letzte] [Wochentag] jedes [#] Monats: Verwenden Sie die Menüs, um den Tag des Monats auszuwählen und geben Sie die Anzahl der Monate zwischen den Operation ein.

  • Häufigkeit: Wählen Sie eine von zwei Optionen für die Uhrzeiten aus, zu denen der Zeitplan den Operation an den Tagen, an denen er ausgeführt wird, starten soll:

    • Tritt einmal auf um [hh:mm:ss] [AM/PM]: Der Zeitplan aktiviert den Operation nur einmal zur angegebenen Zeit. Geben Sie die Zeit an, indem Sie Stunde und Minute eingeben (in HH:MM Format) und der Zeitraum (AM oder PM).

    • Tritt alle [#] [Minute(n)/Stunde(n)] auf, beginnt um [hh:mm:ss] [AM/PM] und endet um [hh:mm:ss] [AM/PM]: Der Zeitplan reaktiviert den Operation wiederholt für das angegebene Intervall und den angegebenen Zeitraum im Laufe des Tages. Geben Sie das Intervall und den Zeitraum an, auf den der Operation beschränkt sein soll. Geben Sie die Stunde und Minute (in HH:MM Format) und der Zeitraum (AM oder PM).

      Hinweis

      Zeitzonen werden weiter unten unter Betriebszeitzonen besprochen.

  • Dauer: Konfigurieren Sie die Dauer des Zeitplans.

    Notiz

    Start- und Enddaten in einem Zeitplan sind inklusiv, d. h. der Zeitplan ist während des verbleibenden Tages sowohl am Start- als auch am Enddatum aktiv.

    • Startdatum: Standardmäßig ist der Zeitplan ab dem aktuellen Datum aktiv. Wenn der Zeitplan an einem anderen Tag beginnen soll, wählen Sie mit der Datums-/Uhrzeitauswahl das gewünschte Startdatum aus.
    • Enddatum hinzufügen: Standardmäßig werden die Operation, denen der Zeitplan zugewiesen ist, gemäß dem Zeitplan unbegrenzt ausgeführt. Wenn Sie ein Enddatum angeben möchten, klicken Sie zuerst auf den Link Enddatum hinzufügen, um das Feld Enddatum hinzuzufügen. Verwenden Sie dann die Datums-/Uhrzeitauswahl, um ein Datum festzulegen, an dem der Zeitplan enden soll. Der Zeitplan ist bis zum Ende des Enddatums aktiv.
    • Enddatum entfernen: Dieser Link wird angezeigt, sobald das Feld Enddatum hinzugefügt wird. Um das Feld Enddatum zu entfernen, klicken Sie auf den Link zum Enddatum entfernen.

  • Speichern: Klicken Sie hier, um die Zeitplankonfiguration zu speichern und zu schließen.

Betriebszeitzonen

Beim Konfigurieren eines Zeitplans wird im Feld Häufigkeit nicht die Zeitzone angezeigt, in der der Operation ausgeführt wird. Die Zeitzone, in der der Operation ausgeführt wird, hängt vom Agenten ab, der den Operation ausführt, es sei denn, die Einstellung Zeitzone des Agent überschreiben ist in den Richtlinien Ihrer Organisation aktiviert:

• Zeitzone des Agent

  • Cloud-Agenten: Alle Cloud-Agenten sind in UTC.
  • Private Agenten: Die Zeitzonen privater Agenten werden durch die Zeitzone des Betriebssystems des privaten Agenten bestimmt. Es wird dringend empfohlen, dass alle Agenten in einer privaten Agentengruppe in derselben Zeitzone ausgeführt werden, da die Zeiten, zu denen ein konfigurierter Zeitplan den Operation initiiert, je nach verwendetem spezifischen Agenten möglicherweise unvorhersehbar sind.

  Wenn Sie den Agenten in der Version 10.85/11.23 oder höher verwenden und der Agent eine Zeitzone mit Sommerzeit nutzt, werden bei der Umstellung auf die Sommerzeit folgende Aktionen ausgeführt:

  • Wenn ein Zeitplan für einmal täglich zwischen 2 und 3 Uhr festgelegt ist, wird der geplante Operation am zweiten Sonntag im März um 3 Uhr ausgeführt.

  • Wenn ein Zeitplan für einmal täglich zwischen 1 und 2 Uhr festgelegt ist, wird der geplante Operation zum zweiten Mal um 1 Uhr am ersten Sonntag im November ausgeführt.

  Ein Bekanntes Problem existiert für die oben genannten Szenarien bei Verwendung der Agentenversion 10.84 / 11.22 und früher.

  Tipp

  Aus Gründen der Zeitplankonsistenz wird empfohlen, eine Zeitzone zu verwenden, in der keine Sommerzeit gilt, z. B. UTC (Cloud-Agenten verwenden standardmäßig UTC). Wenn Sie einen privaten Agenten verwenden, können Sie die Einstellung Zeitzone des geplanten Agent überschreiben verwenden und Etc/UTC auswählen.

• Zeitzone des Zeitplanagenten überschreiben

  • Wenn die Einstellung Zeitzone des Agent überschreiben in den Richtlinien Ihrer Organisation aktiviert ist, bestimmt die ausgewählte Zeitzone die Zeitzone, in der alle aktuellen und zukünftigen Zeitpläne einer Organisation ausgeführt werden.

Aktionsmenü planen“

Nachdem ein Zeitplan erstellt wurde, sind die Menüaktionen für diesen Zeitplan über die Tab Komponenten im Projektbereich zugänglich (siehe Aktionsmenü im Projektbereich Tab Komponenten).

Jede dieser Menüaktionen ist verfügbar:

Menüelement	Beschreibung
	Anzeigen/Bearbeiten öffnet den Zeitplan-Konfigurationsbildschirm (siehe Operation konfigurieren weiter oben auf dieser Seite). Hinweis Zeitplanänderungen wirken sich auf alle Vorgänge aus, denen sie zugewiesen sind.
	Ausschneiden legt eine Kopie des Zeitplans in Ihre Zwischenablage und löscht den ursprünglichen Zeitplan aus dem Projekt (siehe Komponentenwiederverwendung).
	Kopieren legt eine Kopie des Zeitplans in Ihre Zwischenablage (siehe Komponentenwiederverwendung).
	Duplicate erstellt einen neuen, nicht referenzierten Zeitplan mit der gleichen Konfiguration wie die Originalkomponente (siehe Komponentenwiederverwendung).
	Umbenennen positioniert den Cursor auf den Zeitplannamen, damit Sie bei Bedarf Änderungen vornehmen können.
	Abhängigkeiten anzeigen ändert die Ansicht im Projektbereich, um alle anderen Teile des Projekts anzuzeigen, von denen der Zeitplan abhängig ist (siehe Komponentenabhängigkeiten, Löschen und Entfernen).
	Zur Gruppe hinzufügen öffnet einen Dialog zum Erstellen einer neuen benutzerdefinierten Gruppe oder zum Hinzufügen des Zeitplans zu einer vorhandenen Gruppe (siehe Komponentengruppen).
	Löschen löscht den Zeitplan dauerhaft (siehe Komponentenabhängigkeiten, Löschung und Entfernung).
	Entfernen ist derzeit nicht funktionsfähig.

Verwenden von Scripts zum Planen von Vorgängen

Wenn die in der Benutzeroberfläche verfügbaren Optionen wie unter Operation konfigurieren beschrieben Ihren Anforderungen nicht entsprechen, können Sie mithilfe von Skripten komplexere Zeitpläne erstellen.

Ein gängiger Anwendungsfall könnte beispielsweise die Erstellung eines Zeitplans sein, um den Operation am letzten Tag des Monats auszuführen. Die folgenden Schritte erläutern diesen Anwendungsfall:

1. Operation erstellen mit einem einzelnen Script als Projektkomponente.

2. Konfigurieren Sie das Script als Jitterbit Script mit Script, die den letzten Tag des Monats prüft und bei „true“ eine Operation ausführt. Stellen Sie sicher, dass Sie die Operation durch die der Operation ersetzen, die Sie im Zeitplan ausführen möchten.

   <trans>
   if(DayOfMonth(LastDayOfMonth(Now()))==DayOfMonth(Now()),
   RunOperation("<TAG>operation:Scheduled Operation</TAG>");
   );
   </trans>
   

3. Erstellen Sie einen Zeitplan, der jeden Tag zur gewünschten Zeit ausgeführt wird, und wenden Sie ihn auf den Operation an, der das soeben erstellte Script enthält.

4. Sobald diese Schritte abgeschlossen sind, sollte die Operation ungefähr so aussehen:

   

Aktivieren oder Deaktivieren von Zeitplänen

Wenn Sie einen Zeitplan für eine Operation erstellen und anwenden, ist dieser standardmäßig aktiviert. Mithilfe der Management Console können Sie einen Zeitplan (sofern deaktiviert) remote über Projekte deaktivieren oder erneut aktivieren Seite.

Auf der Seite Projekte-Seite können Sie dies entweder über die Tab Operationen oder Zeitpläne tun, indem Sie den Schalter in der Spalte Operationsstatus verwenden, um einen Zeitplan für eine einzelne Operation zu aktivieren oder zu deaktivieren, oder indem Sie den Schalter in der Spalte Zeitplanstatus verwenden, um einen Zeitplan für alle Operationen zu aktivieren oder zu deaktivieren, auf die der Zeitplan angewendet wurde. Beachten Sie, dass das Deaktivieren eines Zeitplans auf Projektebene dazu führt, dass der Gültigkeitsstatus deaktiviert wird, auch wenn der Zeitplan für eine einzelne Operation aktiviert ist. Ausführliche Anweisungen finden Sie unter Projekte (Management Console).

Fehlerbehebung bei Zeitplänen

Wenn ein Zeitplan nicht wie erwartet funktioniert, überprüfen Sie bei der Fehlerbehebung die folgenden Punkte:

• Haben Sie die Operation ausgeführt, der der Zeitplan zugewiesen ist?
  In Integration Studio müssen Zeitpläne einer Operation zugewiesen und dann bereitgestellt werden, damit sie ausgelöst werden. Nachdem Sie einer Operation einen Zeitplan zugewiesen haben in Integration Studio, wird es erst wirksam, wenn es bereitgestellt wurde. (Im Gegensatz dazu werden Zeitpläne, die einem Operation über die Management Console zugewiesen werden, sofort wirksam, ohne dass das Projekt erneut in Harmony bereitgestellt werden muss.)

• Ist der Zeitplan aktiviert?
  Zeitpläne können nur innerhalb der Management Console deaktiviert und wieder aktiviert werden. Überprüfen Sie die Projekte-Seite in den Registerkarten Operationen und Zeitpläne, um sicherzustellen, dass der Zeitplan aktiviert ist.

• Wissen Sie, in welcher Zeitzone sich Ihr Zeitplan befindet?
  Zeitzonen werden in Zeitzonen für Operationen besprochen.

• Wenn Sie einen privaten Agenten verwenden, läuft der Planungsdienst?
  Überprüfen Sie auf dem Computer, auf dem der private Agent installiert ist, ob Jitterbit Scheduler und Jitterbit Scheduler Service ausgeführt werden. Unter Windows kann dies über den Task-Manager unter Prozesse überprüft werden. Verwenden Sie unter Linux und Docker die jitterbit status Befehl.

• Wenn Sie einen privaten Agenten verwenden, führen aggressive Zeitpläne zu einer Überlastung der Agentengruppe?
  Bei der Verwendung privater Agenten sollten zusätzliche Bewertungen durchgeführt werden, um sicherzustellen, dass zu viele Zeitpläne innerhalb eines kurzen Zeitraums die Agentengruppe nicht überlasten und so einen Operation verursachen.

  Private Agenten können standardmäßig bis zu zweimal so viele CPUs pro Agentenmaschine ausführen. Wenn die private Agentenmaschine beispielsweise über 4 CPU-Kerne verfügt, können Sie bis zu 8 Vorgänge gleichzeitig ausführen.

  Bei der Bewertung der Anforderungen können einige Vorgänge zeitabhängiger sein als andere. Wenn mehrere nicht kritische Vorgänge die Agentenwarteschlange verstopfen, können kritischere Vorgänge betroffen sein. Um dies zu vermeiden, ermitteln Sie die Anzahl der Vorgänge, die die Agentengruppe gleichzeitig verarbeiten kann (mithilfe der oben beschriebenen CPU-Zählberechnungen) und wägen Sie diese dann gegen die Geschäftspriorität und Laufzeit der geplanten Vorgänge ab.