Schedule-Trigger

Mit dem Schedule-Trigger können Sie die Integration in bestimmten Zeitintervallen ausführen. Dieser Trigger ist hilfreich, wenn Sie Ihre Integration automatisch, also ohne manuellen Eingriff ausführen möchten. Schedule-Trigger können Sie beispielsweise für folgende Aufgaben verwenden:

  • Dateien in regelmäßigen Abständen von einem System auf ein anderes hochladen
  • Regelmäßige E-Mail-Erinnerungen senden
  • Datenbank in regelmäßigen Abständen synchronisieren

Vorbereitung

Achten Sie darauf, dass Sie dem Apigee Service Agent ( service-PROJECT_ID @gcp-sa-apigee.iam.gserviceaccount.com ) in Ihrem Google Cloud-Projekt die IAM-Rolle Aufrufer von Apigee-Integrationen zuweisen.

Weitere Informationen zum Zuweisen von IAM-Rollen finden Sie unter Zugriff in Google Cloud verwalten.

Schedule-Trigger hinzufügen

Führen Sie die folgenden Schritte aus, um einer neuen oder vorhandenen Integration einen Zeitplan-Trigger hinzuzufügen:
  1. Wählen Sie in der Apigee-Benutzeroberfläche Ihre Apigee-Organisation aus.
  2. Klicken Sie auf Entwickeln > Integrationen.
  3. Wählen Sie eine vorhandene Integration aus oder erstellen Sie eine neue Integration, indem Sie auf Integration erstellen klicken.

    Wenn Sie eine neue Integration erstellen, gehen Sie so vor:

    1. Geben Sie im Dialogfeld Integration erstellen einen Namen und eine Beschreibung ein.
    2. Wählen Sie eine Region für die Integration aus der Liste der unterstützten Regionen aus.
    3. Klicken Sie auf Erstellen.

    Dadurch wird die Integration auf der Seite Integrationsdesigner geöffnet.

  4. Klicken Sie in der Navigationsleiste Integrationsdesigner auf + Aufgabe/Trigger hinzufügen > Trigger, um die Liste der verfügbaren Trigger aufzurufen.
  5. Klicken Sie auf das Element Schedule-Trigger und platzieren Sie es im Designer.

Schedule-Trigger konfigurieren

Klicken Sie im Integrationseditor auf das Element Schedule-Trigger, um den Bereich für die Triggerkonfiguration aufzurufen.

Sie können den Schedule-Trigger mit einem der folgenden Modi konfigurieren:

  • Standard: Bietet eine Benutzeroberfläche, in der die Häufigkeit der Ausführung konfiguriert wird.
  • Erweitert: Verwendet einen Cron-Ausdruck, um die Häufigkeit der Ausführung zu konfigurieren.

Im Modus Standard können Sie auswählen, ob die Integration zu einem bestimmten Zeitpunkt oder in stündlichen Intervallen ausgeführt werden soll. Wenn Sie die Integration zu einem bestimmten Zeitpunkt ausführen möchten, wählen Sie im Drop-down-Menü Zeiten die Option Zu einem bestimmten Zeitpunkt ausführen aus und legen die folgenden Attribute fest:

  • Zeit: Die Zeit (im 24-Stunden-Format), zu der die Integration ausgeführt werden muss.
  • Tage: Die Tage, an denen die Integration ausgeführt werden soll. Sie können die Integration täglich, an bestimmten Wochentagen oder an einem bestimmten Tag im Monat ausführen.
  • Monate: Der/die Monat(e), in dem/denen die Integration ausgeführt werden muss. Sie können die Integration jeden Monat ausführen oder bestimmte Monate auswählen.

Im erweiterten Modus können Sie die Häufigkeit der Ausführung mit einem Cron-Ausdruck angeben. Der Cron-Ausdruck umfasst fünf Werte, die in der folgenden Reihenfolge angegeben werden müssen:

  • Minute (0–59)
  • Stunde (0–23)
  • Tag des Monats (1–31)
  • Monat (einer der folgenden Werte):
    • Eine Zahl (1–12)
    • Eine aus drei Buchstaben bestehende monatliche Abkürzung (z. B. Januar, Februar, März usw.)
  • Wochentag (einer der folgenden Werte):
    • Zahl von 0–6, beginnend mit Sonntag als 0
    • Eine Abkürzung aus drei Buchstaben (z.B. Mon, Die, Mit usw.)

Wenn Sie beispielsweise die Integration am ersten Tag jedes Monats ausführen möchten, verwenden Sie den Cron-Ausdruck * * 1 * *.

Best Practices

Deaktivieren Sie als Best Practice die Schedule-Trigger, wenn sie nicht mehr benötigt werden. Wenn Sie einen redundanten Schedule-Trigger aktiviert lassen, wird weiterhin automatisch die Integration ausgelöst.

Führen Sie einen der folgenden Schritte aus, um einen Schedule-Trigger zu deaktivieren:

  • Heben Sie die Veröffentlichung der Integration auf, die den Schedule-Trigger enthält. Die Integration ist dann nicht mehr aktiv und der Trigger wird nicht ausgeführt.
  • Ersetzen Sie den Schedule-Trigger durch einen anderen Trigger und veröffentlichen sie die Integration noch einmal. Die neu veröffentlichte aktive Version der Integration verwendet nicht den Schedule-Trigger.
  • Löschen Sie die aktuelle Version der Integration. Die Option Löschen finden Sie in der Versionsliste neben dem Namen der Integration.