Warning |
---|
Looking for the documentation on the newest versions of SIL Engine and the Simple Issue Language for Jira 8 for Server/Data Center? Click here ! |
Info | ||
---|---|---|
| ||
This routine is available starting with katl-commons SIL Engine™ 1.0. |
Syntax
call(sysname, silprogrampath, arguments)
Description
Excerpt |
---|
Executes another SIL SIL™ script on the current host or someother different host. |
If sysname is equal with to "local" ( or is empty "" ) it will execute the script on the current JIRA Jira server. The execution will automatically define an a variable named 'argv' which that will contain the parameters, as a string array.
You can use return to return values back to the caller; again, a . A string array only. If the call is local, current issue is available. If the call is a remote call, the current context is lost (as issue variables will have no meaning).
Parameters
Parameter name | Type | Required | Description |
---|---|---|---|
sysname | string | yes |
System name. The local system |
, Jira server machine |
, is identified by an empty string "" or by the string "local". For remote systems, it should contain the system name, as configured in the configuration page. | |||
silprogrampath | string | yes | Full path to the program being run |
. Absolute path, |
for instance "/opt/jira/home/silprograms/myprogram.sil" or "C:/Atlassian/Jira/Home/silprograms/myprogram.sil" |
. | |||
arguments | string [] | yes | The arguments, as an array of strings. |
Returns
string []
The return from the script, as an array of strings (values . Values that are returned using the return keyword).
Example
Code Block |
---|
//Local script, placed in a postfunction (for instance): string [] arrp = "param1|param2"; string [] rec; call("", "/tmp/printme.sil", arrp); //local call rec = call("system_remote", "c:/testme.sil", arrp); //remote call if(isNotNull(rec)) { //The following code prints: "Hello", "from", "remote", "jjupin" for(string s in rec) { print(s); } } |
...
Note |
---|
For remote calls, you need additional steps (see the configuration manual). Windows: We recommend you to use forward slashes "/" in paths instead of "\" since it will simplify your life. |
Resolution of the remote system goes as follows: (following, as you may define the same name for a remote system in multiple places):
- Try to see if If the name of the system is empty ('') or the string 'local' . If yes, it will call a local script.
- Next, try to find Find the name of the system as defined by REST. If it is defined, it calls the REST remote system.
- If it is not defined, fallback on SOAP.
- If it is still not defined, error will appear.
Info |
---|
Please To configure the Remote systems see the configuration page on how you should configure the Remote Systems. |
See also
Filter by label (Content by label) | ||||||||
---|---|---|---|---|---|---|---|---|
|