Zum Inhalt springen

Schemaregeneration im Jitterbit Integration Studio

Einführung

Schemata werden auf eine von zwei Arten generiert. Abhängig vom verwendeten Konnektor sind dessen Schemata entweder konnektorgeneriert oder benutzerdefiniert:

  • Vom Connector generiert: Vom Connector generierte Schemas sind entweder im Connector festgelegt oder werden direkt vom Endpoint generiert.

  • Benutzerdefiniert: Benutzerdefinierte Schemas werden vom Benutzer bereitgestellt, entweder durch Erstellen eines benutzerdefinierten Schema, durch Hochladen einer Datei oder URL oder durch manuelle Eingabe des Schema.

Auf dieser Seite finden Sie Informationen zum erneuten Generieren von Schemas für beide Schema.

Vom Connector generierte Schemas

Ein vom Connector generiertes Schema (im Gegensatz zu einem benutzerdefinierten Schema) ist entweder im Connector festgelegt, oder der Connector interagiert mit diesem Endpoint basierend auf der Benutzerkonfiguration unter Verwendung der von der API des entsprechenden Endpunkts bereitgestellten Metadaten.

Sobald ein vom Connector generiertes Schema konfiguriert ist, Integration Studio speichert die Schemata innerhalb des Projekts, um ein schnelleres Laden während der Projektgestaltung zu ermöglichen.

Wenn externe Änderungen an einem Schema vorgenommen werden, das von einem Endpoint generiert wird, müssen Sie das Schema innerhalb von Integration Studio um diese Änderungen im Projekt zu verwenden. Dies kann beispielsweise erforderlich sein, wenn Sie ein benutzerdefiniertes Feld hinzugefügt oder Ihre Instanz aktualisiert haben, um eine neuere API Version zu verwenden.

Abhängig vom Endpoint gibt es zwei Möglichkeiten, Schemas neu zu generieren:

Wenn ein von einem Endpoint generiertes Schema aktualisiert wird, Integration Studio verwendet die vom Endpoint bereitgestellte API, um das Schema für diese Aktivität neu zu generieren.

Wenn ein in einem Connector festgelegtes Schema aktualisiert wird, wird das aktuelle, im Connector enthaltene Schema neu geladen, wodurch das Schema effektiv aktualisiert wird.

Durch das erneute Generieren oder Aktualisieren eines Schema aus einer Aktivität oder Transformation wird das Schema an allen Stellen aktualisiert, an denen darauf verwiesen wird. Das heißt, wenn Sie mehrere Kopien derselben Aktivität an verschiedenen Stellen im gesamten Projekt referenziert haben, wird das Schema durch Aktualisieren in der Aktivitätskonfiguration oder durch Durchlaufen der Aktivitätskonfigurationsschritte an einer Stelle für alle aktualisiert. Wenn Sie ein Schema in einer Transformation aktualisieren, wird es durch diese Aktion in der Aktivität und an allen Stellen im Projekt aktualisiert, an denen auf dieselbe Aktivität verwiesen wird.

Wenn ein Schema im System des Endpunkts Änderungen aufweist, Sie das Schema jedoch weder in der Aktivität noch in der Transformation neu generiert haben, kann der Operation erfolgreich sein oder nicht. Dies hängt von verschiedenen Faktoren ab, beispielsweise vom einzelnen Endpoint, den einzelnen Feldern, die in der Transformation zugeordnet sind, und davon, ob sich diese Felder innerhalb des Schema geändert haben. Wenn beispielsweise ein erforderliches Feld im ursprünglichen Schema später im aktualisierten Schema entfernt wird, werden Fehler vom Endpoint wahrscheinlich zur Laufzeit gemeldet. Wenn jedoch ein Feld entfernt wurde, in der Zuordnung jedoch optional ist, werden Fehler möglicherweise nicht gemeldet.

Schema Regeneration

Um ein vom Connector generiertes Schema aus einem Aktivitätskonfigurationsbildschirm neu zu generieren (außer für Schemata, die von Database, NetSuite, Salesforce, Salesforce Service Cloud oder ServiceMax Aktivitäten), klicken Sie im Schritt Datenschema auf Aktualisieren:

ServiceNow erstellen Schritt 2 Schema aktualisieren

Um ein vom Connector generiertes Schema aus einem Aktivitätskonfigurationsbildschirm neu zu generieren (einschließlich von Datenbank bereitgestellter Schemata), NetSuite, Salesforce, Salesforce Service Cloud und ServiceMax Aktivitäten), öffnen Sie die Aktivitätskonfiguration und durchlaufen Sie die einzelnen Konfigurationsschritte. Sie müssen mindestens eine Änderung an der Konfiguration vornehmen (z. B. das Hinzufügen und Entfernen eines Zeichens am Ende des Aktivitätsnamens), um eine Aktualisierung des Schema im Schritt Datenschema zu erzwingen:

Datenbank einfügen, Schritt 1, Tabelle auswählen, nächste

Datenbankeinfügung Schritt 2 Schema abgeschlossen

Transformation Schema

Um ein vom Connector generiertes Schema aus einer Transformation neu zu generieren (außer für Schemata, die von Database bereitgestellt werden), NetSuite, Salesforce, Salesforce Service Cloud oder ServiceMax Aktivitäten), klicken Sie auf das Schema Zahnradsymbol, um ein Menü zu öffnen. Wählen Sie im Menü Schema aktualisieren:

Schema Aktionsmenü Schema aktualisieren

Benutzerdefinierte Schemas

Ein benutzerdefiniertes Schema (im Gegensatz zu einem vom Connector generierten Schema) bezieht sich auf einen Endpoint, dessen Schemas vom Benutzer bereitgestellt werden, entweder durch Erstellen eines benutzerdefinierten Schema, durch Hochladen einer Datei oder URL oder durch manuelle Eingabe des Schema.

Änderungen an benutzerdefinierten Schemas werden automatisch an alle Schema weitergegeben. Beim Öffnen eines Schema, auf das mehrere Komponenten verweisen, wird in einem Dialogfeld eine Liste aller Komponenten angezeigt, die auf das Schema verweisen und von Änderungen betroffen sind:

Von mehreren Komponenten verwendetes Schema

Wenn Sie nicht möchten, dass Änderungen an allen Standorten verbreitet werden, an denen auf das Schema verwiesen wird, müssen Sie zuerst die Konfiguration dieser Komponenten bearbeiten, um den Schema zu entfernen oder zu ersetzen.

Projekte vor 10.33.2

Benutzerdefinierte Schemas, auf die von mehreren Transformations in Projekten verwiesen wird, die vor Harmony Version 10.33.2 erstellt wurden, werden automatisch gemäß dieser Namenskonvention umbenannt:

<Original Schema Name>_<Transformation Name>_<Source or Target>

Die Namenskonvention besteht aus diesen Komponenten:

  • Ursprünglicher Schemaname: Der ursprüngliche Name des Schema vor 10.33.2.
  • Transformation: Der Name der Transformation, in der auf das Schema verwiesen wird.
  • Quelle oder Ziel: Ob das Schema auf der Quell- oder Zielseite der Transformation verwendet wird.