Wiederverwenden von Projektkomponenten im Jitterbit Integration Studio

Einführung

Auf dieser Seite wird die Wiederverwendung von Projektkomponenten beschrieben, die als Operation oder zur Unterstützung von Vorgängen eingesetzt werden.

Diese Seite ist in folgende Abschnitte unterteilt:

• Terminologie zur Wiederverwendung von Komponenten
  In diesem Abschnitt wird die Terminologie definiert, die zur Diskussion der Wiederverwendung von Komponenten verwendet wird. Das Erkennen des Unterschieds zwischen unabhängigen Komponenten und Verweisen auf diese Komponenten bildet die Grundlage für das Verständnis der zugehörigen UI-Begriffe:
  • Duplizieren einer Komponente zum Erstellen einer Kopie
  • Verweisen auf eine vorhandene Komponente
  • Ausschneiden oder Kopieren von Komponenten zum Platzieren in der Zwischenablage
  • Einfügen als neue Komponente oder als Verweis, je nach Kontext
• Komponenten ausschneiden und kopieren
  In diesem Abschnitt werden die verschiedenen Stellen beschrieben, an denen Sie Komponenten ausschneiden und kopieren können. Durch das Ausschneiden einer Komponente wird auch die Komponente oder ihre Referenz aus dem Projekt gelöscht, je nachdem, wo sie ausgeschnitten wurde.
• Erstellen einer neuen Komponente aus einer vorhandenen Komponente
  In diesem Abschnitt werden die verschiedenen Möglichkeiten beschrieben, wie Sie aus einer vorhandenen Komponente eine neue Komponente erstellen können. Normalerweise geschieht dies durch Duplizieren einer vorhandenen Komponente oder durch Ausschneiden/Kopieren und Einfügen an bestimmten Stellen. Bestimmte Arten von Aktivitäten (Salesforce, Salesforce Service Cloud und ServiceMax Aktivitäten) führen beim Einfügen immer zu einer neuen Komponente, da die Wiederverwendung mehrerer gleicher Instanzen dieser Aktivitätstypen nicht zulässig ist.
• Erstellen einer Aktivitätsinstanz
  In diesem Abschnitt werden die verschiedenen Möglichkeiten beschrieben, wie Sie eine Aktivitätsinstanz als neue, unabhängige Komponente erstellen können. Dies geschieht durch Ziehen und Ablegen oder durch Ausschneiden/Kopieren und Einfügen an den angegebenen Stellen.
• Komponentenreferenz erstellen
  In diesem Abschnitt werden die verschiedenen Möglichkeiten beschrieben, wie Sie Komponenten referenzieren können. Bestimmte Komponenten können als Operation verwendet werden, während andere Komponententypen 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 von einer Aktivität geerbtes Schema verwendet, finden Sie als Ergänzung zu dieser Seite in Wiederverwendung von Transformation.

Die Wiederverwendung von Operationen selbst wird in Operationswiederverwendung behandelt.

Terminologie zur Wiederverwendung von Komponenten

Projektkomponenten, wie sie im Integration Studio Die Benutzeroberfläche kann entweder aus unabhängigen Komponenten oder Komponentenreferenzen bestehen:

• Unabhängige Komponenten sind die einzelnen Bausteine eines Projekts und befinden sich auf der Tab Komponenten des Projektfensters. Unabhängige Komponenten sind die Komponenten im Projekt.
• Komponentenreferenzen verweisen auf die unabhängigen Komponenten. Komponentenreferenzen in Projekt Workflows sind im Design-Canvas enthalten und im Projektfenster auf der Tab Workflows. Auf Komponenten kann auch von Komponenten verwiesen werden, die nicht Teil eines Workflows sind.

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

