File Transfer

The File Transfer action copies a file to or from the gateway and the deviceWISE Cloud.

NOTE: While the primary connection between the node and the deviceWISE Cloud is via MQTT, files are transferred via HTTPS (or HTTP if TLS is not available), thus you will need to ensure that port 443 and/or 80 is also open on your device.


Parameter description

Input Description
Operation The file transfer operation. The options are:
  • Get - Copy a file from the deviceWISE Cloud to this gateway's staging browser.
  • Put - Copy a file from this gateway's staging browser to the deviceWISE Cloud.
File Location The options are:
  • Global - The file is associated with the organization in the deviceWISE Cloud. The file can be accessed using the Management Portal -> Developer -> Files page.
  • Thing - The file is associated with the thing specified by the Thing Key parameter. The file can be accessed using the Management Portal -> Things -> Specific thing -> Files tab.

Input tab

Input Description
Connection Name The TR50 connection name of the connection to perform this action on.

 (Optional) If not specified, the name of the connection used is Default.

Thing Key
Optional. Available when using the Thing option for the File Location parameter.
The thing key of the thing to associate the file in the deviceWISE Cloud.
If the Thing option is used and the Thing Key parameter is not specified, the file will be associated with the gateway's thing in the M2M Service.
Source File When using the Get operation, the name of the file in the deviceWISE Cloud.
When using the Put operation, the name of the file on the local gateway.
File paths and names are relative to the root of the staging browser on the gateway.
Destination File When using the Get operation, the name of the file on the local gateway.
When using the Put operation, the name of the file in the deviceWISE Cloud.
File paths and names are relative to the root of the staging browser on the gateway.
If the destination file name already exists, it will be replaced.
Tag(s) Optional. When using the Put operation, the tags to associate with the file. Multiple tags are separated by a comma.
Public Optional. When using the Put operation, an indication that the file can be accessed by users or applications outside of this gateway's organization.
True (1) - indicates the file can be accessed from outside of the organization.
False (0) - indicates that file can not be accessed from outside of the organization. This is the default if it is not specified.