Zum Inhalt springen

FTP-Connector in Jitterbit Studio

Zusammenfassung

Der FTP-Connector stellt den Zugriff auf einen FTP-Server her.

Der FTP-Connector bietet eine Schnittstelle zur Erstellung einer FTP-Verbindung, die die Grundlage für die Generierung von Instanzen von FTP-Aktivitäten bildet. Diese Aktivitäten interagieren, sobald sie konfiguriert sind, über die Verbindung mit dem FTP-Server.

Der FTP-Connector wird über die Registerkarte Projektendpunkte und -connectoren in der Designkomponentenpalette aufgerufen (siehe Designkomponentenpalette).

Übersicht über den Connector

Dieser Connector wird zunächst verwendet, um eine FTP-Verbindung zu konfigurieren. Die mit dieser Verbindung verbundenen Aktivitätstypen werden dann verwendet, um Instanzen von Aktivitäten zu erstellen, die als Quellen (um Daten in einem Vorgang bereitzustellen) oder Ziele (um Daten in einem Vorgang zu konsumieren) gedacht sind.

Zusammen werden eine spezifische FTP-Verbindung und ihre Aktivitäten als FTP-Endpunkt bezeichnet:

FTP-Aktivitäten

  • Lesen: Liest Daten von einem FTP-Endpunkt und ist dazu gedacht, als Quelle in einem Vorgang verwendet oder in einem Skript aufgerufen zu werden.

  • Schreiben: Schreibt Daten in einen FTP-Endpunkt und ist dazu gedacht, als Ziel in einem Vorgang verwendet oder in einem Skript aufgerufen zu werden.

Hinweis

Dieser Connector ist ein nativer Studio-Connector, auf den Jitterbit möglicherweise verweist, wenn Änderungen an Connectors kommuniziert werden. Der Veröffentlichungszeitplan für native Studio-Connectoren basiert auf dem Rhythmus der Webanwendungen des Harmony-Portals.

Endpunkte, die mit diesem Connector erstellt wurden, sind in Berichten zur Endpunktnutzung enthalten und zählen zu Ihrer Lizenz.

Verbindung zu SFTP mit SSH-Schlüsseln

SSH-Client-Schlüssel werden verwendet, um Harmony mit externen Ressourcen wie SFTP-Servern zu authentifizieren.

Für detaillierte Informationen zur Verwendung von SSH-Client-Schlüsseln speziell für SFTP-Verbindungen und wie man Schlüssel in ein geeignetes Format für Jitterbit-Private-Agents konvertiert, siehe Verbindung zu SFTP mit SSH-Schlüsseln.

Private Agents unterstützen OpenSSL-Verschlüsselungssuiten für eingehende und ausgehende SFTP-Operationen.

Fehlerbehebung

Wenn Sie Probleme mit dem FTP-Connector haben, werden die folgenden Schritte zur Fehlerbehebung empfohlen:

  1. Stellen Sie sicher, dass die FTP-Verbindung erfolgreich ist, indem Sie die Test-Schaltfläche im Konfigurationsbildschirm verwenden. Wenn die Verbindung nicht erfolgreich ist, kann der zurückgegebene Fehler einen Hinweis auf das Problem geben.

  2. Überprüfen Sie die Betriebsprotokolle auf Informationen, die während der Ausführung des Vorgangs geschrieben wurden.

  3. Aktivieren Sie das Debug-Protokoll für den Betrieb (für Cloud-Agents oder für private Agents), um zusätzliche Protokolldateien und Daten zu generieren.

  4. Wenn Sie private Agents verwenden, können Sie die Agent-Protokolle auf weitere Informationen überprüfen.

  5. Für zusätzliche Überlegungen zur Fehlerbehebung siehe Fehlerbehebung bei Operationen.

SFTP: Schreiben einer Datei mit einem Multibyte-Dateinamen schlägt mit "Zugriff verweigert" fehl

  • Symptom: Eine FTP Schreib-Aktivität, die eine Datei mit mehrbyteigen Zeichen an einen SFTP-Server schreibt, schlägt mit einem ähnlichen Fehler fehl:

    Failed to put data to the url <path>. Quote command returned error. Rename command failed: Permission denied.

    Dateien, deren Namen nur ASCII-Zeichen verwenden, werden erfolgreich hochgeladen.

  • Mögliche Ursache: Ab Agent-Version 12.8 kann der FTP-Connector Dateien lesen und schreiben, deren Namen mehrbyteige Zeichen enthalten. Mit der Option FTP Umbenennen verwenden (standardmäßig aktiviert) lädt der Agent die Datei unter einem temporären Namen (einem -jbupload-Suffix) hoch und benennt sie dann in den endgültigen Namen um. Wenn der SFTP-Server das Umbenennen von Dateien, deren Namen mehrbyteige Zeichen enthalten, nicht unterstützt, schlägt der Umbenennungsschritt fehl und der Server gibt einen irreführenden Fehler Zugriff verweigert zurück. Dies ist eine Einschränkung des SFTP-Servers, nicht von Jitterbit.

  • Auflösung:

    • Deaktivieren Sie die Option FTP umbenennen verwenden bei der FTP Schreib-Aktivität, damit die Datei direkt unter ihrem endgültigen Namen geschrieben wird, ohne den Umbenennungsschritt.

    • Alternativ verwenden Sie einen SFTP-Server, der das Umbenennen von Dateien unterstützt, deren Namen mehrbyteige Zeichen enthalten.

Zusätzliche Ressourcen

Die folgenden Jitterbit-Mikrolern-Tutorials sind über unsere Jitterbit-Grundlagen-Videoserie verfügbar, die von der Jitterbit University erstellt wurde: