Benutzerdefiniertes flaches Schema im Jitterbit Integration Studio

Einführung

Ein flaches Schema (oder flaches Schema) ist eine einfache, einlevelige Feldstruktur mit demselben Datensatztyp im gesamten Textdokument. Diese Seite behandelt die Erstellung und Bearbeitung eines benutzerdefinierten flachen Schemas innerhalb einer Transformation.

Erstellen eines benutzerdefinierten flachen Schemas

Benutzerdefinierte Schemata, einschließlich flacher Schemata, werden in Transformationen definiert. Um ein flaches Schema zu erstellen, erstellen Sie zunächst eine Transformation.

Die Option Flaches Schema erstellen ist nur aktiviert, wenn eine Transformation nicht bereits ein Schema von einer angrenzenden Aktivität erbt. Wenn eine angrenzende Aktivität vorhanden ist, die die Konfiguration von benutzerdefinierten Schemata ermöglicht, geben Sie in der Konfiguration der Aktivität kein Anfrage- oder Antwortschema an, da dies dazu führen würde, dass diese Schemata von der Transformation geerbt werden.

Wenn diese Bedingung erfüllt ist, wird die Schaltfläche Flaches Schema erstellen im Mapping-Modus auf jeder Seite der Transformation angezeigt, die noch kein Schema in einer Aktivität definiert hat. Klicken Sie auf Flaches Schema erstellen auf der Quell- oder Zielseite der Transformation:

Bearbeiten eines flachen Schemas

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

Beim Öffnen eines Schemas, das von mehreren Komponenten referenziert wird, wird ein Dialogfeld angezeigt, das eine Liste aller Komponenten enthält, die auf das Schema verweisen und von Änderungen betroffen sein werden:

Konfigurieren eines flachen Schemas

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

• Schema-Name: Geben Sie im Texteingabefeld oben auf dem Bildschirm einen Namen ein, um das flache Schema zu identifizieren.

• Speicherstatus: Rechts vom Schema-Namen befinden sich das Datum und die Uhrzeit, zu denen die zugehörige Transformation des Schemas zuletzt gespeichert wurde. Diese Informationen sind nicht mit dem Schema selbst verbunden, das mit der Schaltfläche Änderungen speichern am Ende 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, wobei die Länge zur Abgrenzung der Felder verwendet wird.
  • Zeichengetrennt: Das Schema wird im CSV-Format erstellt, wobei Zeichen zur Abgrenzung der Felder verwendet werden.

• 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 anzugeben. Der Standardwert ist ein Komma. Sie können auch Mehrzeichen-Trennzeichen verwenden, wie z.B. ein doppeltes Pipe ||. Um ein Tabulatorzeichen als Trennzeichen zu verwenden, geben Sie \t ein.

  • Zeilenumbrüche für das Ende von Datensätzen: Aktivieren Sie dieses Kontrollkästchen, um Zeilenumbrüche zur Trennung von Datensätzen zu verwenden. Diese Option ist standardmäßig ausgewählt. Wenn diese Option ausgewählt ist, werden das Ende von Datensätzen durch Zeilenumbrüche angezeigt, sodass jeder Datensatz in einer Zeile existiert (es sei denn, es wird ein Qualifizierer verwendet). Wenn deaktiviert, werden Zeilenumbrüche ignoriert und neue Datensätze beginnen, nachdem die Gesamtzahl der Felder erreicht ist.

    Hinweis

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

• String-Qualifier: Geben Sie das Zeichen an, das als Wrapper verwendet werden soll, um einen Textstring zu kennzeichnen, der als eine einzelne Dateneinheit behandelt werden soll. Der Standard ist ein doppelt angeführtes Zeichen. Wenn das Feld leer gelassen wird, wird kein String-Qualifier verwendet.

  Wenn Sie einen **String-Qualifier** verwenden, wählen Sie entweder **Immer** oder **Bei Bedarf**, um anzugeben, wann der Qualifier verwendet werden soll. Der Standardwert **Bei Bedarf** wird empfohlen, damit, wenn die als **Trennzeichen** angegebenen Zeichen innerhalb des Strings auftreten, der String von den angegebenen String-Qualifier-Zeichen umschlossen wird. Wenn das Trennzeichen nicht auftritt, wird der String nicht umschlossen.
  
  Während der Verarbeitung von Quellen wird der String-Qualifier entfernt. Während der Verarbeitung von Zielen wird der String-Qualifier hinzugefügt.
  

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

  !!! note "Hinweis"
      Diese Option ist nur für Schemata relevant, die auf der Quellseite einer Transformation verwendet werden.
  

• Feld hinzufügen: Klicken Sie, um neue Feldzeilen einzeln zur Tabelle hinzuzufügen. Diese Spalten sind für jede Zeile 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 an eine andere Position innerhalb der Tabelle oder fahren Sie mit der Maus über die Nummer und klicken Sie auf den 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: @ $ % & / + ( ) : ; ,. Darüber hinaus darf der Feldname nicht mit einer Zahl, einem Punkt (.) oder einem Bindestrich (-) beginnen.

    Tipp

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

• 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 Schemas von einer serverbasierten Aktivität erstellt wurde, können zusätzliche Datentypen aufgeführt sein.

• Beginn: Geben Sie für Fixed Width-Schemata nur die Startzeichenposition ein. Beachten Sie, dass 1 als die Position für den Beginn der Datei betrachtet wird.

  Der Standardwert für nachfolgende Zeilen ist das nächste Zeichen nach der Endposition des vorherigen Feldes. Wenn die Endposition des vorherigen Feldes beispielsweise 50 ist, wird die Startposition des nächsten Feldes 51 sein.

• Länge: Geben Sie für Fixed Width-Schemata nur 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.

  Festgelegte Textdateien geben immer eine bestimmte Anzahl von Zeichen an, die für jedes Feld reserviert sind. Beispielsweise können Sie ein Feld namens LastName identifizieren, das immer 30 Zeichen dafür reserviert hat. Wenn der tatsächliche Wert "Smith" ist, werden nur 5 Zeichen verwendet; die verbleibenden Zeichen sind leer.

• Ende: Geben Sie für Fixed Width-Schemata nur die Endzeichenposition ein. Wenn die Startzeichenposition und die Länge bereits eingegeben sind, wird dieses Feld automatisch berechnet.

  Hinweis

  Standardmäßig werden feste Segmente 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 auf einer vorhandenen Feldzeile durchführen können, fahren Sie mit der Maus über das Feld ganz rechts unter dem Aktionsmenü-Symbol. Klicken Sie dann auf das Duplizieren-Symbol, 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 innerhalb des Schemas manuell definieren, wird eine Vorschau des Schemas auf der rechten Seite angezeigt. Das Schema wird mit den standardmäßigen Schnittstellenelementen angezeigt, die unter Knoten und Felder beschrieben sind.

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

• Änderungen verwerfen: Klicken Sie, um das Schema ohne Speichern der Änderungen zu schließen.

Menü für 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.

Diese umfassen Löschen, Umbenennen, Abhängigkeiten anzeigen, Bereitstellen, Konfigurierbares Bereitstellen und Zur Gruppe hinzufügen, sowie Schema bearbeiten und Schema löschen. Für Details zu diesen Aktionen siehe Menü für Schemaaktionen.