• Duplizieren verwendet die Konfiguration einer vorhandenen Komponente, um eine neue, unabhängige Komponente in einem Projekt zu erstellen. Nachdem Sie eine Komponente dupliziert haben, werden alle Änderungen, die Sie an der ursprünglichen unabhängigen Komponente vornehmen, nicht in der Kopie widergespiegelt, und alle Änderungen, die Sie an der Kopie vornehmen, wirken sich nicht auf die ursprüngliche unabhängige Komponente aus. Wenn Sie eine Komponente duplizieren, wird eine neue Komponente auf der Tab Komponenten des Projektbereichs angezeigt und ist eine unabhängige Komponente im Projekt. Eine Komponente kann auch zwischen Projekten eingefügt werden, die in derselben Browsersitzung geöffnet sind.
• Referenzierung ist die mehrmalige Verwendung derselben Komponente in einem Projekt und ist die Art und Weise, wie Sie Projekt Workflows erstellen. Ein Komponentenverweis in einem Workflow ist eine Operation, Aktivität, Transformation, ein Script oder eine Email-Benachrichtigung, die visuell auf der Design-Canvas dargestellt wird und auf der Tab Workflows des Projektbereichs angezeigt wird (mit Ausnahme von Email Benachrichtigungen). Komponentenverweise können auch in anderen Komponenten enthalten sein, die in Projekt Workflows enthalten sein können, aber nicht müssen. So kann zum Beispiel auf eine Projektvariable in der Konfiguration einer Aktivität verwiesen werden, die als Operation Schritt in einem Projekt-Workflow verwendet wird, und sie kann auch in einem Script referenziert werden, das selbst von keinem Projekt-Workflows referenziert wird. Wenn Sie auf eine Komponente innerhalb oder außerhalb von Projekt-Workflows verweisen, wird die Referenzanzahl der Komponente auf der Tab Komponenten des Projektbereichs erhöht.

Das Wort Kopie wird als Substantiv verwendet, um eine neue, unabhängige Komponente zu beschreiben, die aus einer vorhandenen Komponente erstellt wurde.

Die Wörter Ausschneiden und Kopieren als Aktionen legen beide eine Kopie einer Komponente in Ihre Zwischenablage, die dann verwendet wird, um entweder eine unabhängige Komponente oder eine Komponentenreferenz zu erstellen. Was von beiden erstellt wird, hängt vom Kontext beim Einfügen ab:

• Schneiden legt eine Kopie einer Komponente in Ihre Zwischenablage und löscht entweder die ursprüngliche unabhängige Komponente oder die Komponentenreferenz, je nachdem, wo die Komponente ausgeschnitten wurde:
  • Wenn eine Komponente aus der Tab Komponenten des Projektbereichs ausgeschnitten wird, wird die ursprüngliche unabhängige Komponente gelöscht.
  • Wenn eine Komponente aus der Design-Canvas oder der Tab Workflows des Projektbereichs ausgeschnitten wird, wird nur die Referenz gelöscht und die ursprüngliche unabhängige Komponente bleibt unverändert, da es sich bei der Komponente um eine Referenz auf eine ursprüngliche, unabhängige Komponente handelt.
• Kopieren legt eine Kopie einer Komponente oder eines Aktivitätstyps in Ihre Zwischenablage. Die ursprüngliche unabhängige Komponente bleibt unverändert. Wenn Sie eine Komponente kopieren und dann einfügen, kann dies je nach Kontext beim Einfügen entweder zu einer neuen unabhängigen Komponente oder zu einem Komponentenverweis führen.
• Einfügen erstellt je nach Kontext beim Einfügen entweder eine unabhängige Komponente oder eine Komponentenreferenz. Beispiel:
  • Einfügen einer Komponente oder eines Aktivitätstyps in die Tab Komponenten des Projektbereichs erstellt eine neue, unabhängige Komponente. Einfügen eines Aktivitätstyps erstellt eine Aktivitätsinstanz als neue, unabhängige Komponente.
  • Einfügen einer Komponente in die Design-Canvas fügt einen Verweis auf die ursprüngliche unabhängige Komponente im Projekt Workflow hinzu. (Eine Ausnahme: Das Einfügen eines Salesforce, Salesforce Service Cloud oder ServiceMax Aktivität auf der Design-Canvas erstellt eine neue, unabhängige Komponente anstelle einer Komponentenreferenz.)
  • Einfügen eines Aktivitätstyps in die Design-Canvas oder die Tab Workflows im Projektbereich erstellt eine Aktivitätsinstanz als neue, unabhängige Komponente und fügt im Projekt-Workflow einen Verweis auf diese Aktivität hinzu.

Komponenten ausschneiden und kopieren

Sie können auf die Menüaktionen Ausschneiden und Kopieren über das Aktionsmenü einer Komponente oder eines Aktivitätstyps an einer der folgenden Stellen zugreifen:

