Zum Inhalt springen

Bereitstellen und Ausführen einer Operation in Jitterbit Studio

Einführung

Diese Seite beschreibt, wie man Operationen in der Harmony-Cloud bereitstellt. Nachdem Sie eine Operation und ihre Abhängigkeiten bereitgestellt haben, können Sie diese Operationen ausführen. Sie können eine Operation mit bereits bereitgestellten Abhängigkeiten ausführen oder Abhängigkeiten automatisch zum Zeitpunkt der Ausführung bereitstellen lassen.

Für Informationen zur Behebung bestimmter Fehler, die bei der Ausführung einer Operation auftreten können, siehe Fehlerbehebung bei Operationen.

Visuelle Hinweise auf Operationen mit nicht bereitgestellten Änderungen

Operationen mit nicht bereitgestellten Änderungen zeigen zwei visuelle Indikatoren an:

  • Der Name der Operation erscheint in Blau im Komponenten-Tab des Projektfensters. Für weitere Informationen siehe Komponentenname im Projektfenster Komponenten-Tab.

  • Ein Nicht bereitgestellt-Symbol und eine blaue Unterstreichung erscheinen im unteren linken Bereich einer Operation.

Eine Operation bereitstellen

Sie können Operationen mit drei Methoden bereitstellen:

  • Bereitstellen: Stellt eine Operation direkt bereit. Wenn Sie diese Option auswählen, stellt das System die Operation und ihre Abhängigkeiten sofort bereit oder meldet Validierungsfehler, die die Bereitstellung verhindern.
  • Bereitstellen und Ausführen: Funktioniert genauso wie die Option Bereitstellen, mit dem Unterschied, dass das System nach einer erfolgreichen Bereitstellung auch die Operation und alle nachgelagerten Operationen ausführt. Für weitere Informationen siehe Eine Operation ausführen weiter unten auf dieser Seite.
  • Konfigurierbares Bereitstellen: Stellt ausgewählte Operationen bereit. Wenn Sie diese Option auswählen, öffnet sich ein Bildschirm zur Bereitstellungskonfiguration, auf dem Sie auswählen können, welche Operationen bereitgestellt werden sollen.

Hinweis

Wenn Sie ein Projekt umbenennen, das Sie zuvor bereitgestellt haben, wird der neue Projektname automatisch in Harmony bereitgestellt und aktualisiert. Kein anderer Teil des Projekts wird automatisch bereitgestellt.

Bereitstellen

Sie können die Bereitstellen-Option für eine Operation von den folgenden Orten aus aufrufen:

Wenn Sie Bereitstellen auswählen, wird die Operation zusammen mit ihren Abhängigkeiten sofort bereitgestellt. Damit die Bereitstellung erfolgreich ist, muss die Operation gültig sein. Wenn die Operation ungültig ist, wird ein Dialogfeld mit den spezifischen Validierungsfehlern angezeigt. Für Dokumentationen zu jedem Fehler und wie man ihn behebt, siehe Gültigkeit der Operation.

Bereitstellen und Ausführen

Die Bereitstellen und Ausführen-Option ist von diesen Orten aus zugänglich:

Wenn Sie Bereitstellen und Ausführen auswählen, werden die Operation und ihre Abhängigkeiten sofort bereitgestellt. Damit die Bereitstellung erfolgreich ist, muss die Operation gültig sein. Wenn die Operation ungültig ist, wird ein Dialogfeld mit den spezifischen Validierungsfehlern angezeigt. Für Dokumentationen zu jedem Fehler und wie man ihn behebt, siehe Betriebsvalidität.

Wenn die Bereitstellung erfolgreich ist, werden die Operation und alle nachgelagerten Operationen ebenfalls ausgeführt. Für Details siehe Führen Sie eine Operation aus weiter unten auf dieser Seite.

Konfigurierbare Bereitstellung

Sie können die Option Konfigurierbare Bereitstellung von den folgenden Standorten aus aufrufen. Diese Option öffnet einen Bildschirm zur Bereitstellungskonfiguration, in dem die Operation und ihre Abhängigkeiten standardmäßig ausgewählt sind.

Wenn Sie Konfigurierbare Bereitstellung auswählen, öffnet sich ein Bildschirm zur Bereitstellungskonfiguration, auf dem Sie ein Tag und einen Kommentar definieren und auswählen können, welche Workflows oder Operationen bereitgestellt werden sollen.

