Testen eines Skripts in Jitterbit Studio

Einführung

Der Testmodus bietet grundlegende Debugging-Funktionalitäten, mit denen Sie die Ergebnisse eines Skripts testen können, indem Sie Werte als Eingabe für das Skript eingeben.

Bitte beachten Sie, dass ein Skript je nach Inhalt manchmal beim Testen fehlschlagen kann, aber dennoch erfolgreich ausgeführt wird, wenn es bereitgestellt und auf einem Agenten ausgeführt wird. Dies kann passieren, wenn Sie beispielsweise keinen Standardwert für eine globale Variable festgelegt haben, die ihren Wert während der Ausführung erhält.

Das für Tests verwendete Skript hat eine Größenbeschränkung von 51200 Bytes. Dieses Limit gilt nicht über das Testen hinaus.

Verwenden von Haltepunkten

In Jitterbit-Skripten können Sie die Funktion DebugBreak verwenden, die als Haltepunkt für die Skriptausführung fungiert. Wenn ein Skript getestet wird, stoppt die Jitterbit-Skript-Engine die Ausführung, wenn sie einen Aufruf von DebugBreak erreicht. Sie sendet Informationen über den aktuellen Zustand an den Client zurück, einschließlich der Werte aller Datenelemente, sowohl der Quelldatenelemente als auch der globalen Datenelemente. Dies bietet eine leistungsstarke Möglichkeit, die Logik zu testen, die Sie in das Skript eingefügt haben.

Die Funktion DebugBreak akzeptiert optional einen boolean-Wert. Wenn wahr, wird die Ausführung an der Anweisung beim Testen unterbrochen. Wenn falsch, wird der Haltepunkt beim Testen ignoriert. Dies ermöglicht es Ihnen, ausgeklügelte Testszenarien einzurichten, die durch Eingabevariablen gesteuert werden, sodass Sie Teile eines Skripts je nach Einstellungen testen können. Weitere Informationen zur Verwendung von DebugBreak finden Sie unter Debugging-Funktionen.

In JavaScripts können Sie die Werte von Variablen sehen und validieren, genau wie bei Jitterbit-Skripten. Debugging ist jedoch in JavaScript nicht verfügbar, und die Verwendung von Haltepunkten wird nicht unterstützt.

Führen Sie einen Test aus

Im Skript-Editor verwenden Sie den Bearbeiten/Testen-Schalter (oder die Test-Schaltfläche im Skriptbereich), um den Test-Modus auszuwählen:

Klicken Sie dann auf die Schaltfläche Test ausführen, um einen Test durchzuführen:

Test ausführen

Bereitstellungsüberlegungen

Wenn Sie auf die Schaltfläche Test ausführen klicken, wird ein Bereitstellungsdialog angezeigt, wenn ein Skript andere Projektkomponenten aufruft, die nicht bereitgestellt wurden oder sich seit der letzten Bereitstellung geändert haben. Der angezeigte Dialog hängt von der Gültigkeit der referenzierten Komponenten ab.

• Bereitstellung erforderlich: Wenn alle referenzierten Komponenten gültig sind, enthält der Dialog eine Liste der Komponenten, die für das Testen des Skripts bereitgestellt werden müssen. Klicken Sie auf Bereitstellen und testen, um die aufgeführten Komponenten bereitzustellen und den Test auszuführen:

  Dialogtext

  Bereitstellung erforderlich
  Zum Testen dieses Skripts müssen diese Komponenten bereitgestellt werden:

  Komponententyp
  Komponente 1

  
  Bereitstellen und testenAbbrechen

  Klicken Sie auf Abbrechen, um den Dialog zu schließen, ohne die aufgeführten Komponenten bereitzustellen. Der Test wird nicht ausgeführt.

