User Tools

Site Tools


transformations:morphservercommand

EASYMORPH SERVER COMMAND

Category: Workflow / App/Cloud


Description

This action allows interacting with a remote EasyMorph Server using a configured EasyMorph Server connector. Currently, the action has 6 commands:

  • Run task
  • Enable/disable task
  • Upload file
  • Download file
  • Delete file
  • List files


Use cases

The action can be used to interoperate with an EasyMorph Server from Desktop projects. For example, heavy data processing can be offloaded from a low-memory desktop computer to a high-memory Server. In this case EasyMorph Server Command can be used to upload files to the Server, trigger a Server task that processes them, then download the resulting data from the Server to the local machine.

Use integrations that are set up on the Server, but not available on the local machine. In this case, the action can trigger a Server task that in turn pulls data from an external system, then download the data to the local machine.


Action settings

Setting Description
Connector*Select the preconfigured EasyMorph Server connector.
CommandSelect 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.

* Setting can be specified using a parameter.


Run task settings

Description: Runs a Server task. Task parameters can be specified in the action properties.

Setting Description
TaskSelect the Server task to run.
Don't wait for completion…Check this option to continue running the task, ignoring task errors, while the workflow continues.


Enable/disable task settings

Description: Enable or disable an EasyMorph Server task.

Setting Description
TaskSelect the Server task to enable/disable.
ModeSelect whether this action will enable or disable the selected task. Options: Enable task or Disable task.
If task was enabled/disabledChoose 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).


Upload file settings

Description: Upload a local file to a Server space 's public folder or its sub-folder.

Setting Description
Local file*Enter or browse to the local file to upload.
Server folder*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 existsSelect 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.

* Setting can be specified using a parameter.


Download file settings

Description: Download a file from a Server space to a local folder.

Setting Description
Server file*Enter or browse to the file on the Server to be downloaded.
Local folder*Enter or browse to the local folder to download the file to.
If a file with such name already existsSelect 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.

* Setting can be specified using a parameter.


Delete file settings

Description: Delete a file from a Server space.

Setting Description
Server file*Enter or browse to the file on the Server to be deleted.
If the file doesn't existSelect 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).

* Setting can be specified using a parameter.


List files settings

Description: Produce a list of files, with selected file properties, in a Server space. Each selected property creates a column in the dataset.

Setting Description
Folder*Select the folder in the Server space to create the file list from. Leave this field blank for the root folder.
ColumnsSelect 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.

* Setting can be specified using a parameter.



File already exists options

Option Description
OverwriteThe new file replaces the original file.
Do nothingNo file is downloaded/uploaded, the workflow does not halt, and no error is displayed.
Halt project executionThe project will stop processing and this action will display an error.
transformations/morphservercommand.txt · Last modified: 2021/07/04 23:09 by craigt