| Info | |
|---|---|
| title | AvailabilityThis routine is available starting with Power Scripts™ Scripts™ 3.0.10 (server). |
Syntax
runnerLog(message)
or
runnerLog(message, percent, action)
or
runnerLog(message, treatAsHtml) - (since version 4.6.5)
or
runnerLog(message, treatAsHtml, percent) - (since version 4.6.5)
Description
Puts the 'message' message message on the console of a runner gadget. This is a special routine only for the Power Scripts™ Scripts™ for Jira or SIL™ SIL™ Excel Reporting and only for the runner. The use of it has no effect in other places besides for the runner.
| Note |
|---|
Starting with Power Scripts™ Scripts™ for Jira 3.0.10 (server), the runnerLog routine can also render a progress bar by specifying the percent that you want to be set. |
| Note |
|---|
The runnerLog routine can be called in the SIL Manager, but also in the Power Scripts SIL Runner Gadget. |
Parameters
Parameter | Type | Required | Description |
|---|---|---|---|
message | string | Yes | Specifies the message to be put on the runner console |
percent | number | No | Specifies the percent to be updated on the progress bar |
action | string | No | Specifies the action to be executed (so far, the only action considered is init_progressBar - to initialize the progress bar; everything else will be ignored) |
treatAsHtml | boolean | No | Specifies either to show the message as a string, or treat it and render it in the browser as HTML code. - Since version 4.6.5 |
Return type
string, can always be ignored
Example
The scripts would look like this:
...
execution_script.sil
| Code Block |
|---|
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...", 0, "init_progressBar");
runnerLog("The war will start at this date: " + start_date, 10);
runnerLog("Building tanks...");
runnerLog("Built " + tanks + " tanks.", 30);
runnerLog("Gathering infantry...");
runnerLog("Gathered " + infantry + " brave men.", 60);
runnerLog("Fueling rockets...");
runnerLog(rockets + " ready.", 90);
runnerLog("Dispatching orders...", 100);
return "Good job! The world is now at war!"; |
...
In this case, using the new runnerLog routine, when the script execution is done, the runner will look like this:
...
Example 2
The following runnerLog routine call:
...
html_runner_log.sil
| Code Block |
|---|
runnerLog("<font color='red'>This is a red text!</font>", true); |
...
Will print a red text in the runner log:
...
See also
- SIL™
- Language™