Erstellen Sie ein FTP Site-Ziel in Jitterbit Design Studio

Einführung

Ein FTP Site-Ziel kann zum Schreiben auf einen FTP Server mit Optionen wie Erfolgs-/Fehlerordnern verwendet werden.

Voraussetzungen

Bevor Sie die Funktion „Erfolgs-/Fehlerordner“ eines FTP Site-Ziels verwenden können (siehe Optionen unten), müssen Sie den lokalen Dateispeicherort auf Ihrem privaten Jitterbit-Agenten aktiviert haben. Siehe Aktivieren des lokalen Dateispeicherorts für Einzelheiten.

Erstellen eines FTP Site-Ziels

Sie können ein neues FTP Site-Ziel einzeln oder innerhalb einer vorhandenen Operation erstellen. Einzelheiten zur Funktionsweise von Zielen innerhalb von Operationen finden Sie unter Erstellen einer Operation.

Neues FTP Site-Ziel als eigenständiges Ziel erstellen

In Ihrem Projekt in Jitterbit Design Studio erstellen Sie ein neues FTP Site-Ziel auf eine der folgenden Arten:

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

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

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

Wählen Sie im Popup als Typ FTP Site aus:

Ihr neues Ziel wird auf der eigenen Tab Neues Ziel im rechten Fensterbereich angezeigt.

Erstellen eines neuen FTP Site-Ziels in einem vorhandenen Operation

Ein Ziel 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 ihres Ziels wie folgt angeben:

• Doppelklicken Sie auf das Zielsymbol. Wählen Sie im Popup Neues Ziel erstellen aus. oder

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

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

Verwenden eines vorhandenen FTP Site-Ziels in einem vorhandenen Operation

Um ein vorhandenes FTP Site-Ziel in einem vorhandenen Operation mit einem Ziel zu verwenden, können Sie es wie folgt festlegen:

• Doppelklicken Sie während des Operation auf das Zielsymbol und wählen Sie im angezeigten Popup das gewünschte FTP Site-Ziel aus der Liste aus. oder

• Klicken Sie während des Operation mit der rechten Maustaste auf das Zielsymbol, wählen Sie Vorhandenes Ziel auswählen und wählen Sie im daraufhin angezeigten Popup das gewünschte FTP Site-Ziel aus der Liste aus. oder

• Ziehen Sie das gewünschte FTP Site-Ziel aus dem Baum links und legen Sie es auf dem vorhandenen Zielsymbol der Operation ab.

Konfigurieren eines FTP Site-Ziels

Nachdem Sie ein FTP Site-Ziel erstellt haben, wird der Konfigurationsbildschirm in der Hauptansicht von Design Studio geöffnet. Sie können jederzeit zum Konfigurationsbildschirm zurückkehren, indem Sie in der Operation auf das Zielsymbol doppelklicken oder im Baum links auf das Ziel doppelklicken.

Grundkonfiguration

Der Konfigurationsbildschirm sieht ähnlich wie dieses Beispiel aus:

• Name: Geben Sie einen passenden, eindeutigen Namen für das Ziel ein.
• Typ: Verwenden Sie das Dropdown-Menü, um FTP Site auszuwählen, falls diese nicht bereits angegeben ist.
• Verbindungsparameter: Geben Sie die Details für Ihre FTP Site-Verbindung an:

• Host: Geben Sie einen gültigen FTP Serverstandort für Ihre Quelle ein, beispielsweise ftp.example.com. (Erforderlich.)

  • Port verwenden: Die Standardports sind 21 für FTP/FTPS und 22 für SFTP/SCP. Für andere Ports deaktivieren Sie das Kontrollkästchen Port verwenden und geben Sie im Feld Port einen zu verwendenden Port ein.
  • Pfad(e): Geben Sie einen oder mehrere gültige Pfade ein. Der Pfad sollte auf ein vorhandenes Verzeichnis auf dem FTP Server verweisen, wie z. B. /incoming/. Mehrere Pfade können mit Komma-getrennten Werten angegeben werden. Wenn mehrere Pfade angegeben werden, wird dieselbe Datei an mehrere Speicherorte geschrieben.
  • Anmelden und Passwort: Geben Sie einen Benutzernamen (erforderlich) und ein Passwort (falls zutreffend) ein, die den Zugriff auf den FTP Server ermöglichen. Lassen Sie das Passwortfeld leer, wenn kein Passwort erforderlich ist.

• Dateiname(n): Geben Sie den gewünschten Namen für die Zieldatei(en) ein. In diesem Feld können Variablen verwendet werden. Wenn Sie eine komprimierte Datei (ZIP) angeben, beachten Sie den Abschnitt „Komprimierung“ der zusätzlichen Verbindungsparameter unter Optionen unten. Die Datei wird automatisch auf Stammebene in das Archiv geschrieben. (Erforderlich.)

  • Deaktivieren Sie FTP Umbenennung verwenden, wenn diese Option Probleme verursacht.

• Verbindung testen: Durch Klicken auf testet das FTP Site-Ziel. Der Test schlägt fehl, wenn das angegebene Verzeichnis nicht existiert. Es wird nicht getestet, ob der angegebene Benutzer Schreibberechtigung für das Verzeichnis hat.

• Klicken Sie in der Hauptsymbolleiste oder in der Zielsymbolleiste 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:

• Passiver Modus: Lassen Sie dieses Kontrollkästchen aktiviert, um die „PASV“-Methode des FTP Servers zum Abrufen von Dateien zu verwenden. Wenn diese Option aktiviert ist, öffnet der Agent eine Kontrollverbindung zum FTP -Server, teilt dem FTP Server mit, dass er eine zweite Verbindung erwarten soll, und öffnet dann die Datenverbindung zum FTP -Server selbst auf einem zufällig ausgewählten Port mit hoher Nummer. Dies funktioniert mit den meisten Firewalls, sofern die Firewall keine ausgehenden Verbindungen auf Ports mit hoher Nummer einschränkt.

• Verzeichnisse automatisch erstellen: Erstellt automatisch alle Verzeichnisse, die im Zielpfad noch nicht vorhanden sind.

  Warnung

  Es ist ein Bekanntes Problem, dass die automatische Erstellung von Verzeichnissen inkonsistent funktioniert. Abhängig vom jeweiligen FTP Server wird das Verzeichnis möglicherweise nicht erstellt. Wenn diese Option verwendet wird, sollten Sie vor der Verwendung in der Produktion bestätigen, dass das Verzeichnis erstellt wurde.

• Kopfzeilen schreiben: Wenn diese Option aktiviert ist und es sich um ein flaches Textziel handelt, wird als erste Zeile eine Header mit Spalten-/Feldnamen geschrieben.

• Keine leeren Dateien erstellen: Wenn aktiviert, wird das Erstellen der Zieldatei übersprungen, wenn keine Zieldaten vorhanden sind.
• An Datei anhängen: Wenn diese Option aktiviert ist, werden die Daten an eine vorhandene Zieldatei angehängt, anstatt sie zu überschreiben. Beachten Sie, dass SFTP-Verbindungen das Anhängen an Dateien nicht unterstützen, was eine Einschränkung von SFTP darstellt.

• Zeilenendetyp: Bestimmt, wie Jitterbit beim Schreiben in ein Ziel Zeilenumbrüche schreibt. Beachten Sie, dass Zeilenendezeichen in den Daten nicht konvertiert werden. Verfügbare Optionen:

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

• Zeichenkodierung: Wird verwendet, um eine Zeichenkodierung für die Zieldatei anzugeben. Wenn dieses Feld leer gelassen wird, versucht Jitterbit, die Kodierung zu erkennen. Um eine andere Kodierung als die Standardkodierung anzugeben, geben Sie eine der unterstützten Kodierungen ein, die unter 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 erhält denselben Namen wie der im Feld Dateiname(n) oben angegebene, 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.
  • Beispiel: Wenn 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 hinzugefügt werden.
  • Wenn ein Fehlerordner angegeben wird, werden auf ähnliche Weise alle fehlgeschlagenen Dateien in eine Datei im Fehlerordner geschrieben.

  Wichtig

  Absolute Pfade für die Erfolgs- und Fehlerordner befinden sich auf dem privaten Agenten, nicht auf dem FTP Server.

  Wenn Sie in diesen Feldern Dateinamen-Schlüsselwörter verwenden, werden die Schlüsselwörter nicht aufgelöst. Eine Problemumgehung finden Sie unter Einschränkung und Problemumgehung unter Dateinamen-Schlüsselwörter. Mit Sternchen (*) und andere normalerweise nicht unterstützte Dateinamenzeichen führen zum Fehlschlagen des Operation.

