Schema im Jitterbit Integration Studio

Einführung

Wenn Sie bereits über eine Datei mit der gewünschten Datenstruktur verfügen, können Sie diese Beispieldatei verwenden, um ein Schema in einer Transformation zu definieren. Sobald eine Beispieldatei hochgeladen ist, wird sie zu einem benutzerdefinierten Schema, das Sie im Schema für ein benutzerdefiniertes flaches Schema bearbeiten können oder benutzerdefiniertes hierarchisches Schema.

Diese Option ist vergleichbar mit der Bereitstellung des Schema während der Konfiguration einer Aktivität. Ein während der Aktivitätskonfiguration bereitgestelltes Schema kann jedoch nach dem Hochladen nicht mehr bearbeitet werden.

Verwenden einer Beispieldatei

Um ein Schema mithilfe einer Beispieldatei in einer Transformation definieren zu können, müssen Sie zunächst eine Transformation erstellen.

Die Option Schema definieren ist nur sichtbar, wenn eine Transformation nicht bereits ein Schema von einer benachbarten Aktivität oder einer ursprünglich benachbarten Aktivität erbt, die inzwischen entfernt wurde. Die Schemata in solchen Aktivitäten haben Vorrang vor einem in einer Transformation definierten Schema.

Sofern diese Bedingung erfüllt ist, wird die Schaltfläche Schema definieren im Mapping-Modus angezeigt auf jeder Seite der Transformation, für die noch kein Schema in einer Aktivität definiert ist. Klicken Sie auf der Quell- oder Zielseite der Transformation auf Schema definieren und wählen Sie Beispieldatei verwenden:

Konfigurieren eines Schema

Der Schema Editor wird geöffnet. Wählen Sie im Schema-Editor entweder Gespeichertes Schema verwenden oder Neues Schema angeben. Jede dieser Optionen wird unten erläutert.

Gespeichertes Schema verwenden

Wählen Sie Gespeichertes Schema verwenden, um ein vorhandenes Schema auszuwählen, das zuvor im aktuellen Projekt definiert wurde. Wenn diese Option ausgewählt ist, werden diese Optionen verfügbar:

• Gespeicherte Schemas: Verwenden Sie die Dropdown-Liste, um ein vorhandenes Schema zur Wiederverwendung auszuwählen.

