設定 FTP 配接器

發行項
07/21/2023

開始之前

FTP 配接器支援從安全的 FTP 伺服器讀取和寫入資料。此配接器可支援透過安全通訊端層 (SSL)/傳輸層級安全性 (TLS) 從 FTP 伺服器傳輸檔案。
FTP 配接器支援從唯讀檔案位置下載檔案。
FTP 配接器也支援 ASCII 模式的不可部分完成檔案傳輸。

請參閱 FTP 配接器的最佳做法和建議。

設定接收位置

您可以在 BizTalk Server 管理主控台中設定 FTP 接收位置配接器屬性。如果未在接收位置設定屬性，則會使用 BizTalk Server 管理主控台中的預設接收處理常式值。

注意

完成下列程式之前，您必須先新增接收埠。請參閱如何建立接收埠。

在 BizTalk Server 管理主控台中，依序展開[BizTalk Server系統管理]、[BizTalk 群組]、[應用程式] 和 [應用程式] ，然後展開您要在其中建立接收位置的應用程式。

在左窗格中，按一下 [ 接收埠] 節點。在右窗格中，以滑鼠右鍵按一下與現有接收位置相關聯的接收埠，或您想要與新接收位置建立關聯的接收埠，然後按一下 [ 屬性]。
在 [ 接收埠屬性] 對話方塊的左窗格中，選取 [接收位置]。在右窗格中，按兩下現有的接收位置，或按一下 [ 新增 ] 來建立新的接收位置。
在 [接收位置屬性]對話方塊的 [類型] 旁的 [傳輸] 區段中，從下拉式清單中選取[FTP]，然後按一下 [設定]。

在 [FTP 傳輸屬性] 中，執行下列動作：

Batch

使用	作法
檔案數目上限	指定每個 BizTalk Server 批次的檔案數目上限。零 (0) 表示無限制。預設值： 0
大小上限	指定每個 BizTalk Server 批次的最大位元組數。零 (0) 表示無限制。預設值： 0

防火牆

使用	作法
位址	指定防火牆的位址，可指定 DNS 名稱或 IP 位址。
模式	指定配接器與 FTP 伺服器之間的連接模式。有效值：被動和主動在主動模式下，FTP 伺服器會連線到 FTP 配接器所開啟的連接埠。在被動模式下，FTP 配接器會連線到 FTP 伺服器所開啟的連接埠。如果您使用內部 IP 並聯機到外部 IP，則作用中模式可能無法運作。在此情況下，您必須搭配使用被動模式或主動模式搭配應用層閘道， (ALG) 與 FTP 支援。預設值：積極
密碼	指定防火牆的密碼。
連接埠	指定防火牆的連接埠。有效值：包含 1 到 65535 預設值： 21
類型	指定部署的防火牆類型。有效值：無、Socks 4 和 Socks 5 預設值：沒有
使用者	指定防火牆的使用者名稱。

FTP

