Wiederverwendung von Projektkomponenten im Jitterbit Integration Studio

Einführung

Diese Seite beschreibt, wie man Projektkomponenten wiederverwendet, die als Operationselemente oder zur Unterstützung von Operationen verwendet werden.

Diese Seite ist in folgende Abschnitte gegliedert:

• Terminologie zur Wiederverwendung von Komponenten
  In diesem Abschnitt wird die Terminologie definiert, die zur Diskussion der Wiederverwendung von Komponenten verwendet wird. Das Verständnis des Unterschieds zwischen unabhängigen Komponenten und Verweisen auf diese Komponenten bildet die Grundlage für das Verständnis der damit verbundenen UI-Begriffe:
  • Duplizieren einer Komponente, um eine Kopie zu erstellen
  • Verweisen auf eine vorhandene Komponente
  • Ausschneiden oder Kopieren von Komponenten, um sie in die Zwischenablage zu legen
  • Einfügen als neue Komponente oder als Verweis, abhängig vom Kontext
• Komponenten ausschneiden und kopieren
  In diesem Abschnitt werden die verschiedenen Orte beschrieben, von denen aus Sie Komponenten ausschneiden und kopieren können. Das Ausschneiden einer Komponente löscht auch die Komponente oder ihren Verweis aus dem Projekt, abhängig davon, wo sie ausgeschnitten wurde.
• Erstellen einer neuen Komponente aus einer vorhandenen Komponente
  In diesem Abschnitt werden die verschiedenen Möglichkeiten beschrieben, wie Sie eine neue Komponente aus einer vorhandenen Komponente erstellen können. Typischerweise geschieht dies durch Duplizieren einer vorhandenen Komponente oder durch Ausschneiden/Kopieren und Einfügen an bestimmten Orten. Bestimmte Arten von Aktivitäten (Salesforce, Salesforce Service Cloud und ServiceMax-Aktivitäten) führen immer zu einer neuen Komponente, wenn sie eingefügt werden, da die Wiederverwendung von mehr als einer Instanz dieser Aktivitätstypen nicht erlaubt ist.
• Erstellen einer Aktivitäts- oder Toolinstanz
  In diesem Abschnitt werden die verschiedenen Möglichkeiten beschrieben, wie Sie eine Instanz einer Aktivität oder eines Tools als neue, unabhängige Komponente erstellen können. Dies geschieht durch Ziehen und Ablegen oder durch Ausschneiden/Kopieren und Einfügen an bestimmten Orten.
• Erstellen eines Komponentenverweises
  In diesem Abschnitt werden die verschiedenen Möglichkeiten beschrieben, wie Sie Komponenten referenzieren können. Bestimmte Komponenten können als Operationselemente verwendet werden, während andere Arten von Komponenten zur Unterstützung von Operationen verwendet werden können. Die meisten dieser Komponententypen können mehrfach referenziert werden.

Details zum Verweisen auf eine Transformation, die ein Schema verwendet, das von einer Aktivität geerbt wurde, sind als Ergänzung zu dieser Seite in Transformation wiederverwenden angegeben.

Die Wiederverwendung von Operationen selbst wird in Operation wiederverwenden behandelt.

Terminologie zur Wiederverwendung von Komponenten

Projektkomponenten, wie sie in der Benutzeroberfläche des Integration Studio erscheinen, können entweder unabhängige Komponenten oder Komponentenreferenzen sein:

• Unabhängige Komponenten sind die diskreten Bausteine eines Projekts und befinden sich im Komponenten-Tab des Projektfensters. Unabhängige Komponenten sind die Komponenten im Projekt.
• Komponentenreferenzen verweisen auf die unabhängigen Komponenten. Komponentenreferenzen in Projekt-Workflows befinden sich auf dem Design-Canvas und im Workflows-Tab des Projektfensters. Komponenten können auch von Komponenten referenziert werden, die nicht Teil von Workflows sind.

Eine unabhängige Komponente kann auf zwei Arten in einem Projekt wiederverwendet werden:

• Duplizieren bedeutet, die Konfiguration einer vorhandenen Komponente zu verwenden, um eine neue, unabhängige Komponente in einem Projekt zu erstellen. Nachdem Sie eine Komponente dupliziert haben, werden Änderungen, die Sie an der ursprünglichen unabhängigen Komponente vornehmen, nicht in der Kopie widergespiegelt, und Änderungen, die Sie an der Kopie vornehmen, wirken sich nicht auf die ursprüngliche unabhängige Komponente aus. Wenn Sie eine Komponente duplizieren, erscheint eine neue Komponente im Komponenten-Tab des Projektfensters und ist eine unabhängige Komponente im Projekt. Eine Komponente kann auch zwischen Projekten eingefügt werden, die in derselben Browsersitzung geöffnet sind.
• Referenzieren bedeutet, dieselbe Komponente mehr als einmal in einem Projekt zu verwenden und ist die Art und Weise, wie Sie Projekt-Workflows erstellen. Eine Komponentenreferenz in einem Workflow ist eine Operation, Aktivität, Transformation, Skript oder E-Mail-Benachrichtigung, die visuell auf dem Design-Canvas dargestellt wird und im Workflows-Tab des Projektfensters erscheint (außer bei E-Mail-Benachrichtigungen). Komponentenreferenzen können auch in anderen Komponenten enthalten sein, die möglicherweise Teil von Projekt-Workflows sind oder nicht. Zum Beispiel kann eine Projektvariable in der Konfiguration einer Aktivität referenziert werden, die als Operation Schritt in einem Projekt-Workflow verwendet wird, und kann auch in einem Skript referenziert werden, das selbst von keinem Projekt-Workflow referenziert wird. Wenn Sie eine Komponente in oder außerhalb von Projekt-Workflows referenzieren, wird die Referenzanzahl der Komponente im Komponenten-Tab des Projektfensters erhöht.

Das Wort Kopie wird als Substantiv verwendet, um ein neues, unabhängiges Element zu beschreiben, das aus einem bestehenden Element erstellt wurde.

Die Wörter Ausschneiden und Kopieren als Aktionen platzieren beide eine Kopie eines Elements in Ihrer Zwischenablage, die dann verwendet wird, um entweder ein unabhängiges Element oder eine Elementreferenz zu erstellen. Welches dieser beiden erstellt wird, hängt vom Kontext beim Einfügen ab:

• Ausschneiden platziert eine Kopie eines Elements in Ihrer Zwischenablage und löscht entweder das ursprüngliche unabhängige Element oder die Elementreferenz, abhängig davon, wo das Element ausgeschnitten wurde:
  • Wenn ein Element aus dem Komponenten-Tab des Projektfensters ausgeschnitten wird, wird das ursprüngliche unabhängige Element gelöscht.
  • Wenn ein Element aus der Entwurfskanvas oder dem Workflows-Tab des Projektfensters ausgeschnitten wird, da das Element eine Referenz zu einem ursprünglichen unabhängigen Element ist, wird nur die Referenz gelöscht und das ursprüngliche unabhängige Element bleibt unverändert.
• Kopieren platziert eine Kopie eines Elements oder eines Aktivitätstyps in Ihrer Zwischenablage. Das ursprüngliche unabhängige Element bleibt unverändert. Das Kopieren und anschließende Einfügen eines Elements kann entweder zu einem neuen unabhängigen Element oder zu einer Elementreferenz führen, abhängig vom Kontext beim Einfügen.
• Einfügen erstellt entweder ein unabhängiges Element oder eine Elementreferenz, abhängig vom Kontext beim Einfügen. Zum Beispiel:
  • Einfügen eines Elements oder Aktivitätstyps im Komponenten-Tab des Projektfensters erstellt ein neues, unabhängiges Element. Einfügen eines Aktivitätstyps erstellt eine Aktivitätsinstanz als neues, unabhängiges Element.
  • Einfügen eines Elements in der Entwurfskanvas fügt eine Referenz zum ursprünglichen unabhängigen Element im Projektworkflow hinzu. (Eine Ausnahme: Das Einfügen einer Salesforce, Salesforce Service Cloud oder ServiceMax-Aktivität in der Entwurfskanvas erstellt ein neues, unabhängiges Element anstelle einer Elementreferenz.)
  • Einfügen eines Aktivitätstyps in der Entwurfskanvas oder im Workflows-Tab des Projektfensters erstellt eine Aktivitätsinstanz als neues, unabhängiges Element und fügt eine Referenz zu dieser Aktivität im Projektworkflow hinzu.