konfigurierbare Bereitstellung

  • Projektinformationen: Oben auf dem Bildschirm werden der Projektname sowie die Harmony-Organisation und -Umgebung angezeigt, in der sich das Projekt befindet.

  • Tag: Geben Sie ein Tag ein, um das Bereitstellungsereignis zu kennzeichnen. Das Tag erscheint als Etikett auf dem Bereitstellungsereignis und wird in den Bereitstellungsdetails aufgezeichnet, die über die Projektgeschichte zugänglich sind. Dieses Feld kann je nach Bereitstellungseinstellungen auf Projektebene erforderlich sein.

  • Kommentar: Geben Sie einen Kommentar ein, um das Bereitstellungsereignis zu beschreiben. Der Kommentar wird in den Bereitstellungsdetails aufgezeichnet, die über die Projektgeschichte zugänglich sind. Dieses Feld kann je nach Bereitstellungseinstellungen auf Projektebene erforderlich sein.

  • Workflows und Operationen auswählen: Wählen Sie die Workflows oder Operationen aus, die bereitgestellt werden sollen. Die Operation und ihre Abhängigkeiten sind standardmäßig ausgewählt. Sie müssen mindestens ein Element auswählen, um die Schaltfläche Bereitstellen zu aktivieren.

    Wenn Sie einen Workflow oder eine Operation auswählen, werden auch alle abhängigen Workflows oder Operationen ausgewählt und können nicht abgewählt werden.

    Um Workflows und Operationen ein- oder auszuklappen, verwenden Sie die Pfeile, die links vom Namen des Workflows oder der Operation angezeigt werden.

    Ungültige Workflows oder Operationen erscheinen in roter, kursiver Schrift. Sie müssen nur gültige Elemente auswählen, um die Schaltfläche Bereitstellen zu aktivieren.

  • Bereitstellen: Klicken Sie, um die ausgewählten Workflows oder Operationen bereitzustellen.

Eine Operation ausführen

Nachdem Sie eine Operation und ihre Abhängigkeiten bereitgestellt haben, können Sie diese Operationen ausführen. Sie können eine Operation mit vorhandenen bereitgestellten Abhängigkeiten ausführen oder die Abhängigkeiten zum Zeitpunkt der Ausführung automatisch bereitstellen lassen. Wenn Sie eine Operation ausführen, werden auch alle nachgelagerten (verknüpften) Operationen ausgeführt.

Sie können Operationen manuell zur Entwurfszeit ausführen, indem Sie ein Skript verwenden (entweder in Studio oder Design Studio), von einer Befehlszeile auf einem Agenten, über einen API-Trigger, über einen Listener oder über einen Zeitplan. Nachdem Sie Operationen ausgeführt haben, können Sie das ordnungsgemäße Verhalten überprüfen, indem Sie die Betriebsprotokolle überprüfen.

Für Informationen zur Verwendung eines Zeitplans im Vergleich zu einem ereignisgesteuerten Ansatz siehe Batch- und ereignisgesteuerte Verarbeitung.

Manuell ausführen

Manuelle Ausführung einer Operation wird häufig während der Projektentwicklung verwendet, um ausgewählte Operationen oder das gesamte Projekt zu testen. Sie können Operationen manuell im Studio ausführen, wie unten beschrieben, oder von der Projekte Seite der Management-Konsole für Operationen, die Sie bereits bereitgestellt haben.

Sie können die meisten Operationen manuell ausführen, mit den folgenden Ausnahmen:

  • Operationen, die über den Harmony API Manager ausgelöst werden. Diese Operationen verwenden eine API- oder API SOAP-Anforderungsaktivität, die Quelldaten für die Operation bereitstellt.
  • Operationen, die durch einen Listener ausgelöst werden. Diese Operationen verwenden eine Listening-Aktivität, die ein Ereignis empfängt, das die Ausführung der Operation auslöst.

Sie haben zwei Optionen für die manuelle Ausführung von Operationen:

  • Ausführen: Wenn Sie eine Operation und ihre Abhängigkeiten bereits bereitgestellt haben, führt diese Option die Operation und alle nachgelagerten Operationen sofort mit den vorhandenen bereitgestellten Abhängigkeiten aus. Die ausgeführten Operationen enthalten keine Designänderungen, die nach der letzten Bereitstellung vorgenommen wurden. Um die Operation mit den neuesten Designänderungen auszuführen, verwenden Sie Bereitstellen und Ausführen.
  • Bereitstellen und Ausführen: Diese Option stellt die Operation und alle ihre Abhängigkeiten sofort bereit (oder meldet Validierungsfehler, die die Bereitstellung verhindern) und führt dann die Operation und alle nachgelagerten Operationen mit den neu bereitgestellten Abhängigkeiten aus.

