FTP-Client-Konfiguration

Ein konfigurierter FTP-Client (File Transfer Protocol) ist erforderlich, um Verbindungen zu FTP-Servern herzustellen.
Vorlagenbibliotheken
 enthält ein Laufzeit-Skript und ein Widget, mit denen Sie Verbindungen zu FTP-Servern herstellen können.

Erforderliche Pakete

Sie müssen eine stabile Version des erforderlichen NuGet-Pakets installieren: FluentFTP. Weitere Informationen finden Sie unter NuGet-Pakete.

FTP-Client-Skript

FTPClientLogic
 ist ein Laufzeit-Skript, das OPC UA-Methoden für die Auflistung und Übertragung von Dateien zu und von einem FTP-Server bereitstellt.
Zu den konfigurierbaren Parametern gehören:
  • FtpServerIPAddress
    . IP-Adresse des FTP-Servers.
  • FtpServerPort
    . Port des FTP-Servers.
  • FtpServerUsername
    . Benutzername, der zur Authentifizierung des Benutzers auf dem FTP-Server verwendet wird.
  • FtpServerUserPassword
    . Passwort, das zur Authentifizierung des Benutzers auf dem FTP-Server verwendet wird.
  • OverwriteFileIfExists
    . Bestimmt, ob vorhandene Dateien überschrieben werden müssen oder nicht.
  • ClientCertificateFile
    . Öffentliche Zertifikatdatei des Servers, gemäß Standard X509v3 und mit der Dateierweiterung „.der“. Sie muss sich im Ordner
    FTOptixApplication/ProjectFiles/PKI/Own/Certs
     befinden. Falls angegeben, muss auch der private Schlüssel angegeben werden. Wird er nicht angegeben, wird er zur Laufzeit automatisch im Ordner
    FTOptixApplication/ApplicationFiles/PKI/Own/Certs
     erzeugt.
  • ClientPrivateKeyFile
    . Private Schlüsseldatei des Servers, mit ASCII Base64-Codierung und der Dateierweiterung „.pem“. Sie muss sich im Ordner
    FTOptixApplication/ProjectFiles/PKI/Own/Certs
     befinden. Falls angegeben, muss auch das Zertifikat angegeben werden. Wird er nicht angegeben, wird er zur Laufzeit automatisch im Ordner
    FTOptixApplication/ApplicationFiles/PKI/Own/Certs
     erzeugt.
  • UseFtps
    . Bestimmen Sie das zu verwendende Protokoll: FTP oder FTPS.
Die folgenden Parameter, die nur zum Lesen verwendet werden können, geben Aufschluss über den internen Zustand des Clients:
  • FtpClientIsRunning
    . Zeigt an, ob der Client mit einem FTP-Server verbunden ist.
  • FtpClientOperationInProgress
    . Zeigt an, ob der Client einige Vorgänge ausführt, wie z. B. Dateiliste oder Dateiübertragung.
Offengelegte Methoden umfassen:
  • ConnectFtpClient
    . Stellt Verbindung zum FTP-Server her.
  • DisconnectFtpClient
     Trennt die Verbindung zum FTP-Server.
  • DownloadItem
    . Lädt ein Remote-Element herunter, z. B. eine Datei oder einen Ordner, der im
    remoteItem
    -Parameter im
    LocalFolderPath
    -Ordner enthalten ist.  Mit dem Parameter
    overwriteItemIfExists
     können Sie festlegen, ob vorhandene Dateien überschrieben werden sollen oder nicht.
  • UploadItem
    . Lädt das lokale Element, z. B. eine Datei oder einen Ordner, der im Parameter
    localItemPath
     enthalten ist, in den Ordner
    remoteFolderPath
     hoch. Mit dem Parameter
    overwriteItemIfExists
     können Sie festlegen, ob vorhandene Dateien überschrieben werden sollen oder nicht.

FTP-Client-Widget

FTPClientWidget
 ermöglicht das Auflisten und Übertragen von Dateien zu und von einem FTP-Server über eine grafische Oberfläche.
Zu den konfigurierbaren Parametern gehören:
  • ServerIPAddress
    . IP-Adresse des FTP-Servers.
  • FtpServerPort
    . Port des FTP-Servers.
  • Username
    . Benutzername zur Authentifizierung auf dem FTP-Server.
  • Password
    . Passwort des Benutzers für die Authentifizierung auf dem FTP-Server.
  • ClientCertificateFile
    . Öffentliche Zertifikatdatei des Servers, gemäß dem Standard X509v3 und mit der Erweiterung
    .der
    . Sie muss sich im Ordner
    FTOptixApplication/ProjectFiles/PKI/Own/Certs
     befinden. Falls angegeben, muss auch der private Schlüssel angegeben werden. Wird er nicht angegeben, wird er zur Laufzeit automatisch im Ordner
    FTOptixApplication/ApplicationFiles/PKI/Own/Certs
     erzeugt.
  • ClientPrivateKeyFile
    . Private Schlüsseldatei des Servers, mit ASCII Base64-Codierung und
    .pem
    -Erweiterung. Sie muss sich im Ordner
    FTOptixApplication/ProjectFiles/PKI/Own/Certs
     befinden. Falls angegeben, muss auch das Zertifikat angegeben werden. Wird er nicht angegeben, wird er zur Laufzeit automatisch im Ordner
    FTOptixApplication/ApplicationFiles/PKI/Own/Certs
     erzeugt.
  • UseFtps
    . Bestimmen Sie das zu verwendende Protokoll: FTP oder FTPS.
  • ExtensionFilter
    . Setzen Sie einen oder mehrere Filter, um nur Dateien mit bestimmten Erweiterungen anzuzeigen. Um mehr als eine Erweiterung anzugeben, trennen Sie die Erweiterungen mit
    ;
    . Verwenden Sie zum Beispiel
    .txt;.csv
    , um nur Dateien mit den Erweiterungen
    .txt
     und
    .csv
     anzuzeigen. Verwenden Sie
    .
    , um Dateien mit allen Erweiterungen anzuzeigen.
  • ShowHiddenFiles
    . Gibt an, ob versteckte Dateien angezeigt werden sollen. Diese Einstellung gilt nicht für Remote-Dateisysteme von Windows-FTP-Servern.
  • StartLocalFilesystemPath
    . Legt den Startordner für die Suche im lokalen Dateisystem fest.
  • AccessFullFilesystem
    . Legt fest, ob das Durchsuchen des gesamten Dateisystems erlaubt werden soll. Diese Option wird nur für Windows- und Ubuntu-Systeme unterstützt. Unter Windows können Sie vom Stammverzeichnis der Festplatten aus durchsuchen, unter Linux vom
    /
     (Stammordner).
  • AccessLocalNetworkDrives
    . Zeigt die Netzlaufwerke an, die mit dieser Einstellung zugeordnet sind, wenn
    AccessFullFilesystem
     im Windows-Betriebssystem aktiviert ist.
Rückmeldung geben
Haben Sie Fragen oder Feedback zu dieser Dokumentation? Bitte geben Sie hier Ihr Feedback ab.