Schemaverwendung im Jitterbit Integration Studio

Einführung

Schemata werden verwendet, um die Anforderungs- und Antwortstrukturen in einer Transformation darzustellen. Diese Schemata können von Aktivitäten geerbt werden, die ursprünglich neben der Transformation liegen, oder sie können direkt in einer Transformation definiert werden. Auf dieser Seite wird beschrieben, wann Schemata verwendet werden und wie Schemata definiert werden.

Wann wird ein Schema verwendet?

Ob ein Schema verwendet wird, hängt von der Aktivität ab und davon, ob es als Quelle oder Ziel einer Transformation verwendet wird.

Quellen

Eine Quellaktivität ist jede Aktivität, die Daten innerhalb einer Operation bereitstellt, die dann unverändert oder durch eine Transformation verändert auf ein Ziel übertragen werden können bevor ein Ziel erreicht wird.

Quellaktivitäten erfordern nur dann ein Schema, wenn sie als Eingabe in einer Transformation verwendet werden:

• Wenn die Quellaktivität Daten bereitstellt, die transformiert werden, muss sie über ein Schema verfügen, das entweder automatisch bereitgestellt wird oder beim Konfigurieren der Aktivität oder Transformation definiert werden kann.
• Wenn die Quellaktivität Daten bereitstellt, die nicht transformiert werden, muss kein Schema definiert werden, da das Schema im Operation nicht verwendet wird.

Zu den Aktivitäten, die typischerweise (aber nicht notwendigerweise) als Quellen verwendet werden, zählen solche, deren Name eines dieser Wörter enthält:

• Herunterladen
• Erhalten
• Lesen
• Anfrage
• Abfrage

Ziele

Eine Zielaktivität ist jede Aktivität, die Daten innerhalb einer Operation empfängt. Diese Daten können aus einer Quellaktivität, aus einer Transformation oder aus anderen Eingaben wie Variablen oder Scripts.

Zielaktivitäten erfordern nur dann ein Schema, wenn sie transformierte Daten empfangen oder eine Antwort bereitstellen, die Sie in ein anderes Ziel schreiben möchten:

• Wenn die Zielaktivität transformierte Daten empfängt, muss sie über ein Schema verfügen, das entweder automatisch bereitgestellt wird oder beim Konfigurieren der Aktivität oder Transformation definiert werden kann.
• Wenn die Zielaktivität Daten empfängt, die nicht transformiert wurden, muss kein Schema definiert werden, da das Schema im Operation nicht verwendet wird.
• Wenn ein bestimmter Typ von Zielaktivität eine Antwort bereitstellt, können Sie auch ein Schema haben. Wenn Sie die Antwort in ein anderes Ziel schreiben möchten, wird das Schema entweder automatisch bereitgestellt oder kann beim Konfigurieren der Aktivität oder Transformation definiert werden. Wenn der Zieltyp eine Antwort bereitstellt, ist kein Operation erforderlich, um die Antwort in ein anderes Ziel zu schreiben. Das heißt, ein Schema kann bereitgestellt werden, kann aber innerhalb des Operation ignoriert werden, wenn es nicht erforderlich ist.

Zu den Aktivitäten, die typischerweise (aber nicht notwendigerweise) als Ziele verwendet werden, zählen solche, deren Name eines dieser Wörter enthält:

• Hinzufügen
• Erstellen
• Löschen
• Einfügen
• Post
• Setzen
• Antwort
• Hochladen
• Aktualisieren
• Upsert
• Schreiben

So werden Schemata definiert

Schemata werden entweder in einer Aktivität definiert oder in einer Transformation. Bei einer Operation hat ein in einer benachbarten Aktivität bereitgestelltes Schema (oder eine ursprünglich benachbarte Aktivität, die inzwischen entfernt wurde) Vorrang vor einem in einer Transformation definierten Schema.

Dieses Diagramm zeigt eine Operation, deren Transformation ihr Schema von einer vorhergehenden benachbarten Aktivität erbt und über ein durch die Transformation definiertes Schema verfügt:

In einer Aktivität definierte Schemata können entweder vom Connector generiert oder benutzerdefiniert sein:

