Erstellen Sie ein lokales Dateiziel in Jitterbit Design Studio

Einführung

Eine lokale Datei auf einem privaten Agenten kann als Ziel 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äres Speicherziel 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 ein lokales Dateiziel 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 Sie ein lokales Dateiziel

Sie können wählen, ob Sie ein neues lokales Dateiziel eigenständig oder innerhalb einer bestehenden Operation erstellen möchten. Weitere Informationen dazu, wie Quellen und Ziele innerhalb von Operationen funktionieren, finden Sie unter Erstellen einer Operation.

Erstellen Sie ein neues lokales Dateiziel als eigenständiges Ziel

Innerhalb Ihres Projekts im Jitterbit Design Studio erstellen Sie ein neues Dateifreigabe-Ziel auf folgende Weise:

• Gehen Sie zu Datei > Neu > Neues Ziel; oder

• Klicken Sie im Baum auf der linken Seite mit der rechten Maustaste auf Ziele und wählen Sie Neues Ziel; oder

• Klicken Sie in der oberen Symbolleiste auf das blaue Zielsymbol .

Im Popup wählen Sie Dateifreigabe als Typ:

Ihr neues Ziel erscheint in einem eigenen Neues Ziel-Tab im rechten Bereich des Fensters.

Erstellen eines neuen lokalen Dateiziels in einer vorhandenen Operation

Ein Ziel wird normalerweise standardmäßig erstellt, wenn Sie eine neue Operation erstellen. (Die Ausnahme ist eine Operation, die nur aus einem Skript besteht.) Bei einer vorhandenen Operation können Sie den Typ des Ziels wie folgt festlegen:

• Doppelklicken Sie auf das Zielsymbol; wählen Sie im Popup Neues Ziel erstellen; oder

• Klicken Sie mit der rechten Maustaste auf das Zielsymbol und wählen Sie Neues Ziel erstellen.

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

Verwenden eines vorhandenen lokalen Dateiziels in einer vorhandenen Operation

Um ein vorhandenes Lokales Dateiziel in einer vorhandenen Operation mit einem Ziel zu verwenden, können Sie es auf eine der folgenden Arten festlegen:

• Innerhalb der Operation, doppelklicken Sie auf das Zielsymbol, und wählen Sie im resultierenden Popup das gewünschte Lokale Dateiziel aus der Liste; oder

• Innerhalb der Operation, klicken Sie mit der rechten Maustaste auf das Zielsymbol, wählen Sie Vorhandenes Ziel auswählen, und wählen Sie im resultierenden Popup das gewünschte Lokale Dateiziel aus der Liste; oder

• Ziehen Sie das gewünschte Lokale Dateiziel aus dem Baum auf der linken Seite und lassen Sie es auf das vorhandene Zielsymbol der Operation fallen.

Konfigurieren eines lokalen Dateiziels

Nachdem Sie ein Lokales Dateiziel erstellt haben, öffnet sich der Konfigurationsbildschirm in der Hauptansicht von Design Studio. Sie können jederzeit zum Konfigurationsbildschirm zurückkehren, indem Sie auf das Zielsymbol in der Operation doppelklicken oder auf das Ziel im Baum auf der linken Seite doppelklicken.

Grundkonfiguration

Der Konfigurationsbildschirm wird ähnlich wie in diesem Beispiel angezeigt:

• Name: Geben Sie einen geeigneten, eindeutigen Namen für das Ziel ein.
• Type: Verwenden Sie das Dropdown-Menü, um Local File auszuwählen, falls dies nicht bereits angegeben ist.

• Connection Parameters: Geben Sie die Details für Ihre lokale Datei-Verbindung an:

  • Browse: Die Browse-Schaltfläche, falls aktiviert, kann 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 lokale Dateien aktivieren, wie in Aktivieren des lokalen Dateispeicherorts beschrieben. Wenn Sie einen Ordner oder eine Datei über Browse auswählen, werden die Felder Folder(s)—und möglicherweise Filename(s)—automatisch ausgefüllt.

  • Folder(s): Geben Sie einen lokalen Pfad auf dem Rechner an, auf dem der Jitterbit-Agent installiert ist, der auf den Ordner verweist, in dem die Ziel-Datei(en) gespeichert werden sollen.

    • 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.
    • Mehrere Pfade können mit durch Kommas getrennten Werten angegeben werden. Wenn mehrere Pfade angegeben werden, wird dieselbe Datei an mehreren Standorten geschrieben.

  • Filename(s): Geben Sie den gewünschten Namen für die Ziel-Datei(en) ein. Variablen können in diesem Feld verwendet werden. Wenn Sie eine komprimierte Datei (ZIP) angeben, siehe den Abschnitt "Kompression" der zusätzlichen Verbindungsparameter unter Optionen unten. Die Datei wird automatisch im Archiv auf der obersten Ebene geschrieben. (Erforderlich.)

