| Both sides previous revisionPrevious revisionNext revision | Previous revision |
| transformations:amazoncommand [2021/07/05 02:19] – [Upload folder settings] craigt | transformations:amazoncommand [2023/04/21 00:35] (current) – Add create folder, delete folder settings craigt |
|---|
| Currently, the following commands are available: | Currently, the following commands are available: |
| * List files | * List files |
| | * List folders |
| * Download file | * Download file |
| * Download folder | * Download folder |
| * Upload folder | * Upload folder |
| * Delete file | * Delete file |
| | * Create folder |
| | * Delete folder |
| |
| \\ | \\ |
| =====Action settings===== | =====Action settings===== |
| ^ Setting ^ Description ^ | ^ Setting ^ Description ^ |
| |Command|Select the file operation this action will perform. Options: //List files//, //Download file//, //Download folder//, //Upload file//, //Upload folder//, or //Delete file//. See below for details of each command type.| | |Command|Select the file operation this action will perform. Options: //List files//, //List folders//, //Download file//, //Download folder//, //Upload file//, //Upload folder//, //Delete file//, //Create folder//, or //Delete folder//. See below for details of each command type.| |
| |Connector<sup>*</sup>|Select the preconfigured Amazon S3 connector, or, build one by selecting //Add connector//.| | |Connector<sup>*</sup>|Select the preconfigured Amazon S3 connector, or, build one by selecting //Add connector//.| |
| |Bucket<sup>*</sup>|Select the Amazon S3 bucket to perform the command in.| | |Bucket<sup>1</sup>|Select the Amazon S3 bucket to perform the command in.| |
| <sup>*</sup> Setting can be specified using a [[:parameters|parameter]]. | <sup>*</sup> Setting can be specified using a [[:parameters|parameter]].\\ |
| | <sup>1</sup> Setting can be specified using a [[:parameters|parameter]] or the first value of a column. |
| |
| \\ | \\ |
| |Folder<sup>*</sup>|Select a folder containing the files to create the file list from.| | |Folder<sup>*</sup>|Select a folder containing the files to create the file list from.| |
| |Columns|Select the details of the found files to be included in the dataset. Each detail creates a column in the dataset. Options: //File name with full path//, //File name only//, //File extension//, //Size//, and //Date modified//.| | |Columns|Select the details of the found files to be included in the dataset. Each detail creates a column in the dataset. Options: //File name with full path//, //File name only//, //File extension//, //Size//, and //Date modified//.| |
| <sup>*</sup> Setting can be specified using a [[:parameters|parameter]]. | <sup>*</sup> Setting can be specified using a [[:parameters|parameter]] or the first value of a column. |
| | |
| | \\ |
| | ====List folders settings==== |
| | **Description:** Produce a list of folders, with selected details, in a specified S3 bucket. |
| | ^ Setting ^ Description ^ |
| | |Folder<sup>*</sup>|Enter or select a folder containing the subfolders to create the list of.| |
| | |Columns|Select the details of the folders to be included in the dataset. Each detail creates a column in the dataset. Options: //Folder name with full path// and //Folder name only//.| |
| | <sup>*</sup> Setting can be specified using a [[:parameters|parameter]], or the first value of a column. |
| |
| \\ | \\ |
| |Local folder<sup>*</sup>|Enter or browse to the local folder to download the file to.| | |Local folder<sup>*</sup>|Enter or browse to the local folder to download the file to.| |
| |If a file with such\\ name already exists|Select how EasyMorph will handle saving the file if a file with the same name exists in the destination folder.\\ Options: //Overwrite//, //Do nothing//, or //Halt project execution//. See the "File already exists" table below.| | |If a file with such\\ name already exists|Select how EasyMorph will handle saving the file if a file with the same name exists in the destination folder.\\ Options: //Overwrite//, //Do nothing//, or //Halt project execution//. See the "File already exists" table below.| |
| <sup>*</sup> Setting can be specified using a [[:parameters|parameter]]. | <sup>*</sup> Setting can be specified using a [[:parameters|parameter]], or the first value of a column. |
| |
| \\ | \\ |
| |Folder path<sup>*</sup>|Enter or browse to the folder in S3 bucket containing the files to download.| | |Folder path<sup>*</sup>|Enter or browse to the folder in S3 bucket containing the files to download.| |
| |Local folder<sup>*</sup>|Enter or browse to the local folder to download the files to. This action will //overwrite// files with the same name(s)\\ that already exist(s) in the destination folder.| | |Local folder<sup>*</sup>|Enter or browse to the local folder to download the files to. This action will //overwrite// files with the same name(s)\\ that already exist(s) in the destination folder.| |
| <sup>*</sup> Setting can be specified using a [[:parameters|parameter]]. | <sup>*</sup> Setting can be specified using a [[:parameters|parameter]], or the first value of a column. |
| |
| \\ | \\ |
| |Target folder<sup>*</sup>|Enter or browse to a folder in the S3 bucket to upload the file to.| | |Target folder<sup>*</sup>|Enter or browse to a folder in the S3 bucket to upload the file to.| |
| |If a file with such\\ name already exists|Select how EasyMorph will handle saving the file if a file with the same name exists in the destination folder.\\ Options: //Overwrite//, //Do nothing//, or //Halt project execution//. See the "File already exists" table below.| | |If a file with such\\ name already exists|Select how EasyMorph will handle saving the file if a file with the same name exists in the destination folder.\\ Options: //Overwrite//, //Do nothing//, or //Halt project execution//. See the "File already exists" table below.| |
| <sup>*</sup> Setting can be specified using a [[:parameters|parameter]]. | <sup>*</sup> Setting can be specified using a [[:parameters|parameter]], or the first value of a column. |
| |
| \\ | \\ |
| |Filter files|When checked, enter a filter to use on the filenames in the specified folder to constrain which files are uploaded. Using wildcards in the filter is supported.| | |Filter files|When checked, enter a filter to use on the filenames in the specified folder to constrain which files are uploaded. Using wildcards in the filter is supported.| |
| |Target folder<sup>*</sup>|Enter or browse to a folder in the S3 bucket to upload the files to. This action will //overwrite// files with the same name(s) that already exist(s) in the destination folder.| | |Target folder<sup>*</sup>|Enter or browse to a folder in the S3 bucket to upload the files to. This action will //overwrite// files with the same name(s) that already exist(s) in the destination folder.| |
| <sup>*</sup> Setting can be specified using a [[:parameters|parameter]]. | <sup>*</sup> Setting can be specified using a [[:parameters|parameter]], or the first value of a column. |
| |
| \\ | \\ |
| |File path<sup>*</sup>|Enter or browse to the remote file in the S3 bucket to delete.| | |File path<sup>*</sup>|Enter or browse to the remote file in the S3 bucket to delete.| |
| |If the file doesn't exist|Select how EasyMorph handles situations when the specified file does not exist. Options: //Do nothing// (nothing\\ happens, the workflow continues, no error is displayed), or //Halt project execution// (workflow stops, an error is displayed).| | |If the file doesn't exist|Select how EasyMorph handles situations when the specified file does not exist. Options: //Do nothing// (nothing\\ happens, the workflow continues, no error is displayed), or //Halt project execution// (workflow stops, an error is displayed).| |
| <sup>*</sup> Setting can be specified using a [[:parameters|parameter]]. | <sup>*</sup> Setting can be specified using a [[:parameters|parameter]], or the first value of a column. |
| |
| \\ \\ | \\ |
| ====File already exists options==== | ====File already exists options==== |
| ^Option ^Description ^ | ^Option ^Description ^ |
| |Do nothing|No file is downloaded/uploaded, the workflow does not halt, and no error is displayed.| | |Do nothing|No file is downloaded/uploaded, the workflow does not halt, and no error is displayed.| |
| |Halt project execution|The project will stop processing and this action will display an error.| | |Halt project execution|The project will stop processing and this action will display an error.| |
| | |
| | |
| | \\ |
| | ====Create folder settings==== |
| | **Description:** Create a new folder under the parent folder in the selected S3 bucket. |
| | ^ Setting ^ Description ^ |
| | |Parent folder<sup>*</sup>|Select a folder in the S3 bucket to create the new folder under.| |
| | |Folder name<sup>*</sup>|Enter the name of the new folder.| |
| | |If a folder with such name already exists|Choose how EasyMorph behaves if a folder with the //Folder name// already exists. Options: //Fail// (the workflow stops with a warning) or //Do nothing// (the workflow continues without creating the new folder).| |
| | <sup>*</sup> Setting can be specified using a [[:parameters|parameter]].\\ |
| | |
| | \\ |
| | ====Delete folder settings==== |
| | **Description:** Delete the selected folder in the S3 bucket. |
| | ^ Setting ^ Description ^ |
| | |Folder path<sup>*</sup>|Select the folder in the S3 bucket to delete.| |
| | |If the folder doesn't exist|Choose how EasyMorph behaves if the selected folder does not exist. Options: //Do nothing// (the workflow continues without creating the new folder) or //Fail// (the workflow stops with a warning).| |
| | <sup>*</sup> Setting can be specified using a [[:parameters|parameter]].\\ |
| |
| \\ | \\ |
