Konfigurieren des FTP-Adapters

Voraussetzungen

• Der FTP-Adapter unterstützt das Lesen und Schreiben von Daten auf einem sicheren FTP-Server. Der Adapter bietet Unterstützung für die Dateiübertragung von einem FTP-Server über SSL (Secure Sockets Layer)/Transport Level Security (TLS).
• Der FTP-Adapter unterstützt das Herunterladen von Dateien aus schreibgeschützten Dateispeicherorten.
• Der FTP-Adapter unterstützt auch die atomare Dateiübertragung im ASCII-Modus.

Weitere Informationen finden Sie unter Bewährte Methoden und Empfehlungen für den FTP-Adapter.

Konfigurieren des Empfangsspeicherorts

Sie können die Eigenschaften des FTP-Empfangsspeicherortadapters in der BizTalk Server-Verwaltungskonsole festlegen. Wenn Eigenschaften am Empfangsspeicherort nicht festgelegt sind, werden die Standardwerte des Empfangshandlers in der BizTalk Server-Verwaltungskonsole verwendet.

2. Klicken Sie im linken Bereich auf den Knoten Empfangsports . Klicken Sie im rechten Bereich mit der rechten Maustaste auf den Empfangsport, der einem vorhandenen Empfangsspeicherort zugeordnet ist oder den Sie einem neuen Empfangsspeicherort zuordnen möchten, und klicken Sie dann auf Eigenschaften.

3. Wählen Sie im Dialogfeld Eigenschaften des Empfangsports im linken Bereich die Option Empfangsspeicherorte aus. Doppelklicken Sie im rechten Bereich auf einen vorhandenen Empfangsspeicherort, oder klicken Sie auf Neu , um einen neuen Empfangsspeicherort zu erstellen.

4. Wählen Sie im Dialogfeld Eigenschaften des Empfangsspeicherorts im Abschnitt Transport neben Typ die Option FTP aus der Dropdownliste aus, und klicken Sie dann auf Konfigurieren.