Komponenten ausschneiden und kopieren

Sie können die Menüaktionen Ausschneiden und Kopieren aus dem Aktionsmenü eines Komponenten- oder Aktivitätstyps an folgenden Stellen aufrufen:

• Unabhängige Komponenten im Komponenten-Tab des Projektfensters (siehe Aktionsmenü für Komponenten im Projektfenster Komponenten-Tab).
• Komponentenreferenzen auf der Entwurfsleinwand (siehe Aktionsmenü für Komponenten im Entwurfsleinwand).
• Komponentenreferenzen im Workflows-Tab des Projektfensters (siehe Aktionsmenü für Komponenten im Projektfenster Workflows-Tab).
• Aktivitätstypen im Projektendpunkte und -verbindungen-Tab der Entwurfskomponentenpalette (siehe Aktionsmenü für Verbindungen und Aktionsmenü für Aktivitätstypen in Entwurfskomponentenpalette).

Sie können auch die standardmäßigen Tastenkombinationen für Ausschneiden (Control+X unter Windows oder Linux und Command+X unter macOS) und Kopieren (Control+C unter Windows oder Linux und Command+C unter macOS) verwenden.

Sowohl das Ausschneiden als auch das Kopieren von Komponenten legen eine Kopie einer Komponente in Ihrer Zwischenablage ab. Aktivitätstypen können ebenfalls aus der Entwurfskomponentenpalette kopiert werden; die Kopie in der Zwischenablage wird verwendet, um eine neue Komponente im Projekt (eine Aktivitätsinstanz) zu erstellen.

Das Ausschneiden einer unabhängigen Komponente aus dem Projekt (aus dem Komponenten-Tab des Projektfensters) löscht die ursprüngliche unabhängige Komponente aus dem Projekt. Da das Löschen erforderlich ist, ist das Ausschneiden einer Komponente nur bei nicht referenzierten Komponenten möglich. Die Standarddialoge für das Löschen werden wie in Komponentenabhängigkeiten, Löschung und Entfernung dokumentiert angezeigt.

Das Ausschneiden eines Komponentenverweises aus einem Projektworkflow (aus der Entwurfskanvas oder dem Workflows-Tab des Projektfensters) löscht nur den Komponentenverweis. Die ursprüngliche unabhängige Komponente bleibt unverändert.

Erstellen einer neuen Komponente aus einer bestehenden Komponente

Das Erstellen einer neuen, unabhängigen Komponente aus einer bestehenden, unabhängigen Komponente ist für Schemata, Aktivitäten, Tools, Projektvariablen, E-Mail-Benachrichtigungen und Zeitpläne verfügbar.

Sie können eine neue Komponente aus diesen bestehenden Komponenten erstellen, indem Sie eine Kombination der Menüaktionen Ausschneiden oder Kopieren (siehe Kopieren und Ausschneiden von Komponenten oben) und Einfügen (siehe Einfügen unten) (oder deren Tastenkombinationen) verwenden oder indem Sie die Menüaktion Duplizieren (siehe Duplizieren unten) verwenden. Es gibt zusätzliche Möglichkeiten, neue Salesforce, Salesforce Service Cloud und ServiceMax-Aktivitäten zu erstellen (siehe Salesforce, Salesforce Service Cloud und ServiceMax-Aktivitäten unten).