使用	作法
帳戶	指定 FTP 伺服器的帳戶名稱。此選項已被取代，不建議使用此屬性。
GET 之後	指定檔案 GET 後要執行的 FTP 命令。使用分號 (;) 來分隔命令。
GET 之前	指定檔案 GET 前要執行的 FTP 命令。使用分號 (;) 來分隔命令。注意： GET 檔案之前不支援 QUIT 命令。
錯誤閾值	指定在停用位置之前，容許 BizTalk Server 發生的錯誤數目。預設值： 10
檔案遮罩	指定傳輸檔案時要使用的檔案遮罩篩選。
資料夾	指定 FTP 伺服器上的輪詢位置。
FTP 伺服器類型	從 BizTalk Server 2016 開始的新功能。使用這個屬性來選擇不需要 SYST 命令的 FTP 伺服器。選項為 None、AIX、Detect、GXS、MVS、OS400 和其他。如果設定為 None，則會使用 SYST 命令。當 OS 類型不符合任何指定的類別時，會使用其他。預設值：沒有
Log	指定要輸出之記錄檔檔案名的完整路徑。您可以使用此檔案來診斷透過 FTP 傳送或接收檔案時所發生的錯誤情況。
最大檔案大小	指定可下載的檔案大小上限，以 MB 為單位。零 (0) 表示檔案大小無限制。預設值： 100
密碼	指定要用來登入 FTP 伺服器的使用者密碼。
連接埠	指定此 FTP 伺服器的連接埠位址。預設值： 21
表示法	選取 FTP 接收資料的方式。有效值：二進位或 ASCII 預設值：二進位
伺服器	指定 FTP 伺服器的伺服器名稱或 IP 位址。注意：傳送埠或接收位置的 URI 不能超過 256 個字元。
SSO 分支機構	指定「企業單一登入」分支機構應用程式。
使用名稱清單 (NLST)	指定配接器列出檔案的方式。若不檢視系統定義的檔案清單，而要檢視檔案名稱，請將這個值設定為 [是]。預設值：不
使用者名稱	指定要用來登入 FTP 伺服器的使用者名稱。

輪詢

使用	作法
下載後刪除	指定配接器在從 FTP 伺服器下載檔案之後，是否要刪除檔案。預設值：是注意：
啟用時間戳記比較	指定配接器是否要根據修改的時間戳記，再次下載檔案。如果配接器不具有 FTP 伺服器的刪除權限，MDTM (修改時間) 命令可讓配接器知道檔案自從上次下載後是否曾被修改。根據此屬性的值，再次下載檔案。預設值：否注意：如果 FTP 伺服器不支援 MDTM，請設定 Redownload Interval 屬性。注意：只有當 [下載後刪除] 設定為 [否] 時，才適用這個屬性。
間隔	指定輪詢此位置的時間間隔數。若要連續輪詢，請將此值設為零 (0)。預設值： 60
重新下載間隔	指定配接器再次下載檔案的間隔。只有當 [下載後刪除] 和 [ 啟用時間戳記比較 ] 都設定為 [否] 時，才適用此屬性。預設值： -1 -1 表示配接器將不會再次下載檔案。 0 表示配接器會在每個輪詢循環下載檔案一次。
單位	指定 Interval 和 Redownload Interval 屬性的單位類型。有效值：秒、分鐘、時和日預設值：秒

SSL

使用	作法
用戶端憑證雜湊	指定必須在安全通訊端層 (SSL) 交涉中使用之用戶端憑證的 SHA1 雜湊。系統會根據此雜湊，從用於執行 BizTalk 主控件執行個體之使用者帳戶的個人存放區挑選用戶端憑證。
FTPS 連線模式	指定對 FTPS 伺服器的 SSL 連線模式。有效值：隱含或明確預設值：明確
使用資料保護	如果配接器必須使用 SSL 加密來與 FTPS 伺服器之間往返傳送資料檔，請將這個屬性指定為 [是]。將這個屬性指定為 [否]，配接器就會以純文字傳送和接收資料檔。注意：只有當 Use SSL 屬性設定為 [是] 時，此屬性才適用。有效值：是或否預設值：是的
使用 SSL	指定 FTP 配接器是否必須使用 SSL 來與 FTPS 伺服器通訊。有效值：是或否預設值：不

微調參數

使用	作法
接收資料逾時	指定接收呼叫中止前時間 (以毫秒為單位)。您可以使用此屬性，防止慢速伺服器造成接收位置停止回應。預設值： 90000
暫存資料夾	指定暫存資料夾的位置。您可以使用此位置來保證可自傳輸失敗的地方回復傳輸。

按一下 [確定 ] 以儲存設定。
在 [ 接收位置屬性 ] 對話方塊中，輸入適當的值以完成接收位置的設定，然後按一下 [ 確定 ] 以儲存設定。如需 [接收位置屬性] 對話方塊的詳細資訊，請參閱如何建立接收位置。