5. Gehen Sie unter FTP-Transporteigenschaften wie folgt vor:

   Batch

   Option	Aufgabe
   Maximale Anzahl von Dateien	Geben Sie die maximale Anzahl von Dateien pro BizTalk Server-Batch an. 0 bedeutet, dass keine Einschränkung besteht. Standardwert: 0
   Maximale Größe	Geben Sie die maximale Anzahl von Bytes pro BizTalk Server-Batch an. 0 bedeutet, dass keine Einschränkung besteht. Standardwert: 0

   Firewall

   Option	Aufgabe
   Adresse	Geben Sie die Adresse der Firewall an, entweder den DNS-Namen oder die IP-Adresse.
   Mode	Geben Sie an, in welchem Modus der Adapter eine Verbindung zum FTP-Server herstellt. Gültige Werte: Passiv und Aktiv Im aktiven Modus wird eine Verbindung vom FTP-Server mit einem vom FTP-Adapter geöffneten Port hergestellt. Im passiven Modus verbindet sich der FTP-Adapter mit einem vom FTP-Server geöffneten Port. Der aktive Modus funktioniert möglicherweise nicht, wenn Sie eine interne IP-Adresse verwenden und eine Verbindung mit einer externen IP-Adresse herstellen. In diesem Fall müssen Sie den passiven Modus oder den aktiven Modus mit einem Gateway auf Anwendungsebene (Application Layer Gateway, ALG) mit FTP-Unterstützung verwenden. Standardwert: Aktiv
   Kennwort	Geben Sie das Kennwort für die Firewall an.
   Port	Geben Sie den Port für die Firewall an. Gültige Werte: 1 bis einschließlich 65535 Standardwert: 21
   Typ	Geben Sie den Typ der aktivierten Firewall an. Gültige Werte: Keine, Socken 4 und Socken 5 Standardwert: Nichts
   Benutzer	Geben Sie den Benutzernamen für die Firewall an.

   FTP

   Option	Aufgabe
   Konto	Geben Sie den Kontonamen für den FTP-Server an. Diese Option ist veraltet, und von der Verwendung dieser Eigenschaft wird abgeraten.
   Nach Dem Abrufen	Geben Sie die FTP-Befehle an, die nach dem Abrufen (GET) der Dateien ausgeführt werden müssen. Trennen Sie Befehle mit einem Semikolon (;).
   Vor dem Abrufen	Geben Sie die FTP-Befehle an, die vor dem Abrufen (GET) der Dateien ausgeführt werden müssen. Trennen Sie Befehle mit einem Semikolon (;). Hinweis: Der QUIT-Befehl wird vor der Get-Datei nicht unterstützt.
   Fehlerschwellenwert	Geben Sie die Anzahl der Fehler an, die BizTalk Server auftreten können, bevor der Speicherort deaktiviert wird. Standardwert: 10
   Dateimaske	Geben Sie den Dateimaskenfilter für das Übertragen von Dateien an.
   Ordner	Geben Sie den Abrufspeicherort auf dem FTP-Server an.
   FTP-Servertyp	Neu ab BizTalk Server 2016. Verwenden Sie diese Eigenschaft, um einen FTP-Server auszuwählen, für den der SYST-Befehl nicht erforderlich ist. Optionen sind None, AIX, Detect, GXS, MVS, OS400 und Other. Wenn auf Keine festgelegt ist, wird der SYST-Befehl verwendet. Andere wird verwendet, wenn der Betriebssystemtyp nicht in eine der angegebenen Kategorien passt. Standardwert: Nichts
   Log	Geben Sie den vollständigen Pfad einschließlich Dateinamen der Protokolldatei an, in die ausgegeben werden soll. Sie verwenden diese Datei, um Fehlerzustände beim Senden oder Empfangen von Dateien über FTP zu diagnostizieren.
   Maximale Dateigröße	Geben Sie an, wie groß Downloaddateien höchstens sein dürfen (in MB). Null (0) zeigt an, dass keine Einschränkung hinsichtlich der Dateigröße besteht. Standardwert: 100
   Kennwort	Geben Sie das Benutzerkennwort für die Anmeldung am FTP-Server an.
   Port	Geben Sie die Portadresse für den FTP-Server an. Standardwert: 21
   Darstellung	Wählen Sie aus, wie FTP die Daten empfängt. Gültige Werte: Binär oder ASCII Standardwert: binär
   Server	Gibt den Namen oder die IP-Adresse des FTP-Servers an. Hinweis: Der URI für einen Sendeport oder Empfangsspeicherort darf nicht länger als 256 Zeichen sein.
   SSO-Partner	Geben Sie die Partneranwendung für Einmaliges Anmelden für Unternehmen (SSO) an.
   Namensliste verwenden (NLST)	Geben Sie an, wie der Adapter Dateien auflistet. Legen Sie für diesen Wert Ja fest, um Dateinamen anstelle der vom System definierten Dateiliste anzuzeigen. Standardwert: Nein
   Benutzername	Geben Sie den Benutzernamen für die Anmeldung am FTP-Server an.

   Polling

   Option	Aufgabe
   Nach Download löschen	Geben Sie an, ob der Adapter eine Datei nach dem Download vom FTP-Server löscht. Standardwert: Ja Hinweis:
   Zeitstempelvergleich aktivieren	Geben Sie an, ob der Adapter eine Datei auf Basis ihres geänderten Zeitstempels erneut herunterlädt. Wenn der Adapter auf dem FTP-Server nicht über die Berechtigung zum Löschen verfügt, kann der Adapter mithilfe des Befehls MDTM (Änderungszeit) erkennen, ob eine Datei seit dem letzten Download geändert wurde. Die Datei wird auf Grundlage des Werts dieser Eigenschaft erneut heruntergeladen. Standardwert: Kein Hinweis: Falls der FTP-Server MDTM nicht unterstützt, legen Sie die Eigenschaft Redownload Interval fest. Hinweis: Diese Eigenschaft gilt nur, wenn Löschen nach dem Download auf Nein festgelegt ist.
   Intervall	Geben Sie die Anzahl der Intervalle für das Abrufen des Speicherorts an. Legen Sie für diesen Wert null (0) fest, um fortlaufend abzurufen. Standardwert: 60
   Intervall für erneuten Download	Geben Sie das Intervall an, nach dem der Adapter die Dateien erneut herunterlädt. Diese Eigenschaft gilt nur, wenn sowohl Löschen nach dem Download als auch Zeitstempelvergleich aktivieren auf Nein festgelegt sind. Standardwert: -1 -1 gibt an, dass der Adapter die Dateien nicht erneut herunterlädt. 0 gibt an, dass der Adapter die Datei in jedem Abrufzyklus herunterlädt.
   Einheit	Geben Sie den Typ der Einheiten für die Eigenschaften Interval und Redownload Interval an . Gültige Werte: Sekunden, Minuten, Stunden und Tage Standardwert: Sekunden

   SSL

   Option	Aufgabe
   Clientzertifikathash	Geben Sie den SHA1-Hash des Clientzertifikats an, der bei der SSL-Aushandlung (Secure Sockets Layer) verwendet werden muss. Basierend auf diesem Hash wird das Clientzertifikat aus dem persönlichen Speicher des Benutzerkontos entnommen, unter dem die BizTalk-Hostinstanz ausgeführt wird.
   FTPS-Verbindungsmodus	Geben Sie den Modus der SSL-Verbindung mit dem FTPS-Server an. Gültige Werte: Implizit oder Explizit Standardwert: Explizit
   Verwenden des Datenschutzes	Legen Sie diese Option auf Ja fest, wenn der Adapter beim Senden und Empfangen von Datendateien über den FTPS-Server die SSL-Verschlüsselung verwenden muss. Wählen Sie Nein aus, wenn der Adapter Daten unverschlüsselt senden und empfangen soll. Hinweis: Diese Eigenschaft gilt nur, wenn die Use SSL-Eigenschaft auf Ja festgelegt ist. Gültige Werte: Ja oder nein Standardwert: Ja
   SSL verwenden	Geben Sie an, ob der FTP-Adapter zur Kommunikation mit dem FTPS-Server SSL verwenden muss. Gültige Werte: Ja oder nein Standardwert: Nein

   Parameter optimieren

   Option	Aufgabe
   Datenempfangstimeout	Gibt die Zeit in Millisekunden an, bevor der Empfangsaufruf abgebrochen wird. Mithilfe dieser Eigenschaft verhindern Sie, dass ein langsamer Server dazu führt, dass der Empfangsspeicherort nicht mehr antwortet. Standardwert: 90000
   Temporärer Ordner	Geben Sie den Speicherort für einen temporären Ordner an. Anhand dieses Speicherorts stellen Sie sicher, dass Daten aus einer fehlerhaften Übertragung wiederhergestellt werden können.

