Zum Inhalt springen

Benutzerdefiniertes flaches Schema im Jitterbit Integration Studio

Einführung

Ein flaches Schema (oder flaches Schema) ist eine einfache, einstufige Feldstruktur mit demselben Datenzeilentyp im gesamten Textdokument. Auf dieser Seite wird das Erstellen und Bearbeiten eines benutzerdefinierten flachen Schema innerhalb einer Transformation beschrieben.

Erstellen eines benutzerdefinierten flachen Schema

Benutzerdefinierte Schemata, einschließlich flacher Schemata, werden in Transformations definiert. Um ein flaches 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 Flach erstellen:

Schema definieren, flach erstellen

Bearbeiten eines flachen Schema

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

Schema Schema bearbeiten

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

Konfigurieren eines flachen Schema

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

Wohnung

  • Schemaname: Geben Sie in das Texteingabefeld oben auf dem Bildschirm einen Namen ein, der zur Identifizierung des flachen 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 zwischen zwei Typen für ein benutzerdefiniertes flaches Schema:

    • 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.

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

    durch flache Zeichen getrennte Optionen

    • 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.

  • Feld hinzufügen: Klicken Sie hier, um der Tabelle nacheinander neue Feldzeilen hinzuzufügen. Für jede Zeile stehen folgende Spalten zur Verfügung:

    • #: 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, 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 sind, 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 namens 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 möchten, dass dieses Feld einen Standardwert hat, geben Sie den Wert hier ein.

    • Format: Wenn Sie möchten, dass dieses Feld ein bestimmtes Format hat, z. B. für Datum oder Währung, geben Sie das Format hier ein.

    • Aktionen: Für Aktionen, die Sie für eine vorhandene Feldzeile ausführen können, 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.

Aktionsmenü „Schemaaktionen“

Nachdem ein benutzerdefiniertes flaches 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.