Availability
This routine is available starting with
- Power Scripts 2.5
- katl-commons 2.5
Syntax
lfExecuteJS(jsFilePath);
Description
Gives you the possibility to run your own javascript code.This routine gives you virtually unlimited power on Jira UI. However, note that this might not be portable across Jira versions.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| jsFilePath | String | Yes | The script source to run that contains your javascript code. The file is resolved relative to silprograms path. |
Example
For this example we will first create a file with the following javascript code and save it on the disk as hook.js.
AJS.$('#summary-val').get(0).childNodes[0].nodeValue = "Executing my javascript";
AJS.$('#descriptionmodule').hide();
Now we call the lfExecuteJS routine like in the code block below:
lfExecuteJS("hook.js"); // jsFilePath = "hook.js"
For the jsFilePath parameter you can either give the relative path (as in the example above) or the absolute path.
When this routine is called, the javascript code from hook.js is executed. This will set the summary value on the issue page and will hide the description.
Important
The file designated by the jsFilePath parameter must contain only JavaScript code. Note that this code will be inlined, so do not use single line comments!
var v = "a"; // let's show an alert alert(v);
The above script will be evaluated to
var v = "a"; // let's show an alert alert(v);
So the alert() will never be called.
See also