Der Standardname der neuen Komponente verwendet den Namen der ursprünglichen unabhängigen Komponente, ergänzt um - Kopie. Nachfolgende Kopien werden mit einer inkrementierten Zahl in Klammern weiter ergänzt. Da Projektvariablen keine Leerzeichen, Bindestriche oder Klammern enthalten dürfen, verwendet der Standardname einer duplizierten Projektvariablen keine Klammern und verwendet stattdessen einen Unterstrich anstelle der Leerzeichen und des Bindestrichs.

Paste

Sobald Sie eine Kopie eines Elements in Ihrer Zwischenablage haben, können Sie es im selben Projekt mit der aktuellen Browseranwendung oder dem Browsermodus, aus dem Sie es kopiert haben, einfügen.

Ein Element (außer den unten genannten) kann auch zwischen Projekten eingefügt werden, die in derselben Browsersitzung geöffnet sind. Beim Einfügen von Aktivitäten zwischen Projekten wird beim ersten Einfügen der Aktivität ein neuer Endpunkt erstellt. Weitere Einfügungen in dasselbe Projekt werden mit dem vorhandenen Endpunkt verbunden.

Schneiden oder Kopieren eines Elements und verwenden Sie dann die Menüaktion Einfügen aus dem Aktionsmenü der Komponentenpalette im Komponenten-Tab des Projektbereichs (siehe Aktionsmenü des Komponenten-Tabs im Projektbereich Komponenten-Tab). Diese Aktion ist in den Kategorien Dateien, Endpunkte, Skripte, Transformationen, Projektvariablen, E-Mails und Zeitpläne verfügbar und ist nur aktiviert, wenn Sie ein Element des entsprechenden Typs in Ihrer Zwischenablage haben.

Beim Erstellen des neuen Elements wird der Cursor auf den Elementnamen zum Umbenennen positioniert.

Duplicate

Sie können die Menüaktion Duplizieren für ein Element im Projekt über das Aktionsmenü eines Elements im Komponenten-Tab des Projektbereichs aufrufen (siehe Aktionsmenü der Komponenten im Projektbereich Komponenten-Tab).

Beim Klicken auf Duplizieren wird eine neue, nicht referenzierte, unabhängige Komponente erstellt, die dieselbe Konfiguration wie die ursprüngliche unabhängige Komponente verwendet.

Salesforce, Salesforce Service Cloud und ServiceMax-Aktivitäten

Für Salesforce, Salesforce Service Cloud und ServiceMax-Aktivitäten können Sie die Aktivität auch auf die Entwurfsfläche einfügen, um eine neue, unabhängige Komponente auf eine der folgenden Arten zu erstellen:

• Wählen Sie eine Ablagezone auf der Entwurfsfläche aus und verwenden Sie dann die Menüaktion Einfügen (siehe Menüaktionen der Ablagezone in Entwurfsfläche), um eine Aktivitätsinstanz im Projekt zu erstellen und eine Referenz zu dieser Aktivitätsinstanz im Projektworkflow hinzuzufügen.
• Wählen Sie eine Ablagezone auf der Entwurfsfläche aus und verwenden Sie dann die Tastenkombination Control+V (Windows oder Linux) oder Command+V (macOS), um eine Aktivitätsinstanz im Projekt zu erstellen und eine Referenz zu dieser Aktivitätsinstanz im Projektworkflow hinzuzufügen.

Sie können auch eine vorhandene Salesforce-, Salesforce Service Cloud- oder ServiceMax-Aktivität aus dem Komponenten-Tab des Projektfensters in eine Komponentenablagezone auf der Entwurfsfläche ziehen.

Beim Platzieren der Aktivität auf der Entwurfsfläche zeigt ein Dialog an, dass eine neue, unabhängige Komponente erstellt wird:

Erstellen einer Aktivitäts- oder Toolinstanz

Sie können eine Instanz einer Aktivität oder eines Tools als neue, unabhängige Komponente erstellen, indem Sie sie ziehen und ablegen (siehe Ziehen und Ablegen unten) oder indem Sie eine Kombination der Menüaktionen Kopieren (siehe Kopieren und Ausschneiden von Komponenten oben) und Einfügen (siehe Einfügen unten) oder deren Tastenkombinationen verwenden.

