传输文件 transfer-file

说明 description

利用 Transfer file 活动,可接收或发送文件、测试文件是否存在或列出 Adobe Campaign 中的文件。

使用环境 context-of-use

可在配置活动时定义数据的提取方式。例如,要加载的文件可以是联系人的列表。

您可以使用此活动取回随后将要使用 Load file 活动构建的数据。

相关主题:

配置 configuration

  1. Transfer file 活动拖放到工作流中。

  2. 选择活动,然后使用所显示快速操作中的 按钮将其打开。

  3. 使用 Action 字段中的下拉列表,选择以下活动操作之一:

    • 文件下载:用于下载文件。
    • 文件上传:用于上传文件。从 Adobe Campaign 文件上传文件,会在 Export audits 菜单中生成日志条目。有关导出审核的更多信息,请参阅审核导出一节。
    • 测试以查看文件是否存在:用于检查文件是否存在。
    • 文件列表:用于列出 Protocol 选项卡中规定服务器上存在的文件。此操作主要用于调试,主要是为了在从远程服务器下载文件之前,检查活动配置是否符合您的需要。
  4. 选择要使用的协议:

  5. 根据所选协议提供的​ Additional options ​部分允许您向协议添加参数。

    您可以:

    • Delete the source files after transfer:清除远程服务器上的文件。 如果未选中此选项,请确保手动监控SFTP目录中存档内容的大小。

    • Sorting files:允许您按字母数字对文件进行排序。 默认禁用此选项。

    • List all files:在​ General ​选项卡中选择​ File listing ​操作时,此选项可用。 利用此选项可在 vars.filenames 事件变量中索引服务器上存在的所有文件,其中各个文件名之间以 'n’ 字符进行分隔。

  6. 通过 Advanced options 选项卡的 If no files are found 部分,可配置如果在启动活动时检测到任何错误或不存在文件,应执行的特定操作。

    您还可以定义重试。工作流执行日志中会显示各项不同的重试。

  7. 确认活动的配置并保存工作流。

使用HTTP进行配置 HTTP-configuration-wf

利用 HTTP 协议,可从外部帐户或 URL 开始下载文件。

使用此协议,您可以选择​ Use connection parameters defined in an external account ​选项。 在这种情况下,请选择所需的帐户,并指定要下载的文件的路径。

您还可以选择 Quick configuration 选项。只需在 URL 字段中输入 URL 即可。

选择HTTP协议时,Follow redirectionsIgnore 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 ​选项,然后选择所需的帐户并指定下载文件的路径。

CAUTION
支持使用通配符。

您还可以选择 Quick configuration 选项。只需在 URL 字段中输入 URL 即可。

Amazon S3的配置 S3-configuration-wf

利用 Amazon S3 协议,可通过 Amazon Simple Storage Service (S3) 从 URL 或外部帐户下载文件。

  1. 选择 Amazon S3 外部帐户。有关更多信息,请参见此页面

  2. 选择是要 Define a file path 还是 Use a dynamic file path

  3. 指定下载文件的路径。

    note caution
    CAUTION
    Amazon S3不支持通配符。
    若要定位多个文件(如my_file_02my _file_3433),可以使用以下语法: acs-myawsbucket.s3.amazonaws.com/object-path/my_file_
  4. 如果要在传输完成时删除源文件,请勾选 Delete the source files after transfer

Microsoft Azure Blob Storage的配置 azure-blob-configuration-wf

利用 Microsoft Azure Blob 协议,您可以访问位于 Microsoft Azure Blob Storage 帐户上的 Blob。

  1. 选择 Microsoft Azure Blob 外部帐户。有关更多信息,请参见此页面

  2. 选择是要 Define a file path 还是 Use a dynamic file path

  3. 指定下载文件的路径,它可以匹配多个 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&lt;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) 为止。
NOTE
如果不再执行活动,则不会检查或清除其文件夹。考虑到这一点,在传输大文件时要多加小心。

输出变量 output-variables

Transfer file ​活动生成事件变量作为输出,您可以在其他活动中利用这些变量,例如使用Test活动检查已下载文件的数量。

请注意,事件变量也可以使用外部信号传递给另一个工作流(请参阅使用外部参数自定义工作流)。

可用的输出变量包括:

  • fileName:已传输文件的名称。
  • filesCount:已传输的文件数。
recommendation-more-help
3ef63344-7f3d-48f9-85ed-02bf569c4fff