Vorschaumodus bei Transformations im Jitterbit Integration Studio

Einführung

Der Vorschaumodus bietet eine schreibgeschützte Schnittstelle zum Verwenden von Beispieldaten, um zu testen, wie die Transformation die Daten verarbeitet.

Der Vorschaumodus basiert auf der Anzeige des Mapping-Modus, wo eine Übersicht über die Transformation angezeigt wird. Zusätzlich zur Anzeige der Elemente der Mappingmodus-Schnittstelle enthält der Vorschaumodus eine Inline-Anzeige von Daten in jedem Quell- und Zielfeld sowie Steuerelemente zur Interaktion mit der Vorschaumodus-Schnittstelle, wie auf dieser Seite beschrieben.

Im Vorschaumodus ist es nicht möglich, die Transformation zu bearbeiten, z. B. durch Hinzufügen, Bearbeiten oder Löschen von Zuordnungen. Im Vorschaumodus werden jedoch dieselben Steuerelemente zum Vornehmen von Änderungen angezeigt, die im Zuordnungsmodus angezeigt werden.

Wenn Sie versuchen, die Transformation zu bearbeiten, verlassen Sie automatisch den Vorschaumodus und wechseln in den Mapping-Modus (bei Verwendung eines Schnittstellenelements, bei dem Sie im Zuordnungsmodus bleiben würden) oder Script (beim Öffnen eines Script in einem Zielfeld).

Informationen zu Elementen der Benutzeroberfläche, die von mehreren Anzeigemodi gemeinsam genutzt werden, finden Sie unter Gemeinsame Moduselemente.

Transformation

Beim Konfigurieren einer Transformation gibt es zwei Methoden, mit denen Beispieldaten bereitgestellt werden können:

1. Beispieldaten werden vom Benutzer bereitgestellt
   Sie laden die Beispieldaten hoch, die für die Transformation verwendet werden sollen, wenn Sie die Transformation konfigurieren. Diese Methode ist in den folgenden Szenarien verfügbar:

   • Wenn eine Transformation ein Schema hat das innerhalb einer angrenzenden Aktivität definiert ist, mit Ausnahme einer Abfrage.
   • Wenn eine Transformation ein Schema hat das innerhalb der Transformation definiert ist (entweder mit oder ohne angrenzende Quellaktivität).

   Diese Option wird unter Beispieldaten auswählen beschrieben weiter unten auf dieser Seite.

2. Beispieldaten werden durch die Operation bereitgestellt
   Die Beispieldaten werden aus der Operation für bestimmte Endpoints abgerufen. Diese Methode ist in diesen Szenarien verfügbar:

   • Wenn eine Transformation eine benachbarte Abfrage hat. Sie haben die Möglichkeit, eine zusätzliche WHERE-Klausel anzuwenden, um die Anzahl der für die Vorschau abgerufenen Datensätze zu begrenzen. Diese Option wird unter Abfrage beschrieben weiter unten auf dieser Seite.

   • Wenn eine Transformation eine benachbarte NetSuite hat Salesforce, Salesforce Service Cloud oder ServiceMax Aktivität — entweder eine Quell- oder eine Zielaktivität. Diese Optionen werden unter NetSuite Aktivität beschrieben und Salesforce, Salesforce Service Cloud oder ServiceMax Aktivität weiter unten auf dieser Seite.

Im Vorschaumodus werden die Beispieldaten so angezeigt, wie sie mithilfe der in der Transformation angegebenen Scripts in das Ziel der Transformation geschrieben werden. Im Allgemeinen werden nachlegende Schritte im selben Operation oder nachlegende Vorgänge selbst nicht ausgeführt, es sei denn, sie werden innerhalb eines Transformation aufgerufen. (Wie am Ende dieses Abschnitts erwähnt, wenn bestimmte Aktivitäten das Transformation sind, werden Beispieldaten in das Ziel geschrieben.)

Beispielsweise Operationen, Scripts, Email Benachrichtigungen oder Plugins, die in einer Transformation mit Funktionen wie RunOperation(), RunScript(), SendEmailMessage(), oder RunPlugin() werden ausgeführt, da sie Teil der Transformation sind. Plugins, die auf Aktivitäten angewendet werden werden während einer Transformation nicht ausgeführt, da sie nicht Teil der Transformation sind.

