Parameters in SIL™ Runner Gadget

Parameters in SIL™ Runner Gadget

You can customize the SIL™ Runner Gadget in a more user friendly way by setting up the following components:

• Name - name of the configuration
• Description - description of the configuration
• Execution script - script that will be executed 
• Parameter script - optional script that will dynamically insert the advanced parameter fields on the configuration run screen. 

If no parameter script is given, the user will be able to add simple input fields for the text parameters (we maintained the old functionality). In order to not show any kind of input for the parameters, use an empty script.

Example

The execution script is the script that will be executed. If there are any parameters declared in the parameter script, their values will be received and interpreted here. In order to get the values of the parameters, use the parameter retrieval routines. 

In our case, the execution script uses the runnerLog routine and can return as many values as you need, regardless of their type.

date start_date = gadget_getDateValue(argv, "Start Date");
string tanks = gadget_getSingleValue(argv, "Tanks");
string infantry = gadget_getSingleValue(argv, "Infantry");
string rockets = gadget_getMultiValues(argv, "Rockets");
runnerLog("Preparing to start a war...");
runnerLog("The war will start at this date: " + start_date);
runnerLog("Building tanks...");
runnerLog("Built " + tanks + " tanks.");
runnerLog("Gathering infantry...");
runnerLog("Gathered " + infantry + " brave men.");
runnerLog("Fueling rockets...");
runnerLog(rockets + " ready.");
runnerLog("Dispatching orders...");
return "Good job! The world is now at war!";

The parameter script contains the declaration of the parameters that will be used in the execution script. In order to declare the parameters, use the input type routines.

gadget_createDatePicker("Start Date", currentDate(), true, "Choose a start date");
gadget_createInput("Tanks", "500", true, "The number of tanks");
gadget_createInput("Infantry", "1600", true, "The number of tanks");
gadget_createCheckboxGroup("Rockets", {"A big one", "A lot of small ones"}, "", false, "Do you want to use rockets?");

The parameters can be set to default values, which can be edited before running the execution script. Using the scripts above, the SIL™ Runner Gadget will look like this:

The execution of the script above produces the following output: