httpPost
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 !
Availability
This routine is available starting with SIL Engine™ 4.1.0.
Syntax
httpPost(url, request [, postDataObject])
Starting with SIL Engine™ 4.5.0:
httpPost(url, request [[, proxy] [, postDataObject]])
Description
Executes an HTTP POST for the given URL using the specified HttpRequest object. The posted data can be either included in the request object (as name-value parameters) or it can be added as a separate parameter (in the case of JSON, struct etc).Requests can also be sent through a proxy.
Parameters
Parameter | Type | Required | Description |
---|---|---|---|
url | string | Yes | The URL. |
request | HttpRequest | Yes | A HttpRequest object containing headers, cookies, parameters. |
proxy | HttpProxy | No | An HttpProxy object containing the host and port of the proxy server. |
postDataObject | variable: primitive type, array or struct | No | Data to be posted. |
The request parameter should have the HttpRequest type described here. The HttpProxy type is described here.
Return type
variable return type - depending on the left hand side operator type
Example
Using this routine, you can create a new ticket in the specified project for instance based on certain conditions, and pass the information for the additional fields to be filled in for this ticket too.
The following example shows how to create a JSON object, transmit it to an external application, and receive data in response. The example simulates creating a user account on another system and receiving back the user ID. This ID could then be stored in a custom field in Jira creating a reference.
Part 1 - Setting Up
This section of code defines the structs that will ultimately determine the JSON structure. The JSON structure is typically defined by the external systems API.
//Define structs struct property { string property; string value; } struct properties { property [] properties; } struct returnData { string status; string contactID; }
Part 2 - Adding Data
This section of code creates the structs and arrays and adds data to them.
//Create array/struct property [] propertyArray; property p; properties newContact; //Add data to array/struct p.property = "firstname"; p.value = "Merimas"; propertyArray += p; p.property = "lastName"; p.value = "Fairbairn"; propertyArray += p; p.property = "email"; p.value = "merimas_fairbairn@aol.com"; propertyArray += p; p.property = "company"; p.value = "Goodchild"; propertyArray += p; newContact.properties += propertyArray;
Part 3 - Sending the Post
This section of code sets up the request, posts the data to the external system, and gets the response.
//Create request HttpRequest request; HttpHeader header = httpCreateHeader("Content-Type", "application/json"); request.headers += header; //Post data and get response returnData result = httpPost("https://api.somewebsite.com/contacts/v1/contact/", request, newContact); //Return ID of newly created user return result.contactID;
Complete Script
See also