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 Jitterbit-privaten Agenten aktiviert haben. Siehe Aktivieren des lokalen Dateispeicherorts für Details.

Erstellen einer lokalen Dateiquelle

Sie können wählen, ob Sie eine neue lokale Dateiquelle eigenständig oder innerhalb einer bestehenden Operation erstellen möchten. Weitere Informationen dazu, wie Quellen innerhalb von Operationen funktionieren, finden Sie unter Erstellen einer Operation.

Erstellen einer neuen lokalen Dateiquelle als eigenständige Quelle

Innerhalb Ihres Projekts im Jitterbit Design Studio erstellen Sie eine neue lokale Dateiquelle auf folgende Weise:

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

• Klicken Sie im Baum auf der linken Seite 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 erscheint in einem eigenen Neue Quelle-Tab im rechten Bereich des Fensters.

Erstellen einer neuen lokalen Dateiquelle in einem bestehenden Vorgang

Eine Quelle wird normalerweise standardmäßig erstellt, wenn Sie einen neuen Vorgang erstellen. (Die Ausnahme ist ein Vorgang, der nur aus einem Skript besteht.) Bei einem bestehenden Vorgang können Sie den Typ seiner Quelle festlegen durch:

• Doppelklicken auf das Quellensymbol; im Popup wählen Sie Neue Quelle erstellen; oder

• Rechtsklicken auf das Quellensymbol und Neue Quelle erstellen auswählen.

Im erscheinenden Konfigurationsbildschirm verwenden Sie das Dropdown-Menü Typ, um Lokale Datei auszuwählen, wie oben gezeigt.

Verwenden einer bestehenden lokalen Dateiquelle in einem bestehenden Vorgang

Um eine bestehende lokale Dateiquelle in einem bestehenden Vorgang mit einer Quelle zu verwenden, können Sie dies auf folgende Weise festlegen:

• Innerhalb des Vorgangs doppelklicken Sie auf das Quellensymbol und wählen im resultierenden Popup die gewünschte lokale Dateiquelle aus der Liste; oder

• Innerhalb des Vorgangs rechtsklicken Sie auf das Quellensymbol, wählen Vorhandene Quelle auswählen und wählen im resultierenden Popup die gewünschte lokale Dateiquelle aus der Liste; oder

• Ziehen Sie die gewünschte lokale Dateiquelle aus dem Baum auf der linken Seite und lassen Sie sie auf das bestehende Quellensymbol des Vorgangs fallen.

Konfigurieren einer lokalen Dateiquelle

Nachdem Sie eine lokale Dateiquelle erstellt haben, öffnet sich der Konfigurationsbildschirm in der Hauptansicht von Design Studio. Sie können jederzeit zum Konfigurationsbildschirm zurückkehren, indem Sie doppelt auf das Quellensymbol im Vorgang klicken oder auf die Quelle im Baum auf der linken Seite doppelklicken.

Grundkonfiguration