6. Klicken Sie auf OK, um die Einstellungen zu speichern.

7. Geben Sie im Dialogfeld Eigenschaften des Empfangsspeicherorts die entsprechenden Werte ein, um die Konfiguration des Empfangsspeicherorts abzuschließen, und klicken Sie dann auf OK , um die Einstellungen zu speichern. Informationen zum Dialogfeld Eigenschaften für Empfangsspeicherort finden Sie unter Erstellen eines Empfangsspeicherorts.

Konfigurieren des Sendeports

Sie können die Eigenschaften des FTP-Sendeportadapters in der BizTalk Server-Verwaltungskonsole festlegen. Wenn keine Eigenschaften für den Sendeport festgelegt sind, werden die Standardwerte des Sendehandlers in der BizTalk Server-Verwaltungskonsole verwendet.

1. Erstellen Sie in der BizTalk Server-Verwaltungskonsole einen neuen Sendeport, oder doppelklicken Sie auf einen vorhandenen Sendeport, um diesen zu ändern. Weitere Informationen finden Sie unter Erstellen eines Sendeports. Konfigurieren Sie alle Sendeportoptionen, und geben Sie im Abschnitt Transport der Seite Allgemeinftp für die Option Typ an.

2. Klicken Sie auf der Seite Allgemein im Abschnitt Transport auf die Schaltfläche Konfigurieren neben Typ.

