Page Comparison

...

Starting with SIL Engine™ 4.5.0: 

...

...

Description

...

Short Name

post (only when using package)

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

...

The request parameter should have the HttpRequest type described here. The HttpProxy type is described here.

Return type

...

Return Type

String

Variable return type depends on the left hand side operator type

...

.

Examples

Part 1 - Setting Up

Using this routine, you can create a new ticket in the specified project for instance based 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 receive data in response. The example simulates creating a user account on another system and receiving back 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 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;

...

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