Drag and drop

Ziehen Sie einen Aktivitäts- oder Tooltyp aus der Design-Komponentenpalette in den Projektendpunkte und -verbindungen, Globale Endpunkte oder Tools Tabs in eine Ablagezone innerhalb eines Workflows:

Paste

Wenn Sie einen Aktivitätstyp kopieren, wird die Kopie verwendet, um eine neue, unabhängige Komponente im Projekt (eine Aktivitätsinstanz) zu erstellen.

Sobald Sie den Aktivitätstyp kopiert haben, können Sie ihn im selben Projekt mit der aktuellen Browseranwendung oder dem Browsermodus, aus dem Sie ihn kopiert haben, einfügen. Das Einfügen von Aktivitätstypen zwischen Projekten und Browsermodi wird nicht unterstützt.

Kopieren Sie einen Aktivitätstyp und fügen Sie ihn dann auf eine der folgenden Arten ein — wodurch eine Aktivitätsinstanz als unabhängige Komponente erstellt wird:

• Verwenden Sie die Menüaktion Aktivität einfügen, die über das Aktionsmenü des Komponenten-Tabs im Projektbereich zugänglich ist (siehe Aktionsmenü des Komponenten-Tabs im Projektbereich Komponenten-Tab), um eine Aktivitätsinstanz im Projekt zu erstellen.
• Wählen Sie eine Ablagezone auf der Design-Leinwand aus und verwenden Sie dann die Menüaktion Einfügen (siehe Aktionsmenü der Ablagezone in Design-Leinwand), um eine Aktivitätsinstanz im Projekt zu erstellen und eine Referenz zu dieser Aktivitätsinstanz im Projektworkflow hinzuzufügen.
• Wählen Sie eine Ablagezone auf der Design-Leinwand aus und verwenden Sie dann die Tastenkombination Control+V (Windows oder Linux) oder Command+V (macOS), um eine Aktivitätsinstanz im Projekt zu erstellen und eine Referenz zu dieser Aktivitätsinstanz im Projektworkflow hinzuzufügen.

Erstellen einer Komponentenreferenz

Bestimmte Arten von Komponenten können als Operation Schritte verwendet werden, einschließlich Aktivitäten und Tools. Andere Arten von Komponenten können zur Unterstützung von Operationen verwendet werden. Die meisten dieser Komponententypen können mehrfach referenziert werden, wie im Folgenden beschrieben.

Komponenten, die als Operation Schritte verwendet werden

Bestimmte Arten von Aktivitäten und Tools können mehrfach als Schritte in einer Operation referenziert werden:

• Aktivitäten: Die meisten Aktivitäten können mehrfach als Operation Schritte referenziert werden. Ausnahmen sind Salesforce, Salesforce Service Cloud und ServiceMax-Aktivitäten, die nicht von mehr als einer Komponente referenziert werden können. Stattdessen können Sie eine Kopie einer Salesforce-, Salesforce Service Cloud- oder ServiceMax-Aktivität erstellen, um sie an anderer Stelle zu verwenden.

• Tools: Alle Tools (Transformationen, Skripte und Flow Control-Tools) können mehrfach als Operation Schritte referenziert werden.

  Hinweis

  Beim Referenzieren einer Transformation, die ein Schema von einer Aktivität erbt, steuert die Reihenfolge, in der die Schritte einer Operation konfiguriert sind, wie Schemas über Transformationsreferenzen propagiert werden, wie in Transformation Wiederverwendung beschrieben.

Sie können eine Referenz zu einer dieser Arten von Komponenten als Operation Schritt erstellen, indem Sie sie per Drag & Drop verschieben oder eine Kombination der Menüaktionen Ausschneiden oder Kopieren und Einfügen oder deren Tastenkombinationen verwenden.

Drag & Drop

Ziehen Sie die Komponente von der Komponenten-Registerkarte im Projektbereich in eine Ablagezone innerhalb eines Workflows:

Paste

