gettree

You can use this method to return array of files or folders in the defined path.

Sample URLs

https://mft.acme.com/cfcc/control?view=view/filetransfer/jsondirtree.jsp&action=gettree&path=/&org.apache.catalina.filters.CSRF_NONCE=0BC0207D47896DBF5EEA627EEA716193

or

https://mft.acme.com/cfcc/control?view=view/filetransfer/jsondirtree.jsp&action=gettree&path=/Dir1/FY2018&org.apache.catalina.filters.CSRF_NONCE=0BC0207D47896DBF5EEA627EEA716193

Fixed Parameters Returned

The following table lists the data returned:

Parameter Description
"token" The token to use for all file transfer requests.

It will be changed on each request.

"rc" The valid values are as follows:
  • 0: success.
  • 1: failure.
"errmsg" Message.
"path" The path value sent to the server.

Forward slash (/) means the root level.

"action" The action requested.
"delfile" Defines whether the transfer definition allows a delete file action.
The valid values are as follows:
  • "Y": yes.
  • "N": no.
"deldir" Defines whether the transfer definition allows a delete directory action.
The valid values are as follows:
  • "Y": yes.
  • "N": no.
"rename" Defines whether the transfer definition allows a rename action.
The valid values are as follows:
  • "Y": yes.
  • "N": no.
"create" Defines whether the transfer definition allows a create directory action.
The valid values are as follows:
  • "Y": yes.
  • "N": no.
"readfid" The download transfer ID associated with this file or folder.

This parameter is used when uploading or downloading files.

"writefid" The upload transfer ID associated with this file or folder.

This parameter is used when uploading or downloading files.

"vmgrname" This parameter is for internal use only and can be ignored.
"changemode" This parameter is for internal use only and can be ignored.
"currentcrlf" This parameter is for internal use only and can be ignored.
"currentmode" This parameter is for internal use only and can be ignored.

Array of Children Returned

The following table lists the array of children returned:

Parameter Description
"entries" A JSON array for files and folders in the parent directory.

There will be one entry in the array for each file or folder in the path.

"isdir" Defines whether the entry is a directory.
The valid values are as follows:
  • "Y": yes.
  • "N": this is a file.
"size" The file size when isdir != "Y".
"modified" The date of last modification: seconds since 1 January 1970.
"name" The file or folder name.
"readrestart" Defines whether download restart is supported.
The valid values are as follows:
  • "Y": yes.
  • "N": no.
"writerestart" Defines whether upload restart is supported.
The valid values are as follows:
  • "Y": yes.
  • "N": no.
"delfile" The parameter echoes information from the root entry.
"deldir" The parameter echoes information from the root entry.
"rename" The parameter echoes information from the root entry.
"create" The parameter echoes information from the root entry.
"readfid" The parameter echoes information from the root entry.
"writefid" The parameter echoes information from the root entry.
"readcompress" The parameter is for internal use only and can be ignored.
"writecompress" The parameter is for internal use only and can be ignored.
"remainingpath" The parameter is for internal use only and can be ignored.
"changemode" The parameter is for internal use only and can be ignored.
"currentmode" The parameter is for internal use only and can be ignored.
"currentcrlf" The parameter is for internal use only and can be ignored.