3. Gehen Sie unter FTP-Transporteigenschaften wie folgt vor:

   Firewall

   Option	Aufgabe
   Adresse	Geben Sie die Adresse der Firewall an, entweder den DNS-Namen oder die IP-Adresse.
   Mode	Wählen Sie den Modus aus, in dem der Adapter eine Verbindung mit dem FTP-Server herstellt. Gültige Werte: Passiv und Aktiv Im aktiven Modus wird eine Verbindung vom FTP-Server mit einem vom FTP-Adapter geöffneten Port hergestellt. Im passiven Modus verbindet sich der FTP-Adapter mit einem vom FTP-Server geöffneten Port. Der aktive Modus funktioniert möglicherweise nicht, wenn Sie eine interne IP-Adresse verwenden und eine Verbindung mit einer externen IP-Adresse herstellen. In diesem Fall müssen Sie den passiven Modus oder den aktiven Modus mit einem Gateway auf Anwendungsebene (Application Layer Gateway, ALG) mit FTP-Unterstützung verwenden. Standardwert: Aktiv
   Kennwort	Geben Sie das Kennwort für die Firewall an.
   Port	Geben Sie den Port für die Firewall an. Gültige Werte: 1 bis 65535 inklusive Standardwert: 21
   Typ	Legt den Typ der aktivierten Firewall fest. Gültige Werte: Socken 4, Socken 5, Keine Standardwert: Nichts
   Benutzer	Geben Sie den Benutzernamen für die Firewall an.

   FTP

   Option	Aufgabe
   Konto	Optional. Geben Sie den Kontonamen für den FTP-Server an. Von dieser Option und der Verwendung dieser Eigenschaft wird abgeraten.
   Nach PUT	Geben Sie die FTP-Befehle an, die nach dem Abrufen (PUT) der Dateien ausgeführt werden sollen. Trennen Sie Befehle mit einem Semikolon (;).
   Speicher zuweisen	Legt fest, ob Speicherplatz für Legacyhostsysteme zugewiesen werden soll. Diese Option wird aus Gründen der Abwärtskompatibilität bereitgestellt. Gültige Werte: Nein und Ja Standardwert: Nein
   Vor dem Einfügen	Geben Sie die FTP-Befehle an, die vor dem Einfügen (PUT) der Dateien ausgeführt werden müssen, zum Beispiel Befehle, mit denen Standardwerte auf dem FTP-Server geändert werden. Trennen Sie Befehle mit einem Semikolon (;). Ein Befehl zum Öffnen ist nicht erforderlich. Hinweis: Der QUIT-Befehl wird vor der Put-Datei nicht unterstützt.
   Ordner	Gibt den Ordner an, in den Dateien auf dem FTP-Server verschoben werden sollen.
   FTP-Servertyp	Neu ab BizTalk Server 2016. Verwenden Sie diese Eigenschaft, um einen FTP-Server auszuwählen, für den der SYST-Befehl nicht erforderlich ist. Optionen sind None, AIX, Detect, GXS, MVS, OS400 und Other. Wenn auf Keine festgelegt ist, wird der SYST-Befehl verwendet. Andere wird verwendet, wenn der Betriebssystemtyp nicht in eine der angegebenen Kategorien passt. Standardwert: Nichts
   Log	Geben Sie den vollständigen Pfad einschließlich Dateinamen der Protokolldatei an, in die ausgegeben werden soll. Anhand dieser Datei können Sie Fehler beim Senden oder Empfangen von Dateien über den FTP-Adapter analysieren.
   Kennwort	Gibt das Kennwort zum Anmelden am FTP-Server an.
   Port	Gibt die Portadresse des FTP-Servers an. Standardwert: 21
   Darstellung	Wählen Sie aus, wie der FTP-Adapter die Daten sendet (im Binär- oder ASCII-Format). Gültige Werte: Binär oder ASCII Standardwert: binär
   Server	Gibt den Namen oder die IP-Adresse des FTP-Servers an.
   SSO-Partner	Geben Sie die Partneranwendung für Einmaliges Anmelden für Unternehmen (SSO) an.
   Zieldateiname	Gibt einen alternativen Namen für die Datei an. Das Beibehalten des Standardnamens gewährleistet einen eindeutigen Namen für jede gesendete Nachricht. Standardwert: %MessageID%.xml
   Benutzername	Geben Sie den Benutzernamen für die Anmeldung am FTP-Server an.

   SSL

   Option	Aufgabe
   Clientzertifikathash	Geben Sie den SHA1-Hash des Clientzertifikats an, der bei der SSL-Aushandlung (Secure Sockets Layer) verwendet werden muss. Basierend auf diesem Hash wird das Clientzertifikat aus dem persönlichen Speicher des Benutzerkontos entnommen, unter dem die BizTalk-Hostinstanz ausgeführt wird.
   FTPS-Verbindungsmodus	Geben Sie den Modus der SSL-Verbindung mit dem FTPS-Server an. Gültige Werte: Implizit oder Explizit Standardwert: Explizit
   Verwenden des Datenschutzes	Legen Sie diese Option auf Ja fest, wenn der Adapter beim Senden und Empfangen von Datendateien über den FTPS-Server die SSL-Verschlüsselung verwenden muss. Wählen Sie Nein aus, wenn der Adapter Daten unverschlüsselt senden und empfangen soll. Hinweis: Diese Eigenschaft gilt nur, wenn die Use SSL-Eigenschaft auf Ja festgelegt ist. Gültige Werte: Ja oder nein Standardwert: Ja
   SSL verwenden	Geben Sie an, ob der FTP-Adapter zur Kommunikation mit dem FTPS-Server SSL verwenden muss. Gültige Werte: Ja oder nein Standardwert: Nein

   Parameter optimieren

   Option	Aufgabe
   Verbindungslimit	Gibt die maximale Anzahl gleichzeitiger FTP-Verbindungen an, die mit dem Server geöffnet sein dürfen. Der Wert 0 bedeutet, dass kein Limit besteht. Standardwert: 0 Hinweis: Diese Eigenschaft ersetzt den Registrierungseintrag, der in früheren Versionen von BizTalk Server verwendet wurde, um das Verbindungslimit zu steuern. BizTalk Server ignoriert den Registrierungseintrag, der zum Steuern des Verbindungslimits verwendet wird.
   Temporärer Ordner	Geben Sie den Speicherort eines temporären Ordners auf dem FTP-Server an. Die Datei wird zuerst hierhin übertragen und anschließend in den FTP-Zielordner verschoben. Bei einem Übertragungsfehler startet der Adapter das Hochladen der Datei im ASCII-Übertragungsmodus neu und setzt die Übertragung im Binärmodus fort. Hinweis: Wenn die Dateiübertragung zwischen dem temporären Speicherort und dem relevanten Speicherort auf dem FTP-Server atomar ist, ist auch der Dateiupload atomar.