Operationen, die Sie manuell mit einer der beiden Methoden ausführen, zeigen den Echtzeit-Status der Operation auf der Design-Leinwand an, wie in Betriebsstatus unten beschrieben.

Ausführen

Sie können die Ausführen-Option von den folgenden Orten aus aufrufen:

Wenn Sie Ausführen auswählen, werden die Operation und alle nachgelagerten Operationen, die mit Operationsaktionen verknüpft sind, basierend auf den konfigurierten Bedingungen gestartet, sofern Sie bereits eine Operation und deren Abhängigkeiten bereitgestellt haben.

Wenn Sie eine Operation oder deren Abhängigkeiten noch nicht bereitgestellt haben, wird eine Nachricht angezeigt, die darauf hinweist, dass die Operation nicht ausgeführt werden konnte:

Dialogtext

Operation konnte nicht ausgeführt werden
Die spezifische Operation wurde nicht bereitgestellt oder wurde gelöscht.

Klicken Sie auf Weiter, um zum vorherigen Bildschirm zurückzukehren. Um die Operation und deren Abhängigkeiten bereitzustellen und die Operation auszuführen, verwenden Sie die Option Bereitstellen und Ausführen.

Wenn Sie eine Operation oder deren Abhängigkeiten bereitgestellt haben, aber seit der letzten Bereitstellung Änderungen im Studio-Projekt-Designer vorgenommen wurden, wird eine Aufforderung angezeigt, dass es nicht bereitgestellte Änderungen gibt:

Dialogtext

Operation hat nicht bereitgestellte Änderungen
Diese Operation oder deren abhängige Komponenten haben nicht bereitgestellte Änderungen. Klicken Sie auf Weiter, um die letzte bereitgestellte Version dieser Operation auszuführen.

Klicken Sie auf Weiter, um zu bestätigen, dass es nicht bereitgestellte Änderungen gibt, die nicht bereitgestellt werden, und um die letzte bereitgestellte Version der Operation und deren Abhängigkeiten ohne die zuletzt im Studio-Projekt-Designer vorgenommenen Änderungen auszuführen.

Wenn Sie die letzte bereitgestellte Version nicht ausführen möchten, klicken Sie auf Abbrechen, um zum vorherigen Bildschirm zurückzukehren. Um die neueste Version der Operation und deren Abhängigkeiten bereitzustellen und die Operation auszuführen, verwenden Sie die Option Bereitstellen und Ausführen.

Bereitstellen und Ausführen

Sie können die Option Bereitstellen und Ausführen von den folgenden Orten aus aufrufen:

Wenn Sie Bereitstellen und Ausführen auswählen, werden die Operation und ihre Abhängigkeiten sofort bereitgestellt. Die Bereitstellung muss erfolgreich sein, damit die Operation ausgeführt werden kann, wie zuvor auf dieser Seite unter Bereitstellen beschrieben.

Wenn die Bereitstellung erfolgreich ist, werden die Operation und alle nachgelagerten (Kind-)Operationen verkettet mit Operationsaktionen ebenfalls basierend auf den konfigurierten Bedingungen gestartet.

Betriebsstatus

Wenn eine Operation erfolgreich in die Betriebswarteschlange eingereicht wurde, wird der Echtzeit-Betriebsstatus in der unteren linken Ecke einer Operation angezeigt:

Betriebsstatus

Der Betriebsstatus wird für die ersten 6 Operationen angezeigt, die innerhalb einer Operationenkette ausgeführt werden. Sie können den Status für alle verbleibenden Operationen in den Betriebsprotokollen einsehen.

Der angezeigte Status entspricht den auf der Seite Betriebsprotokolle unter Betriebsstatus beschriebenen Status. Klicken Sie auf den Betriebsstatus, um detaillierte Protokollinformationen anzuzeigen. Der Bildschirm mit den Betriebsprotokollen öffnet sich automatisch in einem separaten Tab, sodass Sie weiterarbeiten können, während die Operationen ausgeführt werden (siehe Betriebsprotokolle).

