跳至主要內容
Administrator Guide
上次更新時間 :2023-06-23
參照︰FTPS 傳出傳輸屬性

參照︰FTPS 傳出傳輸屬性

通用分頁

屬性
XML 屬性內容名稱
說明
ID
id
ftps-out
元件在程序集中的唯一 ID。
將回覆送交至
routes-response-to
ftps-out
傳輸的回應訊息目的地。
執行時間
execute-when
決定是否執行傳輸的條件。
端點
endpoint
指定要寫入檔案的主機 (也可選擇傳輸埠) 和 FTP 目錄。
遵循格式
ftps://FTPS-directory
,其中
FTPS-directory
是目標位置。
範例︰
ftps://ftpsserver.example.org/outputDir
伺服器上必須已有您指定的目錄位置。
二進制檔案
binary-file
指定是否要以二進位物件的形式傳輸輸出檔案。
明確 SSL
explicit-ssl
指定連線類型︰顯式 SSL (AUTH TLS) 或隱式 SSL (AUTH SSL)。設為
true
以使用明確的 SLL。
FTP 用戶端可以選擇像一般 FTP 階段作業一樣在未加密的情況下繼續通訊,或發出 AUTH 命令,切換為 FTPS 模式。
輸入檔案模式
input-file-pattern
檔案名稱模式,用於比對特定類型的檔案。
範例︰指定
*.xls
,僅選取 Excel 檔案。
輸入內容類型
input-content-type
執行階段包含的媒體類型︰
content-type
訊息標頭中的值媒體類型至少包含 2 個部分︰類型、子類型和 1 或多個選用參數。該
text
子類型有選填項目
charset
參數,指定字元編碼。
範例︰
text/html; charset=UTF-8
如果是非 XML 文字檔格式,且檔案中並未明確指出媒體類型和字元集,此屬性就特別有用。
輸出檔案模式
output-file-pattern
指定產生輸出檔案名稱的方式。模式可包含常值字串以及下列一或多個標記︰
  • ${INFILE}
    ,取代為輸入檔案的名稱。
  • ${UUID}
    ,取代為通用唯一 ID。
  • ${EXT}
    ,放置在模式的結尾,根據寫入組合件元件輸出的資料內容類型,以不同的副檔名取代。
方法
method
指定轉移方法︰
  • put
    「」︰將檔案寫入包含遠端目錄的 FTP 端點。
  • list
    ︰列出 FTP 端點上的所有檔案和目錄。將
    「輸入檔案模式」
    屬性搭配使用
    list
    ,將模式套用至要傳回的清單。您可以存取「」的結果
    list
    方法使用 MVEL
    ftp
    物件。範例
    ︰ftp.list()
    會傳回一個字串清單,其中包含最後擷取的清單。
  • get
    ︰擷取第一個符合
    「輸入檔案模式」
    屬性值的檔案。
  • delete
    ︰刪除找到的第一個符合
    「輸入檔案模式」
    屬性值的檔案。
    刪除後,檔案不會自動從 FTP 網站刪除。
    get
    已執行「」。如果您要刪除檔案,必須呼叫個別的方法。範例︰您可以包含單獨的
    ftp-out
    專門傳送以刪除檔案。
密碼
password
與用來存取 FTP 伺服器的使用者名稱相關聯的密碼。
使用者名稱
username
用於存取 FTP 伺服器的使用者名稱。

進階分頁

屬性
XML 屬性內容名稱
說明
商店訊息
store-message
除非 Workday 支援團隊另有建議,否則請指定
「無」
若要儲存訊息,請使用 Studio 的
儲存
步驟。
傳輸類別
transport-class
視需要逐一指定替代實作類別。
您可透過編輯 WEB-INF/classes/spring/assembly-bean.xml 檔案,全域變更實作類別。
忽略動態端點
ignore-dynamic-endpoints
指定是否要忽略傳入訊息標頭中的動態 WS-Addressing (WSA) 值,或使用該值覆寫傳輸的
「端點」
屬性中的值。
請使用
set- Dynamic-endpoint
步驟指定 WS-Addressing 詳細資料。
被動模式
passive-mode
指定傳輸是否支援被動模式下的 FTP。
在被動模式下,FTP 用戶端會起始 FTP 傳輸所需的兩個連線。用戶端會透過指令連接埠聯絡伺服器並發出 PASV 命令。伺服器隨後會回覆,指出其正在偵聽哪個通訊埠以進行資料連線。用戶端接著起始資料連線,從其資料通訊埠連至指定的伺服器資料通訊埠。最後,伺服器會將 ACK 傳回至用戶端的資料通訊埠。在作用中模式下,用戶端會起始指令連線,而伺服器會起始資料連線。
逾時
timeout
指定用戶端與傳輸系統正在偵聽的 FTP 伺服器之間的 FTP 階段作業逾時期間 (以毫秒為單位)。
如果您未指定值,則階段作業會在 300000 毫秒 (5 分鐘) 後逾時。
MIME 類型對應檔案
mime-types-map-file
指定對應檔案的位置,以便在 MIME 類型與檔案副檔名之間進行對應。使用此屬性可︰
  • 「方法」
    屬性設定為時,將 MIME 類型對應至檔案副檔名
    put
  • 「方法」
    屬性設定為時,將檔案副檔名對應至 MIME 類型
    get
此對應的檔案為
ccx/conf/mime.types
。您可以提供您自己的此檔案版本。
此傳輸可使用
${EXT}
放在結尾的標記
output-file-pattern
值。
臨時檔案名稱
temp-file-name
指定臨時檔案名稱。當
「方法」
屬性設為
put
,檔案會使用此臨時檔案名上傳。FTP 完成後,檔案會重新命名為
輸出檔案模式
屬性指定的名稱。
關閉連結
close-connection
指定是否在 FTP 動作完成時進行中斷連接。
額度大小
pool-size
此元件在個別主機上可支援的同時連線和階段作業數上限。如果嘗試連線至同一主機的執行緒數超過指定數量,系統會強制部分執行緒等候存取池。
若要使分配池大小不受限制,請指定負數。
偵錯
debug
啟用傳輸中的 JSCAPE 偵錯模式。