Die maximale Größe eines einzelnen Datensatzes bei der Vorschau einer Transformation beträgt 384 KB (komprimiert) bzw. ca. 512 KB (unkomprimiert). Zur Laufzeit des Operation gibt es keine Begrenzung der Datensatzgröße.

Verfügbarkeit des Vorschaumodus

Der Vorschaumodus ist nur verfügbar, wenn für die Transformation sowohl ein Quell- als auch ein Schema angegeben ist. Die Quell- und Zielschemata können durch eine angrenzende Aktivität definiert eines beliebigen Endpoint oder sie können in einer Transformation definiert werden.

Der Vorschaumodus kann nicht für Quelldateien oder Daten im XSD- oder ZIP-Format verwendet werden, da in diesen Dateitypen keine Werte vorhanden sind. (Eine XML-Datei, die XSD implementiert, kann verwendet werden.)

Zugriff auf den Vorschaumodus

Wenn der Vorschaumodus verfügbar ist, Das Vorschausymbol wird in der Transformation angezeigt.

Vom Mapping-Modus oder Script, klicken Sie auf das Vorschausymbol:

Anschließend geben Sie Eingaben ein, um die Transformation zu konfigurieren, wie im Folgenden beschrieben.

Konfigurieren einer Transformation

Der Konfigurationsprozess für die Transformation führt Sie durch die Einrichtung einer Transformation zur Vorschau. Die in der Vorschaukonfiguration angezeigten spezifischen Bereiche hängen von diesen Kriterien ab:

• Transformations, die von Komponenten abhängen, die noch nicht bereitgestellt wurden, zeigen Erforderliche Komponenten als ersten Konfigurationsschritt an, der weiter unten unter Abhängigkeiten bereitstellen beschrieben wird.
• Alle Transformations, die in der Vorschau angezeigt werden können, außer denen mit einer angrenzenden Abfrage wird ein Bereich mit der Bezeichnung Beispieldaten auswählen angezeigt, der weiter unten unter Beispieldaten auswählen beschrieben wird. Der Bereich Beispieldaten auswählen kann in einem eigenen Schritt angezeigt werden oder, wenn die Transformation über ein angrenzendes NetSuite, Salesforce, Salesforce Service Cloud oder ServiceMax Aktivität muss zuerst die Option Vorschau mit Beispieldatei ausgewählt werden, um diesen Bereich anzuzeigen.
• Transformations mit einer angrenzenden Abfrage zeigen Sie als nächsten Schritt Definieren Sie die WHERE-Klausel, wie unten unter Abfrage beschrieben.
• Transformations mit einer angrenzenden NetSuite Aktivität (entweder als Quelle oder als Ziel) bieten die Optionen Vorschau mit Quelldaten oder Vorschau mit Beispieldatei, die weiter unten in NetSuite Aktivität beschrieben werden. Wenn das Ziel der Transformation eine NetSuite-Aktivität ist, werden Beispieldaten in das Ziel geschrieben.
• Transformations mit einem angrenzenden Salesforce, Salesforce Service Cloud oder ServiceMax Aktivität (entweder als Quelle oder Ziel) bieten die Optionen Vorschau mit Quelldaten oder Vorschau mit Beispieldatei, die weiter unten in NetSuite, Salesforce, Salesforce Service Cloud oder ServiceMax Zielaktivität beschrieben werden. Wenn das Ziel der Transformation eine Salesforce, Salesforce Service Cloud oder ServiceMax Aktivität ist, werden Beispieldaten in das Ziel geschrieben.

Bereitstellen von Abhängigkeiten

Der Schritt Erforderliche Komponenten ist nur vorhanden, wenn Sie noch nicht bereitgestellt alle Operationen, von denen die Transformation abhängig ist. Wenn Sie bereits alle Vorgänge bereitgestellt haben, von denen die Transformation abhängig ist, basiert der erste Schritt auf den anderen Kriterien, die am Anfang dieses Abschnitts aufgeführt sind.

Wenn die Transformation und alle Abhängigkeiten gültig sind, sieht dieser Schritt ungefähr wie der unten angezeigte aus:

