Erstellen eines FTP-Standorts in Jitterbit Design Studio

Einführung

Ein FTP-Standort kann verwendet werden, um auf einen FTP-Server mit Optionen wie Erfolgs-/Fehlerordnern zu schreiben.

Voraussetzungen

Bevor Sie die Funktion für Erfolgs-/Fehlerordner eines FTP-Standorts nutzen können (siehe die Optionen unten), müssen Sie den lokalen Dateispeicherort auf Ihrem Jitterbit-Privatagenten aktiviert haben. Siehe Aktivieren des lokalen Dateispeicherorts für Details.

Erstellen eines FTP-Standorts

Sie können wählen, ob Sie einen neuen FTP-Standort eigenständig oder innerhalb einer bestehenden Operation erstellen möchten. Für Details, wie Ziele innerhalb von Operationen funktionieren, siehe Erstellen einer Operation.

Neuen FTP-Standort als eigenständiges Ziel erstellen

Innerhalb Ihres Projekts in Jitterbit Design Studio erstellen Sie einen neuen FTP-Standort 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 .

Wählen Sie im Popup FTP-Standort als Typ aus:

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

Erstellen eines neuen FTP-Standorts 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 Konfigurationsbildschirm, der erscheint, verwenden Sie das Dropdown-Menü Typ, um FTP-Standort auszuwählen, wie oben gezeigt.

Verwenden eines vorhandenen FTP-Standorts in einer vorhandenen Operation

Um einen vorhandenen FTP-Standort in einer vorhandenen Operation mit einem Ziel zu verwenden, können Sie dies auf folgende Weise festlegen:

• Innerhalb der Operation doppelklicken Sie auf das Zielsymbol und wählen im resultierenden Popup den gewünschten FTP-Standort aus der Liste; oder

• Innerhalb der Operation klicken Sie mit der rechten Maustaste auf das Zielsymbol, wählen Vorhandenes Ziel auswählen und wählen im resultierenden Popup den gewünschten FTP-Standort aus der Liste; oder

• Ziehen Sie den gewünschten FTP-Standort aus dem Baum auf der linken Seite und lassen Sie ihn auf das vorhandene Zielsymbol der Operation fallen.

Konfigurieren eines FTP-Standorts

Nachdem Sie einen FTP-Standort 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.
• Typ: Verwenden Sie das Dropdown-Menü, um FTP-Standort auszuwählen, falls dies nicht bereits angegeben ist.
• Verbindungsparameter: Geben Sie die Einzelheiten für Ihre FTP-Standortverbindung an:

• Host: Geben Sie einen gültigen Standort des FTP-Servers für Ihre Quelle ein, z. B. ftp.example.com. (Erforderlich.)

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

• Dateiname(en): 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.)

  • FTP-Umbenennung verwenden: Standardmäßig ausgewählt, ist diese Option dafür gedacht, dass Dateien zunächst einen temporären Dateinamen verwenden, der dann in den endgültigen Namen umbenannt wird. Deaktivieren Sie das Kontrollkästchen, wenn diese Option Probleme verursacht.

    Vorsicht

    Die Verwendung der Option FTP-Umbenennung verwenden, wenn auf einen SFTP-Server in einer Archivoperation geschrieben wird, ist nicht funktionsfähig.

• Verbindung testen: Durch Klicken auf die Schaltfläche wird das Ziel des FTP-Standorts getestet; es schlägt fehl, wenn das angegebene Verzeichnis nicht existiert. Es wird nicht getestet, ob der angegebene Benutzer Schreibberechtigungen für das Verzeichnis hat.

• 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 angegeben werden, indem Sie auf Optionen am Ende des Abschnitts Verbindungsparameter klicken:

• Passiver Modus: Lassen Sie dieses Kästchen aktiviert, um die "PASV"-Methode des FTP-Servers zum Abrufen von Dateien zu verwenden. Wenn diese Option aktiviert ist, öffnet der Agent eine Steuerverbindung zum FTP-Server, teilt dem FTP-Server mit, dass eine zweite Verbindung erwartet wird, und öffnet dann die Datenverbindung zum FTP-Server selbst über einen zufällig gewählten Hochport. Dies funktioniert mit den meisten Firewalls, es sei denn, die Firewall beschränkt ausgehende Verbindungen auf Hochports.

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

  Warnung

  Es ist ein bekanntes Problem, dass die automatische Erstellung von Verzeichnissen inkonsistent funktioniert. Je nach dem betreffenden FTP-Server kann das Verzeichnis möglicherweise nicht erstellt werden. Wenn diese Option verwendet wird, sollten Sie bestätigen, dass das Verzeichnis vor der Produktion erstellt wurde.

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

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

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

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