• Schema anzeigen: Nachdem ein vorhandenes hochgeladenes Schema ausgewählt wurde, können Sie das Schema direkt im Textbereich unter der Dropdown-Liste anzeigen. Um das Schema in einem größeren Bereich anzuzeigen, klicken Sie auf das Popout-Symbol (nachdem Sie diesen Bereich geöffnet haben, klicken Sie auf das (Zurück-Symbol, um zu diesem Bildschirm zurückzukehren).

  Obwohl ein gespeichertes Schema nicht editierbar ist, kann dieser Textbereich kopiert werden mit Control+C (Windows oder Linux) oder Command+C (macOS).

  Dieser Textbereich dient nur zur Anzeige vorhandener hochgeladener Schemata und zeigt keine flat, hierarchisch oder gespiegelt benutzerdefinierte Schemata.

• Validierung: Validierungsinformationen werden unterhalb des Textbereichs bereitgestellt und basieren auf der Dateierweiterung des gespeicherten Schema.

• Schemavorschau: Auf der rechten Seite wird eine Vorschau des Schema angezeigt. Das Schema wird mit den unter Knoten und Felder beschriebenen Standard-Oberflächenelementen angezeigt.

• Änderungen speichern: Diese Schaltfläche ist nicht verwendbar, da es nicht möglich ist, vom Schema Editor aus Änderungen an einem gespeicherten Schema vorzunehmen. Um Änderungen an einem gespeicherten Schema vorzunehmen, verwenden Sie stattdessen die Option Schema bearbeiten, die im Aktionsmenü eines Schemas verfügbar ist.

• Fertig: Klicken Sie hier, um die Schema zu speichern und den Schema Editor zu schließen.

• Abbrechen: Klicken Sie hier, um den Schema Editor zu schließen.

Neues Schema bereitstellen

Wählen Sie Neues Schema bereitstellen, um ein neues Schema zu definieren, indem Sie eines von einer URL laden, eine Datei hochladen oder manuell in den Textbereich eingeben. Wenn diese Option ausgewählt ist, stehen die folgenden Optionen zur Verfügung:

• Schemaname: Geben Sie in das obere Textfeld einen Namen für das Schema ein, einschließlich der Dateierweiterung (.csv, .json, .xml, .xsd, oder .zip). Wenn keine Dateierweiterung angegeben ist, wird der Inhalt analysiert, um den für die Validierung zu verwendenden Dateityp automatisch zu erkennen. Wenn Sie das Schema von einer URL laden oder eine Datei hochladen, können Sie dieses Feld leer lassen, da der Name nach dem Laden der Datei eingetragen wird.

• URL laden: Klicken Sie hier, um ein Dialogfeld zu öffnen, in dem Sie ein Schema von einer URL laden können:

  

  • Dateityp: Verwenden Sie das Dropdown-Menü, um aus den unterstützten Dateitypen auszuwählen, darunter CSV, JSON, XML, XSD und ZIP. Beachten Sie:

    • XSD: Ein per URL bereitgestelltes XSD kann andere XSD- URLs per Referenz importieren/einschließen.

    • ZIP: Ein ZIP-Archiv kann eine Sammlung von XSDs enthalten, die sich gegenseitig per Referenz importieren/einschließen können. Alle Nicht-XSD-Dateien im Archiv werden ignoriert. Mehrere Verzeichnisebenen werden unterstützt.

  • URL: Geben Sie eine URL ein, die ohne Authentifizierung zugänglich ist. Es können Dateien bis zu einer Größe von 5 MB hochgeladen werden.

  • Laden: Klicken Sie hier, um das Schema von der URL zu laden. Beachten Sie, dass die Datei nur einmal zur Schema abgerufen wird. Beachten Sie außerdem, dass einige Daten während der Verarbeitung konvertiert werden können, wie unter Schemaverarbeitung beschrieben.

  • Abbrechen: Klicken Sie hier, um das Dialogfeld Schema-URL hochladen ohne Speichern zu schließen.

• Datei hochladen: Klicken Sie hier, um ein Dialogfeld zu öffnen, in dem Sie ein Schema aus einer Datei laden können, auf die vom aktuellen Computer aus zugegriffen werden kann:

  

  • Dateityp: Verwenden Sie das Dropdown-Menü, um aus den unterstützten Dateitypen auszuwählen, darunter CSV, JSON, XML, XSD und ZIP.

    Notiz

    Ein ZIP-Archiv kann eine Sammlung von XSDs enthalten, die sich gegenseitig per Referenz importieren/einschließen können. Alle Nicht-XSD-Dateien im Archiv werden ignoriert. Mehrere Verzeichnisebenen werden unterstützt.

  • Datei: Über die Schaltfläche Durchsuchen rechts können Sie zu einer Datei navigieren, die im aktuellen Projekt noch nicht verwendet wurde. Es können Dateien mit einer Größe von bis zu 5 MB hochgeladen werden.

  • Laden: Klicken Sie hier, um das Schema aus der Datei zu laden. Beachten Sie, dass einige Daten während der Verarbeitung konvertiert werden können, wie unter Schemaverarbeitung beschrieben.

  • Abbrechen: Klicken Sie hier, um das Dialogfeld Schemadatei hochladen ohne Speichern zu schließen.

• Schema anzeigen/bearbeiten: Wenn Sie kein Schema hochladen, können Sie eines manuell in den Textbereich unter den Schaltflächen URL laden und Datei hochladen eingeben. Andernfalls können Sie nach dem Hochladen eines Schema das Schema direkt in diesem Textbereich anzeigen oder bearbeiten.

  Um das Schema in einem größeren Bereich anzuzeigen oder zu bearbeiten, klicken Sie auf das Popout-Symbol (nachdem Sie diesen Bereich geöffnet haben, klicken Sie auf das Zurück-Symbol, um zu diesem Bildschirm zurückzukehren).

  Dieser Textbereich kann auch kopiert werden mit Control+C (Windows oder Linux) oder Command+C (macOS).

• Validierung: Wenn Sie ein Schema bearbeiten, werden unterhalb des Textbereichs Validierungsinformationen bereitgestellt, wobei alle Fehler zeilenweise gemeldet werden. Das heißt, nach der Behebung eines Fehlers in einer Zeile werden möglicherweise weitere zu behebende Syntaxfehler für nachfolgende Zeilen gemeldet. Die Validierung basiert auf der Dateierweiterung des bereitgestellten Schema.

• Schemavorschau: Auf der rechten Seite wird eine Vorschau des Schema angezeigt. Nachdem Sie ein neues Schema geladen oder Änderungen im Textbereich links vorgenommen haben, müssen Sie zuerst auf die Schaltfläche Änderungen speichern klicken, damit die Änderungen im Vorschaubereich angezeigt werden. Das Schema wird mithilfe der unter Knoten und Felder beschriebenen Standardoberflächenelemente angezeigt.

• Änderungen speichern: Klicken Sie hier, um das Schema zu speichern und die auf der rechten Seite angezeigte Schema zu aktualisieren.

  Warnung

  Wenn Sie versuchen, eine Datei mit demselben Namen wie eine vorhandene Datei hochzuladen, die bereits im Projekt definiert ist, werden Sie in einem Dialogfeld gefragt, ob Sie die vorhandene Datei überschreiben möchten. Wenn Sie auf Weiter klicken, wird die Datei an allen Stellen, an denen sie im Projekt verwendet wird, durch die neue Datei mit demselben Namen ersetzt. Wenn Sie die Datei nicht überschreiben möchten, klicken Sie auf Abbrechen und ändern Sie die Datei dann manuell, sodass sie einen Namen hat, der noch nicht verwendet wird. Versuchen Sie dann erneut, sie zu speichern.

  

  Hinweis

  Beim Hochladen einer XSD-Datei, die mehrere Elemente der obersten Ebene enthält, werden Sie beim Klicken auf Änderungen speichern aufgefordert, den gewünschten Stammknoten auszuwählen. Wählen Sie das gewünschte Element aus und klicken Sie dann zum Speichern auf Fertigstellen:

  

• Fertig: Klicken Sie hier, um das Schema zu speichern und den Schema Editor zu schließen.

• Abbrechen: Klicken Sie hier, um den Schema Editor zu schließen.

  Notiz

  Wenn Sie die Schaltfläche Änderungen speichern bereits verwendet haben, wurden die Änderungen bereits gespeichert und mit Abbrechen wird lediglich die Konfiguration geschlossen. Wenn Sie Abbrechen verwenden, ohne vorher Änderungen speichern zu verwenden, wird der Schema Editor ohne Speichern geschlossen.

Aktionsmenü „Schemaaktionen“

Nachdem ein Schema aus der Beispieldatei erstellt wurde, können Sie auf zusätzliche Menüoptionen zugreifen, die für alle Schemas verfügbar sind.

Dazu gehören Löschen, Umbenennen, Abhängigkeiten anzeigen, Bereitstellen, Konfigurierbare Bereitstellung und Zur Gruppe hinzufügen sowie Schema bearbeiten und Schema löschen. Einzelheiten zu diesen Aktionen finden Sie unter Aktionsmenü Schemaaktionen.