• Erforderliche Komponenten: Überprüfen Sie die Komponenten, die bereitgestellt werden, wenn Sie auf Weiter klicken.

• Weiter: Klicken Sie, um die Komponenten in der Liste einsetzen und mit dem nächsten Schritt fortzufahren.

  Hinweis

  Unter bestimmten Umständen können zusätzliche Bildschirme angezeigt werden. Siehe Operationsbereitstellung für eine Beschreibung dieser Bildschirme:

  • Zeitpläne und Projektvariablen auswählen: Wenn Projektvariablen oder Zeitpläne bereitgestellt werden, die bereits in der Harmony-Cloud bereitgestellt wurden, werden Ihnen auf einem Bildschirm Optionen zur Auswahl der zu verwendenden Werte angezeigt.
  • Tags und Kommentare hinzufügen: Wenn Bereitstellungseinstellungen auf Projektebene so konfiguriert wurden, dass bei der Bereitstellung ein Tag und/oder ein Kommentar erforderlich ist, wird ein Dialogfeld angezeigt, in das Sie das erforderliche Tag und/oder den erforderlichen Kommentar eingeben können.

• Abbrechen: Klicken Sie hier, um den Konfigurationsvorschaubildschirm zu schließen und ohne Datenvorschau zur Transformation zurückzukehren.

Wenn die Transformation oder Abhängigkeiten ungültig sind, werden sie in der Liste identifiziert und die Schaltfläche Weiter ist deaktiviert:

Brechen Sie den Konfigurationsvorschaubildschirm ab oder schließen Sie ihn, um die Gültigkeit ungültiger Komponenten zu korrigieren, bevor Sie erneut versuchen, die Transformation in der Vorschau anzuzeigen. Informationen zur Gültigkeit finden Sie unter Gültigkeit der Transformation und Komponentengültigkeit.

Beispieldaten auswählen

Alle Transformations, die in der Vorschau angezeigt werden können, außer denen mit einer angrenzenden Abfrage, zeigen Sie einen Bereich namens Beispieldaten auswählen an. Der Bereich Beispieldaten auswählen kann in einem eigenen Schritt angezeigt werden (siehe linkes Bild unten) oder, wenn die Transformation ein angrenzendes NetSuite hat, Salesforce, Salesforce Service Cloud oder ServiceMax Aktivität, muss zuerst die Option Vorschau mit Beispieldatei ausgewählt werden, um diesen Bereich anzuzeigen (siehe rechtes Bild unten).

• Beispieldaten auswählen: Wählen Sie eine der Optionen aus, um Beispieldaten für die Vorschau in der Transformation bereitzustellen. Inhalt und Dateiformat der Beispieldatei sollten mit dem Schema kompatibel sein (XSD- und ZIP-Dateien werden nicht unterstützt).

  Notiz

  Wenn die Datei ein ungültiges Format hat, weist eine allgemeine Fehlermeldung auf „sampleDataLoadFailure“ hin. Mögliche Ursachen für ein ungültiges Format sind eine CSV-Datei ohne Header, eine JSON-Datei ohne schließendes Anführungszeichen, eine XML-Datei ohne schließendes Tag usw.

  • Neue Datei zum Testen hochladen: Verwenden Sie die Schaltfläche Durchsuchen rechts neben dem Feld unten, um zu einer Datei zu navigieren, die im aktuellen Projekt noch nicht für Transformation verwendet wurde. Obwohl Dateien bis zu 1,2 MB hochgeladen werden können, beachten Sie, dass die für die Transformation verwendeten Beispieldaten eine Größenbeschränkung von 51200 Byte haben. Diese Beschränkungen gelten nur für diesen Vorschautest.

    Tipp

    So generieren Sie eine gültige Beispieldatei für eine Transformation, die eine NetSuite verwendet, Salesforce, Salesforce Service Cloud oder ServiceMax Aktivität:

    1. Verwenden Sie Mock-Daten aus Quellstruktur erstellen, um einen Beispieldatensatz zu generieren.
    2. Ändern Sie die Ansicht der Transformation durch Klicken auf das Beispieldateisymbol, um die Beispielquelldaten und die Zieldatei mit Beispieldaten anzuzeigen, die generiert würden, wenn die Transformation ausgeführt würde. Diese Ansicht enthält zusätzliche Tags, die nicht durch Spiegeln eines Schema generiert werden.
    3. Kopieren Sie den Inhalt der Quell- oder Zielseite (je nach Bedarf) und fügen Sie ihn in eine neue Datei ein.
    4. Nehmen Sie nach Bedarf Änderungen an der neuen Datei vor, z. B. das Bearbeiten bestimmter Felder oder das Hinzufügen oder Entfernen von Datensätzen.
    5. Stellen Sie die neue Datei mit Neue Datei zum Testen hochladen bereit.

  • Zuvor geladene Datei zum Testen auswählen: Verwenden Sie die Dropdown-Liste im Feld unten, um eine vorhandene Datei auszuwählen, die zuvor für Transformation im aktuellen Projekt verwendet wurde.

  • Scheindaten aus Quellstruktur erstellen: Wählen Sie diese Option aus, um zufällige Daten basierend auf der Struktur des Schema zu generieren.