• Vom Connector generiert: Vom Connector generierte Schemata sind entweder im Connector festgelegt oder werden direkt vom Endpoint generiert. Abhängig von der jeweiligen Aktivität kann entweder ein Anforderungs- oder ein Schema oder sowohl ein Anforderungs- als auch ein Schema bereitgestellt werden. Vom Connector generierte Schemata haben einen automatisch generierten Namen, der davon abhängt, ob das Schema eine Anforderung oder eine Antwort ist:

  User-defined Endpoint Name→User-defined Activity Name→Request
  

  User-defined Endpoint Name→User-defined Activity Name→Response
  

  Diese Transformation zeigt die Namen der vom Connector generierten Schemas, die von Aktivitäten sowohl auf der Quell- als auch auf der Zielseite geerbt werden:

  

  Je nach Konnektor kann die Struktur einiger vom Konnektor generierter Schemata vom Benutzer bearbeitet werden, oder die Struktur kann sich dynamisch basierend auf Benutzereingaben während der Aktivitätskonfiguration oder basierend auf Änderungen am Endpoint selbst ändern.

  Die Namen der vom Connector generierten Schemas können von einem Benutzer nicht bearbeitet werden.

• Benutzerdefiniert: Benutzerdefinierte Schemata werden vom Benutzer bereitgestellt, entweder durch Erstellen eines benutzerdefinierten Schema, durch Hochladen einer Datei oder URL oder durch manuelles Eingeben des Schema. Abhängig von der jeweiligen Aktivität kann entweder ein Anforderungs- oder ein Schema, sowohl ein Anforderungs- als auch ein Schema oder kein Schema definiert werden.

  Die Namen benutzerdefinierter Schemas basieren auf dem Namen der bereitgestellten Datei oder sind benutzerdefiniert.

Bei Verwendung in einer Operation muss Aktivitäten mit einem Schema nicht unbedingt eine Transformation vorangestellt werden. Ebenso muss Aktivitäten mit einem Schema nicht unbedingt eine Transformation folgen. In manchen Fällen, z. B. bei einer Operation zum Archivieren von Dateien aus einer Datenquelle in ein Ziel ohne Transformation, sind keine Schemata erforderlich. Wenn sie angegeben werden, werden sie einfach ignoriert.

Wenn in einer Operation eine Transformation ein Schema erfordert, muss ihr eine Aktivität vorangehen, die ein Schema bereitstellt. Weitere Regeln und Muster zum Erstellen einer gültigen Operation werden in Operationsgültigkeit behandelt.

Von der Aktivität bereitgestellte Antwort- und Anforderungsschemata überschreiben immer von der Transformation bereitgestellte Quell- und Zielschemata, sofern vorhanden:

• Von der Aktivität bereitgestelltes Schema: Wenn einer Transformation eine Connector-Aktivität mit einem Schema vorangestellt wird, wird das Schema von der Transformation als Schema übernommen und überschreibt alle von der Transformation bereitgestellten Schema.
• Von der Aktivität bereitgestelltes Schema: Wenn eine Connector-Aktivität mit einem Schema nach einer Transformation platziert wird, wird das Schema von der vorhergehenden Transformation als Schema übernommen und überschreibt alle von der Transformation bereitgestellten Schema.

Alle Transformations sind wiederverwendbar, unabhängig davon, woher ihre Schemas stammen. Es gibt jedoch besondere Überlegungen, wenn in einem anderen Operation auf eine Transformation verwiesen wird, die ein von einer Aktivität bereitgestelltes Schema hat, wie in Wiederverwendung von Transformation beschrieben.

Wenn vor der Konfiguration einer angrenzenden Aktivität ein durch die Transformation bereitgestelltes Schema vorhanden war, kann dieses Schema nicht direkt gelöscht werden. 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, können Sie zunächst die angrenzende Aktivität vorübergehend entfernen. Sobald die angrenzende Aktivität entfernt wurde, kann ein durch die Transformation bereitgestelltes Schema mithilfe des Aktionsmenü gelöscht werden, um Schema löschen auszuwählen. Nachdem Sie das von der Transformation bereitgestellte Schema gelöscht haben, können Sie die Aktivität im Operation ersetzen.