POST Service

Function:

The tool POST enables you to execute a HTTP POST request on a Web application which creates a resource.

Tool Attribute:

Attribute Type Description
Response Body Resource Processing [O] Selection Specifies what type of resource operation should be executed based on the returned response body.

The resource operation will use all properties mapped in the referenced response body output parameter file descriptor. This is optional, since not all resource operation types require property values to be successfully executed (e.g. DELETE will remove the selected element even if no element ID properties are specified).

Possible values:

  • COPY
  • DELETE
  • INSERT
  • INSERT_CHILD
  • MOVE
  • REFRESH
  • UPDATE

For more information on resource processing, see Tool Descriptor

Note: The Resource Processing attribute of the tool descriptor must be set to “TOOL_DEFINED” in order for the resource operation to be processed.

Media Type [M] Selection Specifies the media type that is acceptable for the response. Valid values are
  • application/json (default)
  • application/octet-stream

Note: If the accepted media type is specified via a Request Header with the key "Accept" , the header value has preference. See also:

HTTPS://WWW.W3.ORG/PROTOCOLS/RFC2616/RFC2616-SEC14.HTML#SEC14.1

Example

A POST request for creating a new project entity with Response Body Resource Processing set to INSERT_CHILD will add a new project element as a child of the currently selected element in the Application Explorer view.

Note: Many REST clients don’t return attributes of an entity created via a POST request. In these cases the desired resource operation can usually be executed by setting up Response Body Resource Processing in an additional, subsequent REST GET request

Parameters:

Parameter Name I/O Type Description
URL [M] I String URL to the POST service of the Web application
Realm [O] I String Realm enables mapping between client application and Web application. It is only relevant if an AWM application addresses different Web applications.
Request Body [O] I File File containing the post payload as expected by the Web application.
Response Body * [O] O File File containing the post response sent from the server application.
Response Code [O] O String Response Code returned by the server application.
Response Header * [O] O String Reference to a response header field of the HTTP POST request.

Additional Parameter Attributes:

Parameter Name Attribute Description
URL Query Encoding Charset used to encode the URL.
Query Separator Symbol Symbol used to separate query parameters within the URL string.
Response Body Status Code Status code to be intercepted by custom error handling. Note: Specified as a regular expression.
Response Header Name Name of the response header field.

Relationship: REST Tool Has Request Header

The relationship REST Tool Has Request Header enables you to specify a name/value pair to be sent in the HTTP request header.

If specified in an authentication request the name/value pair is sent with every HTTP request for the signed in session.

Attribute Type Description
Name String Name of the HTTP header field.
Value String Value of the HTTP header field.

Relationship: URL Has Query Parameter

The relationship URL has Query Parameter that enables you to specify parameters in the form of name/value pairs to be added to the HTTP request.

Attribute Type Description
Name String Name of the query parameter.
Value String Value of the query parameter.

Example

The following example shows a tool to start the regions of an Enterprise Server:



The service gets an empty request body as its input file descriptor:



The file descriptor for the execution of the tool (response code=200) can be modelled as follows:



The file descriptor to be used when the tool returns with a response code of 4nn (n numeric) can be modelled as follows:



Parent topic: Tool Types of the REST Function Package