4. Klicken Sie erneut aufOK, um die Einstellungen zu speichern.

FTP-Befehle, die für den FTP-Adapter erforderlich sind

Für den FTP-Adapter gelten die Einschränkungen des FTP-Protokolls, und er erfordert, dass bestimmte FTP-Befehle auf dem FTP-Quell- oder -Zielserver verfügbar sind.

Der FTP-Adapter arbeitet als FTP-Client und erfordert möglicherweise, dass die folgenden Befehle auf dem FTP-Server verfügbar sind, um ordnungsgemäß zu funktionieren:

Weitere Informationen zu diesen FTP-Befehlen finden Sie unter:

• RFC 959 – File Transfer Protocol (https://go.microsoft.com/fwlink/p/?LinkId=119603)

• RFC 4217 : Sichern von FTP mit TLS (https://go.microsoft.com/fwlink/p/?LinkId=183154)

• RFC 3659 – Erweiterungen für FTP (https://go.microsoft.com/fwlink/p/?LinkId=183155)

Konfigurieren eines FTP-Adapters für die Verwendung mit Legacyhosts

In diesem Abschnitt wird erläutert, was Sie wissen müssen, um die Kommunikation zwischen dem FTP-Adapter und einem Mainframecomputer zu erleichtern.

MVS

Damit Dateien an einen FTP-Server auf einem Großrechner gesendet werden können, muss der Großrechner IBM Generation Data Group unterstützen. Im Namensfeld wird bei jedem Dateinamen (+1) an den Zieldateinamen angefügt (ein vollständiger Pfad in Anführungszeichen).

AS400

Es gibt drei Methoden zum Benennen von Dateien und Definieren ihrer Pfade beim Übertragen von Dateien an ein und von einem AS400-System:

• Feld Dateiname: Geben Sie beim Senden einer Datei an einen FTP-Server den Dateinamen in das Feld Dateiname ein. Der Dateiname muss den Dateibenennungskonventionen des AS400-Systems entsprechen, da die Datei im Library File System gespeichert wird.

• Anführungszeichenbefehl: Verwenden Sie den Befehl Quote, um ein Skript auf dem Remotecomputer auszuführen. Geben Sie den Befehl Quote in die Felder Before GET, Before PUT, After GET und After PUT auf einem der Endpunkte ein. Geben Sie den Befehl „Quote“ im folgenden Format ein:

  QUOTE RCMD <command to be run on the remote system>.
  

• Integriertes Dateisystem (IFS): IFS ist ein Bereich auf dem AS400-System, der die Speicherung von PC-basierten Dateien und damit die gleichen Namenskonventionen wie ein PC ermöglicht. Wenn Sie ifs anstelle des Standardmäßigen Bibliotheksdateisystems verwenden möchten, lautet quote site namefmt 1der erste Befehl, den Sie eingeben möchten. Dieser Befehl weist das AS400-System an, die IFS-Benennungskonvention zu verwenden.

Weitere gute Tipps

FTP-Adaptereigenschaftsschema und -Eigenschaften

Bewährte Methoden und Empfehlungen für den FTP-Adapter

FTP-Adapter