GET Service

Function:

The tool GET provides support for you to execute a HTTP GET request on a Web application to get resources from a Web application.

Tool Attribute:

Attribute Type Description
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. Click here for more information on header field definitions.
Response Body Resource Processing [O] Selection Specifies what type of resource operation should be executed based on the returned response body.

The resource operation uses all properties mapped in the referenced response body output parameter file descriptor. Optional, not all resource operation types require property values to be successfully executed, for example, DELETE will remove the selected element even if no element ID properties are specified.

Attribute values:

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

See Tool Descriptor for more information on resource processing.

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

For example, a GET request for obtaining information about a project entry with Response Body Resource Processing set to UPDATE will refresh the property values of a selected project entry.

Parameters:

Parameter Name I/O Type Description
URL [M] I String URL to the GET 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 [M] I File File containing the get payload as expected by the Web application.
Response Body * [O] O File File containing the get 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 GET 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 which can be intercepted by a custom error handling.
Note: This must be specified as 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.

Relationship: REST Tool Has Status Handler

The relationship REST Tool Has Status Handler enables you to specify the handling of certain status codes returned by the tool. It overwrites a general handling of the status codes defined under the REST connection.

Attribute Type Description
Allow Loop [M] Boolean Specifies if loops are allowed in the status handler, that is, the status handler action can reference itself.

The default value is true.

Response Code Pattern [M] String Specified the response code(s) to be handled by this status handler.

Must be specified as a regular expression.

Perform Action [M] Action Descriptor Specifies which action should be performed when the status handler is triggered.
Structure Descriptor [O] File Descriptor File containing the structure for the response that is specific for the matched status code.
Workflow Execution [M] Selection Specifies the impact on the original action of the handled REST tool.

It describes how the action containing the REST tool is continued after the status handler action specified under the attribute Perform Action was executed.

Attribute values are:

Stop Execution
Stop the execution of the action that executes the REST tool.
Execute Tool Again
Execute the REST tool again and continue the execution of the action.
Continue Execution
Continue the execution of the action.

Example

The following example shows a tool that gets the regions of an Enterprise Server:


Get Regions Tools

The file descriptor that describes the response body can be modelled as follows:


Modelled Response Body