• Unabhängige Komponenten auf der Tab Komponenten des Projektbereichs (siehe Aktionsmenü im Projektbereich Tab Komponenten).
• Komponentenreferenzen im Design-Canvas (siehe Aktionsmenü in Entwurfsfläche).
• Komponentenreferenzen im Tab Workflows des Projektfensters (siehe Aktionsmenü Komponentenaktionen im Projektbereich Tab Workflows).
• Aktivitätstypen auf der Tab Endpoints und -konnektoren der Designkomponentenpalette (siehe Aktionsmenü Verbindungsaktionen und Aktivitätstyp-Aktionsmenü in Komponentenpalette).

Sie können auch die Standard-Tastaturkürzel zum Ausschneiden verwenden (Control+X unter Windows oder Linux und Command+X unter macOS) und kopieren Sie (Control+C unter Windows oder Linux und Command+C unter macOS).

Beim Ausschneiden und Kopieren von Komponenten wird eine Kopie der Komponente in Ihrer Zwischenablage abgelegt. Aktivitätstypen können auch aus der Design-Komponentenpalette kopiert werden. Die Kopie in der Zwischenablage wird zum Erstellen einer neuen Komponente im Projekt (einer Aktivitätsinstanz) verwendet.

Durch das Ausschneiden einer unabhängigen Komponente aus dem Projekt (über die Tab Komponenten im Projektfenster) wird die ursprüngliche unabhängige Komponente aus dem Projekt gelöscht. Da das Löschen erforderlich ist, ist das Ausschneiden einer Komponente nur bei nicht referenzierten Komponenten möglich. Die Standarddialoge zum Löschen werden wie in Komponentenabhängigkeiten, Löschen und Entfernen dokumentiert angezeigt.

Wenn Sie eine Komponentenreferenz aus einem Projekt-Workflow ausschneiden (von der Design-Canvas oder der Tab Workflows des Projektbereichs), wird nur die Komponentenreferenz gelöscht. Die ursprüngliche unabhängige Komponente bleibt unverändert.

Erstellen einer neuen Komponente aus einer vorhandenen Komponente

Das Erstellen einer neuen, unabhängigen Komponente aus einer vorhandenen, unabhängigen Komponente ist für Schemata, Aktivitäten, Scripts, Transformations, Projektvariablen, Email Benachrichtigungen und Zeitpläne verfügbar.

Sie können aus diesen vorhandenen Komponenten eine neue Komponente erstellen, indem Sie eine Kombination der Menüaktionen Ausschneiden oder Kopieren verwenden (siehe Komponenten kopieren und ausschneiden oben) und Einfügen (siehe Einfügen unten) (oder ihre Tastaturkürzel) oder mithilfe der Menüaktion Duplizieren (siehe Duplizieren unten). Es gibt weitere Möglichkeiten zum Erstellen neuer Salesforce, Salesforce Service Cloud und ServiceMax Aktivitäten (siehe Salesforce, Salesforce Service Cloud und ServiceMax-Aktivitäten unten).

Der Standardname der neuen Komponente verwendet den Namen der ursprünglichen unabhängigen Komponente, an den - Kopie angehängt wird. Nachfolgende Kopien werden zusätzlich mit einer in Klammern angehängten inkrementierten Nummer versehen. Da Projektvariablennamen keine Leerzeichen, Bindestriche oder Klammern enthalten dürfen, verwendet der Standardname einer duplizierten Projektvariablen keine Klammern und verwendet anstelle der Leerzeichen und Bindestriche einen Unterstrich.

Paste

Sobald Sie eine Kopie einer Komponente in Ihrer Zwischenablage haben, können Sie sie mit der aktuellen Browseranwendung oder dem aktuellen Browsermodus in dasselbe Projekt einfügen, aus dem Sie sie kopiert haben.

Eine Komponente (mit Ausnahme der unten aufgeführten) 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 Endpoint erstellt. Nachfolgende Einfügungen in dasselbe Projekt werden mit dem vorhandenen Endpoint verbunden.

