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

參照︰SFTP 傳出傳輸屬性

通用分頁

屬性
XML 屬性內容名稱
說明
ID
id
sftp-out
元件在程序集中的唯一 ID。
將回覆送交至
routes-response-to
sftp-out
傳輸的回應訊息目的地。
執行時間
execute-when
指定一個條件,決定是否執行傳輸。
端點
endpoint
指定要寫入檔案的主機 (也可選擇傳輸埠) 和 FTP 目錄。
遵循格式
sftp://SFTP-directory
,其中
SFTP-directory
是目標位置。
範例︰
sftp://sftpserver.example.org/outputDir
伺服器上必須已有您指定的目錄位置。
雙重驗證
dual-authentication
指定是否同時使用使用者名稱/密碼組合和私人金鑰強制執行雙重驗證。預設值為
false
,這表示使用者可以使用私人金鑰或使用者名稱/密碼組合進行驗證,但不能同時使用兩者。
如果屬性設為
false
且使用者輸入私人金鑰 (透過配置
sftp-out
元件的私人金鑰屬性),則驗證會自動使用該金鑰值和使用者名稱,而忽略密碼欄位。如果屬性設為
false
且未配置私人金鑰,則驗證會使用使用者名稱/密碼組合。
如果屬性設為
true
則驗證會同時使用私人金鑰值和使用者名稱/密碼組合。
主機金鑰指紋
host-key-fingerprint
FTP 伺服器將用於 SSH 通訊的加密金鑰。
使用者名稱
username
用於存取 FTP 伺服器的使用者名稱。
密碼
password
與用來存取 FTP 伺服器的使用者名稱相關聯的密碼。
二進制檔案
binary-file
指定是否要以二進位格式傳輸輸出檔案。
明確 SSL
explicit-ssl
連線類型︰顯式 SSL (AUTH TLS) 或隱式 SSL (AUTH SSL)。設為
true
使用明確的 SSL。
輸入檔案模式
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
    專門傳送以刪除檔案。

進階分頁

屬性
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 詳細資料。
逾時
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 偵錯模式。