• Fertig: Klicken Sie hier, um die Beispieldaten zu laden, die transformierten Daten aus Harmony abzurufen und mit dem Transformation fortzufahren, der später auf dieser Seite unter Vorschau einer Transformation beschrieben wird.

  Vorsicht

  Hochgeladene Quelldateien, die zur Vorschau einer Transformation verwendet werden, werden regelmäßig aus Harmony entfernt. In diesem Fall erhalten Sie möglicherweise eine Fehlermeldung, die besagt, dass keine Quelldatei zum Testen verfügbar ist oder die Quelldatei abgelaufen ist. Um das Problem zu beheben, laden Sie die Datei erneut hoch und versuchen Sie es erneut.

• Abbrechen: Klicken Sie hier, um den Konfigurationsvorschaubildschirm zu schließen und ohne Datenvorschau zur Transformation zurückzukehren.

Abfrage

Der Schritt WHERE-Klausel definieren wird angezeigt, wenn die Transformation eine Quelle mit einem Schema verwendet, das aus einer Abfrage definiert wurde.

• Definieren Sie die WHERE-Klausel: Die vorhandene Abfrage wird verwendet, um die Beispieldaten für die Vorschau bereitzustellen. In diesem Schritt können Sie durch Angabe einer WHERE-Klausel weiter einschränken, welche Beispieldaten geladen werden.

  • Original-SQL: Bei Erstellung aus einer Abfrage mithilfe des Assistenten oder eine manuelle Abfrage, wird die ursprüngliche SQL-Anweisung, die innerhalb der Quellaktivität verwendet wurde, zu Referenzzwecken aufgeführt. Das Original-SQL wird für eine Abfrage mit dem Assistenten nicht angezeigt.

  • Ursprüngliche WHERE-Klausel: Die ursprüngliche WHERE-Klausel wird, sofern vorhanden, zu Referenzzwecken aufgeführt.

  • WHERE-Klausel, die in dieser Vorschau verwendet werden soll (optional): Geben Sie bei Bedarf eine WHERE-Klausel ein, die für die Vorschau der Transformation angewendet werden soll. Damit kann die Anzahl der Datensätze begrenzt werden, die für die Vorschau abgerufen werden. Wenn Sie eine ursprüngliche WHERE-Klausel haben, wird zusätzlich zur ursprünglichen Klausel eine weitere hier angegebene WHERE-Klausel verwendet, die nicht überschrieben wird.

    Hinweis

    Die für die WHERE-Klausel verwendete Syntax ist groß- und kleinschreibungsabhängig und muss den entsprechenden Anführungszeichenbezeichner des jeweiligen Datenbanktyps verwenden. Beispiele für WHERE-Klauseln finden Sie unter Datenbankspezifische Informationen.

• Fertig: Klicken Sie hier, um die Beispieldaten zu laden, die transformierten Daten aus Harmony abzurufen und mit dem Transformation fortzufahren, der später auf dieser Seite unter Vorschau einer Transformation beschrieben wird.

• Abbrechen: Klicken Sie hier, um den Konfigurationsvorschaubildschirm zu schließen und ohne Datenvorschau zur Transformation zurückzukehren.