• Test Connection: Durch Klicken auf die Schaltfläche wird das lokale Datei-Ziel getestet und überprüft, ob eine Verbindung zum angegebenen Ordner hergestellt werden kann; es schlägt fehl, wenn der Pfad kein gültiger Pfad im Betriebssystem ist, auf dem der Jitterbit-Agent ausgeführt wird. Wenn Sie eine Fehlermeldung 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 des Ziels, um die Konfiguration zu speichern.

Optionen

Zusätzliche Verbindungsparameter können durch Klicken auf Optionen am Ende des Abschnitts Verbindungsparameter angegeben werden:

• Ende der Zeile Typ: Bestimmt, wie Jitterbit Zeilenumbrüche beim Schreiben in ein Ziel schreibt. Beachten Sie, dass Zeilenumbruchzeichen in den Daten nicht konvertiert werden. Verfügbare Optionen:

  • Standard: Standard-Zeilenumbruchzeichen für die Plattform, auf der der Agent ausgeführt wird.
  • Windows: CRLF (ASCII 13 und ASCII 10)
  • Unix: LF (ASCII 10)

• Kopfzeilen schreiben: Wenn aktiviert und ein flaches Textziel, wird eine Kopfzeile mit Spalten-/Feldnamen als erste Zeile geschrieben.

• Keine leeren Dateien erstellen: Wenn aktiviert, wird das Erstellen der Zieldatei übersprungen, wenn keine Zieldaten vorhanden sind.
• Verzeichnisse automatisch erstellen: Wenn aktiviert, werden alle erforderlichen Zwischenverzeichnisse, um die Pfade (wie oben in Verbindungsparameter angegeben) abzuschließen, automatisch erstellt.
• Zeichenkodierung: Wird verwendet, um eine Zeichenkodierung für die Zieldatei anzugeben. Wenn leer gelassen, versucht Jitterbit, die Kodierung zu erkennen. Um eine andere Kodierung als die Standardkodierung anzugeben, fügen Sie eine der unterstützten Kodierungen ein, die in Unterstützte Zeichenkodierungen beschrieben sind.

• Erfolgs-/Fehlerordner: Gibt an, ob Erfolgs- und/oder Fehlerordner verwendet werden, um eine Kopie aller verarbeiteten Dateien zu archivieren.

  • Wenn ein Erfolgsordner angegeben ist, wird nach erfolgreicher Verarbeitung des Ziels eine Kopie der Datei in eine Datei in diesem Ordner geschrieben.
  • Die Datei wird denselben Namen wie im Feld Dateiname(n) oben 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.
  • 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 Lauf 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.

• Kompression: Wenn das Kontrollkästchen für Ziel-Dateien komprimieren ausgewählt ist, werden die Ziel-Dateien im ZIP-Format komprimiert. Zusätzliche Optionen sind:

  • Dateiname(n) im Archiv: Akzeptiert Variablen und Dateinamen-Schlüsselwörter. Um den Dateinamen im Archiv gleich dem im Ziel definierten Dateinamen zu halten, verwenden Sie das Format [file].[ext], wie oben gezeigt.
  • Modus: Einer von Überschreiben oder Anhängen. Überschreiben wird ein vorhandenes Archiv überschreiben. Für nicht verschlüsselte Archive wird Anhängen Dateien zu einem vorhandenen Archiv hinzufügen. Dieser Modus ist nur für lokale Dateien (und temporäre Speicherorte) verfügbar.
  • Passwort: Für verschlüsselte Archive geben Sie ein Passwort an.
  • Verschlüsselungsmodus: Wenn ein Passwort angegeben wird, stehen zwei Verschlüsselungsmodi zur Verfügung: AES oder Standard ZIP.