傳輸檔案 transfer-file
說明 description
Transfer file 活動可讓您接收或傳送檔案、測試 Adobe Campaign 中是否有檔案或列出檔案。
使用內容 context-of-use
設定活動時,會定義資料擷取的方式。例如,要載入的檔案可以是聯絡人清單。
您可以使用 Load file 活動來復原隨後將與活動一起建構的資料。
相關主題:
設定 configuration
-
將活動 Transfer file 拖曳至工作流程中。
-
選取活動,然後使用所顯示快速動作中的 按鈕將其開啟。
-
使用 Action 欄位中的下拉式清單,選取下列活動動作之一:
- 檔案下載:可讓您下載檔案。
- 檔案上傳:可讓您上傳檔案。從 Adobe Campaign 檔案上傳檔案會在 Export audits 功能表中產生記錄項目。有關匯出稽核的詳細資訊,請參閱稽核匯出區段。
- 測試以查看檔案是否存在:可讓您檢查是否存在檔案。
- 檔案清單:可讓您列出伺服器上存在的檔案(在 Protocol 索引標籤中定義)。此動作主要用於偵錯,以在從遠端伺服器下載檔案之前,先檢查活動是否已根據您的需求進行設定。
-
選取要使用的通訊協定:
-
Additional options 區段(視選取的通訊協定而定)可讓您新增引數至通訊協定。
您可以:
-
Delete the source files after transfer:清除遠端伺服器上的檔案。 如果未核取此選項,請務必手動監視SFTP目錄中封存內容的大小。
-
Sorting files:可讓您依字母數字排序檔案。 此選項預設為停用。
-
List all files:在 General 索引標籤中選取 File listing 動作時,此選項可供使用。 它可讓您為 vars.filenames event 變數中伺服器上所有檔案建立索引,其中檔案名稱以 'n' 字元分隔 。
-
-
If no files are found 索引標籤的 Advanced options 區段可讓您在活動啟動時偵測到任何錯誤或不存在的檔案時設定特定操作。
您也可以定義重試次數。不同的重試次數會出現在工作流程執行記錄中。
-
確認活動的設定並儲存工作流程。
使用HTTP進行設定 HTTP-configuration-wf
HTTP 通訊協定可讓您從外部帳戶或 URL 開始下載檔案。
使用此通訊協定,您可以選擇 Use connection parameters defined in an external account 選項。 在此情況下,請選取您需要的帳戶,並指定要下載的檔案路徑。
您也可以選取 Quick configuration 選項。您只需在 URL 欄位中輸入URL。
當您選取HTTP通訊協定時,Follow redirections、Ignore the HTTP return code 和 Add received HTTP headers to the file 是其他可用的選項。
使用SFTP進行設定 SFTP-configuration-wf
SFTP 通訊協定可讓您開始從 URL 或外部帳戶下載檔案。
使用此通訊協定,您可以選擇 Use connection parameters defined in an external account 選項,然後選取您要的帳戶並指定要下載的檔案路徑。
您也可以選取 Quick configuration 選項。您只需在 URL 欄位中輸入 URL。
使用Amazon S3進行設定 S3-configuration-wf
Amazon S3 通訊協定可讓您透過 Amazon Simple Storage Service(S3) 從 URL 或外部帳戶開始下載檔案。
-
選取 Amazon S3 外部帳戶。如需詳細資訊,請參閱此頁面。
-
選取是否 Define a file path 或 Use a dynamic file path。
-
指定要下載的檔案路徑。
note caution CAUTION Amazon S3不支援萬用字元。 若要鎖定多個檔案(例如 my_file_02
和my _file_3433
),您可以使用下列語法:acs-myawsbucket.s3.amazonaws.com/object-path/my_file_
。 -
如果要在傳輸完成時刪除源檔案,請核取 Delete the source files after transfer。
使用Microsoft Azure Blob儲存設定 azure-blob-configuration-wf
Microsoft Azure Blob 通訊協定可讓您存取位於 Microsoft Azure Blob 儲存帳戶上的 blob。
-
選取 Microsoft Azure Blob 外部帳戶。如需詳細資訊,請參閱此頁面。
-
選取是否 Define a file path 或 Use a dynamic file path。
-
指定要下載的檔案路徑,可比對多個 blob。在這種情況下,找到每個 blob 之後,File transfer 活動就會啟動出站轉變。然後會依字母順序處理。
note caution CAUTION 不支援萬用字元來比對多個檔案名稱。您需要輸入首碼。所有與該首碼相符的 blob 名稱都符合條件。 您可以在檔案路徑的範例清單下找到:
- "campaign/":相符項目:位於容器根目錄的 Campaign 資料夾中的所有 blob。
- "campaign/new-":相符項目:所有檔案名稱以 "new-" 開頭且位於 Campaign 檔案夾下方的 blob。
- "":新增空白路徑可讓您比對容器中所有可用的 blob。
Adobe Campaign伺服器上檔案的設定 files-server-configuration-wf
File(s) present on the Adobe Campaign server 通訊協定對應於包含要復原的檔案的存放庫。
中繼字元或萬用字元(例如*或?) 可用於篩選檔案。
選取是否 Define a file path 或 Use a dynamic file path
Use a dynamic file path 選項可讓您使用標準運算式和事件變數來個人化要傳輸的檔案名稱。如需詳細資訊,請參閱此頁面。
請注意,路徑必須相對於 Adobe Campaign 伺服器的儲存空間目錄。檔案位於 sftp<yourinstancename>/ 目錄。您也無法瀏覽儲存空間上方的目錄。
例如:
user<yourinstancename>/my_recipients.csv
正確。
../hello/my_recipients.csv
不正確。
//myserver/hello/myrecipients.csv
不正確。
歷史化設定 historization-settings
每次執行 Transfer file 活動時,都會將已上傳或已下載的檔案儲存在專用的資料夾中。系統會為工作流的每個 Transfer file 活動建立一個資料夾。因此,必須能夠限制此資料夾的大小,以便保留伺服器上的實體空間。
若要這麼做,您可在 Transfer File 活動的 Advanced options 中定義 Historization settings。
Historization settings 可定義活動資料夾的檔案數目上限或總大小。依預設,授權 100 個檔案和 50 MB。
每次執行活動時,都會檢查資料夾,如下所示:
- 只考慮在活動執行前 24 小時以上建立的檔案。
- 如果考慮的檔案數大於 Maximum number of files 參數的值,則刪除最舊的文件,直到達到允許的 Maximum number of files 值為止。
- 如果考慮的檔案總大小大於 Maximum size (in MB) 參數值,則會刪除最舊的檔案,直到達到允許的 Maximum size (in MB) 值為止。
輸出變數 output-variables
Transfer file 活動會產生事件變數作為輸出,您可以在其他活動中運用這些變數,例如使用測試活動來檢查已下載檔案的數量。
請注意,事件變數也可以使用外部訊號傳遞給另一個工作流程(請參閱使用外部引數自訂工作流程)。
可用的輸出變數包括:
- fileName:已傳輸檔案的名稱。
- filesCount:已傳輸的檔案數目。