Differences

This shows you the differences between two versions of the page.

--- commandexecutordocumentation [2022/01/09 20:11] – wikiadmin
+++ commandexecutordocumentation [2022/01/09 22:02] (current) – wikiadmin
@@ Line 13: / Line 13: @@
 {{:pasted:20220109-190630.png?width=160}}
-===Using in a Script===
+The Output of this Bean is the text which would be generated if the command were executed in a command shell or terminal.
+===Run a Simple Command===
+<note important>For Windows, you must run the "cmd /c" command shell to execute a command. The "/c" ensures that the process returns and terminates after completion, or it will appear to hang.</note>
+To get a list of png image files in directory C:\pathtoimages\myimages on Windows, enter this as the "Command"
+<code text>
+cmd /c dir C:\pathtoimages\myimages\*.png /b
+</code>
+and connect a Button to the "Trigger" input to test. The output can be displayed in a TextArea on the Design screen and should contain a list of png files in that directory.
+In Linux, the Command will be similar, but in this example we change to the images directory then get the list of png files in it:
+<code text>
+ (cd /home/myname/mypath/images && ls -a -1 *.png)
+</code>
+===Running a .sh or .bat===
+You can use the Command Executor to run a Linux .sh or Windows .bat. Example commands for Linux and Windows are:
+<code text>
+ ./reports/run_report.sh
+</code>
+<code text>
+cmd /c start  .\\reports\\run_report.bat
+</code>
+===Passing Parameters===
+An Array Value Object can be constructed (either by script or using a StringToArray, for example) and passed into the "Argument Input" trigger of the CommandExecutor. The AVO will trigger the command set in the "Command" property with the elements of the array on the command line in order that they were added to the AVO.
 ===Configuration===
@@ Line 20: / Line 53: @@
 **Command**: The command to be executed when triggered (either the "Trigger" or the "Argument Input" can be used as a trigger).
-**SQL Statement**: The SQL Statement to execute when this Bean is triggered