NetSuite Aktivität

Wenn eine Transformation eine angrenzende NetSuite-Aktivität (entweder als Quelle oder als Ziel), bietet der Schritt die Optionen Vorschau mit Quelldaten oder Vorschau mit Beispieldatei. Die Option Vorschau mit Beispieldatei zeigt den Bereich Beispieldaten auswählen, der in Beispieldaten auswählen beschrieben wird weiter oben auf dieser Seite.

Wenn Vorschau mit Quelldaten ausgewählt ist, wird der Text Klicken Sie auf „Fertig stellen“, um den Vorgang auszuführen und Vorschaudaten abzurufen angezeigt:

• Fertig: Klicken Sie hier, um Beispieldaten direkt aus der Quelle abzurufen, die transformierten Daten aus Harmony abzurufen und mit dem Transformation fortzufahren, der später auf dieser Seite unter Vorschau einer Transformation beschrieben wird.
• Abbrechen: Klicken Sie hier, um den Konfigurationsvorschaubildschirm zu schließen und ohne Datenvorschau zur Transformation zurückzukehren.

Salesforce, Salesforce Service Cloud oder Servicemax-Aktivität

Wenn eine Transformation ein benachbartes Salesforce hat Salesforce Service Cloud oder ServiceMax Aktivität (entweder als Quelle oder als Ziel), bietet der Schritt die Optionen Vorschau mit Quelldaten oder Vorschau mit Beispieldatei. Die Option Vorschau mit Beispieldatei zeigt den Bereich Beispieldaten auswählen, der in Beispieldaten auswählen beschrieben wird weiter oben auf dieser Seite.

Was bei der Option Vorschau mit Quelldaten angezeigt wird, hängt davon ab, ob es sich bei der Aktivität um eine Quell- oder Zielaktivität für die Transformation handelt:

Quellaktivität

Wenn die Salesforce, Salesforce Service Cloud oder ServiceMax Aktivität eine Abfrageaktivität ist und als Quelle für die Transformation verwendet wird, werden die SOQL-Anweisung und die ursprüngliche WHERE-Klausel angezeigt:

• SOQL: Überprüfen Sie die vorhandene Abfrage aus der Aktivität, die zum Bereitstellen der Beispieldaten für die Vorschau verwendet wird.

  • Ursprüngliche WHERE-Klausel: Überprüfen Sie die vorhandene WHERE-Klausel (sofern vorhanden), die dazu dient, die in der Transformation in der Vorschau anzuzeigenden Beispieldaten einzuschränken.

  Notiz

  Dieser Schritt dient nur zu Informationszwecken. Die ursprüngliche SOQL- und WHERE-Klausel kann nicht bearbeitet oder weiter eingeschränkt werden.

• Fertig: Klicken Sie hier, um Beispieldaten direkt aus der Quelle abzurufen, die transformierten Daten aus Harmony abzurufen und mit dem Transformation fortzufahren, der weiter unten unter Vorschau einer Transformation beschrieben wird.

• Abbrechen: Klicken Sie hier, um den Konfigurationsvorschaubildschirm zu schließen und ohne Datenvorschau zur Transformation zurückzukehren.

Zielaktivität

Wenn die Salesforce, Salesforce Service Cloud oder ServiceMax Aktivität keine Abfrageaktivität ist und als Ziel der Transformation verwendet wird, wird der Text Klicken Sie auf „Fertig stellen“, um den Vorgang auszuführen und Vorschaudaten zu erhalten angezeigt.

• Fertig: Klicken Sie hier, um Beispieldaten direkt aus der Quelle abzurufen, die transformierten Daten aus Harmony abzurufen und mit dem Transformation fortzufahren, der weiter unten unter Vorschau einer Transformation beschrieben wird.
• Abbrechen: Klicken Sie hier, um den Konfigurationsvorschaubildschirm zu schließen und ohne Datenvorschau zur Transformation zurückzukehren.

Vorschau einer Transformation

