51ºÚÁϲ»´òìÈ

DocumentationCampaignCampaign Standard Documentation

Transfer file transfer-file

Last update: Tue Feb 08 2022 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Applies to:
  • Campaign Standard

CREATED FOR:

  • Intermediate
  • Developer

Description description

The Transfer file activity allows you to receive or send files, test whether there are files present, or list files in 51ºÚÁϲ»´òìÈ Campaign.

Context of use context-of-use

The way in which the data will be extracted is defined when the activity is configured. The file to load may be a list of contacts, for example.

You can use this activity to recover data that will then be structured with the Load file activity.

Related topics:

Configuration configuration

  1. Drop a Transfer file activity into your workflow.

  2. Select the activity, then open it using the button from the quick actions that appear.

  3. Use the drop-down list in the Action field to select one of the following activity actions:

    • File download: allows you to download a file.
    • File upload: allows you to upload a file. Uploading a file from 51ºÚÁϲ»´òìÈ Campaign file generates a log entry in the Export audits menu. For more information on export audits, refer to the Auditing exports section.
    • Test to see if file exists: allows you to check whether there is a file.
    • File listing: allows you to list the files present on the server defined in the Protocol tab. This action is mainly used for debugging purposes, to check if the activity is configured according to your needs before downloading the files from the remote server.

  4. Select the protocol you want to use:

  5. The Additional options section, available depending on the protocol selected, allows you to add parameters to your protocol.

    You can:

    • Delete the source files after transfer: erases the files on the remote server. If you leave this option unchecked, make sure you manually monitor the size of your archived content in the SFTP directory.

    • Sorting files: enables you to sort files alphanumerically. This option is disabled by default.

    • List all files: this option is available when selecting the File listing action in the General tab. It allows you to index all the files present on the server in the vars.filenames event variable in which the file names are separated by the ‘n’ characters.

  6. The If no files are found section of the Advanced options tab allows you to configure specific actions if any errors or inexistent files are detected when the activity is started.

    You can also define retries. The different retries appear in the workflow execution log.

  7. Confirm the configuration of your activity and save your workflow.

Configuration with HTTP HTTP-configuration-wf

The HTTP protocol allows you to start downloading a file from an external account or from a URL.

With this protocol, you can choose to Use connection parameters defined in an external account option. In this case select the account you would like and specify the path of the file to download.

You can also choose the Quick configuration option. You only need to enter the URL in the URL field.

Follow redirections, Ignore the HTTP return code, and Add received HTTP headers to the file are the additional options available when you select the HTTP protocol.

Configuration with SFTP SFTP-configuration-wf

The SFTP protocol allows you to start downloading a file from a URL or an external account.

With this protocol, you can choose to Use connection parameters defined in an external account option, then select the account you would like and specify the path of the file to download.

CAUTION
Wildcards are supported.

You can also choose the Quick configuration option. You only need to enter the URL in the URL field.

Configuration with Amazon S3 S3-configuration-wf

The Amazon S3 protocol allows you to start downloading a file from a URL or an external account via Amazon Simple Storage Service (S3).

  1. Select an Amazon S3 external account. For more on this, refer to this page.

  2. Choose if you want to Define a file path or Use a dynamic file path.

  3. Specify the path of the file to download.

    note caution
    CAUTION
    Wildcards are not supported with Amazon S3.
    To target multiple files such as my_file_02 and my _file_3433, you can use the following syntax: acs-myawsbucket.s3.amazonaws.com/object-path/my_file_.

  4. If you want to delete your source files when transfer is completed, check Delete the source files after transfer.

Configuration with Microsoft Azure Blob storage azure-blob-configuration-wf

The Microsoft Azure Blob protocol allows you to access blob located on a Microsoft Azure Blob Storage account.

  1. Select a Microsoft Azure Blob external account. For more on this, refer to this page.

  2. Choose if you want to Define a file path or Use a dynamic file path.