Erstellen einer lokalen Dateiquelle in Jitterbit Design Studio

Einführung

Eine lokale Datei auf einem privaten Agenten kann als Quelle in Jitterbit verwendet werden. Sie muss sich auf dem Computer befinden, auf dem der private Agent installiert ist, und kann nicht mit Cloud-Agenten verwendet werden. (Siehe Temporäre Speicherquelle für einen Ansatz, der für Cloud-Agenten anwendbar ist.)

Jeder Dateityp kann verwendet werden. Häufig verwendete Typen für lokale Dateien sind Text (.txt), CSV (.csv), XML (.xml) und JSON (.json).

Voraussetzungen

Bevor Sie eine lokale Dateiquelle verwenden können, müssen Sie den lokalen Dateispeicherort auf Ihrem privaten Jitterbit-Agenten aktiviert haben. Siehe Lokalen Dateispeicherort aktivieren für Einzelheiten.

Erstellen einer lokalen Dateiquelle

Sie können eine neue lokale Dateiquelle eigenständig oder innerhalb einer vorhandenen Operation erstellen. Weitere Informationen zur Funktionsweise von Quellen innerhalb von Operationen finden Sie unter Erstellen einer Operation.

Erstellen Sie eine neue lokale Dateiquelle als eigenständige Quelle

In Ihrem Projekt in Jitterbit Design Studio erstellen Sie eine neue lokale Dateiquelle auf eine der folgenden Arten:

• Gehen Sie zu Datei > Neu > Neue Quelle; oder

• Klicken Sie im Baum links mit der rechten Maustaste auf Quellen und wählen Sie Neue Quelle; oder

• Klicken Sie in der oberen Symbolleiste auf das grüne Quellensymbol .

Wählen Sie im Popup Lokale Datei als Typ aus:

Ihre neue Quelle wird im rechten Fensterbereich auf einer eigenen Tab Neue Quelle angezeigt.

Erstellen einer neuen lokalen Dateiquelle in einem vorhandenen Operation

Eine Quelle wird normalerweise standardmäßig erstellt, wenn Sie eine neue Operation erstellen. (Die Ausnahme ist eine Operation, die nur aus einem Script besteht.) Bei einer vorhandenen Operation können Sie den Typ ihrer Quelle wie folgt angeben:

• Doppelklicken Sie auf das Quellensymbol. Wählen Sie im Popup Neue Quelle erstellen aus. oder

• Klicken Sie mit der rechten Maustaste auf das Quellensymbol und wählen Sie Neue Quelle erstellen.

Wählen Sie im angezeigten Konfigurationsbildschirm im Dropdown-Menü Typ die Option Lokale Datei aus, wie oben gezeigt.

Verwenden einer vorhandenen lokalen Dateiquelle in einem vorhandenen Operation

Um eine vorhandene lokale Dateiquelle in einem vorhandenen Operation mit einer Quelle zu verwenden, können Sie sie wie folgt festlegen:

• Doppelklicken Sie während des Operation auf das Quellsymbol und wählen Sie im angezeigten Popup die gewünschte lokale Dateiquelle aus der Liste aus. oder

• Klicken Sie während des Operation mit der rechten Maustaste auf das Quellsymbol, wählen Sie Vorhandene Quelle auswählen und wählen Sie im daraufhin angezeigten Popup die gewünschte lokale Dateiquelle aus der Liste aus. oder

• Ziehen Sie die gewünschte lokale Dateiquelle aus dem Baum links und legen Sie sie auf dem vorhandenen Quellensymbol der Operation ab.

Konfigurieren einer lokalen Dateiquelle

Nachdem Sie eine lokale Dateiquelle erstellt haben, wird der Konfigurationsbildschirm in der Hauptansicht von Design Studio geöffnet. Sie können jederzeit zum Konfigurationsbildschirm zurückkehren, indem Sie im Operation auf das Quellensymbol doppelklicken oder im Baum links auf die Quelle doppelklicken.

Grundkonfiguration

Der Konfigurationsbildschirm sieht ähnlich wie dieses Beispiel aus:

