Datenschnittstelle: SFTP Adapter

Allgemein

Ein SFTP-Adapter in einer Datenschnittstelle ermöglicht die sichere und automatisierte Übertragung von Daten zwischen Systemen über das Secure File Transfer Protocol (SFTP). Im logistischen Anwendungsbereich wird er häufig genutzt, um Lieferscheine, Bestellungen, Versandinformationen oder Lagerbestände zuverlässig zwischen Unternehmen, Lieferanten und Logistikdienstleistern auszutauschen.

Voraussetzungen

Ein SFTP Server
Datainterface für SFTP im Webservice Verzeichnis
Firewall Regeln für den problemlosen Austausch von Daten zwischen COGLAS & SFTP Server
Ein COGLAS Benutzer mit der WebAPI Rolle

Eingabemöglichkeiten

Alle Eingabemöglichkeiten werden detailliert in Tabellen beschrieben. Pflichtfelder, optionale Felder und Buttons werden jeweils in separaten Tabellen erläutert.

Pflichtfelder Source Adapter	Beschreibung
sourceAdapter type = Sftp	Der SourceAdapter Typ “SFTP” muss im Datainterface als Source Adapter verwendet werden
FileType	Dateityp der ausgegeben wird. z.B.: idoc
InboundDirectory	Ein Verzeichnis für den Upload von Daten
OutboundDirectory	Ein Verzeichnis für das Polling von Daten
PollingIntervalSeconds	Angabe des Invervals zum abholen von Daten in Sekunden
SftpHost	Host IP Adresse vom SFTP Server
SftpPassword	Passwort des SFTP Zugangs
SftpPort	Port des SFTP Servers (Standard: 22)
SftpUsername	Benutzername für den SFTP Zugang

Pflichtfelder Target Adapter	Beschreibung
targetAdapter type = WebAPI	Für den Zugriff auf das COGLAS wird ein WebAPI TargetAdapter benötigt.
URL	Die URL vom COGLAS System, z.B.: https://test.coglas.com/server
Username	Der Benutzername eines in der Oberfläche angelegten Benutzers mit der Rolle “WebAPI”
Password	Das Passwort dieses Benutzers
RequestTimeoutInSeconds	Der Timeout nachdem ein Request abgebrochen wird. Standard 300 Sekunden

Optionale Felder	Beschreibung
SftpWorkingDirectory	Überschreibt `InboundDirectory` und stellt das vorherige Verhalten her, d.h. einfacher Upload in angegebenes Verzeichnis ohne Unterverzeichnisse wie /New und /Processing

Web.config eines SFTP Datainterface

Ein Beispiel zur pflege der Web.config des SFTP Datainterfaces mit den Daten für den SFTP Server

CODE

<sourceAdapter type="Sftp">
  <AdapterSettings>
    <DataCleanup>
      <DeleteFailedMessageAfterDays>14</DeleteFailedMessageAfterDays>
      <DeleteSucceededMessagesAfterDays>7</DeleteSucceededMessagesAfterDays>
    </DataCleanup>
    <FileType>xlsx</FileType>
    <InboundDirectory>Inbound</InboundDirectory>
    <OutboundDirectory>Outbound</OutboundDirectory>
    <PollingIntervalSeconds>60</PollingIntervalSeconds>
    <SftpHost>127.0.0.1</SftpHost>
    <SftpPassword>psw</SftpPassword>
    <SftpPort>22</SftpPort>
    <SftpUsername>usr</SftpUsername>
  </AdapterSettings>
</sourceAdapter>

→ zurück zu COGLAS Prozessen
→ zurück zu COGLAS Menü