• Zeichencodierung: Wird verwendet, um eine Zeichencodierung für die Zieldatei anzugeben. Wenn das Feld leer gelassen wird, 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 Unterstützte Zeichencodierungen 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 einen Datei in diesem Ordner geschrieben.

• Die Datei wird denselben Namen wie der im Feld Dateiname(n) oben angegebene tragen, 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 Durchlauf existiert, würde eine neue Datei data.csv_2018-01-01_12-00-00-000_1 hinzugefügt.

• In ähnlicher Weise, wenn ein Fehlerordner angegeben ist, werden alle Dateien, die fehlschlagen, 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.

  Bei der Verwendung von Dateinamenschlüsselwörtern in diesen Feldern werden die Schlüsselwörter nicht aufgelöst. Für eine Umgehung siehe Einschränkung und Umgehung unter Dateinamenschlüsselwörter. Die Verwendung von Sternchen (*) und anderen typischerweise nicht unterstützten Dateinamenzeichen führt dazu, dass der Vorgang fehlschlägt.

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

  • Dateiname(n) im Archiv: Akzeptiert Variablen und Dateinamenschlüsselwörter. Um den Dateinamen im Archiv gleich dem im Ziel definierten Dateinamen zu halten, verwenden Sie ein Format von [file].[ext], wie oben gezeigt.
  • Modus: Nicht anwendbar für FTP-Standortziele.
  • 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 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: Die Proxy-Einstellungen sind für diese spezifische Quelle deaktiviert, wodurch die Agent-Proxy-Konfiguration umgangen wird, falls eine vorhanden ist.

• Standard: Die Proxy-Einstellungen sind aktiviert und verwenden die Agent-Proxy-Konfiguration, falls eine vorhanden ist. Wenn in der Agent-Konfiguration keine Proxy-Einstellungen angegeben sind, hat die Standard-Einstellung das gleiche Ergebnis wie die Deaktivieren-Einstellung.

• Benutzerdefiniert: Die Proxy-Einstellungen sind für diese spezifische Quelle aktiviert und verwenden die hier bereitgestellten benutzerdefinierten Informationen. Diese Option umgeht die Agent-Proxy-Konfiguration, falls eine vorhanden ist. Wenn Benutzerdefiniert ausgewählt ist, werden diese Felder verfügbar:

  ![attachment](/_download/attachments/55148712/image2016-12-19%20141147.png)
  
  Siehe [Aktivieren des Proxys für private Agenten](/de/agent/proxy/) für Details zu diesen Feldern.
  

• Übertragungsart: Wenn Dateien ASCII-basiert sind, wählen Sie die Übertragungsart ASCII; für alle anderen Dateitypen wählen Sie Binary. Binary 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 Umgebung verwenden. (Standard.)

  • Explizites FTPS: Diese Option verwendet explizites FTP mit SSL, wobei der FTP-Client aufgefordert wird, Sicherheitsinformationen anzufordern, bevor ein Dateiübertrag beginnt. Wenn diese Option ausgewählt ist, können Sie den bevorzugten Authentifizierungsmodus (entweder TLS oder SSL) und diese SSL-Optionen festlegen:

    • SSL versuchen: Dies versucht, eine TLS/SSL-verschlüsselte Übertragung zu initiieren. Wenn dies fehlschlägt, wird unverschlüsseltes FTP verwendet.
    • TLS/SSL für die Steuerverbindung erforderlich: Mit dieser Option wird die initiale FTP-Steuerverbindung mit TLS/SSL verschlüsselt, um sicherzustellen, dass der Passwortaustausch verschlüsselt ist. Die Übertragung selbst wird nicht verschlüsselt, aber zumindest wird das Passwort nicht im Klartext gesendet. Wenn die Daten selbst nicht sensibel 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 sind. Wenn der Server SSL nicht unterstützt, schlägt die Übertragung fehl.

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

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