Der Transformation wird im Vorschaumodus geladen. Dieser Modus ähnelt dem Mapping-Modus, außer dass es schreibgeschützt ist und zusätzliche Optionen zum Testen der Transformation mit Beispieldaten bietet. Wenn Sie die Transformation bearbeiten möchten, wird bei diesem Versuch automatisch der Zuordnungsmodus (bei Verwendung eines Schnittstellenelements, bei dem Sie im Zuordnungsmodus bleiben würden) oder der Script geöffnet (beim Öffnen eines Script in einem Zielfeld).

Im Vorschaumodus werden Daten aus der bereitgestellten Beispieldatei oder Abfrage inline neben jedem Quellfeld und jedem zugeordneten Zielfeld angezeigt:

Im Vorschaumodus bietet die Transformation eine Reihe von Tools zur Interaktion mit der Benutzeroberfläche des Vorschaumodus:

• Beispieldaten: Der Name der aktuell geladenen Beispieldatei oder Abfrage wird angezeigt. Klicken Sie auf die Beispieldatei oder Abfrage, um Optionen zum Löschen oder Ändern der Beispieldaten anzuzeigen, die unter Beispieldaten löschen oder ändern beschrieben sind unten.

  

• Datensatzzyklus: Klicken Sie auf die Pfeile nach links und rechts, um durch die Datensätze in der Beispieldatendatei oder den Abfrage zu blättern und die Datenvorschau zu aktualisieren:

  

  Die erste Zahl gibt an, welche Datensatzdaten aktuell in der Transformation angezeigt werden, von der Gesamtzahl der in der Beispieldatei oder Abfrage verfügbaren Datensätze.

  Hinweis

  Innerhalb der Vorschaudaten sind zusätzliche Pfeile auf Knoten verfügbar, die mehrere Unterdatensätze innerhalb eines Datensatzes zum Durchlaufen haben:

  

• Rückgängig machen: Klicken Sie auf das Rückgängig-Symbol, um Ihre letzte Aktion rückgängig zu machen (siehe Rückgängig und Wiederherstellen In Integration Studio Berechtigungen, Zusammenarbeit und Speichern).

• Wiederholen: Klicken Sie auf das Symbol „Wiederholen“, um Ihre letzte Rückgängig-Aktion rückgängig zu machen (siehe Rückgängig und Wiederherstellen In Integration Studio Berechtigungen, Zusammenarbeit und Speichern).

• Inline-Daten: Klicken Sie auf das Inline-Datensymbol, um die Inline-Vorschau der Daten anzuzeigen. Dies ist die Standardansicht.

• Beispieldateien: Klicken Sie auf das Symbol „Beispieldateien“, um die Beispielquelldaten und die Zieldatei mit Beispieldaten anzuzeigen, die generiert würden, wenn die Transformation ausgeführt würde:

  

• Schließen: Klicken Sie auf das Klicken Sie auf das Schließen-Symbol, um den Vorschaumodus zu verlassen und zum Transformation zurückzukehren.

Löschen oder Ändern von Beispieldaten

Klicken Sie auf den Namen der Beispieldatei oder Abfrage, um Optionen zum Löschen oder Ändern der Beispieldaten anzuzeigen:

• Löschen: Klicken Sie hier, um die Beispieldateidaten oder Abfrage zu entfernen und zum Transformation zurückzukehren.

• Ändern: Klicken Sie hier, um die Beispieldateidaten oder Abfrage zu ersetzen. Das Verhalten hängt davon ab, wie die Beispieldaten definiert wurden:

  • Beispieldatei: Wenn Sie eine Beispieldatei verwenden, gelangen Sie zurück zum Schritt zur Auswahl der Beispieldaten, um eine andere Datei auszuwählen.

  • Datenbankabfrage: Wenn Sie eine Datenbankabfrageaktivität verwenden, gelangen Sie zurück zum WHERE-Klauseldefinitionsschritt, um die WHERE-Klausel zu ändern.

  • Salesforce / Salesforce Service Cloud / ServiceMax Query: Wenn Sie eine Salesforce, Salesforce Service Cloud oder ServiceMax Query-Aktivität verwenden, gelangen Sie zurück zu Schritt 2 der Konfiguration dieser Aktivität, einer Salesforce Abfrage, Salesforce Service Cloud Abfrage oder ServiceMax Abfrageaktivität, um die Abfrage zu ändern.