Übersicht
Der SFTP Service kann Nachrichten über eine gesicherte SFTP-Verbindung (SSH File Transfer Protocol) zur Verarbeitung innerhalb der B2B by practise abholen. Im Folgendem wird die Konfiguration dieses Services beschrieben. Hier werden nur die Inhalte genannt, die im Standard Customizing vorhanden sind. Bei speziellen Customizings können die Bezeichnungen variieren und vom Standard abweichen. Die Abholung von einem FTP-Server wird hier beschrieben.
Technische Beschreibung
Klassenpfad org.b2bbp.service.inbound.sftp.SFTPService
Einrichtung
In der Administration muss der SFTPService, wie in dem folgenden Screenshot einzusehen, als aktiver Service angelegt werden.
Der neu angelegten ID „SFTPService“ muss in den Global Properties ein Knoten zugewiesen werden.
Einstellungsmöglichkeiten
Pflichtwerte
| Eigenschaft | Beispielwert | Erklärung |
|---|---|---|
| SFTP_SERVER | 127.0.0.1 | Name oder IP-Adresse des SFTP-Servers |
| SFTP_USER | Testuser | Name des anzumeldenden Benutzers |
| B3P_MAX_FILES | 100 | maximale Anzahl der gleichzeitig einzulesenden Files |
Authentifizierung
Es wird entweder die Konfiguration für Passwort oder per Zertifikaten vorausgesetzt.
| Eigenschaft | Beispielwert | Erklärung |
|---|---|---|
| SFTP_PASSWORD | pVX5VxHrAKLLoqXMMuslrg== | kodiertes Passwort |
| oder | ||
| SFTP_PRIVATE_KEY | Testprivatkey | Name der Extension, die den privaten Schlüssel beinhaltet |
| SFTP_PUBLIC_KEY | Testpublickey | Name der Extension, die den öffentlichen Schlüssel beinhaltet |
Optionale Werte
| Eigenschaft | Beispielwert | Erklärung |
|---|---|---|
| SFTP_TIMEOUT | 60000 | Session Timeout (Zeit in Millisekunden) |
| SFTP_FOLDER | Outbound | anzusteuernder Importordner |
| SFTP_PORT | 22 | der Port, auf dem der SFTP Server läuft (22 ist hier der default) |
| B3P_POLL_INTERVAL | 60 | Überwachung des Abholortes in Sekunden (default ist 10) |
| B3P_ENCODING | ISO-8859-1 | gewünschtes Encoding-Format |
| B3P_READ_GZ | true | für die Verarbeitung von GZ-Archiven relevant |
| B3P_READ_ZIP | true | für die Verarbeitung von ZIP-Archiven relevant |
| B3P_FILE_MIN_AGE | 60 | Mindestalter der zu berücksichtigten Dateien in Sekunden |
| B3P_IGNORE_FILES_WITH_EXTENSIONS | tmp;sh | Dateitypen, die ignoriert werden sollen |
| B3P_ZIP_SPAM_PATH | C:\b2b\ZIP_SPAM | Windowspfad für die fehlerhaften ZIP-Archive |
| B3P_BINARY_SUFFIXES | pdf;xls;xlxs | Eine Liste von Dateitypen, welche dann als Binärdateien interpretiert werden |
| B3P_BINARY_SENDER | BinarySender | Im Falle einer Binärdatei kann das Format-Objekt nicht erstellt werden, weswegen man mit dieser Property einen statischen Sender (System) konfigurieren kann |
| B3P_BINARY_PARTNER | BinaryPartner | Im Falle einer Binärdatei kann das Format-Objekt nicht erstellt werden, weswegen man mit dieser Property einen statischen Partner konfigurieren kann |
| B3P_BINARY_CHANNEL | BINARY_CHANNEL | Im Falle einer Binärdatei kann ggf. die Channel Distribution nicht funktionieren, weswegen man mit dieser Property einen alternativen Channel konfigurieren kann |
| B3P_REMOVE_UTF8_MARKS | true/false (default) | Falls diese Property aktiviert wird, wird versucht die UTF-8 Byte Order Mark (BOM) aus der gelesenen Datei zu entfernen |
Wenn fehlerhafte Zip Dateien gefunden werden und kein ZipSpam Ordner definiert ist, werden die Dateien nicht verschoben. Es wird aber ein Systemfehler geschrieben, dass die Konfiguration unvollständig ist.
Trouble Shooting / Known Problems
Sollte mit gezippten Nachrichten gearbeitet werden, darf in jeder ZIP-Datei jeweils nur eine Nachricht vorhanden sein.
View Me Edit Me