Eine Komponente ausschneiden oder kopieren und verwenden Sie dann die Menüaktion Einfügen aus dem Aktionsmenü der Komponentenpalette auf der Tab Komponenten des Projektbereichs (siehe Aktionsmenü der Tab „Komponenten“ im Projektbereich Tab Komponenten). Diese Aktion ist in den Kategorien Dateien, Endpoints, Scripts, Transformations, Projektvariablen, Emails und Zeitpläne verfügbar und wird nur aktiviert, wenn Sie eine Komponente des entsprechenden Typs in Ihrer Zwischenablage haben.

Beim Anlegen der neuen Komponente wird Ihr Cursor zum Umbenennen auf den Komponentennamen positioniert.

Duplizieren

Sie können auf die Menüaktion Duplizieren für eine Komponente im Projekt über das Aktionsmenü einer Komponente auf der Tab Komponenten im Projektbereich zugreifen (siehe Aktionsmenü im Projektbereich Tab Komponenten).

Wenn Sie auf Duplizieren klicken, wird eine neue, nicht referenzierte, unabhängige Komponente mit derselben Konfiguration wie die ursprüngliche unabhängige Komponente erstellt.

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 der Design-Canvas einfügen, um auf eine der folgenden Arten eine neue, unabhängige Komponente zu erstellen:

• Wählen Sie eine Drop-Zone auf der Design-Canvas aus und verwenden Sie dann deren Menüaktion Einfügen (siehe Aktionsmenü in Entwurfsfläche), um eine Aktivitätsinstanz im Projekt zu erstellen und im Projekt-Workflow einen Verweis auf diese Aktivitätsinstanz hinzuzufügen.
• Wählen Sie eine Drop-Zone auf der Design-Canvas 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 im Projekt-Workflow einen Verweis auf diese Aktivitätsinstanz hinzuzufügen.

Sie können auch eine vorhandene Salesforce -, Salesforce Service Cloud- oder ServiceMax Aktivität aus der Tab Komponenten des Projektbereichs ziehen zu einer Komponenten-Drop-Zone auf der Design-Canvas.

Beim Platzieren der Aktivität auf der Design-Canvas wird in einem Dialogfeld darauf hingewiesen, dass eine neue, unabhängige Komponente erstellt wird:

Erstellen einer Aktivitätsinstanz

Sie können eine Aktivitätsinstanz als neue, unabhängige Komponente per Drag & Drop erstellen (siehe Drag & Drop unten) oder durch eine Kombination aus Kopieren (siehe Ausschneiden und und Ausschneidekomponenten oben) und Einfügen-Menüaktionen (siehe Einfügen unten) oder ihre Tastaturkürzel.

Ziehen und Ablegen

Ziehen Sie einen Aktivitätstyp aus der Designkomponentenpalette Endpoints und -konnektoren oder Globale Endpoints Tabs auf eine Operation auf der Design-Canvas:

Paste

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

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

Einen Aktivitätstyp kopieren und fügen Sie es 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, auf die Sie über das Aktionsmenü der Tab Komponenten in der Tab Komponenten des Projektbereichs zugreifen können (siehe Aktionsmenü der Tab Komponenten im Projektbereich Tab Komponenten), um eine Aktivitätsinstanz im Projekt zu erstellen.
• Wählen Sie eine Drop-Zone auf der Design-Canvas aus und verwenden Sie dann deren Menüaktion Einfügen (siehe Aktionsmenü in Entwurfsfläche), um eine Aktivitätsinstanz im Projekt zu erstellen und im Projekt-Workflow einen Verweis auf diese Aktivitätsinstanz hinzuzufügen.
• Wählen Sie eine Drop-Zone auf der Design-Canvas 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 im Projekt-Workflow einen Verweis auf diese Aktivitätsinstanz hinzuzufügen.

Erstellen einer Komponentenreferenz

Bestimmte Komponententypen können als Operation verwendet werden, darunter Aktivitäten, Scripts und Transformations. Andere Komponententypen können zur Unterstützung von Operationen verwendet werden. Die meisten dieser Komponententypen können mehrfach referenziert werden, wie unten beschrieben.

Als Operation verwendete Komponenten

Auf bestimmte Arten von Aktivitäten, Transformations und Scripts kann mehrfach als Schritt in einer Operation verwiesen werden:

