FTP Rename Action—Setting Properties

The FTP Rename action is used to rename files on an FTP server. The FTP Log On action must be used first to begin the FTP transaction and connect with the server.

To set FTP Rename properties

  1. From the Task Builder Available Actions pane, open the Internet\FTP folder and double-click the FTP Rename action or drag it into the Steps pane.

  2. In the Original name box, enter the fully qualified UNIX path and file name for the file or files to be renamed, or click the Open Folder button and use the FTP browser to navigate to the file. You can use asterisk (*) and question mark (?) as wildcard characters. Separate multiple entries with a pipe symbol (|). Example: /sourcefoldername/*.txt|/sourcefoldername/*.doc. All files must be in the same folder.

  3. In the New name box enter the new file name. When renaming multiple files, use wildcard characters asterisk (*) or questions mark (?). For example, use *.txt to change all to text files, or [Date]*.* to add a date to all files. Renamed files must remain in their original folders.

  4. In the Session name box, enter the name of the FTP session. The name is set in the FTP Log On action.

  5. Click the Options tab.

  6. If you want to rename files in the subfolders, select Include subfolders. If this is not selected, the subfolders will be ignored.

  7. If you want the newly renamed files to overwrite any existing files of the same names, select Overwrite existing files. If this is not selected files that already exist with the new name will be skipped.

  8. If you want to rename the files only if a file of the same name exists, select Only if exists in destination. This is a sub-selection of Overwrite existing files. If this is selected, only files for which the new name matches an existing file will be renamed, and they will overwrite the existing files.

  9. In the Exclude mask box, enter the names of any files or folders you want to exclude from the action. You can use asterisk (*) and question mark (?) as wildcard characters. Separate multiple entries with a pipe symbol (|).

  10. To set the Description tab properties, refer to Description Tab Options.

  11. To set the Error Causes and On Error tab properties, refer to Step Error Handling.

  12. When finished, click OK to save settings and close the properties dialog window.

See Also

About Actions

Adding Task Steps

FTP Rename Action