注意

請勿設定多個 FTP 接收位置來輪詢相同的 FTP URL。若多個 FTP 接收位置同時輪詢相同的 URL，則每個接收位置均可接收一個檔案複本，如此可能造成資料重複。因為 FTP 通訊協定不提供從目標 URL 讀取檔案時鎖定檔案的功能，才會發生此狀況。

若要提供 FTP 接收配接器的高可用性，您應該將 FTP 接收配接器設定為在叢集 BizTalk 主機實例中執行。請參閱在叢集主機內執行配接器處理常式的考慮。

設定傳送埠

您可以在 BizTalk Server 管理主控台中設定 FTP 傳送埠配接器屬性。如果未設定傳送埠的屬性，則會使用 BizTalk Server 管理主控台中的預設傳送處理常式值。

在 BizTalk Server 管理主控台中，建立新的傳送埠，或按兩下現有的傳送埠加以修改。請參閱如何建立傳送埠。設定所有傳送埠選項，然後在 [一般] 頁面的 [傳輸] 區段中，指定[類型]選項的FTP。
在 [一般] 頁面上的 [傳輸] 區段中，按一下[類型] 旁的 [設定] 按鈕。

在 [FTP 傳輸屬性]中，執行下列動作：

防火牆

使用	作法
位址	指定防火牆的位址，可指定 DNS 名稱或 IP 位址。
模式	選取配接器與 FTP 伺服器間的連接模式。有效值：被動和主動在主動模式下，FTP 伺服器會連線到 FTP 配接器所開啟的連接埠。在被動模式下，FTP 配接器會連線到 FTP 伺服器所開啟的連接埠。如果您使用內部 IP 並聯機到外部 IP，則作用中模式可能無法運作。在此情況下，您必須搭配使用被動模式或主動模式搭配應用層閘道， (ALG) 與 FTP 支援。預設值：積極
密碼	指定防火牆的密碼。
連接埠	指定防火牆的連接埠。有效值：包含 1 到 65535 預設值： 21
類型	選取部署之防火牆的類型。有效值： Socks 4、Socks 5、None 預設值：沒有
使用者	指定防火牆的使用者名稱。

FTP

使用	作法
帳戶	選擇性。指定 FTP 伺服器的帳戶名稱。不鼓勵使用此屬性的選項。
PUT 之後	指定檔案 PUT 後要執行的 FTP 命令。使用分號 (;) 來分隔命令。
配置儲存區	指定是否配置儲存空間給舊版主控件系統。為回溯相容性提供此選項。有效值：否和是預設值：不
PUT 之前	指定檔案 PUT 前要執行的 FTP 命令，例如，要在 FTP 伺服器上變更預設值的命令。使用分號 (;) 來分隔命令。不需要開啟命令。注意： FILE PUT 之前不支援 QUIT 命令。
資料夾	指定在 FTP 伺服器上移動檔案的位置。
FTP 伺服器類型	從 BizTalk Server 2016 開始的新功能。使用此屬性來選擇不需要 SYST 命令的 FTP 伺服器。選項為 None、AIX、Detect、GXS、MVS、OS400 和其他。如果設定為 None，則會使用 SYST 命令。當 OS 類型不符合任何指定的類別時，則會使用其他。預設值：沒有
Log	指定要輸出的記錄檔檔案名的完整路徑。使用此檔案來診斷透過 FTP 配接器傳送或接收檔案時所發生的錯誤情況。
密碼	指定要用來登入 FTP 伺服器的密碼。
連接埠	指定 FTP 伺服器的連接埠位址。預設值： 21
表示法	選取 FTP 配接器傳送資料的方式 (二進位還是 ASCII)。有效值：二進位或 ASCII 預設值：二進位
伺服器	指定 FTP 伺服器的伺服器名稱或 IP 位址。
SSO 分支機構	指定「企業單一登入」分支機構應用程式。
目標檔案名稱	為檔案指定別名。保留預設名稱可確保每一個傳送的訊息均擁有唯一的訊息名稱。預設值： %MessageID%.xml
使用者名稱	指定要用來登入 FTP 伺服器的使用者名稱。

