传输文件 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 事件变量中索引服务器上存在的所有文件,其中各个文件名之间以 'n’ 字符进行分隔。
-
-
通过 Advanced options 选项卡的 If no files are found 部分,可配置如果在启动活动时检测到任何错误或不存在文件,应执行的特定操作。
您还可以定义重试。工作流执行日志中会显示各项不同的重试。
-
确认活动的配置并保存工作流。
使用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 Storage的配置 azure-blob-configuration-wf
利用 Microsoft Azure Blob 协议,您可以访问位于 Microsoft Azure Blob Storage 帐户上的 Blob。
-
选择 Microsoft Azure Blob 外部帐户。有关更多信息,请参见此页面。
-
选择是要 Define a file path 还是 Use a dynamic file path。
-
指定下载文件的路径,它可以匹配多个 Blob。在此类情况下,File transfer 活动将为找到的每个 Blob 激活一次传出过渡。随后将根据字母顺序对它们进行处理。
note caution CAUTION 不支持匹配多个文件名的通配符。相反,您还需要输入前缀。所有与该前缀匹配的 Blob 名称都符合条件。 下方提供了一系列文件路径的示例:
- “Campaign/”:匹配位于容器根目录 Campaign 文件夹中的所有 Blob。
- “Campaign/new-”:匹配 Campaign 文件夹下所有文件名以“new-”开头的 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<您的实例名称>/ 目录中。您也无法浏览存储空间上方的目录。
例如:
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 活动生成事件变量作为输出,您可以在其他活动中利用这些变量,例如使用Test活动检查已下载文件的数量。
请注意,事件变量也可以使用外部信号传递给另一个工作流(请参阅使用外部参数自定义工作流)。
可用的输出变量包括:
- fileName:已传输文件的名称。
- filesCount:已传输的文件数。