ÃÛ¶¹ÊÓÆµ

FTP modules

FTP modules let you monitor file changes in a selected folder, upload new files to the desired folder, and modify or delete existing files that are already in a folder.

Access requirements

Expand to view access requirements for the functionality in this article.

You must have the following access to use the functionality in this article:

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
ÃÛ¶¹ÊÓÆµ Workfront package Any
ÃÛ¶¹ÊÓÆµ Workfront license

New: Standard

Or

Current: Work or higher

ÃÛ¶¹ÊÓÆµ Workfront Fusion license**

Current: No Workfront Fusion license requirement

Or

Legacy: Workfront Fusion for Work Automation and Integration

Product

New:

  • Select or Prime Workfront package: Your organization must purchase ÃÛ¶¹ÊÓÆµ Workfront Fusion.
  • Ultimate Workfront package: Workfront Fusion is included.

Or

Current: Your organization must purchase ÃÛ¶¹ÊÓÆµ Workfront Fusion.

For more detail about the information in this table, see Access requirements in documentation.

For information on ÃÛ¶¹ÊÓÆµ Workfront Fusion licenses, see ÃÛ¶¹ÊÓÆµ Workfront Fusion licenses.

Prerequisites

In order to use FTP modules, you must have an account with an FTP service.

Create a connection in an FTP module create-a-connection

  1. In any FTP module, click Add next to the connection box.

  2. Fill in the following fields.

    table 0-row-2 1-row-0 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 10-row-2 layout-auto html-authored no-header
    Connection name Enter the name for your FTP connection.
    Environment Select whther you are using a production or non-production environment.
    Type Select whether you are using a service account or a personal account.
    Host Enter the FTP server hostname. Example: myftp123.server.com
    Port Enter the FTP server port number. Example: 21
    User name Enter your FTP account user name.
    Password Enter your FTP account password.
    Use a secure connection (TLS)

    Select whether you want to use a secure connection.

    • No

      The connection is not secured.

    • Explicit encryption or Implicit encryption

      The connection is secured using SSL.

    Reject unauthorized certificates

    Enable this option to verify the FTP server certificate. If the verification fails, the connection will not be created. To pass the verification, the certificate must meet one of the following criteria:

    • be signed by a Root Certificate Authority
    • be signed by an Intermediate Certificate Authority. In this case all the Intermediate Certificates should be installed on the FTP server.
    • be a Self-Signed Certificate supplied in the Self-signed certificate field (see below)

    If this option is disabled, the FTP server certificate is not verified. We strongly advise against disabling the option as it renders the connection insecure and poses a serious security risk.

    Self-signed certificate

    Click the Extract button to open the upload dialog.

    Upload the certificate to use the TLS with your self-signed certificate. Workfront Fusion does not retain or store any data you provide, such as files and passwords. File and password are used only to extract the certificate.

  3. Click Continue to save the connection and return to the module.

FTP modules and their fields

Triggers

Watch files

Watch files is the only trigger module for FTP. It monitors the file content of the selected folder. The trigger is executed when a new file is added tp the specified folder.

Connection
For instructions on establishing a connection to the FTP account, see Create a connection in an FTP module in this article.
Folder

Select the folder you want to watch.

Note: Only one folder per scenario is allowed. Subfolders are ignored.

Tip: To watch multiple folders, create a separate scenario for each of them.

Maximum number of returned files
Set the maximum number of results that you want the module to work with during one cycle. If the value is set too high, the connection may be interrupted on the side of the FTP server. Workfront Fusion has no influence on this. We recommend that you set a lower value and either define a higher value for the maximum number of cycles or run the scenario more frequently.

Actions

Change permissions

This action module changes permission settings of a file or folder.

Connection
For instructions on establishing a connection to the FTP account, see Create a connection in an FTP module in this article.
Change permission settings of
Select whether you want to change settings for a file or folder.
File path
Enter or map the file path to the folder or file.
Permissions

Set the desired file or folder permissions. Use the chmod parameters. For example: 777 or -rwxrwxrwx.

Permissions must match the pattern /(.?([r-][w-][x-]){3})|[0-7]{3,4}/.

Create a folder

This action module creates a new folder.

Connection
For instructions on establishing a connection to the FTP account, see Create a connection in an FTP module in this article.
Folder path
Enter or map the file path to the new folder.
New folder name
Enter or map a name for the new folder.

Delete a file

This action module deletes a file from the specified folder.

Connection
For instructions on establishing a connection to the FTP account, see Create a connection in an FTP module in this article.
Folder
Select the FTP folder you want to delete a file from.
File name
Enter the filename, including file name extension. Example: image.png

Delete a folder

This action module permanently deletes the specified folder.

Connection
For instructions on establishing a connection to the FTP account, see Create a connection in an FTP module in this article.
Folder
Select the FTP folder you want to delete a file from.

Get a file

This action module retrieves a file from the FTP server.

Connection
For instructions on establishing a connection to the FTP account, see Creating the FTP Connection in this article.
File path
Enter the path of the file you want to get.

List of files in a folder

This action module retrieves file and/or folder information.

Connection
For instructions on establishing a connection to the FTP account, see Creating the FTP Connection in this article.
Folder
Select the FTP folder you want to search in.
Show
Select whether you want to retrieve information about files or folders, or both.
Search
Enter the search term. If no search term is entered, all files or folders from the specified folder will be retrieved.
Maximum number of returned files
Enter or map the maximum number of results that you want the module to work with during one cycle.

Move a file or folder

This action module moves a file or folder to a different location.

Connection
For instructions on establishing a connection to the FTP account, see Create a connection in an FTP module in this article.
Old file path
Enter the path that you want to move the file from. Example: /folder1/document.txt.
New file path
Enter the path that you want to move the file to. Example: /folder2/document.txt.

Upload a file

Uploads a file to the FTP server.

Connection
For instructions on establishing a connection to the FTP account, see Creating the FTP Connection in this article.
Folder
Select the FTP folder you want to upload the file to.
Source file
Select a source file from a previous module, or map the source file's name and data.
Append to an already existing file
If this option is enabled and the file already exists on the FTP server, the contents of the file are appended to the existing file. If this option is not enabled, the content of the file will be overwritten.
Create folders if don't exist
If this option is enabled and the folder you have entered to the Folder field does not exist on the FTP server, the module creates the folder

Troubleshooting troubleshooting

If you are experiencing issues with the FTP app either during the connection creation or during a module’s operation, try to use one of the popular FTP clients, and try to perform the same action (for example, create a connection or list files in a folder). with the FTP client. If you are experiencing the same issues also with the FTP client, the reason might be a misconfiguration of the FTP server.

recommendation-more-help
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3