Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Parameters in SIL Runner Gadget

 


Since JJUPIN 3.0.8, SIL Runner Gadget can be customized in a much user friendly way, asking parameters more nicely. 

...

                                         If no parameter script is given, the user will be able to add simple input fields for text parameters (we maintained the old functionality).Image Removed

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, you will need to 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.

Code Block
titleExample code
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 you will need to use the input type routines.

Code Block
titleExample code
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 a 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 output below: