|
|
|
|
|
This activity starts an external program on both the Rich and Web clients.
There are several specifics for the Web client to be noted:
- Both 'allow_applets' and 'allow_exec_applet' web parameters (specified in web.xml for instance), have to be set true.
- User has to confirm the run of ActiveX in Internet Explorer and to trust the USU self-signed applet.
- A try to execute the workflow activity on the Web client with disabled usage of applets or without permission from user is reported by alert message window in the browser.
- Do not use WAIT_FOR = true on the Web client. It locks browser GUI until the program returns; the page in the browser is not refreshed until then.
Activity Parameter |
Function / Meaning |
Name |
Name of the program to be executed (e.g. 'PSpad.exe'). |
Path |
Program path to the executable file (e.g. C:\Program Files\PSPad editor). |
Args |
Arguments to be passed to the executed program, separated by spaces. Example: C:\Temp\File1.txt C:\Temp\File2.txt If the space is part of an argument value, pass "commandArray" on the input transition instead. Example1: _output.put("commandArray", ["C:\\Program Files\\PSPad editor\\PSPad.exe", '"C:\\Temp 2\\File1.txt"', '"C:\\Temp 2\\File2.txt"']) Example2: execute Visual Basic script _output.put("commandArray", ["cmd.exe", "/C", '"C:\\Temp 2\\Test.vbs"']) CommandArray overwrites values of both the path, name and args parameters. It can be PyList, ApiList, or String jarray. |
Env |
Environment variable settings in format 'name=value'. If not specified, the program will inherit the Valuemation environment settings. |
Wait |
When false, activity returns 0 on an output transition and a workflow can continue immediately after program is started. When true, workflow will be waiting until external program finishes. Activity return code will be then the exit value of the external program. Note that web client GUI is frozen util external program returns. Therefore it is recommended not to use wait = true on web client. |
Input Arguments |
Function / Meaning |
Args |
Please see the 'Activity Parameter' table above. |
CommandArray |
Please see the "Args" activity parameter above. |
Env |
Please see the 'Activity Parameter' table above. |
EnvironmentArray |
Please see the 'Env' parameter above. |
In |
Please see the common parameters/arguments. |
Name |
Please see the 'Activity Parameter' table above. |
Path |
Please see the 'Activity Parameter' table above. |
Wait |
Please see the 'Activity Parameter' table above. |
Output Arguments |
Function / Meaning |
Out |
Please see the common parameters/arguments. |
Return code |
If 'wait' is true, then the return code is an integer value returned by the executed program. If 'wait' is false, then the return code is 0. |