File Transfer

  • Last update: October 31, 2024
  • Overview 

    Version 

    FineDataLink VersionFunction Description
    4.1.5.5/

    Application Scenario 

    • Transfer attachments from APIs: You may want to download attachments from APIs and synchronize them to the FTP server/local system/other business systems (through APIs) for archiving.

    • Relocate files on the FTP server/local system: You may want to back up a file from an FTP server to another folder on the server and delete the original file.

    未命名文件(5).png

    Function Description 

    You can use the File Transfer node to download files from and upload files to multiple positions, such as APIs, local systems, and FTP/SFTP servers.

    iconNote:

    1. This node is used to synchronize files, not extracting data from files.

    2. This node is not subject to the dirty data threshold and will report an error upon detecting a dirty file.


    Prerequisite 

    You must create the corresponding data connection to transfer files from/to the local directory or the FTP/SFTP server. For details, see Data Connection of Local Server Directory and FTP/SFTP Data Connection.

    Function Description 

    File Source 

    API

    Select API Input from the drop-down list of Data Source to fetch files from an API. The response data must be a file stream. (The file name extension is not restricted.) Otherwise, the node fails to run and reports an error.

    FTP/SFTP

    Choose File Input > FTP/SFTP from the drop-down list of Data Source to fetch files from the specified server. 

    You can set Read Method to Read File or Read Folder.

    • Select Read File to read a specific file. You can use parameters when entering the file address.

    iconNote:

    1. You can enter the filename extension (not case-sensitive) to limit the type of files to be read automatically from the FTP/SFTP server or uploaded manually from the local system. Separate multiple values by comma (,).

    2. There is no restriction on the suffix entered in Filename Extension.

    • Select Read Folder to read files from a specific folder. You can use parameters when entering the folder address.

    Configuration ItemDescription
    Folder AddressYou can select a folder within your permission scope. Using parameters is supported. For details about parameter use, see File Input.
    Read Subfolder

    If it is selected, files in the subfolder will be read.

    If it is unselected, files in the subfolder will not be read.

    File Filtering

    This item appears after you select Read Folder.

    You can configure filtering conditions for files to be read in the folder.

    The condition is effective only after the folder address is set.

    You can add conditions to specify names (including filename extensions) and the modification time of the file to be read.

    • Conditions for File Name include InNot InContainNot ContainBegin WithEnd WithNot Begin With, and Not End With.

    • Conditions for File Modification Time include BetweenNot BetweenBeforeAfterEqual To, and Not Equal To.

    Referencing parameters is supported. For details about the judgment logic, see Judgment Logic Description.

    Notes:

     If you select Read Subfolder and files with the same name and different paths exist in the selected folder, the names of target files are the original file names prefixed with Subfolder name_ for distinguishing. For example, Folder A has the following structure.

    Folder A/Subfolder B/File C

    Folder A/Subfolder B/File D

    Folder A/File C

    After a successful file transfer, file names in the target location are Subfolder B_File C, Subfolder B_File D, and File C. If a file name already exists in the target location, the duplicate handling strategy will be followed.

    Local Server Directory

    Choose File Input > Local Server Directory from the drop-down list of Data Source to fetch files from the FineDataLink server.

    You can set Read Method to Read File or Read Folder. Referencing parameters in the address is supported.

    You can only select the folder of the entered data connection and its subfolders after selecting Read Folder.

    iconNote:
    There is no restriction on the suffix entered in Filename Extension.

    Target File Location 

    API

    Select API Output from the drop-down list of Data Source to upload a file to an API. The configuration method is the same as that of the API Output operator, except that only binary Body is supported here.

    Configuration ItemDescription
    Request MethodRequest methods include POSTPUT, DELETE, and PATCH.
    URLIt defaults to empty. Referencing parameters is supported.
    HeadersThe value of Content-Type defaults to application/octet-stream and is uneditable.
    Others

    The obtained file defaults to the pre-downloaded file stream.

    iconNote:
    Only a single row of input is allowed. An error will be reported during execution if the input exceeds one row. Use a Loop Container node to upload multiple files.

    This method is typically used to upload files. There is no key-value pair, so only one file can be uploaded at a time.

    FTP/SFTP

    Choose File Output > FTP/SFTP from the drop-down list of Data Source to upload files to the specified server.

    Enter the folder address and set the target file name and the duplicate handling strategy, as shown in the following figure.

    Configuration ItemDescription
    Folder Address

    Set the file output path, whose parent directory defaults to the directory of the selected data connection.

    You can select the file address or use parameters.

    • Keep the file address empty before entering the parameter.

    • You can select the file directory from the drop-down list.

    File Name

    You can use the original file name or customize the file name.

    Select Custom to customize the file name (which cannot be empty). The input box is empty by default. You can enter the parameter or a mix of the parameter and text. 

    Duplicate Handling Strategy

    The strategy for handling files with duplicate names when they are written to the server includes Stop Outputting and Report An ErrorKeep Both Files, and Overwrite Target File.

    Local Server Directory

    The configuration method is the same as uploading files to the FTP/SFTP server, except that the folder address must be the data connection folder or its subfolder.



    附件列表


    主题: Data Development - Scheduled Task
    Previous
    Next
    • Helpful
    • Not helpful
    • Only read

    滑鼠選中內容,快速回饋問題

    滑鼠選中存在疑惑的內容,即可快速回饋問題,我們將會跟進處理。

    不再提示

    10s後關閉

    Get
    Help
    Online Support
    Professional technical support is provided to quickly help you solve problems.
    Online support is available from 9:00-12:00 and 13:30-17:30 on weekdays.
    Page Feedback
    You can provide suggestions and feedback for the current web page.
    Pre-Sales Consultation
    Business Consultation
    Business: international@fanruan.com
    Support: support@fanruan.com
    Page Feedback
    *Problem Type
    Cannot be empty
    Problem Description
    0/1000
    Cannot be empty

    Submitted successfully

    Network busy