Konfigurationseigenschaften des FTP-Adapters
In der folgenden Tabelle sind die Konfigurationseigenschaften aufgelistet, die Sie für einen FTP-Adapterempfangsspeicherort festlegen können:
| Eigenschaftenname | type | BESCHREIBUNG | Beschränkungen | Kommentare |
|---|---|---|---|---|
| uri | VT_BSTR | Geben Sie den vollständigen Pfad des Standorts an, der vom Empfangsspeicherort überwacht wird. | Der URI für einen Sendeport oder Empfangsspeicherort darf nicht länger als 256 Zeichen sein. | Keine |
| serverAddress | VT_BSTR | Gibt den Namen oder die IP-Adresse des FTP-Servers an. | Keine | Keine |
| serverPort | VT_BSTR | Gibt den TCP-Port an, über den mit dem FTP-Zielserver kommuniziert werden soll. | Keine | Keine |
| userName | VT_BSTR | Geben Sie den Benutzernamen an, der für den Zugriff auf den FTP-Server verwendet wird. | Keine | Keine |
| password | VT_BSTR | Gibt das Kennwort für den Zugriff auf den FTP-Server an. | Dieser Wert ist beim Exportieren einer Bindungsdatei immer maskiert. In diese Eigenschaft muss manuell das Kennwort eingetragen werden, bevor die Bindungsdatei in die Konfiguration des BizTalk-Zielservers importiert wird. | Keine |
| fileMask | VT_BSTR | Geben Sie den Dateimaskenfilter für das Übertragen von Dateien an. | Keine | Keine |
| targetFolder | VT_BSTR | Geben Sie den Abrufspeicherort auf dem FTP-Server an. | Keine | Keine |
| commandLogFilename | VT_BSTR | Geben Sie an, wo eine Kopie der Protokolldatei gespeichert werden soll. | Keine | Sie verwenden diese Datei, um Fehlerbedingungen beim Senden oder Empfangen von Dateien über den FTP-Adapter zu diagnostizieren. |
| representationType | VT_BSTR | Legt fest, wie der FTP-Adapter die Daten empfängt. | Gültige Werte sind: – Binär - ASCII |
Der Standardwert ist Binary. |
| spoolingFolder | VT_BSTR | Geben Sie den Speicherort eines temporären Ordners auf dem FTP-Server an. Sie verwenden dies, um die Wiederherstellung nach einem Übertragungsfehler zu gewährleisten. | Keine | Keine |
| receiveDataTimeOut | VT_BSTR | Gibt die Zeit in Millisekunden an, bevor der Empfangsaufruf abgebrochen wird. Dadurch wird vermieden, dass ein langsamer Server zu einem Stillstand des Empfangsspeicherorts führt. | Keine | Der Standardwert ist 90000. |
| maximumBatchSize | VT_BSTR | Geben Sie die maximale Anzahl von Bytes pro BizTalk Server-Batch an. | Keine | Keine |
| maximumNumberOfFiles | VT_BSTR | Geben Sie die maximale Anzahl von Dateien pro BizTalk Server-Batch an. | Keine | Keine |
| passiveMode | VT_BSTR | Geben Sie an, in welchem Modus der Adapter eine Verbindung zum FTP-Server herstellt. | Gültige Werte sind: -Passive – Aktiv |
Der Standardwert ist Aktiv. |
| useNLST | VT_BSTR | Mit Ja wird angegeben, dass nur Dateinamen statt der standardmäßigen systemdefinierten Dateiauflistung abgerufen werden sollen. | Gültige Werte sind: -Ja -Nein |
Der Standardwert ist Nein. |
| beforeGet | VT_BSTR | Gibt die FTP-Befehle an, die vor dem Abrufen (GET) der Dateien ausgeführt werden müssen. | Trennen von Befehlen mit einem Semikolon (;) Hinweis: Der QUIT-Befehl wird vor der Datei GET nicht unterstützt. | Keine |
| afterGet | VT_BSTR | Gibt die FTP-Befehle an, die nach dem Abrufen (GET) der Dateien ausgeführt werden müssen. | Trennen Sie die Befehle mit einem Semikolon (;). | Keine |
| firewallType | VT_BSTR | Geben Sie den Typ der aktivierten Firewall an. | Gültige Werte sind: – None - Socken 4 - Socken 5 |
Der Standardwert lautet „Keine“. |
| firewallAddress | VT_BSTR | Gibt die Adresse der Firewall an (DNS-Name oder IP-Adresse). | Keine | Keine |
| firewallPort | VT_BSTR | Geben Sie den Port für die Firewall an. | Gültige Werte sind 1 bis 65535. | Der Standardwert ist 21. |
| firewallUserName | VT_BSTR | Geben Sie den Benutzernamen für die Firewall an. | Keine | Keine |
| firewallPassword | VT_BSTR | Geben Sie das Kennwort für die Firewall an. | Keine | Keine |
| pollingUnitOfMeasure | VT_BSTR | Gibt die Einheit für die Eigenschaft pollingIntervall an. | Gültige Werte sind: -Sekunden -Minuten -Stunden -Tage |
Der Standardwert ist Sekunden. |
| pollingInterval | VT_BSTR | Gibt den Intervallwert für das Abrufen dieses Speicherorts an. | Keine | Legen Sie für diesen Wert 0 fest, um fortlaufend abzurufen. Der Standardwert beträgt ist 60. |
| redownloadInterval | VT_BSTR | Gibt das Intervall in Sekunden an, nach dessen Ablauf die Datei erneut vom FTP-Adapter heruntergeladen wird. | Diese Eigenschaft trifft nur zu, wenn sowohl die Eigenschaft deleteAfterDownload als auch die Eigenschaft enableTimeComparison auf Nein gesetzt sind. | Der Wert -1 gibt an, dass der Adapter die Datei nicht erneut herunterladen wird. Der Standardwert ist -1. |
| ssoAffiliateApplication | VT_BSTR | Gibt die Partneranwendung für Einmaliges Anmelden (Single Sign-On, SSO) an. | Keine | Keine |
| errorThreshold | VT_BSTR | Geben Sie die Anzahl von Fehlern an, die BizTalk Server auftreten können, bevor der Speicherort deaktiviert wird. | Keine | Der Standardwert ist 10. |
| maxFileSize | VT_BSTR | Geben Sie an, wie groß Downloaddateien höchstens sein dürfen (in MB). | Keine | Der Wert 0 zeigt an, dass keine Einschränkung hinsichtlich der Dateigröße besteht. Der Standardwert ist 100. |
| useSsl | VT_BSTR | Mit Ja wird angegeben, dass der FTP-Aadpter bei der Kommunikation mit dem FTPS-Server SSL verwenden muss. | Gültige Werte sind: -Ja -Nein |
Der Standardwert ist Nein. |
| useDataProtection | VT_BSTR | Mit Ja wird angegeben, dass der FTP-Adapter beim Senden und Empfangen von Dateien über den FTPS-Server die SSL-Verschlüsselung verwenden muss. | Diese Eigenschaft ist gültig, wenn die Eigenschaft useSsl auf Ja festgelegt ist. Gültige Werte sind: -Ja -Nein |
Der Standardwert ist Ja. |
| ftpsConnMode | VT_BSTR | Geben Sie den Modus der SSL-Verbindung mit dem FTPS-Server an. | Gültige Werte sind: – Explicit (Explizit) -Implizite |
Der Standardwert ist Explicit. |
| clientCertificateHash | VT_BSTR | Geben Sie den SHA1-Hash des Clientzertifikats an, das in der SSL-Aushandlung verwendet werden muss. | Keine | Basierend auf diesem Hash wird das Clientzertifikat aus dem persönlichen Speicher des Benutzerkontos entnommen, unter dem die BizTalk-Hostinstanz ausgeführt wird. |
| deleteAfterDownload | VT_BSTR | Geben Sie dies als Ja an, wenn der Adapter die Datei nach Abschluss des Downloads vom FTP-Server löschen muss. | Gültige Werte sind: -Ja -Nein |
Der Standardwert ist Ja. |
| enableTimeComparison | VT_BSTR | Mit Ja wird angegeben, dass eine Datei erneut vom Adapter heruntergeladen werden muss, wenn sich eine Änderung des Zeitstempels der Datei ergeben hat. | Diese Eigenschaft ist nur gültig, wenn deleteAfterDownload auf Nein festgelegt ist. Für diese Funktion muss der FTP-Zielserver den MDTM-Befehl unterstützen. Gültige Werte sind: -Ja -Nein |
Der Standardwert ist Nein. |
Im folgenden Code wird das Format der Zeichenfolge dargestellt, die zum Festlegen der Eigenschaften verwendet wird:
<CustomProps><AdapterConfig vt="8"><Config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"><uri>ftp://localhost:21/in/*.xml</uri><serverAddress>localhost</serverAddress><serverPort>21</serverPort><userName>domain\testuser</userName><password>******</password><fileMask>*.xml</fileMask><targetFolder>in</targetFolder><commandLogFilename>c:\temp\realftplog.txt</commandLogFilename><representationType>binary</representationType><maximumBatchSize>0</maximumBatchSize><maximumNumberOfFiles>0</maximumNumberOfFiles><passiveMode>False</passiveMode><firewallType>NoFirewall</firewallType><firewallPort>21</firewallPort><pollingUnitOfMeasure>Seconds</pollingUnitOfMeasure><pollingInterval>5</pollingInterval><errorThreshold>10</errorThreshold><maxFileSize>5000</maxFileSize><useSsl>False</useSsl><useDataProtection>True</useDataProtection><ftpsConnMode>Explicit</ftpsConnMode><clientCertificateHash>bc 32 2c a9 22 75 6a 3f e4 f7 a9 b1 b3 3a 24 20 23 53 68 49</clientCertificateHash><deleteAfterDownload>True</deleteAfterDownload><enableTimeComparison>False</enableTimeComparison></Config></AdapterConfig></CustomProps>
In der folgenden Tabelle sind die Konfigurationseigenschaften aufgelistet, die Sie für den Sendeport eines FTP-Adapters festlegen können:
| Eigenschaftenname | type | BESCHREIBUNG | Beschränkungen | Kommentare |
|---|---|---|---|---|
| uri | VT_BSTR | Gibt den vollständigen Pfad des Speicherorts an, an den Daten gesendet werden sollen. | Der URI für einen Sendeport oder Empfangsspeicherort darf nicht länger als 256 Zeichen sein. | Keine |
| serverAddress | VT_BSTR | Geben Sie die Adresse der Firewall an, entweder den DNS-Namen oder die IP-Adresse. | Keine | Keine |
| serverPort | VT_BSTR | Gibt die Portadresse des FTP-Servers an. | Keine | Der Standardwert ist 21. |
| userName | VT_BSTR | Geben Sie den Benutzernamen für die Anmeldung am FTP-Server an. | Keine | Keine |
| password | VT_BSTR | Gibt das Kennwort zum Anmelden am FTP-Server an. | Dieser Wert ist beim Exportieren einer Bindungsdatei immer maskiert. In diese Eigenschaft muss manuell das Kennwort eingetragen werden, bevor die Bindungsdatei in die Konfiguration des BizTalk-Zielservers importiert wird. | Keine |
| . | VT_BSTR | Geben Sie den Kontonamen für den FTP-Server an. | Optional | Keine |
| targetFolder | VT_BSTR | Gibt den Ordner an, in den Dateien auf dem FTP-Server verschoben werden sollen. | Keine | Keine |
| targetFileName | VT_BSTR | Gibt einen alternativen Namen für die Datei an. Das Beibehalten des Standardnamens gewährleistet einen eindeutigen Namen für jede versendete Nachricht. | Keine | Der Standardwert ist %MessageID%.xml. |
| commandLogFilename | VT_BSTR | Geben Sie an, wo eine Kopie der Protokolldatei gespeichert werden soll. Anhand der Protokolldatei können Sie Fehler beim Senden oder Empfangen von Dateien über den FTP-Server analysieren. | Keine | Keine |
| representationType | VT_BSTR | Legt fest, wie FTP die Daten sendet (im Binär- oder ASCII-Format). | Gültige Werte sind: -Binäre - ASCII |
Der Standardwert ist Binär. |
| beforePut | VT_BSTR | 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 (;). Hinweis: Der QUIT-Befehl wird vor der Datei PUT nicht unterstützt. | Ein Befehl zum Öffnen ist nicht erforderlich. |
| afterPut | VT_BSTR | Geben Sie die FTP-Befehle an, die nach dem Abrufen (PUT) der Dateien ausgeführt werden sollen. | Trennen Sie Befehle mit einem Semikolon (;). | Keine |
| allocateStorage | VT_BSTR | Legt fest, ob Speicherplatz für Legacyhostsysteme zugewiesen werden soll. | Gültige Werte sind: -Ja -Nein |
Der Standardwert ist Nein. |
| spoolingFolder | VT_BSTR | Geben Sie den Speicherort eines temporären Ordners auf dem FTP-Server an. Hiermit wird sichergestellt, dass Daten aus einer fehlerhaften Übertragung wiederhergestellt werden können, wenn der Übertragungsmodus Binär lautet. Wenn der Übertragungsmodus ASCII lautet, startet der Adapter das Hochladen erneut. | Keine | Keine |
| connectionLimit | VT_BSTR | Gibt die maximale Anzahl gleichzeitiger FTP-Verbindungen an, die mit dem Server geöffnet sein dürfen. | Keine | Der Wert 0 bedeutet, dass kein Limit besteht. |
| passiveMode | VT_BSTR | Gibt an, ob der aktive oder passive Modus verwendet werden soll. | Gültige Werte sind: – True (passiver Modus) – False (aktiver Modus) |
Der Standardwert ist Falsch (aktiver Modus). |
| firewallType | VT_BSTR | Legt den Typ der aktivierten Firewall fest. | Gültige Werte sind: - Socken 4 - Socken 5 – None |
Der Standardwert lautet „Keine“. |
| firewallAddress | VT_BSTR | Geben Sie die Adresse der Firewall an, entweder den DNS-Namen oder die IP-Adresse. | Keine | Keine |
| firewallPort | VT_BSTR | Geben Sie den Port für die Firewall an. | Gültige Werte sind 1 bis 65535. | Der Standardwert ist 21. |
| firewallUserName | VT_BSTR | Geben Sie den Benutzernamen für die Firewall an. | Keine | Keine |
| firewallPassword | VT_BSTR | Geben Sie das Kennwort für die Firewall an. | Dieser Wert ist beim Exportieren einer Bindungsdatei immer maskiert. In diese Eigenschaft muss manuell das Kennwort eingetragen werden, bevor die Bindungsdatei in die Konfiguration des BizTalk-Zielservers importiert wird. | Keine |
| ssoAffiliateApplication | VT_BSTR | Gibt die Partneranwendung für Einmaliges Anmelden (Single Sign-On, SSO) an. | Keine | Keine |
| useSsl | VT_BSTR | Mit Ja wird angegeben, dass der FTP-Aadpter bei der Kommunikation mit dem FTPS-Server SSL verwenden muss. | Gültige Werte sind: -Ja -Nein |
Der Standardwert ist Nein. |
| useDataProtection | VT_BSTR | Mit Ja wird angegeben, dass der FTP-Adapter beim Senden und Empfangen von Dateien über den FTPS-Server die SSL-Verschlüsselung verwenden muss. | Diese Eigenschaft ist gültig, wenn useSsl auf Ja festgelegt ist. Gültige Werte sind: -Ja -Nein |
Der Standardwert ist Ja. |
| ftpsConnMode | VT_BSTR | Geben Sie den Modus der SSL-Verbindung mit dem FTPS-Server an. | Gültige Werte sind: – Explicit (Explizit) -Implizite |
Der Standardwert ist Explicit. |
| clientCertificateHash | VT_BSTR | Geben Sie den SHA1-Hash des Clientzertifikats an, das in der SSL-Aushandlung verwendet werden muss. | Keine | Basierend auf diesem Hash wird das Clientzertifikat aus dem persönlichen Speicher des Benutzerkontos entnommen, unter dem die BizTalk-Hostinstanz ausgeführt wird. |
Im folgenden Code wird das Format der Zeichenfolge dargestellt, die zum Festlegen der Eigenschaften verwendet wird:
<CustomProps><AdapterConfig vt="8"><Config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"><serverAddress>TestServer</serverAddress><serverPort>21</serverPort><userName>testuser</userName><password>******</password><accountName>testuser</accountName><targetFolder>output</targetFolder><targetFileName>%MessageID%.xml</targetFileName><commandLogFilename>c:\logfile\ftpsendlog.txt</commandLogFilename><representationType>binary</representationType><beforePut>CDW dir</beforePut><afterPut>CDUP </afterPut><allocateStorage>False</allocateStorage><spoolingFolder>tempfolder</spoolingFolder><connectionLimit>0</connectionLimit><passiveMode>False</passiveMode><firewallType>Socks4</firewallType><firewallAddress>TestServer</firewallAddress><firewallPort>21</firewallPort><firewallUserName>domain\testuser</firewallUserName><firewallPassword>******</firewallPassword><useSsl>False</useSsl><useDataProtection>True</useDataProtection><ftpsConnMode>Explicit</ftpsConnMode><clientCertificateHash>bc 32 2c a9 22 75 6a 3f e4 f7 a9 b1 b3 3a 24 20 23 53 68 49</clientCertificateHash><uri>ftp://TestServer:21/output/%MessageID%.xml</uri></Config></AdapterConfig></CustomProps>
Hinweis
Wenn Sie TransportTypeData-Konfigurationsdaten für einen Adapter angeben, der mit dem Adapter Framework erstellt wurde, müssen alle verwendeten Name-Wert-Paare im <AdapterConfig-Element> gespeichert werden. Da das <AdapterConfig-Element> den datentyp VT_BSTR (vt="8") angibt, müssen die <> Zeichen in den Daten mit Escapezeichen versehen werden.