Table of Contents
Command Executor Processor
Purpose
Use this processor to execute command line like 'del' or 'copy'.
Use “Set STDOUT to variable” to populate your command line result to a variable.
Check “Set to error if timeout” if you want FFAStrans to set error state and display an error message.
NOTE : Setting the timeout to 0 (zero) will prevent the node from timing out.
Original Manual
This processor is what ever you want it to be. It's intended to be used with variables.
Command
Here you write the complete DOS command you want to execute. FFAStrans will always wait for the execution to end. Remember to use full paths and quotes where needed. Supports variables. Use the "%s_source%" variable to insert source media picked up by monitors or manually submitted.
Line feed (enter) will be treated as space character on execution.
To run dos-commands you might have to add "%comspec% /c" at the beginning off command with the rest of the command encapsulated with quote(").
Example(copy original):
%comspec% /c"copy "%s_original_full%""D:\MediaCopy""
PS: To mimic the deprecated "Copy failed to" set this to execute on error.
Example(replacement for the removed "Delete original" function):
%comspec% /c"del /f /q "%s_original_full%""
Example(move original):
%comspec% /c"move /y "%s_original_full%""D:\MediaMove""
Example(replacement for the "Remove monitored file record. . . " workflow function):
%comspec% /c"if exist "%s_cache_record%" del /f /q "%s_cache_record%""
WARNING: Adding the latter to a workflow will cause FFAStrans to pick up the job file in a loop if the file still exist.
FFAStrans will try to output stdout and stderr to the status monitor when possible.
PS: It's a good habit to encapsulate ALL paths with a quote (").
This node will try to read the exit code from the executed command. If the exit code is > 0 then the output status will be set to error.
Set %s_source% variable to
Enables you to define your own file as the output source for subsequent node(s). Omitted if blank.
Read std-stream to variable
Allows you to save the output from STDOUT or/and STDERR to a variable. Default is reading both.
Note: The drop down selector accepts only string variables. (%s_variable%)
Set timeout in minutes
Allows you to save specify a timeout before the command forcefully exits.
Note:FFAStrans has no way of detecting if a command is soon finished, so use with care.
Show console
If this one is enabled a command prompt window will open where you can follow the execution process. This will only work when running FFAStrans as application, not service.
Note: When this option is turned on, output is NOT displayed in the status monitor.
Omit exit code
Disregard any exit code from the executed command, effectively setting all outcomes to success.
Show executed command in status
This option will show the command in the status window. If deselected, the command will be hidden from status view.
Read as unicode
Reads the output as unicode instead of default system code page.