Sobald Sie eine Kopie einer Komponente in Ihrer Zwischenablage haben, können Sie sie im selben Projekt mit der aktuellen Browseranwendung oder dem Browsermodus, von dem Sie sie kopiert haben, einfügen. Das Einfügen von Komponentenreferenzen zwischen Projekten und Browsermodi wird nicht unterstützt.

Schneiden oder Kopieren einer Komponente, wählen Sie eine Ablagezone auf der Designfläche aus und fügen Sie dann die Komponente auf eine dieser Arten ein:

• Verwenden Sie die Aktion Einfügen im Menü der Ablagezonenaktion auf der Designfläche (siehe Menü der Ablagezonenaktionen in Designfläche).
• Verwenden Sie die Tastenkombination Control+V (Windows oder Linux) oder Command+V (macOS).

Components used in support of an operation

Die meisten Komponenten, die nicht als Schritte in einer Operation verwendet werden können, können möglicherweise auf andere Weise wiederverwendet oder referenziert werden. Die Wiederverwendung von Komponenten zur Unterstützung von Operationen wird in der Dokumentation für jede Komponente behandelt:

• Endpoints: Endpoints in Jitterbit Script, um bestimmte Arten von bestehenden Verbindungen und Aktivitäten als Argumente mit Jitterbit-Funktionen zu verwenden
• Notifications: E-Mail-Benachrichtigungen, um eine vorhandene E-Mail-Nachricht in mehreren Operationsketten zu verlinken
• Operations: Operationen in Jitterbit Script, um vorhandene Operationen als Argumente mit Jitterbit-Funktionen zu verwenden
• Schedules: Betriebspläne, um vorhandene Zeitpläne auf mehrere Operationen anzuwenden
• Schemas: Beispieldateischema, um ein gespeichertes Schema während der Schema-Definition auszuwählen
• Scripts: Skripte in Jitterbit Script, um vorhandene Skripte als Argumente mit Jitterbit-Funktionen zu verwenden
• Variables: Variablen, um auf Variablen zu verweisen, die beliebig oft gelesen werden können

Die Anzahl der Komponentenreferenzen anzeigen

Komponentenreferenzen werden gezählt und im Komponenten-Tab des Projektfensters angezeigt.

Wenn eine Komponente von keiner der Operationen innerhalb der Workflows eines Projekts referenziert wird, wird sie als ungenutzte Komponente bezeichnet. Ungenutzte Komponenten werden mit einem unreferenzierten Symbol neben dem Komponentennamen angezeigt.

Zum Beispiel werden diese beiden neuen Skripte von keiner Workflow-Operation referenziert:

Wenn eine Komponente nur einmal auf der Entwurfsfläche referenziert wird, wird sie im Projektfenster ohne visuelle Kennzeichnung neben dem Komponentennamen angezeigt.

Zum Beispiel werden diese Skripte jeweils innerhalb einer einzelnen Workflow-Operation verwendet:

Wenn eine Komponente mehrfach auf der Entwurfsfläche referenziert wird, einschließlich innerhalb anderer Komponenten, die auf der Entwurfsfläche verwendet werden, wird die Anzahl der Referenzen in einem Badge neben dem Komponentennamen angezeigt.

In diesem Beispiel wird das erste Skript sowohl innerhalb einer Workflow-Operation als auch von einem anderen Skript innerhalb einer Workflow-Operation referenziert, und das zweite Skript wird von einem zusätzlichen Skript innerhalb einer Workflow-Operation referenziert:

Diese Zählung ist nicht unbedingt die Anzahl der Male, die die Komponente referenziert wird; wenn eine Komponente mehrfach von einer anderen Komponente referenziert wird, zählt dies als eine einzige Referenz. Zum Beispiel:

• Eine Projektvariable, die mehrere Male innerhalb eines Skripts referenziert wird, zählt als nur einmal referenziert.
• Eine Projektvariable, die mehrere Male innerhalb einer Aktivitätskonfiguration referenziert wird, zählt als nur einmal referenziert.