• Komprimierung: Wenn das Kontrollkästchen Zieldateien komprimieren aktiviert ist, werden die Zieldateien im ZIP-Format komprimiert. Weitere Optionen sind:

  • Dateiname(n) im Archiv: Akzeptiert Variablen und Dateinamen-Schlüsselwörter. Um den Dateinamen im Archiv mit dem im Ziel definierten Dateinamen identisch zu halten, verwenden Sie ein Format von [file].[ext] wie oben gezeigt.
  • Modus: Gilt nicht für FTP Site-Ziele.
  • Passwort: Geben Sie für verschlüsselte Archive ein Passwort ein.
  • Verschlüsselungsmodus: Wenn ein Passwort angegeben wird, stehen zwei Verschlüsselung zur Verfügung: AES und Standard-ZIP.

• Proxy-Einstellungen: Verwenden Sie das Dropdown-Menü, um eine dieser Optionen für einen benutzerdefinierten Proxy für den FTP Host auszuwählen:

  • Deaktivieren: Proxy-Einstellungen werden für diese bestimmte Quelle deaktiviert, wodurch die Agent-Proxy-Konfiguration umgangen wird, falls vorhanden.
  • Standard: Proxy-Einstellungen werden mithilfe der Agent-Proxy-Konfiguration aktiviert, falls vorhanden. Wenn in der Agentenkonfiguration keine Proxy-Einstellungen angegeben sind, hat die Einstellung Standard dasselbe Ergebnis wie die Einstellung Deaktivieren.

  • Benutzerdefiniert: Proxy-Einstellungen werden für diese bestimmte Quelle mithilfe der hier bereitgestellten benutzerdefinierten Informationen aktiviert. Diese Option umgeht die Agenten-Proxy-Konfiguration, falls vorhanden. Wenn Benutzerdefiniert ausgewählt ist, werden diese Felder verfügbar:

    

    Siehe Proxy für private Agenten aktivieren für Details zu diesen Feldern.

• Übertragungstyp: Wenn die Dateien ASCII-basiert sind, wählen Sie den Übertragungstyp ASCII; für alle anderen Dateitypen wählen Sie Binär. Binär ist die Standardeinstellung und funktioniert normalerweise am besten.

• Sicherheitsoptionen: Diese Optionen sind verfügbar:

• Unsicheres FTP: Dies verwendet normales unverschlüsseltes FTP und ist nicht sicher, da Passwörter im Klartext über das Netzwerk gesendet werden. Nur in einer sicheren Umfeld verwenden. (Standard.)

  • Explizites FTPS: Diese Option verwendet explizites FTP mit SSL, sodass der FTP Client vor Beginn einer Dateiübertragung Sicherheitsinformationen anfordern muss. Wenn diese Option ausgewählt ist, können Sie den bevorzugten Authentifizierungsmodus (entweder TLS oder SSL) und diese SSL-Optionen festlegen:

    • SSL versuchen: Hiermit wird versucht, eine TLS/SSL-verschlüsselte Übertragung zu initiieren. Wenn dies fehlschlägt, wird unverschlüsseltes FTP verwendet.
    • TLS/SSL für Kontrollverbindung erforderlich: Mit dieser Option wird die initiale FTP Kontrollverbindung mit TLS/SSL verschlüsselt, um sicherzustellen, dass der Passwortaustausch verschlüsselt erfolgt. Die Übertragung selbst wird nicht verschlüsselt, aber zumindest das Passwort wird nicht im Klartext gesendet. Wenn die Daten selbst nicht vertraulich oder bereits verschlüsselt sind, können Sie diese Option verwenden. Wenn der Server FTPS nicht unterstützt, schlägt die Übertragung fehl.
    • TLS/SSL für alle Datenübertragungen erforderlich: Diese Option erfordert, dass sowohl die Steuerverbindung als auch die Datenverbindung mit TLS/SSL verschlüsselt werden. Wenn der Server SSL nicht unterstützt, schlägt die Übertragung fehl.

  • Implizites FTPS: Diese Option verwendet implizites FTPS (implizites FTP mit TLS/SSL) und erfordert vor der Dateiübertragung eine TLS/SSL-Verbindung.

  • SFTP: Diese Option verwendet das SFTP-Protokoll anstelle von FTP. Diese Option kann nur verwendet werden, wenn Sie eine Verbindung zu einem SFTP-Server herstellen. Öffentliche und private Schlüsseldateien für SFTP können im SSH-Abschnitt konfiguriert werden der Agentenkonfigurationsdatei, wie unter Mit SSH-Schlüsseln mit SFTP verbinden beschrieben. Beachten Sie, dass SFTP und FTP/FTPS unterschiedliche Protokolle sind und unterschiedliche Standardports verwenden.