• Bereitstellung nicht möglich: Wenn referenzierte Komponenten ungültig sind, enthält der Dialog eine Liste der ungültigen Komponenten und warum sie ungültig sind. Die ungültigen Elemente müssen behoben werden, um den Test erfolgreich auszuführen. Klicken Sie auf Weiter, um den Dialog zu schließen:

  Dialogtext

  Bereitstellung nicht möglich
  Ihr Projekt kann aufgrund der folgenden ungültigen Elemente nicht bereitgestellt werden. Bitte korrigieren Sie diese Fehler und versuchen Sie es erneut:

  Komponente 1
  Erklärung, warum die Komponente ungültig ist.

  
  Weiter

• Projekt bereitstellen: Wenn nicht bereitgestellte eigenständige Skripte (die nicht mit einer Operation verknüpft sind) oder Projektvariablen referenziert werden, enthält der Dialog eine Liste dessen, was mit einer Projektbereitstellung bereitgestellt werden muss, um den Test erfolgreich auszuführen. Klicken Sie auf Weiter, um den Dialog zu schließen:

  Dialogtext

  Projekt bereitstellen
  Diese Elemente wurden seit dem letzten Deployment geändert. Bitte stellen Sie das Projekt zuerst bereit.

  Komponente 1

  
  Fortfahren

Siehe Bereitstellen und Ausführen einer Operation und Ein Projekt bereitstellen für weitere Informationen zu Deployments. Wenn keine Deployments erforderlich sind, erscheinen keine Deployment-Dialoge und der Test wird automatisch ausgeführt.

Testoberfläche

Beim Ausführen eines Tests werden relevante Informationen in einer Tabelle angezeigt, die jede im Skript verwendete Variable mit anpassbaren Spalten enthält:

• Name: Der Name der Variable. Wenn der Name größer als die aktuelle Spaltengröße ist, wird er standardmäßig abgeschnitten und als Tooltip beim Hover angezeigt.

  Ein Namen in die Zwischenablage kopieren-Button wird ebenfalls beim Hover zur Verfügung gestellt.

• Wert: Der aktuelle Wert der Variable. Wählen Sie aus, um den Wert der Variable zu bearbeiten, wenn das Skript nicht läuft. Wenn der Wert größer als die aktuelle Spaltengröße ist, wird er standardmäßig abgeschnitten und als Tooltip beim Hover angezeigt.

  Wenn der Wert nicht null ist, wird ein Wert in die Zwischenablage kopieren-Button ebenfalls beim Hover zur Verfügung gestellt.

• Ist Null: Gibt an, ob die Variable null ist. Wählen Sie aus, um den Wert der Variable auf null zu setzen, wenn das Skript nicht läuft.

Wenn ein Test gestartet oder fortgesetzt wird, werden alle neuen Werte an die Skript-Engine zurückgesendet.

Sie können den Debugging-Prozess mit den Steuerelementen oben in der Tabelle durchlaufen:

Sie haben auch die Möglichkeit, Haltepunkte auszuschalten. Aktivieren Sie Haltepunkt deaktivieren, wenn Sie möchten, dass der Test alle Aufrufe von DebugBreak ignoriert und stattdessen bis zum Abschluss ausgeführt wird. Diese Option gilt nur für Jitterbit-Skripte.

Um nach einer bestimmten Variablen anhand des Namens zu suchen, verwenden Sie das Suchfeld, um ein Schlüsselwort oder mehrere durch Kommas getrennte Schlüsselwörter einzugeben. Variablen, die einen Teil der Schlüsselwörter im Variablennamen enthalten, werden zurückgegeben.

Um alle Werte zurückzusetzen, klicken Sie auf die Schaltfläche Werte zurücksetzen über der Tabelle.

Schließlich wird das Ergebnis in einer zweiten Tabelle angezeigt, die unter der ersten erscheint:

• Jitterbit-Skript: Die Ergebnis-Tabelle zeigt die resultierende Ausgabe der letzten Anweisung des Skripts an (wenn keine Haltepunkte vorhanden sind) oder die resultierende Ausgabe nach jedem Haltepunkt.
• JavaScript: Die Ergebnis-Tabelle zeigt die Ergebnisse des Skripts an, die entweder durch die Funktionen SetScriptOutput oder SetScriptResult festgelegt wurden.

Darüber hinaus werden auch alle während des Tests aufgetretenen Fehlermeldungen angezeigt.