Both sides previous revisionPrevious revisionNext revision | Previous revision |
transformations:morphservercommand [2021/07/04 23:09] – craigt | transformations:morphservercommand [2023/11/24 20:16] (current) – craigt |
---|
\\ | \\ |
=====Description===== | =====Description===== |
This action allows interacting with a remote EasyMorph Server using a configured EasyMorph Server connector. Currently, the action has 6 commands: | This action allows interaction with a remote EasyMorph Server using a configured EasyMorph Server connector. Currently, the action has 6 commands: |
* Run task | * Run task |
* Enable/disable task | * Enable/disable task |
* Delete file | * Delete file |
* List files | * List files |
| * List folders |
| * List tasks |
| * Delete folder |
| * Create folder |
| * Rename folder |
| * Rename file |
| * Find files recursively |
| |
\\ | \\ |
^ Setting ^ Description ^ | ^ Setting ^ Description ^ |
|Connector<sup>*</sup>|Select the preconfigured EasyMorph Server connector.| | |Connector<sup>*</sup>|Select the preconfigured EasyMorph Server connector.| |
|Command|Select the command this action will perform. Options: //Run task//, //Enable/disable task//, //Upload file//, //Download file//, //Delete file//, or //List files//. See below for details of each command type.| | |Command|Select the command this action will perform.\\ Options: //Run task//, //Enable/disable task//, //Upload file//, //Download file//, //Delete file//, //List files//, //List folders//, //List tasks//, //Delete folder//, //Create folder//, //Rename folder//, //Rename file//, or //Find files recursively//. See below for details of each command type.| |
<sup>*</sup> Setting can be specified using a [[:parameters|parameter]]. | <sup>*</sup> Setting can be specified using a [[:parameters|parameter]]. |
| |
**Description:** Runs a Server task. Task parameters can be specified in the action properties. | **Description:** Runs a Server task. Task parameters can be specified in the action properties. |
^ Setting ^ Description ^ | ^ Setting ^ Description ^ |
|Task|Select the Server task to run.| | |Task<sup>*</sup>|Select the Server task to run. If the task is specified by a parameter, it should be the task ID.| |
|Don't wait for completion…|Check this option to continue running the task, ignoring task errors, while the workflow continues.| | |Don't wait for completion…|Check this option to continue running the task, ignoring task errors, while the workflow continues.| |
| <sup>*</sup> Setting can be specified using a [[:parameters|parameter]]. |
| |
\\ | \\ |
|Task|Select the Server task to enable/disable.| | |Task|Select the Server task to enable/disable.| |
|Mode|Select whether this action will enable or disable the selected task. Options: //Enable task// or //Disable task//.| | |Mode|Select whether this action will enable or disable the selected task. Options: //Enable task// or //Disable task//.| |
|If task was enabled/disabled|Choose how EasyMorph reacts if the task was already enabled (in "Enable task" mode), or disabled (in "Disable task" mode). Options: //Ignore// (the workflow continues and not error is displayed) or //Fail// (the workflow stops and displays an error).| | |If the task was enabled/disabled|Choose how EasyMorph reacts if the task was already enabled (in "Enable task" mode), or disabled (in "Disable task" mode). Options: //Ignore// (the workflow continues and no error is displayed) or //Fail// (the workflow stops and displays an error).| |
| |
\\ | \\ |
====Upload file settings==== | ====Upload file settings==== |
**Description:** Upload a local file to a Server space 's public folder or its sub-folder. | **Description:** Upload a local file to a Server space's public folder or its sub-folder. |
^ Setting ^ Description ^ | ^ Setting ^ Description ^ |
|Local file<sup>*</sup>|Enter or browse to the local file to upload.| | |Local file<sup>*</sup>|Enter or browse to the local file to upload.| |
|Server folder<sup>*</sup>|Enter or browse to the Server folder to upload the file to. Leave this field blank to upload to the root folder.| | |Server folder<sup>*</sup>|Enter or browse to the Server folder to upload the file to. Leave this field blank to upload to the root folder.| |
|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 a 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]]. |
| |
|Server file<sup>*</sup>|Enter or browse to the file on the Server to be downloaded.| | |Server file<sup>*</sup>|Enter or browse to the file on the Server to be downloaded.| |
|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 a 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]]. |
| |
|Folder<sup>*</sup>|Select the folder in the Server space to create the file list from. Leave this field blank for the root folder.| | |Folder<sup>*</sup>|Select the folder in the Server space to create the file list from. Leave this field blank for the root folder.| |
|Columns|Select the details of the found files to be included in the dataset. Each detail produces a column. 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 produces a column. 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]]. |
| |
| \\ |
| ====List folders settings==== |
| **Description:** Produce a list of subfolders under the selected folder, in a Server space. Each selected property creates a column in the dataset. |
| ^ Setting ^ Description ^ |
| |Folder<sup>*</sup>|Select the folder in the Server space to create the list of subfolders from. Leave this field blank for the root folder.| |
| |Columns|Select the details of the found subfolders to be included in the dataset. Each detail produces a column. Options: //Folder name with full path//, //Folder name only//, and //Date modified//.| |
| <sup>*</sup> Setting can be specified using a [[:parameters|parameter]]. |
| |
| \\ |
| ====List tasks settings==== |
| **Description:** Returns a list of tasks on the EasyMorph Server with a number of attributes such as task ID, project path, annotation, and schedule description. No settings are required for this command. |
| |
| \\ |
| ==== Delete folder settings==== |
| **Description:** Deletes the selected Server folder. |
| ^ Setting ^ Description ^ |
| |Server Folder<sup>*</sup>|Select the folder to be deleted.| |
| <sup>*</sup> Setting can be specified using a [[:parameters|parameter]]. |
| |
| \\ |
| ====Create folder settings==== |
| **Description:** Creates a new folder under the selected Parent folder on the EasyMorph Server. |
| ^ Setting ^ Description ^ |
| |Parent Folder<sup>*</sup>|Select the folder under which the new folder will be created.| |
| |Folder name<sup>*</sup>|Enter a name for the new folder.| |
| <sup>*</sup> Setting can be specified using a [[:parameters|parameter]]. |
| |
| \\ |
| ==== Rename folder settings==== |
| **Description:** Renames the existing, selected Server folder. |
| ^ Setting ^ Description ^ |
| |Target Folder<sup>*</sup>|Select the existing folder to change the name of.| |
| |New name<sup>*</sup>|Enter a new name for the folder.| |
| |If the folder doesn't exist|Select how EasyMoprh behaves if the selected Target folder doesn't exist. Options: //Do nothing// (the folder is not renamed and project execution continues) or //Fail// (The folder is not renamed, a warning is displayed, and project execution continues.)| |
| <sup>*</sup> Setting can be specified using a [[:parameters|parameter]]. |
| |
| \\ |
| ==== Rename file settings==== |
| **Description:** Renames the existing, selected Server file. |
| ^ Setting ^ Description ^ |
| |File path<sup>*</sup>|Select the existing file to change the name of.| |
| |New name<sup>*</sup>|Enter a new name for the file.| |
| |If the file doesn't exist|Select how EasyMorph behaves if the selected file doesn't exist. Options: //Do nothing// (no changes are made and project execution continues) or //Halt project execution// (The project will stop processing and this action will display an error.)| |
| |If a file with the new 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]]. |
| |
| \\ |
| ==== Find files recursively settings==== |
| **Description:** Builds a list of files in the specified folder and all of its subfolders. |
| ^ Setting ^ Description ^ |
| |Folder<sup>*</sup>|Select the folder within which to list the files of (including subfolders).| |
| |File name contains<sup>*</sup>|Enter any specific text within the target filenames to find. Separate multiple terms with //spaces//.| |
| |File extension(s)<sup>*</sup>|Enter any specific file extensions to find within the filename. Separate multiple terms with //spaces//.| |
| |
<sup>*</sup> Setting can be specified using a [[:parameters|parameter]]. | <sup>*</sup> Setting can be specified using a [[:parameters|parameter]]. |
| |
|Overwrite|The new file replaces the original file.| | |Overwrite|The new file replaces the original file.| |
|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.| |
| |
| \\ |
| ====Folder already exists options==== |
| ^Option ^Description ^ |
| |Do nothing|No change (rename, create, delete) is made to the target folder.| |
| |Fail|The folder is not renamed, a warning is displayed, and project execution continues.| |
|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.| |
| |
| |