Definieren Sie ein Dateiformat im Jitterbit Design Studio

Jitterbit ermöglicht es Ihnen, einfache oder komplexe Dateitypen als Quellen oder Ziele während des Datentransformationsprozesses zu verwenden. Einfache Dateien haben denselben Datensatztyp im gesamten Textdokument, während komplexe Dateien mehrere Datensatztypen wie Kopf- oder Zusammenfassungszeilen enthalten.

Im Rahmen des Transformationsprozesses müssen Sie das Dateiformat definieren, damit Jitterbit weiß, wie die Daten verarbeitet werden sollen. Typischerweise werden Dateiformate als Teil des Wizard-Durchlaufs beim Erstellen Ihrer Integration generiert. Nachdem ein Dateiformat erstellt wurde, können Sie es im Abschnitt Dateiformate im Baum auf der linken Seite des Studios ändern. Wenn Sie ein benutzerdefiniertes Dateiformat definieren müssen, können Sie ein neues Dateiformat aus demselben Abschnitt erstellen.

Diese Seite behandelt, wie Sie das Dateiformat eines Textdokuments definieren, das als Quelle oder Ziel verwendet werden soll.

Erstellen Sie ein neues Dateiformat

Typischerweise werden Dateiformate als Teil des Wizard-Durchlaufs beim Erstellen Ihrer Integration generiert. Sie können auch ein neues Dateiformat separat über eine der folgenden Methoden erstellen:

• Gehen Sie zu Datei > Neu > Neues Dateiformat.
• Klicken Sie auf das Symbol in der Symbolleiste.
• Klicken Sie mit der rechten Maustaste auf Datei Formate im linken Bereich des Studios und wählen Sie dann Neues Dateiformat aus dem Menü.

Ihr neues Dateiformat wird im Abschnitt Dateiformate im linken Bereich des Studios aufgeführt. Darüber hinaus wird ein Bildschirm zur Konfiguration Ihres neuen Dateiformats im rechten Bereich des Studios geöffnet. Hier wählen Sie aus, ob Sie die Struktur manuell oder aus einer Beispieldatei angeben möchten:

• Manuell erstellen: Geben Sie die Namen und Typen der Felder manuell ein, während Sie Ihr Dateiformat konfigurieren.

• Aus Beispieldatei: Verwenden Sie eine Beispieldatei, falls verfügbar, wie in Erstellen einer Textdokumentdefinition aus einer Beispieldatei beschrieben.

  Hinweis

  Diese Option ist nur für die Erstellung eines einfachen (flachen) Dateiformats verfügbar.

Für manuell erstellte Dateiformate müssen Sie auch den Dokumenttyp sowie das Format auswählen.

• Einfaches Textdokument: Einfache Dateien haben denselben Datensatztyp im gesamten Textdokument.
• Komplexes Textdokument: Komplexe Dateien enthalten mehrere Datensatztypen wie Kopf- oder Zusammenfassungszeilen.

Sowohl einfache als auch komplexe Dokumenttypen erlauben zeichengetrennte und feste Feldbreitenformate.

Klicken Sie auf die Schaltfläche, um zum nächsten Konfigurationsbildschirm zu gelangen.

Sie können jederzeit über das linke Fenster von Studio unter Dateiformate zur bestehenden Konfiguration zurückkehren.

Felder manuell konfigurieren

Nachdem Sie sich entschieden haben, Ihr Dateiformat manuell zu erstellen, wird ein weiterer Konfigurationsbildschirm verwendet, um jedes Feld in Ihrem Dokument zu definieren. Dieser nächste Schritt hängt von der Art der von Ihnen ausgewählten Textstruktur – einfach oder komplex – sowie dem von Ihnen ausgewählten Format – zeichengetrennt oder feste Feldbreite – ab.

Einfaches Textdokument – zeichengetrennt

Wenn Sie ein einfaches Textdokument ausgewählt haben, das zeichengetrennt ist, sollte Ihr konfiguriertes Bildschirm ähnlich wie das untenstehende aussehen. Folgendes ist eine Erklärung für jeden konfigurierbaren Abschnitt.

Trennzeichen & Qualifizierer