Nachdem Sie die Operation manuell ausgeführt haben, wird der Betriebsstatus in einem offenen Projekt 24 Stunden lang angezeigt und wird nicht durch zusätzliche Bereitstellungen oder durch das Ausführen der Operation auf andere Weise beeinflusst. Nur durch das manuelle erneute Ausführen der Operation wird der Betriebsstatus für die Operationen und deren Kindoperationen aktualisiert. Der Betriebsstatus wird gelöscht, wenn Sie das Projekt schließen.

Für Operationen, die den Status Eingereicht, Empfangen, Ausstehend oder Wird ausgeführt haben, wird neben dem Status eine Schaltfläche Abbrechen angezeigt. Ein Klick auf Abbrechen sendet eine Anfrage an den Agenten, um die Operation zu stoppen, und ein Status Abbrechen angefordert wird neben dem Echtzeit-Betriebsstatus angezeigt:

Operation abbrechen

Hinweis

Vorgänge, die den Status Abbrechen angefordert haben, können weiterhin ausgeführt werden.

Bewege den Mauszeiger über den Laufzeitstatus, um die letzte Aktualisierung des Status (angegeben in der lokalen Browserzeit) anzuzeigen.

Die Farbe des Symbols links vom angegebenen Status zeigt die Kategorie des Vorgangsstatus an, die mit dem in den Vorgangsprotokollen angezeigten übereinstimmt. Wenn Vorgänge in der kompakten Ansicht sind, werden nur die farbigen Symbole angezeigt, die die Kategorie des Vorgangsstatus anzeigen.

Verwenden Sie ein Skript

Um einen Vorgang aus einem Skript auszuführen, rufen Sie die Funktion RunOperation in einem Skript auf, wie in der Funktionsdokumentation beschrieben.

Um einen anderen Vorgang im selben Projekt aufzurufen, ziehen Sie ihn in das Skript. Die vollständige Funktion wird automatisch erstellt:

RunOperation("<TAG>operation:Operation 2</TAG>");

Um einen Vorgang in einem anderen Projekt aufzurufen, erhalten Sie die GUID des Vorgangs, indem Sie ein einfaches Skript in diesem Vorgang ausführen (unter Verwendung von Skripttests), das den Referenzpfad des Vorgangs verwendet, um die GUID des Vorgangs auszugeben:

<trans>"<TAG>operation:Beispielvorgang</TAG>";</trans>

Nachdem Sie die GUID eines Vorgangs haben, können Sie das Skript entfernen. Das Ergebnis aus dem Skripttest ähnelt op.52c3eaa8-bc45-491f-b77f-cfeff994cf31.

Sie können es dann mit der Funktion RunOperation in der Form op.<guid> verwenden, wobei <guid> die GUID des Vorgangs im anderen Projekt ist:

RunOperation("op.52c3eaa8-bc45-491f-b77f-cfeff994cf31");

Um einen Design Studio-Vorgang aus dem Studio aufzurufen, übergeben Sie den Parameter operationId an die Funktion in der Form op.<guid>, wobei <guid> die GUID des Design Studio-Vorgangs ist. Sie können dies innerhalb des Design Studios erhalten, wie in Einen Vorgang von einer Befehlszeile aus aufrufen gezeigt.

RunOperation("op.52c3eaa8-bc45-491f-b77f-cfeff994cf31");

Um eine Studio-Operation aus dem Design Studio aufzurufen, benötigen Sie die Namen des Projekts und der Operation. Nachdem Sie Studio-Operationen bereitgestellt haben, können Design Studio-Projekte diese anhand des Projekt- und Operationsnamens aufrufen. Siehe die Design Studio RunOperationFromProject-Funktion:

RunOperationFromProject("<TAG>Projects/MyCloudStudioProject/Operations/MyCloudStudioOperation</TAG>");

Verwenden Sie eine Befehlszeile von einem Agenten

Sie können Operationen auch von einer Befehlszeile auf einem Agenten in der Umgebung aufrufen, in der Sie das Projekt bereitgestellt haben. Für Details siehe Rufen Sie eine Operation von einer Befehlszeile auf.

Verwenden Sie einen API-Trigger

Um die Operation von einer externen Anwendung aus aufzurufen, verwenden Sie API Manager, um eine benutzerdefinierte API zu konfigurieren und die Operation so zuzuweisen, dass sie auf Anfrage ausgelöst wird. Weitere Informationen finden Sie in der API Manager-Dokumentation.

Von APIs aufgerufene Operationen zeigen ein API-Symbol an:

operation api

Wenn Sie über dieses Symbol fahren, wird die Übersicht über den API-Dienst angezeigt:

operation schedule overview

