Benutzerdefiniertes hierarchisches Schema im Jitterbit Integration Studio

Einführung

Ein hierarchisches Schema (oder hierarchisches Schema) ist eine komplexe Dateistruktur mit mehreren Dateizeilentypen wie Header oder Zusammenfassungszeilen. Auf dieser Seite wird das Erstellen und Bearbeiten eines benutzerdefinierten hierarchischen Schema innerhalb einer Transformation beschrieben.

Erstellen eines hierarchischen Schema

Benutzerdefinierte Schemata, einschließlich hierarchischer Schemata, werden in Transformations definiert. Um ein hierarchisches Schema erstellen 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 erbt. Wenn eine benachbarte Aktivität die Konfiguration von benutzerdefinierten Schemas vorhanden ist, geben Sie in der Konfiguration der Aktivität kein Anforderungs- oder Schema an, da dies dazu führen würde, dass diese Schemata von der Transformation übernommen werden.

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 Hierarchisch erstellen:

Bearbeiten eines hierarchischen Schema

Um ein hierarchisches Schema zu bearbeiten, das in einer Transformation definiert wurde, verwenden Sie das Schema in einer Transformation, um Schema bearbeiten auszuwählen:

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:

Konfigurieren eines hierarchischen Schema

Die Konfiguration eines Schema mit dem hierarchischen Schema Editor wird wie folgt behandelt:

• Schemaname: Geben Sie einen Namen ein, der zur Identifizierung des hierarchischen Schema verwendet werden soll.

• Speicherstatus: Rechts neben dem Schema stehen das Datum und die Uhrzeit, zu der die mit dem Schema verknüpfte Transformation zuletzt gespeichert wurde. Diese Information ist nicht mit dem Schema selbst verknüpft, das mit der Schaltfläche Änderungen speichern unten in der Konfiguration gespeichert wird.

• Typ: Wählen Sie unter den verfügbaren Typen für ein benutzerdefiniertes hierarchisches Schema aus:

  • XML: Das Schema wird im XML-Format erstellt.
  • Feste Breite: Das Schema wird im CSV-Format erstellt und verwendet die Länge zur Abgrenzung der Felder.
  • Zeichengetrennt: Das Schema wird im CSV-Format erstellt und verwendet Zeichen zur Abgrenzung der Felder.

  Notiz

  Das Erstellen eines hierarchischen Schema im JSON-Format wird nicht unterstützt.

• Optionen: Wenn Zeichengetrennt ausgewählt ist, werden diese Optionen verfügbar:

  

  • Trennzeichen: Geben Sie die Zeichen ein, die als Feldtrennzeichen verwendet werden sollen, um die Grenze zwischen Datenfeldern festzulegen. Der Standardwert ist ein Komma. Sie können auch Trennzeichen mit mehreren Zeichen verwenden, z. B. ein doppeltes Pipe-Zeichen || Um einen Tab als Trennzeichen zu verwenden, geben Sie ein \t.

  • Zeilenumbrüche für Datensatzende: Aktivieren Sie dieses Kontrollkästchen, um Datensätze durch Zeilenumbrüche zu trennen. Diese Option ist standardmäßig ausgewählt. Wenn diese Option ausgewählt ist, wird das Datensatzende durch Zeilenumbrüche gekennzeichnet, sodass jeder Datensatz in einer Zeile steht (sofern kein Qualifizierer verwendet wird). Wenn diese Option deaktiviert ist, werden Zeilenumbrüche ignoriert und neue Datensätze beginnen, nachdem die Gesamtzahl der Felder erreicht ist.

    Notiz

    Diese Option ist nur für Schemata relevant, die auf der Quellseite einer Transformation verwendet werden. Bei Schemata, die auf der Zielseite einer Transformation verwendet werden, werden Zeilenumbrüche immer verwendet, um das Ende von Datensätzen anzuzeigen.

  • String-Qualifizierer: Geben Sie das Zeichen ein, das als Wrapper verwendet werden soll und einen Textstring angibt, der als einzelne Dateneinheit behandelt werden soll. Der Standardwert ist ein doppeltes Anführungszeichen. Wenn dieses Feld leer gelassen wird, wird kein String-Qualifizierer verwendet.

    Wenn Sie einen String-Qualifizierer verwenden, wählen Sie entweder Immer oder Bei Bedarf, um anzugeben, wann der Qualifizierer verwendet werden soll. Die Standardeinstellung Bei Bedarf wird empfohlen, damit die Zeichenfolge von den angegebenen Zeichenfolgenqualifiziererzeichen umschlossen wird, wenn die als Trennzeichen angegebenen Zeichen in der Zeichenfolge vorkommen. Wenn das Trennzeichen nicht vorkommt, wird die Zeichenfolge nicht umschlossen.

    Während der Verarbeitung der Quellen wird der Zeichenfolgenqualifizierer entfernt. Während der Verarbeitung der Ziele wird der Zeichenfolgenqualifizierer hinzugefügt.

  • Escape-Sequenzen konvertieren: Aktivieren Sie dieses Kontrollkästchen, um Escape-Sequenzen, die durch einen Backslash gekennzeichnet sind, zu konvertieren oder zu ignorieren \. Standardmäßig werden Escape-Sequenzen gemäß Java-Standards konvertiert. Wenn deaktiviert, erfolgt die Textkonvertierung ohne Interpretation von Escape-Sequenzen.

    Notiz

    Diese Option ist nur für Schemas relevant, die auf der Quellseite einer Transformation verwendet werden.

  • EDIFACT: Aktivieren Sie dieses Kontrollkästchen, wenn die Daten dem EDIFACT-Standard für Syntaxregeln entsprechen.

• Knoten hinzufügen: Klicken Sie auf die Schaltfläche Knoten hinzufügen, um der Tabelle nacheinander neue Knoten hinzuzufügen. Diese Spalten sind für jede Knotenzeile verfügbar:

  • #: Jeder Knotenzeile wird automatisch eine Nummer in der Reihenfolge zugewiesen, in der die Zeile angezeigt wird. Sobald Sie mindestens zwei Zeilen mit demselben übergeordneten Element im Baum haben, bewegen Sie den Mauszeiger über die Nummer und klicken Sie auf die Pfeil nach oben oder unten. Der als Stammknoten dienende Knoten (ohne übergeordneten Knoten) kann nicht neu angeordnet werden, und Knoten können auch nicht auf eine andere Ebene in der Baumstruktur verschoben werden (stattdessen kann dies durch Ändern des übergeordneten Knotens erfolgen).

  • Knoten: Geben Sie einen Namen für den Knoten ein. Der Knotenname darf keine Leerzeichen oder Symbole wie diese enthalten: @ $ % & / + ( ) : ; , Außerdem darf der Feldname nicht mit einer Zahl, einem Punkt oder (.) oder Bindestrich (-).

    Tipp

    Referenzinformationen zu allen nicht zulässigen Zeichen finden Sie unter NCName gemäß W3C-Definition.

  • Übergeordneter Knoten: Verwenden Sie das Dropdown-Menü, um den übergeordneten Knoten des Knotens auszuwählen. Beachten Sie, dass die Auswahl eines übergeordneten Knotens, der einen zirkulären Verweis verursachen würde, nicht möglich ist.

  • Vorkommen: Verwenden Sie das Dropdown-Menü, um auszuwählen, wie der Knoten im komplexen Dokument vorkommen soll:

    • Null oder Mehr: Wählen Sie diese Option, wenn dieser Knoten vorkommen kann oder nicht. Wenn er vorkommt, kann er jedoch beliebig oft vorkommen.
    • Null oder Eins: Wählen Sie diese Option, wenn dieser Knoten vorkommen kann oder nicht. Wenn er vorkommt, kann er jedoch nur einmal vorkommen.

    • Eins oder mehr: Wählen Sie diese Option, wenn dieser Knoten mindestens einmal vorkommen muss, aber auch wiederholt werden kann.

    • Genau einmal: Wählen Sie diese Option, wenn dieser Knoten nur einmal im Dokument vorkommen muss.

  • Felder: Die Anzahl der für den Knoten definierten Felder wird aufgelistet. Um die Felder des Knotens zu definieren, klicken Sie auf das Bearbeiten-Symbol rechts neben der Anzahl der Felder. Dadurch wird ein Feldeditor für den jeweiligen Knoten wie folgt geöffnet.

    

    Notiz

    Knoten sollten mindestens ein Feld enthalten, um ihnen beim Ausführen einer Transformation eine Zuordnung ermöglichen zu können.

    

    • Knotenzyklus: Klicken Sie auf die Pfeile nach links oder rechts, um durch die Knoten im hierarchischen Schema zu blättern und die Feldtabelle für den ausgewählten Knoten anzuzeigen.

      • Zurück: Klicken Sie auf das Schließen-Symbol, um zur Knotentabelle zurückzukehren.

        Knotennavigator: Oben in der Tabelle befindet sich eine erweiterte graue Schaltfläche, mit der Sie die Tabellenanzeige ändern können, indem Sie zu einem anderen Knoten navigieren:

        

    • Feld hinzufügen: Klicken Sie hier, um der Tabelle nacheinander neue Feldzeilen hinzuzufügen. Abhängig vom ausgewählten Schema -Typ sind für jede Feldzeile diese Spalten verfügbar:

      • #: Jeder Feldzeile wird automatisch eine Nummer in der Reihenfolge zugewiesen, in der die Zeile erscheint. Um die Zeilen neu anzuordnen, ziehen Sie sie entweder per Drag & Drop an eine andere Position in der Tabelle oder bewegen Sie den Mauszeiger über die Nummer und klicken Sie auf das Pfeil nach oben oder unten.

      • Feld: Geben Sie einen Namen für das Feld ein. Der Feldname darf keine Leerzeichen oder Symbole wie diese enthalten: @ $ % & / + ( ) : ; , Außerdem darf der Feldname nicht mit einer Zahl, einem Punkt oder (.) oder Bindestrich (-).

        Tipp

        Als Referenz siehe NCNameChar für die zulässigen Zeichen, wie vom W3C definiert.

      • Typ: Verwenden Sie das Dropdown-Menü, um einen Datentyp auszuwählen. Optionen für neue benutzerdefinierte Schemata sind boolean, date, decimal, double, float, integer, long, Und string Der Standardwert ist string. Wenn ein benutzerdefiniertes Schema durch Spiegeln eines Schema erstellt wurde von einer serverbasierten Aktivität, können zusätzliche Datentypen aufgelistet werden.

      • Beginn: Geben Sie nur für Schemata mit fester Breite die Startzeichenposition ein. Beachten Sie, dass 1 als Position für den Anfang der Datei betrachtet wird.

        Der Standardwert für nachfolgende Zeilen ist das nächste Zeichen nach der Endposition des vorherigen Felds. Wenn beispielsweise die Endposition des vorherigen Felds 50 ist, dann ist die Anfangsposition des nächsten Felds 51.

      • Länge: Geben Sie nur für Schemata mit fester Breite die Anzahl der Zeichen ein, die für dieses Feld reserviert werden sollen. Wenn die Startzeichenposition und die Endzeichenposition bereits eingegeben wurden, wird dieses Feld automatisch berechnet.

        Textdateien mit fester Länge geben immer eine bestimmte Anzahl von Zeichen an, die für jedes Feld reserviert sind. Sie können beispielsweise ein Feld mit dem Namen LastName dafür sind immer 30 Zeichen reserviert. Wenn der tatsächliche Wert „Smith“ ist, werden nur 5 Zeichen verwendet; die restlichen Zeichen enthalten nichts.

      • Ende: Geben Sie nur für Schemata mit fester Breite die Position des Endzeichens ein. Wenn die Position des Startzeichens und die Länge bereits eingegeben sind, wird dieses Feld automatisch berechnet.

        Hinweis

        Standardmäßig werden Segmente mit fester Länge mit einem Zeilenumbruchzeichen beendet.

      • Standardwert: Wenn Sie für Schemata mit Fester Breite oder Durch Zeichen getrennt einen Standardwert für dieses Feld wünschen, geben Sie den Wert hier ein.

      • Format: Wenn Sie für Schemata mit Fester Breite oder Zeichengetrennt dieses Feld in einem bestimmten Format haben möchten, z. B. für Datum oder Währung, geben Sie das Format hier ein.

      • Aktionen: Um Aktionen für eine vorhandene Feldzeile auszuführen, bewegen Sie den Mauszeiger über das Feld ganz rechts unter dem Aktionsmenü. Klicken Sie dann auf das Symbol "Duplizieren", um die Feldzeile zu duplizieren, oder klicken Sie auf das Löschen-Symbol, um die Feldzeile zu löschen.

    • Schema überprüfen: Während Sie jedes Feld im Schema manuell definieren, wird auf der rechten Seite eine Vorschau des Schema angezeigt. Das Schema wird mithilfe der unter Knoten und Felder beschriebenen Standardschnittstellenelemente angezeigt.

    • Änderungen speichern: Klicken Sie hier, um das Schema zu speichern und zu schließen.

    • Änderungen verwerfen: Klicken Sie hier, um das Schema zu schließen, ohne die Änderungen zu speichern.

  • Aktionen: Für Aktionen, die Sie an einer bestehenden Knotenzeile vornehmen können, bewegen Sie den Mauszeiger über das Feld ganz rechts unter dem Aktionsmenü. Klicken Sie dann auf das Symbol "Duplizieren", um die Knotenzeile zu duplizieren, oder klicken Sie auf das Löschen-Symbol, um die Knotenzeile zu löschen.

• Schema überprüfen: Während Sie jeden Knoten im Schema manuell definieren, wird auf der rechten Seite eine Vorschau des Schema angezeigt. Das Schema wird mithilfe der unter Knoten und Felder beschriebenen Standardschnittstellenelemente angezeigt.

  Vorsicht

  Wenn Sie Knoten erstellt haben, die keine Felder haben, können Sie beim Abschließen einer Transformation keine Zuordnung zu Feldern innerhalb dieser Knoten vornehmen.

• Änderungen speichern: Klicken Sie hier, um das Schema zu speichern und zu schließen.

• Änderungen verwerfen: Klicken Sie hier, um das Schema zu schließen, ohne die Änderungen zu speichern.

Aktionsmenü „Schemaaktionen“

Nachdem ein benutzerdefiniertes hierarchisches Schema erstellt wurde, können Sie auf zusätzliche Menüoptionen zugreifen, die für alle Schemata 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.