SSL

使用	作法
用戶端憑證雜湊	指定必須在安全通訊端層 (SSL) 交涉中使用之用戶端憑證的 SHA1 雜湊。系統會根據此雜湊，從用於執行 BizTalk 主控件執行個體之使用者帳戶的個人存放區挑選用戶端憑證。
FTPS 連線模式	指定對 FTPS 伺服器的 SSL 連線模式。有效值：隱含或明確預設值：明確
使用資料保護	如果配接器必須使用 SSL 加密來與 FTPS 伺服器之間往返傳送資料檔，請將這個屬性指定為 [是]。將這個屬性指定為 [否]，配接器就會以純文字傳送和接收資料檔。注意：只有當 Use SSL 屬性設定為 [是] 時，此屬性才適用。有效值：是或否預設值：是的
使用 SSL	指定 FTP 配接器是否必須使用 SSL 來與 FTPS 伺服器通訊。有效值：是或否預設值：不

微調參數

使用	作法
連線限制	指定伺服器最多可以開啟的並行 FTP 連線數目。值為 0 時表示沒有限制。預設值：0注意：此屬性會取代舊版BizTalk Server用來控管連線限制的登錄專案。 BizTalk Server會忽略用來控制連線限制的登錄專案。
暫存資料夾	指定 FTP 伺服器上的暫存資料夾位置。檔案會先上傳到此處，然後移至目的地 FTP 資料夾。如果傳輸失敗，配接器會以 ASCII 傳輸模式重新開始上傳檔案，並繼續以二進位傳輸模式下載檔案。注意：如果檔案傳輸在暫存位置和 FTP 伺服器上的相關位置之間是不可部分完成的，則檔案上傳也是不可部分完成的。

使用

作法

連線限制

指定伺服器最多可以開啟的並行 FTP 連線數目。值為 0 時表示沒有限制。

預設值：0注意：此屬性會取代舊版BizTalk Server用來控管連線限制的登錄專案。 BizTalk Server會忽略用來控制連線限制的登錄專案。

暫存資料夾

指定 FTP 伺服器上的暫存資料夾位置。檔案會先上傳到此處，然後移至目的地 FTP 資料夾。如果傳輸失敗，配接器會以 ASCII 傳輸模式重新開始上傳檔案，並繼續以二進位傳輸模式下載檔案。 注意： 如果檔案傳輸在暫存位置和 FTP 伺服器上的相關位置之間是不可部分完成的，則檔案上傳也是不可部分完成的。

再次按一下 [確定 ] 和 [ 確定 ] 以儲存設定。

FTP 配接器所需的 FTP 命令

FTP 配接器會受到 FTP 通訊協定限制的影響，所以在來源或目的 FTP 伺服器上必須具有某些 FTP 命令。

FTP 配接器會以 FTP 用戶端的形式運作，而且可能需要 FTP 伺服器上有下列命令才能正常運作：

命令	接收的必要專案	傳送所需
SYST	✔ 選擇性從 BizTalk Server 2016 開始	✔ 選擇性從 BizTalk Server 2016 開始
儲存		✔
RETR	✔
USER	✔	✔
PASS	✔	✔
CWD	✔	✔
QUIT	✔	✔
連接埠	✔	✔
PASV	✔	✔
ABOR	✔	✔
TYPE	✔	✔
RNFR	✔	✔
RNTO	✔	✔
DELE	✔	✔
PWD	✔	✔
清單	✔	✔
NLST	✔	✔
NOOP	✔	✔
APPE		✔
ALLO	✔	✔
MDTM	✔
AUTH TLS	✔	✔
PBSZ	✔	✔
PROT	✔	✔

如需這些 FTP 命令的詳細資訊，請參閱：