Von dieser Übersicht aus können Sie auf Service-URL kopieren klicken, um die Service-URL der API in Ihre Zwischenablage zu kopieren.

Verwenden Sie einen Listener

Ereignis-Listener ermöglichen es, dass Operationen automatisch ausgeführt werden, wenn sie durch bestimmte Ereignisse ausgelöst werden. Sie können steuern, ob eine Operation auf diese Trigger reagiert, indem Sie die Ereignisüberwachungsfunktion aktivieren oder deaktivieren.

Wenn Sie eine Operation mit einer Listener-Aktivität bereitstellen, ist die Ereignisüberwachung standardmäßig deaktiviert und ein deaktiviertes Listener-Symbol wird auf der Operation angezeigt.

Um die Ereignisüberwachung für die Operation zu aktivieren, klicken Sie auf das deaktivierte Listener-Symbol und verwenden Sie den Schalter:

Betriebszeitplanübersicht

Durch Ereignisse ausgelöste Operationen zeigen ein aktives Listener-Symbol an:

Betriebslistener

Für weitere Informationen siehe Listener anzeigen oder aktivieren / deaktivieren auf der Seite Projekte der Management-Konsole.

Einen Zeitplan verwenden

Um die Operation automatisch nach einem Zeitplan auszuführen, müssen Sie zunächst einen Zeitplan konfigurieren und diesen dann auf eine Operation anwenden. Sie können Zeitpläne direkt im Studio erstellen und anwenden, wie unten beschrieben. Sie können auch Zeitpläne von der Seite Projekte in der Management-Konsole erstellen und anwenden.

Hinweis

Nachdem Sie einen Zeitplan auf eine Operation angewendet haben, können Sie ihn von der Seite Projekte in der Management-Konsole deaktivieren oder wieder aktivieren.

Sie fügen Zeitpläne über die Registerkarte Zeitpläne der Betriebseinstellungen hinzu. Sie können die Option Einstellungen von den folgenden Orten aus aufrufen:

Für detaillierte Konfigurationsinformationen siehe Betriebszeitpläne.

Operationen mit aktivierten Zeitplänen zeigen ein Einstellungen für Zeitplanoperationen-Symbol an:

Operation mit Zeitplan

Wenn Sie über dieses Symbol fahren, erscheint eine Übersicht über den Zeitplan:

Übersicht über den Zeitplan der Operation

Von dieser Übersicht aus können Sie auf Zeitplan bearbeiten klicken, um die Einstellungen zu ändern, oder auf Zeitplan entfernen klicken, um den Zeitplan von der Operation zu entfernen.

Bereitstellungsanforderungen

Sie können die Bereitstellungsanforderungen für jedes Projekt während der Projekterstellung und -konfiguration konfigurieren.

Wenn die Bereitstellungseinstellungen auf Projektebene ein Tag oder einen Kommentar erfordern, erscheint ein Dialog, wenn Sie eine Bereitstellung oder eine Bereitstellung und Ausführung initiieren, damit Sie die erforderlichen Informationen eingeben können. Der konfigurierbare Bereitstellungsbildschirm bietet ebenfalls diese Felder.

Dialogtext

Bereitstellungsanforderungen
Ihre Organisation benötigt einen Kommentar und ein Tag bei der Bereitstellung.

  • Tag

  • Kommentar

  • Tag: Geben Sie ein Tag ein, um das Bereitstellungsereignis zu kennzeichnen. Das Tag erscheint als Bezeichnung für das Bereitstellungsereignis und wird in den Bereitstellungsdetails aufgezeichnet, die über die Projektgeschichte zugänglich sind.
  • Kommentar: Geben Sie einen Kommentar ein, um das Bereitstellungsereignis zu beschreiben. Der Kommentar wird in den Bereitstellungsdetails aufgezeichnet, die über die Projektgeschichte zugänglich sind.
  • Kommentar und Tag hinzufügen: Klicken Sie, um das Tag, den Kommentar oder beides hinzuzufügen und mit der Bereitstellung der Operation fortzufahren.
  • Abbrechen: Klicken Sie, um den Dialog zu schließen und zum vorherigen Bildschirm zurückzukehren, ohne die Bereitstellung durchzuführen.

Eine ausgeführte Operation abbrechen

Wenn Sie eine ausgeführte Operation mit dem Status Eingereicht, Empfangen, Ausstehend oder Wird ausgeführt stoppen müssen, können Sie dies an den folgenden Orten tun: