Gemeinsame Moduselemente von Transformations in Jitterbit Integration Studio

Einführung

Für den Zugriff auf eine Transformation gibt es drei Anzeigemodi: Mapping, Script und Vorschau. Die Mapping- und Script bieten Tools zum Konfigurieren der Transformation, während der Vorschaumodus Tools zum Testen der Transformation mit Beispieldaten bietet. Einige Elemente der Benutzeroberfläche sind allen Anzeigemodi gemeinsam.

Diese Seite enthält Elemente, die auch in der Header des Transformation vorkommen:

• Mapping-Modus

  

• Script

  

• Vorschaumodus

  

Umbenennen einer Transformation

Wenn Sie eine neue Transformation erstellen, lautet ihr Standardname Neue Transformation. Nachfolgende neue Transformations mit Standardnamen werden mit einer in Klammern angehängten Nummer versehen. Transformation müssen eindeutig sein und dürfen keine Schrägstriche enthalten (/) oder Doppelpunkte (:) um gültig zu sein.

Um eine Transformation im Transformation umzubenennen, bearbeiten Sie das Feld oben links:

Transformations können auch an diesen Orten umbenannt werden:

• Die Tab Workflows im Projektbereich (siehe Aktionsmenü Komponentenaktionen im Projektbereich Tab Workflows).
• Die Tab Komponenten des Projektbereichs (siehe Aktionsmenü im Projektbereich Tab Komponenten).
• Die Design-Canvas (siehe Umbenennen von Workflows, Operationen und Operation in Entwurfsfläche).

Notizen hinzufügen

Sie können einem Script benutzerdefinierte Notizen hinzufügen, die als Dokumentation oder Erinnerung für Sie selbst oder Projektmitarbeiter dienen. Um eine Notiz hinzuzufügen, klicken Sie auf das Notizsymbol neben dem Feld Script.

Es öffnet sich ein editierbarer Bereich, in dem Sie den Text Ihrer Notiz eingeben können. Klicken Sie auf Posten, um die Notiz dem Script hinzuzufügen:

Ihre gepostete Notiz wird zusammen mit Ihrem Namen und einem Zeitstempel angezeigt. Jeder mit Bearbeitungszugriff auf das Script kann Notizen entfernen, indem er auf das Symbol „Entfernen“. Um die Notiz zu schließen, klicken Sie auf einen anderen Teil der Benutzeroberfläche. Wenn eine oder mehrere Notizen vorhanden sind, wird auf dem Notizsymbol ein orangefarbener Punkt angezeigt:

Speicherstatus anzeigen

Nach Änderungen an einem Mapping wird die Transformation automatisch gespeichert. Der Speicherstatus wird angezeigt:

Das Vorhandensein eines Sternchens nach der Zeit zeigt an, dass die Transformation nicht gespeicherte Änderungen aufweist:

Um die Transformation manuell zu speichern, verwenden Sie Control+S (Windows oder Linux) oder Command+S (macOS).

Weitere Informationen zur automatischen Speicherung finden Sie unter Integration Studio Berechtigungen, Zusammenarbeit und Speichern.

Transformation

Die Transformation enthält einen kontextbezogenen Satz von Werkzeugen zur Interaktion mit der Transformation.

Im Mapping-Modus und im Script Modus enthält die Transformation die folgenden Symbole:

Im Vorschaumodus stehen Ihnen zusätzliche Tools zur Verfügung, mit denen Sie mit den Vorschaudaten interagieren können:

Diese Tools werden in Vorschau einer Transformation behandelt im Vorschaumodus.

Aktionsmenü „Schemaaktionen“

Nachdem Sie ein Quell- oder Schema in einer Transformation angegeben haben, stehen Menüaktionen für dieses Schema oben auf dem Transformation zur Verfügung. Klicken Sie oben auf der Quell- oder Zielseite auf das Zahnradsymbol zum Öffnen des Aktionsmenü:

Menüelement	Beschreibung
	Aktivität bearbeiten öffnet die Aktivitätskonfiguration, damit Sie bei Bedarf Änderungen vornehmen können (siehe In einer Aktivität definierte Schemata). Diese Aktion ist nur verfügbar, wenn die Transformation ein Schema von einer benachbarten oder anfänglich benachbarten Aktivität erbt. Für Aktivitäten mit benutzerdefinierten Schemas, können Sie die Konfiguration bearbeiten, um die für das Schema ausgewählte Datei zu löschen oder auszutauschen. Für andere Aktivitäten können Sie die Abfrage bearbeiten, die Objektauswahl ändern oder ähnliche Konfigurationen vornehmen.
	Schema bearbeiten öffnet den Schema Editor, damit Sie das Schema bearbeiten können (siehe In einer Transformation definierte Schemata). Diese Aktion ist nur für Schemata verfügbar, die editierbar sind. Wenn Sie ein Schema bearbeiten, das in einer Transformation aus einer Beispieldatei erstellt wurde, wird der Konfigurationsbildschirm für ein benutzerdefiniertes flaches Schema oder benutzerdefiniertes hierarchisches Schema wird geöffnet, damit Sie nach Bedarf Felder und/oder Knoten hinzufügen oder bearbeiten können. Schemata, die von einer angrenzenden Aktivität bereitgestellt werden, können nicht bearbeitet werden. Beim Öffnen eines Schema, auf das von mehreren Komponenten verwiesen wird, wird in einem Dialogfeld eine Liste aller Komponenten angezeigt, die auf das Schema verweisen und von Änderungen betroffen sind:
	Schema aktualisieren generiert das Schema vom Endpoint neu. Diese Aktion ist nur für Schemata verfügbar, die von einer benachbarten Aktivität mit einem vom Connector generierten Schema geerbt wurden (außer für Datenbank, NetSuite, Salesforce, Salesforce Service Cloud oder ServiceMax Endpoints). Diese Aktion regeneriert das Schema auch an anderen Stellen im gesamten Projekt, an denen auf dasselbe Schema verwiesen wird, z. B. in einer angrenzenden Aktivität. Weitere Informationen finden Sie unter Schemaregenerierung.
	Schema löschen löscht ein von der Transformation bereitgestelltes Schema aus der Transformation. Diese Aktion ist nur für Schemata verfügbar, die in einer Transformation definiert sind. Beim Entfernen eines Schema werden Sie in einer Meldung aufgefordert, das Entfernen des Schema zu bestätigen. Dies hat folgendes Ergebnis: Quellschema: Das Entfernen eines Schema kann zu ungültigen Zuordnungen führen. Weitere Informationen finden Sie unter Gültigkeit der Transformation. Zielschema: Durch das Entfernen eines Schema werden alle Zuordnungen entfernt. Hinweis Wenn vor der Konfiguration einer angrenzenden Aktivität ein durch die Transformation bereitgestelltes Schema vorhanden war, ist die Option Schema löschen nicht vorhanden. Obwohl ein durch die Transformation bereitgestelltes Schema weiterhin von der Transformation referenziert wird, wird es bei der Verarbeitung nicht verwendet. Um unter diesen Umständen ein durch die Transformation bereitgestelltes Schema zu löschen, entfernen Sie vorübergehend die angrenzende Aktivität und die Option Schema löschen wird angezeigt. Sobald Sie das durch die Transformation bereitgestellte Schema gelöscht haben, ersetzen Sie die Aktivität in der Operation.

Filtern oder suchen

Mithilfe von Filtern oder Suchen können Sie ein bestimmtes Feld in den Quell- oder Zielstrukturen finden. Sie können auch die Suche in der Quellstruktur verwenden, um eine bestimmte Variable zu finden, die in der Zielstruktur verwendet werden soll, oder Sie können die Suche in der Zielstruktur verwenden, um in den Transformation selbst zu suchen.

Filter

Im Mapping- und Vorschaumodus befindet sich das Dropdown-Menü Ansicht oben in den Strukturen Quelle und Ziel. Im Script befindet sich das Dropdown-Menü Ansicht oben in der Struktur Ziel. Dieses Dropdown-Menü ermöglicht Ihnen das Filtern nach diesen Auswahlmöglichkeiten:

• Alle Felder: Alle Felder werden angezeigt.
• Zugeordnet: Es werden nur Felder angezeigt, die zugeordnet wurden. Im Zuordnungs- und Vorschaumodus sind innerhalb der Quellstruktur die zugeordneten Objekte auf diejenigen beschränkt, die einem Zielfeld zugeordnet wurden. In allen Modi sind für die Zielstruktur die zugeordneten Felder diejenigen, die auf irgendeine Weise definiert wurden (mit einem Quellobjekt, einer Variable, einem benutzerdefinierten Wert oder einer anderen Script). Zugeordnete Felder zeigen ein Script oben rechts im Zielfeld.
• Nicht zugeordnet: Es werden nur Felder angezeigt, die nicht zugeordnet wurden.
• Ungültig: Diese Option ist nur in der Ziel-Struktur verfügbar. Es werden nur Felder angezeigt, die zugeordnet wurden, deren Zuordnung jedoch ungültig ist. Die Gültigkeit der Zuordnung wird unter Gültigkeit der Transformation detailliert beschrieben.
• Erforderlich: Diese Option ist nur in der Ziel-Struktur verfügbar. Nur Felder mit einem Kardinalitätsschlüssel von [1] oder [1+] werden angezeigt. Weitere Informationen finden Sie unter Kardinalitätsschlüssel unter Knoten und Felder.

Beim Anzeigen zugeordneter Objekte in den Registerkarten Quelle oder Variablen im Zuordnungs- und Vorschaumodus gibt eine Zahl in Klammern und der Farbe Orange an, wie oft auf der Zielseite der Transformation auf jedes Objekt verwiesen wird.

Wenn Sie den Mauszeiger über ein Quellobjekt bewegen, werden außerdem Linien angezeigt, die das Quellfeld mit allen Zielfeldern verbinden, denen es zugeordnet ist, oder mit Knoten, in denen es referenziert wird. Klicken Sie direkt auf die Zahl, um die referenzierten Zielfelder oder Knoten anzuzeigen, und klicken Sie, um automatisch zum Objekt oder Knoten in der Zielstruktur zu blättern.

Beim Anzeigen zugeordneter Objekte innerhalb der Ziel-Struktur wird beim Bewegen des Mauszeigers über das Feld eine Linie angezeigt, die das zugeordnete Zielfeld mit seinen Ursprüngen in den Registerkarten Quelle oder Variablen verbindet, sofern zutreffend. Klicken Sie auf das zugeordnete Quellobjekt, um automatisch zum Objekt in der Tab zu gelangen.

Wenn Sie auf den Namen eines zugeordneten Zielobjekts klicken, wird es ausgeblendet, sodass die zugeordneten Objekte nicht sichtbar sind.

Wenn ein reduzierter Knoten Zielfeldzuordnungen enthält, wird dieser Knoten fett dargestellt, um anzuzeigen, dass er Zuordnungen enthält:

Suchen

Sie können in allen Modi auch nach bestimmten Feldern suchen, indem Sie auf das Suchsymbol oben auf den Registerkarten Quelle und Variablen im Zuordnungs- und Vorschaumodus sowie in der Ziel-Struktur für alle Modi:

• Quelle: Bei der Suche in der Quellstruktur werden Felder oder Variablen hervorgehoben, deren Name einen Teil der Schlüsselwörter enthält.

• Ziel: Bei der Suche in der Zielstruktur werden Felder zurückgegeben und hervorgehoben, die einen beliebigen Teil der Schlüsselwörter im Feldnamen oder im Transformation eines Felds enthalten. Die Suche gibt bis zu 100 Transformation zurück, die den Suchkriterien entsprechen. Wenn dieses Limit erreicht ist, wird eine Meldung angezeigt:

  Script search results were limited to 100 scripts. All paths were searched.

Bei Quell- und Zielschemata mit mehr als 999 Knoten müssen zwei oder mehr Zeichen in das Suchfeld eingegeben werden, um eine Suche zu starten.

Wenn eine Suche gestartet wird, wird die Gesamtzahl der Ergebnisse zurückgegeben:

Verwenden Sie die vorherige und Weiter-Symbole, um durch die Ergebnisse zu blättern.