• Name: Geben Sie einen passenden, eindeutigen Namen für die Quelle ein.
• Typ: Verwenden Sie die Dropdown-Liste, um Lokale Datei auszuwählen, falls diese nicht bereits angegeben ist.

• Verbindungsparameter: Geben Sie die Details für Ihre lokale Dateiverbindung an:

  • Durchsuchen: Die Schaltfläche Durchsuchen kann, wenn aktiviert, verwendet werden, um schnell den Ordnerpfad einzugeben. Sie kann nur verwendet werden, wenn der Jitterbit-Agent lokal auf demselben Computer installiert ist, auf dem Design Studio ausgeführt wird. Wenn diese Option deaktiviert ist, müssen Sie möglicherweise lokale Dateien aktivieren, wie unter Aktivieren des lokalen Dateispeicherorts beschrieben. Wenn Sie einen Ordner oder eine Datei mit Durchsuchen auswählen, werden die Felder Ordner (und möglicherweise Dateien abrufen) automatisch ausgefüllt.

  • Ordner: Geben Sie einen lokalen Pfad auf dem Computer ein, auf dem der Jitterbit-Agent installiert ist, der auf den Ordner verweist, in dem sich die gewünschten Dateien befinden.

    • Der Pfad darf keines dieser Zeichen enthalten: \~ % $ ? " \< >:

    • Die Pfadtrennzeichen ('/' oder '\') verwendet werden, muss für das Operationssystem der Maschine geeignet sein, auf der der private Agent installiert ist.

    • Es kann nur ein Pfad angegeben werden.

  • Dateien abrufen: Geben Sie den Namen der Quelldatei(en) ein, die Sie aus dem in Ordner(n) angegebenen Verzeichnis lesen möchten. Dieses Feld kann auch ein Sternchen enthalten * als Platzhalter zu verwenden (zum Beispiel *.txt oder *.*) oder ein Fragezeichen ? auf genau ein Zeichen passen (zum Beispiel file?.txt). In diesem Feld können auch Variablen verwendet werden. Wenn Sie eine komprimierte Datei (ZIP) angeben, beachten Sie den Abschnitt „Komprimierung“ der zusätzlichen Verbindungsparameter unter Optionen unten. Die komprimierte Datei kann automatisch dekomprimiert und gelesen werden. (Erforderlich.)

  • Filteroptionen: Ermöglicht die Angabe, ob die Groß-/Kleinschreibung von Dateinamen ignoriert werden soll oder ob die Dateien abrufen-Informationen als regulärer Ausdruck behandelt werden sollen.

• Verbindung testen: Klicken Sie auf testet die lokale Dateiquelle. Es wird überprüft, ob eine Verbindung zum angegebenen Ordner hergestellt werden kann, und eine Liste der gefundenen Dateien zurückgegeben. Der Vorgang schlägt fehl, wenn der Pfad kein gültiger Pfad ist, der Dateien auf dem Operationssystem findet, auf dem der Jitterbit-Agent ausgeführt wird. Wenn Sie eine Fehlermeldung erhalten, stellen Sie sicher, dass Sie lokale Dateien aktiviert haben, wie unter Aktivieren des lokalen Dateispeicherorts beschrieben.

• Klicken Sie entweder in der Hauptsymbolleiste oder in der Symbolleiste der Quelle auf die Schaltfläche Speichern, um die Konfiguration zu speichern.

Optionen

Weitere Verbindungsparameter können durch Klicken auf Optionen unten im Abschnitt Verbindungsparameter angegeben werden:

• Zeichenkodierung: Wird verwendet, um eine Zeichenkodierung für die Quelldatei(en) anzugeben. Wenn dieses Feld leer gelassen wird, versucht Jitterbit, die Kodierung zu erkennen. Um eine andere Kodierung als die Standardkodierung anzugeben, fügen Sie eine der unterstützten Kodierungen ein, die unter Zeichenkodierung beschrieben sind.

• Erfolgs-/Fehlerordner: Verwenden Sie diesen Abschnitt, um anzugeben, ob Erfolgs- und/oder Fehlerordner verwendet werden, um eine Kopie aller verarbeiteten Dateien zu archivieren.

  • Wenn ein Erfolgsordner angegeben ist, wird nach erfolgreicher Verarbeitung der Quelle eine Kopie der Datei in eine Datei in diesem Ordner geschrieben.
  • Die Datei erhält denselben Namen wie die oben im Feld Dateien abrufen angegebene Datei, jedoch mit einem abschließenden Unterstrich und einem hinzugefügten Zeitstempel. Wenn sich in diesem Ordner bereits eine Datei mit demselben Namen befindet, werden ein zusätzlicher Unterstrich und ein Zähler hinzugefügt.
  • Wenn beispielsweise eine Datei mit dem Namen data.csv erfolgreich verarbeitet wurde, wird eine Kopie mit dem Namen data.csv_2018-01-01_12-00-00-000 könnte in den als Erfolgsordner angegebenen Ordner geschrieben werden. Wenn eine solche Datei bereits von einem vorherigen Lauf existiert, wird eine neue Datei data.csv_2018-01-01_12-00-00-000_1 würde hinzugefügt werden.
  • Wenn ein Fehlerordner angegeben ist, werden in ähnlicher Weise alle fehlgeschlagenen Dateien in eine Datei im Fehlerordner geschrieben.

• Triggerdatei: Hiermit können Sie eine Triggerdatei angeben, die die Verarbeitung der Quelldatei(en) einleitet. Die Triggerdatei wird gelöscht, wenn die Verarbeitung beginnt.

  • Nachdem Sie das Kontrollkästchen Trigger verwenden aktiviert haben, geben Sie einen absoluten Dateipfad zu einer Datei an, deren Vorhandensein die Verarbeitung auslöst.
  • In diesem Feld können Variablen (jedoch keine Platzhalter) verwendet werden.
  • Da die Triggerdatei zu Beginn der Verarbeitung gelöscht wird, kann die Triggerdatei nicht dieselbe Datei sein wie eine verarbeitete Quelldatei.
  • Sobald der Operation startet, sucht Operation nach der Triggerdatei. Das Abfragezeitintervall ist auf eine Sekunde festgelegt.
  • Die Triggerdatei wird gelöscht, wenn die Verarbeitung beginnt.
  • Wenn die Triggerdatei nicht gefunden wird, versucht der Operation weiter, die Triggerdatei zu finden, bis die Zeit für den Operation abläuft.
  • Durch das Festlegen einer Triggerdatei werden alle Operation oder Script blockiert, die die Quelle verwenden, bis entweder die Bedingung der Triggerdatei erfüllt ist oder der Operation eine Zeitüberschreitung aufweist.

• Nach der Verarbeitung:

  • Wenn das Kontrollkästchen Datei löschen aktiviert ist, werden die Quelldateien nach der Verarbeitung gelöscht.
  • Wenn im Feld Datei umbenennen ein Wert angegeben ist, wird die Datei nach dem angegebenen Muster umbenannt. In diesem Feld können Variablen verwendet werden.
  • Es wird nur Löschen oder Umbenennen akzeptiert. Wenn das Kontrollkästchen Datei löschen aktiviert ist, wird Datei umbenennen deaktiviert und ignoriert. Wenn Datei umbenennen leer ist, wird es ignoriert. Wenn die Standardeinstellung beibehalten wird, findet keine Nachbearbeitung der Quelldateien statt.

• Zeilen ignorieren: Die angegebene Anzahl der ersten und letzten Zeilen wird für jede Datei ignoriert. Wenn Kopf- oder Fußzeilen ignoriert werden sollen, geben Sie die Anzahl der Zeilen entsprechend in die Felder Erste und Letzte ein.

  Notiz

  Diese Einstellung wird nicht wirksam, wenn eine lokale Dateiquelle von einem Script aus mit dem Befehl referenziert wird ReadFile oder WriteFile Funktionen.

• Komprimierung: Wenn das Kontrollkästchen für Die Quelldaten sind komprimiert aktiviert ist, werden Quelldateien im ZIP-Format dekomprimiert. Ein Passwort (für verschlüsselte Archive) kann angegeben werden. Es wird nur das Lesen aus dem Stammverzeichnis des Archivs unterstützt.