• Aktivitäten: Die meisten Aktivitäten können mehrfach als Operation referenziert werden. Ausnahmen sind Salesforce, Salesforce Service Cloud und ServiceMax Aktivitäten, auf die nicht von mehr als einer Komponente verwiesen werden kann. Stattdessen können Sie eine Kopie einer Salesforce-, Salesforce Service Cloud- oder ServiceMax-Aktivität erstellen, um sie an anderer Stelle zu verwenden.
• Transformations: Alle Transformations können mehrfach als Operation referenziert werden. Wenn eine Transformation mithilfe eines von einer Aktivität geerbten Schema referenziert wird, steuert die Reihenfolge, in der die Schritte einer Operation konfiguriert werden, wie Schemata über Transformation hinweg weitergegeben werden, wie in Transformation beschrieben.
• Scripts: Auf alle Scripts der Projektkomponenten kann mehrfach als Operation verwiesen werden.

Sie können per Drag & Drop oder mit einer Kombination der Menüaktionen Ausschneiden oder Kopieren und Einfügen bzw. der entsprechenden Tastaturkürzel einen Verweis auf einen dieser Komponententypen als Operation Schritt erstellen.

Ziehen und Ablegen

Ziehen Sie die Komponente aus der Tab Komponenten des Projektbereichs auf eine Operation auf der Design-Canvas:

Paste

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

Eine Komponente ausschneiden oder kopieren, wählen Sie eine Drop-Zone auf der Design-Canvas aus und fügen Sie die Komponente dann auf eine der folgenden Arten ein:

• Verwenden Sie die Menüaktion Einfügen, auf die Sie über das Aktionsmenü der Drop-Zone auf der Design-Canvas zugreifen können (siehe Aktionsmenü in Entwurfsfläche).
• Verwenden Sie die Tastenkombination Control+V (Windows oder Linux) oder Command+V (macOS).

Zur Unterstützung einer Operation verwendete Komponenten

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

• Endpoints: Endpoints in Jitterbit Script, um bestimmte Typen bestehender Verbindungen und Aktivitäten als Argumente mit Jitterbit-Funktionen zu verwenden
• Benachrichtigungen: Email Benachrichtigungen, zum Verknüpfen einer bestehenden Email Nachricht in mehreren Operation
• Operationen: Operationen in Jitterbit Script, um vorhandene Operationen als Argumente mit Jitterbit-Funktionen zu verwenden
• Zeitpläne: Operationszeitpläne, um vorhandene Pläne auf mehrere Vorgänge anzuwenden
• Schemas: Schema, zur Auswahl eines gespeicherten Schema während der Schemadefinition
• Scripts: Scripts in Jitterbit Script, um vorhandene Scripts als Argumente mit Jitterbit-Funktionen zu verwenden
• Variablen: Variablen, zum Referenzieren von Variablen, die beliebig oft gelesen werden können

Zeigen Sie die Anzahl der Komponentenreferenzen an

Komponentenreferenzen werden gezählt und innerhalb der Tab Komponenten 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 Nicht referenziertes Symbol neben dem Komponentennamen.

Auf die folgenden beiden neuen Scripts wird beispielsweise in keinem Workflow-Vorgang verwiesen:

Wenn auf der Design-Canvas nur einmal auf eine Komponente verwiesen wird, wird sie im Projektbereich ohne visuellen Indikator neben dem Komponentennamen angezeigt.

Beispielsweise werden diese Scripts jeweils innerhalb einer einzelnen Workflow Operation verwendet:

Wenn auf eine Komponente auf der Design-Canvas mehrfach verwiesen wird, auch innerhalb anderer Komponenten, die auf der Design-Canvas verwendet werden, wird die Anzahl der Verweise in einem Kennzeichen neben dem Komponentennamen angezeigt.

In diesem Beispiel wird auf das erste Script sowohl innerhalb einer Workflow Operation als auch von einem anderen Script innerhalb einer Workflow Operation verwiesen, und auf das zweite Script wird von einem weiteren Script innerhalb einer Workflow Operation verwiesen:

Diese Anzahl entspricht nicht notwendigerweise der Anzahl der Referenzen auf die Komponente. Wenn eine Komponente mehrfach von einer anderen Komponente referenziert wird, zählt dies als eine einzelne Referenz. Beispiel:

• Eine Projektvariable, die innerhalb eines Script mehrmals referenziert wird, zählt als nur einmal referenziert.
• Eine Projektvariable, die innerhalb einer Aktivitätskonfiguration mehrmals referenziert wird, zählt als nur einmal referenziert.