• Feldtrennzeichen: Geben Sie das Zeichen oder die Zeichen ein, die als Feldtrennzeichen verwendet werden sollen und die die Grenze zwischen den Datenfeldern angeben. Der Standardwert ist ein Komma. Sie können auch mehrzeichenige Trennzeichen verwenden, wie z.B. ein doppeltes Pipe ||. Um einen Tabulator als Trennzeichen zu verwenden, geben Sie \`t ein.

• String-Qualifizierer & Qualifizierer verwenden: Geben Sie das Zeichen an, das als Wrapper verwendet werden soll und das anzeigt, dass eine Textzeichenfolge als eine einzelne Dateneinheit behandelt werden soll. Der Standardwert ist ein doppeltes Anführungszeichen. Wenn das Feld leer gelassen wird, wird kein String-Qualifizierer verwendet.

  Bei der Verwendung eines String-Qualifiers wählen Sie eine entsprechende Geschäftsregel, entweder Immer oder Nur bei Bedarf, um anzugeben, wann der Qualifier verwendet werden soll. Die Standardeinstellung Nur bei Bedarf wird empfohlen, damit, falls das als Feldtrennzeichen angegebene Zeichen innerhalb des Strings vorkommt, der String von dem angegebenen String-Qualifier-Zeichen umschlossen wird. Wenn das Trennzeichen nicht vorkommt, 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.

• Zeilenumbrüche für das Ende von Datensätzen verwenden: Ab Version 8.19 wird dieses Kontrollkästchen verwendet, um die Verwendung von Zeilenumbrüchen als Trennung zwischen Datensätzen ein- oder auszuschalten. Standardmäßig werden Enden von Datensätzen durch Zeilenumbrüche angezeigt, sodass jeder Datensatz in einer Zeile existiert (es sei denn, es wird ein Qualifier verwendet). Wenn deaktiviert, werden Zeilenumbrüche ignoriert und neue Datensätze beginnen, nachdem die Gesamtzahl der Felder erreicht ist.

  Hinweis

  Dieses Flag ist nur für Quell-Dateiformate relevant. Für Zieldateien werden Zeilenumbrüche immer verwendet, um das Ende von Datensätzen anzuzeigen.

• Escape-Sequenzen konvertieren: Ab Version 8.23 wird dieses Kontrollkästchen verwendet, um Escape-Sequenzen zu konvertieren oder zu ignorieren, wie durch einen Backslash (\) angezeigt. Standardmäßig werden Escape-Sequenzen gemäß den Java-Standards konvertiert. Wenn deaktiviert, erfolgt die Textkonvertierung ohne Interpretation von Escape-Sequenzen.

  Hinweis

  Dieses Flag ist nur für Quell-Dateiformate relevant.

Validierung (optional)

• Die Zeile muss mindestens 'X' Spalten enthalten: Wenn Sie die Textvalidierung (optional) verwenden möchten, können Sie hier eine Anzahl von Spalten eingeben, die jede Zeile enthalten muss, damit die nebenstehende Aktion ausgeführt wird.

  Hinweis

  Sie müssen zuerst mindestens eine Datenzeile definiert haben, um die Validierungsoptionen zu aktivieren.

• Wenn nicht: Nach Eingabe einer Anzahl von Spalten wird ein Dropdown-Menü verfügbar, in dem Sie "Zeile überspringen" oder "Fehler auslösen" auswählen können. Weitere Informationen zur Validierung finden Sie unter Flat file field validation.

Segment-Eigenschaften definieren

Klicken Sie auf die Neu-Schaltfläche, um das erste Feld des Dokuments zu definieren. Sie müssen Folgendes eingeben (erforderlich):

• Feldname: Geben Sie einen Namen für dieses Feld ein.

• Typ: Wählen Sie einen Typ aus dem Dropdown-Menü aus. Optionen sind String, Integer, Datum, Long, Float, Double, Boolean.

  Hinweis

  Bei Unsicherheiten bezüglich des Feldtyps wird empfohlen, String zu wählen, da dieser Typ es ermöglicht, jeden Datentyp als String einzuschließen.

Die folgenden Punkte sind optional:

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

• Validierung: Doppelklicken Sie in diese Spalte oder verwenden Sie die Schaltfläche ganz rechts, um zusätzliche Optionen für die Feldvalidierung zu öffnen. Weitere Informationen zur Validierung finden Sie unter Flat file field validation.

Wiederholen Sie die vorherigen Schritte für jedes zusätzliche Datenfeld, das Sie definieren müssen.

Einfaches Textdokument – feste Feldbreiten

Wenn Sie ein einfaches Textdokument mit festen Feldbreiten ausgewählt haben, sollte Ihr konfiguriertes Bildschirm ähnlich wie unten aussehen. Folgendes ist eine Erklärung für jeden konfigurierbaren Abschnitt.

Validierung (optional)

• Die Zeile muss mindestens 'X' Spalten enthalten: Wenn Sie die Textvalidierung verwenden möchten (optional), können Sie hier eine Anzahl von Spalten eingeben, die jede Zeile enthalten muss, damit die nebenstehende Aktion ausgeführt wird.

  Hinweis

  Sie müssen zuerst mindestens eine Datenzeile definiert haben, um die Validierungsoptionen zu aktivieren.

• Wenn nicht: Nach Eingabe einer Anzahl von Spalten wird ein Dropdown verfügbar, in dem Sie "Zeile überspringen" oder "Fehler auslösen" auswählen können. Weitere Informationen zur Validierung finden Sie unter Flat file field validation.

Segment-Eigenschaften definieren

Klicken Sie auf die Neu-Schaltfläche, um das erste Feld des Dokuments zu definieren. Sie müssen Folgendes eingeben (erforderlich):

• Feldname: Geben Sie einen Namen für dieses Feld ein.

• Typ: Wählen Sie einen Typ aus dem Dropdown-Menü aus. Optionen sind String, Integer, Date, Long, Float, Double, Boolean.

  Hinweis

  Bei Unsicherheiten bezüglich des Feldtyps wird empfohlen, String zu wählen, da dieser Typ es ermöglicht, jeden Datentyp als Zeichenfolge einzuschließen.

• Begin: Geben Sie die Startzeichenposition ein (1 wird als die Position für den Beginn der Datei betrachtet). Beachten Sie, dass der Standardwert für nachfolgende Zeilen immer das nächste Zeichen nach der Endposition des vorherigen Feldes ist.

• Länge: Geben Sie die Anzahl der Zeichen ein, die für dieses Feld reserviert sind.

  Hinweis

  Festgelegte Textdateien geben immer eine bestimmte Anzahl von Zeichen an, die für jedes Feld reserviert sind. Zum Beispiel 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.)

  Wenn Sie den Zeichenlängenwert eines Feldes geändert haben, verwenden Sie die Schaltfläche, um die Startpositionen aller Felder neu zu berechnen.

  Warnung

  Die Schaltfläche Berechnen setzt alle Begin- und Ende-Feldwerte zurück, basierend auf den Längen-Werten, die Sie angegeben haben. Verwenden Sie diese Schaltfläche nicht, wenn die Feldpositionen Ihrer Datei Lücken oder Überlappungen aufweisen, da diese gelöscht werden.

• Ende: Geben Sie die Endzeichenposition ein.

  Hinweis

  Standardmäßig werden festgelegte Segmente mit einem Zeilenumbruchzeichen beendet.

Die folgenden Angaben sind optional:

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

• Validierung: Doppelklicken Sie in diese Spalte oder verwenden Sie die Schaltfläche ganz rechts, um zusätzliche Optionen für die Feldvalidierung zu öffnen. Weitere Informationen zur Validierung finden Sie unter Validierung von Feldern in Flachdateien.

Wiederholen Sie die vorherigen Schritte für jedes zusätzliche Datenfeld, das Sie definieren müssen.

Komplexes Textdokument – zeichengetrennt

Wenn Sie ein komplexes Textdokument ausgewählt haben, das zeichengetrennt ist, sollte Ihr konfiguriertes Bildschirm ähnlich wie unten aussehen. Folgendes ist eine Erklärung für jeden konfigurierbaren Abschnitt.

Trennzeichen & Qualifizierer

• Feldtrennzeichen: Geben Sie das Zeichen oder die Zeichen ein, die als Feldtrennzeichen verwendet werden sollen und die die Grenze zwischen den Datenfeldern angeben. Der Standard ist ein Komma. Sie können auch mehrzeichenige Trennzeichen verwenden, wie z.B. ein doppeltes Pipe ||. Um ein Tabulatorzeichen als Trennzeichen zu verwenden, geben Sie /t ein.

• String-Qualifizierer & Qualifizierer verwenden: Geben Sie das Zeichen an, das als Wrapper verwendet werden soll und anzeigt, dass ein Textstring als eine einzelne Dateneinheit behandelt werden soll. Der Standard ist ein doppeltes Anführungszeichen. Wenn das Feld leer gelassen wird, wird kein String-Qualifizierer verwendet.

  Wenn Sie einen String-Qualifizierer verwenden, wählen Sie eine entsprechende Geschäftsregel, entweder Immer oder Nur bei Bedarf, um anzugeben, wann der Qualifizierer verwendet werden soll. Der Standardwert Nur bei Bedarf wird empfohlen, damit, wenn das Zeichen oder die Zeichen, die als Feldtrennzeichen angegeben sind, innerhalb des Strings auftreten, der String vom angegebenen String-Qualifizierer-Zeichen umschlossen wird. Wenn das Trennzeichen nicht auftritt, wird der String nicht umschlossen.

  Während der Verarbeitung von Quellen wird der String-Qualifizierer entfernt. Während der Verarbeitung von Zielen wird der String-Qualifizierer hinzugefügt.

• EDIFACT: Aktivieren Sie dieses Kontrollkästchen, wenn Sie EDIFACT-Syntaxregeln in Ihrer Datei verwenden. Wenn Sie nicht wissen, was diese Option ist, lassen Sie sie deaktiviert.

• Zeilenumbrüche für das Ende von Datensätzen verwenden: Ab Version 8.19 wird dieses Kontrollkästchen verwendet, um die Verwendung von Zeilenumbrüchen als Trennung zwischen Datensätzen ein- oder auszuschalten. Standardmäßig 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

  Dieses Flag ist nur für Quell-Dateiformate relevant. Für Zieldateien werden Zeilenumbrüche immer verwendet, um das Ende von Datensätzen anzuzeigen.

• Escape-Sequenzen konvertieren: Ab Version 8.23 wird dieses Kontrollkästchen verwendet, um Escape-Sequenzen zu konvertieren oder zu ignorieren, wie durch einen Backslash (\) angezeigt. Standardmäßig werden Escape-Sequenzen gemäß den Java-Standards konvertiert. Wenn deaktiviert, erfolgt die Textkonvertierung ohne Interpretation von Escape-Sequenzen.

  Hinweis

  Dieses Flag ist nur für Quell-Dateiformate relevant.

Segmente definieren

Klicken Sie auf die Neu-Schaltfläche, um das erste Segment des Dokuments zu definieren. Sie müssen Folgendes eingeben (erforderlich):

• Segmentname: Geben Sie einen Namen für das Segment ein.
• Segmenteltern: Identifizieren Sie den Elternteil dieses Segments aus dem Dropdown-Menü.

• Vorkommen: Geben Sie an, wie das Segment in Ihrem komplexen Dokument vorkommen wird, indem Sie eine der Optionen aus dem Dropdown-Menü auswählen:

  • Wählen Sie Nur einmal, wenn dieses Segment einmal, aber nur einmal im Dokument vorkommen muss.
  • Wählen Sie Ein oder mehr, wenn dieses Segment mindestens einmal vorkommen muss, aber auch wiederholt werden kann.
  • Wählen Sie Null oder eins, wenn dieses Segment möglicherweise nicht vorkommt, aber wenn es vorkommt, nur einmal vorkommen kann.
  • Wählen Sie Null oder mehr, wenn dieses Segment möglicherweise nicht vorkommt, aber wenn es vorkommt, ein oder mehrere Male vorkommen kann.

Wiederholen Sie die vorherigen Schritte für jedes zusätzliche Segment, das Sie definieren müssen.

Segmenteigenschaften definieren

Jetzt, da alle Segmente erstellt wurden, müssen Sie die Felder jedes Segments definieren.

Doppelklicken Sie entweder auf die #-Spalte des gewünschten Segments oder klicken Sie mit dem hervorgehobenen Segment auf die Schaltfläche. Das Popup Segment: Detail wird angezeigt.

Für jedes Segment klicken Sie auf die Neu-Schaltfläche, um die Felder des Segments zu definieren. Sie müssen Folgendes eingeben (erforderlich):

• Feldname: Geben Sie einen Namen für dieses Feld ein.

• Typ: Wählen Sie einen Typ aus dem Dropdown-Menü aus. Optionen sind String, Integer, Datum, Long, Float, Double, Boolean.

  Hinweis

  Im Zweifelsfall wird empfohlen, den Typ "String" auszuwählen, da dieser Typ es ermöglicht, jeden Datentyp als Zeichenfolge einzuschließen.

Die folgenden Optionen sind optional:

• Standard: Wenn dieses Feld einen Standardwert haben soll, geben Sie den Wert hier ein.
• Format: Wenn dieses Feld ein bestimmtes Format haben soll, z. B. für Datum oder Währung, geben Sie das Format hier ein.

Wiederholen Sie die vorherigen Schritte für jedes zusätzliche Datenfeld, das Sie definieren müssen.

Komplexes Textdokument – feste Feldbreiten

Wenn Sie ein komplexes Textdokument mit festen Feldbreiten ausgewählt haben, sollte Ihr konfiguriertes Bildschirm ähnlich wie unten aussehen. Im Folgenden finden Sie eine Erklärung für jeden konfigurierbaren Abschnitt.

Segmente definieren

Klicken Sie auf die Schaltfläche Neu, um das erste Segment des Dokuments zu definieren. Sie müssen Folgendes eingeben (erforderlich):

• Segmentname: Geben Sie einen Namen für das Segment ein.
• Segmenteltern: Wählen Sie den Elternteil dieses Segments aus dem Dropdown-Menü aus.

• Vorkommen: Geben Sie an, wie das Segment in Ihrem komplexen Dokument vorkommen wird, indem Sie eine der Optionen aus dem Dropdown-Menü auswählen:

  • Wählen Sie Nur einmal, wenn dieses Segment einmal, aber nur einmal im Dokument vorkommen muss.
  • Wählen Sie Eins oder mehr, wenn dieses Segment mindestens einmal vorkommen muss, aber auch wiederholt werden kann.
  • Wählen Sie Null oder eins, wenn dieses Segment möglicherweise nicht vorkommt, aber wenn es vorkommt, kann es nur einmal vorkommen.
  • Wählen Sie Null oder mehr, wenn dieses Segment möglicherweise nicht vorkommt, aber wenn es vorkommt, kann es ein oder mehrere Male vorkommen.

Wiederholen Sie die vorherigen Schritte für jedes zusätzliche Segment, das Sie definieren müssen.

Segmenteigenschaften definieren

Nachdem alle Segmente erstellt wurden, müssen Sie die Felder jedes Segments definieren.

Doppelklicken Sie entweder auf die #-Spalte des gewünschten Segments oder klicken Sie mit dem hervorgehobenen Segment auf die Schaltfläche . Das Popup Segment: Detail wird angezeigt.

Für jedes Segment klicken Sie auf die Schaltfläche Neu, um die Felder des Segments zu definieren. Sie müssen Folgendes eingeben (erforderlich):

• Feldname: Geben Sie einen Namen für dieses Feld ein.

• Typ: Wählen Sie einen Typ aus dem Dropdown-Menü aus. Optionen sind String, Integer, Date, Long, Float, Double, Boolean.

  Hinweis

  Im Zweifelsfall über den Feldtyp wird empfohlen, String zu wählen, da dieser Typ es ermöglicht, jeden Datentyp als Zeichenfolge einzuschließen.

• Begin: Geben Sie die Startzeichenposition ein (1 wird als die Position für den Beginn der Datei betrachtet). Beachten Sie, dass der Standardwert für nachfolgende Zeilen immer das nächste Zeichen nach der Endposition des vorherigen Feldes ist.

• Länge: Geben Sie die Anzahl der Zeichen ein, die für dieses Feld reserviert sind.

  Hinweis

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

  Wenn Sie den Zeichenlängenwert eines Feldes geändert haben, verwenden Sie die Schaltfläche, um die Startpositionen aller Felder neu zu berechnen.

  Warnung

  Die Schaltfläche Berechnen setzt alle Begin- und Ende-Feldwerte zurück, basierend auf den Längen-Werten, die Sie angegeben haben. Verwenden Sie diese Schaltfläche nicht, wenn die Feldpositionen Ihrer Datei Lücken oder Überlappungen aufweisen, da diese gelöscht werden.

• Ende: Geben Sie die Endzeichenposition ein.

  Hinweis

  Standardmäßig werden festgelegte Segmente mit einem Zeilenumbruchzeichen beendet.

Die folgenden Angaben sind optional:

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

Wiederholen Sie die vorherigen Schritte für jedes zusätzliche Datenfeld, das Sie definieren müssen.

Felder aus Beispieldatei konfigurieren

Um Felder aus einer Beispieldatei zu erstellen, anstatt sie manuell zu erstellen, beziehen Sie sich bitte auf Erstellen einer Textdokumentdefinition aus einer Beispieldatei.