Der Konfigurationsbildschirm wird ähnlich wie in diesem Beispiel erscheinen:

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

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

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

  • Ordner(e): Geben Sie einen lokalen Pfad auf dem Rechner ein, auf dem der Jitterbit-Agent installiert ist, der auf den Ordner verweist, in dem sich die gewünschten Datei(en) befinden.

    • Der Pfad darf keine dieser Zeichen enthalten: \~ % $ ? " \< > :
    • Die verwendeten Pfadtrennzeichen ('/' oder '\') müssen für das Betriebssystem des Rechners, auf dem der private Agent installiert ist, geeignet sein.
    • Es kann nur ein Pfad angegeben werden.

  • Dateien abrufen: Geben Sie den Namen der Quelldatei(en) ein, die Sie im Verzeichnis, das in Ordner(e) angegeben ist, lesen möchten. Dieses Feld kann auch ein Sternchen * enthalten, das als Platzhalter verwendet wird (zum Beispiel *.txt oder *.*) oder ein Fragezeichen ?, um genau ein Zeichen zu entsprechen (zum Beispiel datei?.txt). Variablen können ebenfalls in diesem Feld verwendet werden. Wenn Sie eine komprimierte Datei (ZIP) angeben, siehe den Abschnitt "Kompression" 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ß- und Kleinschreibung des Dateinamens ignoriert werden soll oder ob die Informationen zu Dateien abrufen als regulärer Ausdruck behandelt werden sollen.

• Verbindung testen: Durch Klicken auf die Schaltfläche wird die lokale Dateiquelle getestet. Es wird überprüft, ob eine Verbindung zum angegebenen Ordner hergestellt werden kann, und eine Liste der gefundenen Dateien zurückgegeben; es schlägt fehl, wenn der Pfad kein gültiger Pfad ist, der Dateien im Betriebssystem findet, auf dem der Jitterbit-Agent ausgeführt wird. Wenn Sie einen Fehler erhalten, stellen Sie sicher, dass Sie lokale Dateien aktiviert haben, wie in Aktivieren des lokalen Dateispeicherorts beschrieben.

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

Optionen

Zusätzliche Verbindungsparameter können angegeben werden, indem Sie auf Optionen am Ende des Abschnitts Verbindungsparameter klicken:

• Zeichencodierung: Wird verwendet, um eine Zeichencodierung für die Quelldatei(en) anzugeben. Wenn dieses Feld leer bleibt, versucht Jitterbit, die Codierung zu erkennen. Um eine andere Codierung als die Standardcodierung anzugeben, fügen Sie eine der unterstützten Codierungen ein, die in Zeichencodierung 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 einen Ordner in diesem Verzeichnis geschrieben.
  • Die Datei wird denselben Namen wie der im Feld Dateien abrufen oben angegebene Namen haben, jedoch mit einem nachgestellten Unterstrich und einem Zeitstempel. Wenn bereits eine Datei mit demselben Namen in diesem Ordner vorhanden ist, wird ein zusätzlicher Unterstrich und ein Zähler hinzugefügt.
  • Zum Beispiel, wenn eine Datei mit dem Namen data.csv erfolgreich verarbeitet wird, könnte eine Kopie mit dem Namen data.csv_2018-01-01_12-00-00-000 in den als Erfolgsordner angegebenen Ordner geschrieben werden. Wenn eine solche Datei bereits aus einem vorherigen Durchlauf existiert, würde eine neue Datei data.csv_2018-01-01_12-00-00-000_1 hinzugefügt werden.
  • In ähnlicher Weise, wenn ein Fehlerordner angegeben ist, werden alle Dateien, die fehlschlagen, in eine Datei im Fehlerordner geschrieben.

• Trigger-Datei: Verwenden Sie dies, um eine Trigger-Datei anzugeben, die die Verarbeitung der Quelldatei(en) initiiert. Die Trigger-Datei 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.
  • Variablen (jedoch keine Platzhalter) können in diesem Feld verwendet werden.
  • Da die Trigger-Datei gelöscht wird, sobald die Verarbeitung beginnt, kann die Trigger-Datei nicht dieselbe Datei wie eine verarbeitete Quelldatei sein.
  • Sobald der Vorgang beginnt, wird der Vorgang regelmäßig nach der Trigger-Datei suchen. Das Abfrageintervall beträgt fest eine Sekunde.
  • Die Trigger-Datei wird gelöscht, sobald die Verarbeitung beginnt.
  • Wenn die Trigger-Datei nicht gefunden wird, wird der Vorgang weiterhin versuchen, die Trigger-Datei zu finden, bis der Vorgang abläuft.
  • Das Festlegen einer Trigger-Datei blockiert jeden Vorgang oder jedes Skript, das die Quelle verwendet, bis entweder die Bedingung für die Trigger-Datei erfüllt ist oder der Vorgang abläuft.

• Nach der Verarbeitung:

  • Wenn das Kontrollkästchen Datei löschen ausgewählt ist, werden die Quelldatei(en) nach der Verarbeitung gelöscht.
  • Wenn ein Wert im Feld Datei umbenennen angegeben ist, wird die Datei gemäß dem angegebenen Muster umbenannt. In diesem Feld können Variablen verwendet werden.
  • Es wird nur eines von 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 es auf dem Standardwert belassen wird, findet keine Nachbearbeitung der Quelldateien statt.

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

  Hinweis

  Diese Einstellung hat keine Wirkung, wenn eine lokale Quelldatei in einem Skript mit den Funktionen ReadFile oder WriteFile referenziert wird.

• Kompression: Wenn das Kontrollkästchen für Die Quelldaten sind komprimiert ausgewählt ist, werden die 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.