HTTP adapter request and response for a Delete action
The Delete action requests the server to delete the resource identified by the request URL.
The following table describes the elements of an HTTP adapter request with a Delete action:
Elements of an HTTP adapter request with a Delete action
Element | Description | Required |
---|---|---|
| Specifies the name of the adapter | No |
| Specifies the URL for the target page | Yes |
| Determines whether to establish a secure connection | No |
| Determines whether to install certificates | No |
| Specifies whether to allow unsigned certificates from trusted zones | No |
| Specifies the Java Standard Trust Keystore passphrase Warning
| No |
| Indicates the data type for the adapter response | No |
| Contains the data to be posted
| No |
| Indicates whether to use NTLM authentication for the target server for the specified user credentials | No |
| Specifies the user name required for basic authentication | No |
| Specifies the password corresponding to the user name provided for basic authentication | No |
| Specifies the supporting CharSet | No |
| Specifies an XML document that includes HTTP connection properties, which contain the | No |
| Specifies the user name required for basic or NTLM authentication specified in | No |
| Specifies the password corresponding to the user name specified in | No |
| Contains the elements that specify information about the public key (X.509 certificate) and the private key that are used for the digital signature
| No |
| Specifies the path to the JKS that contains the client certificate | Conditional; required when |
| Specifies the password of the key contained in the JKS | No |
| Specifies the password to the JKS | Conditional; required when |
| Specifies the name of the alias in the JKS that identifies the Public Key Certificate (PKC) that the web server uses to authenticate the client | Conditional; required when |
| Specifies the file containing the private key that is used to sign the HTTP request
| Conditional; required when |
| Specifies the file containing the public key (X509 Certificate)
| Conditional; required when |
| Contains an XML file specifying the private key in an Base64-encoded PEM format | Conditional; required when |
| Contains an XML file specifying the public key (X509 Certificate) in an Base64-encoded PEM format | Conditional; required when |
| Specifies whether the adapter should treat the input data in the request and the data received in the adapter response as a JavaScript Object Notation (JSON) string
| No |
<request-timeout> | Specifies the time (in seconds) to wait when establishing a connection Default value: 10 seconds. | No |
<ignore-line-break-in-response> | Specifies whether to ignore the line breaks while generating the adapter response If true, the line break markups are ignored and the response is returned as a single line. If false, the line break markers (if specified in the adapter response) are retained. Valid values: true (default), false Note: You can specify the | No |
Recommendation
The HTTP adapter supports both <httpAdapterRequest>
and <http-adapter-request>
tags for an adapter request; however, only the <httpAdapterResponse>
tag is supported for an adapter response.
BMC recommends that you use the <httpAdapterRequest>
root tag for the adapter request.
Note
The JSON string is processed only if it is contained in the <body>
, <message-body>
, or <non-xml-data-response>
elements.
XML sample of the HTTP adapter response with a JSON string in <message-body> after parsing
<httpAdapterResponse>
<metadata>
<status>success</status>
</metadata>
<status-line>
<code>200</code>
<reason>OK</reason>
</status-line>
<header-lines>
<Transfer-encoding>chunked</Transfer-encoding>
<Content-type>text/html</Content-type>
</header-lines>
<message-body>
<html lang="en-US">
<head>
<title>BBDA API</title>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
</head>
<body>
<job-approval>
<detail>dsd</detail>
<result>approve</result>
</job-approval>
<h1>Accepted request</h1>
</body>
</html>
</message-body>
</httpAdapterResponse>
XML sample of the HTTP adapter request with <data>
<httpadapterRequest>
<enable-json-conversion>true</enable-json-conversion>
<action>http://10.128.249.76:8080/DemoJSONNew/JSONServlet2</action>
<data-format></data-format>
<data>
<Demo>
<employees>
<employee>
<name>User1</name>
<age>23</age>
</employee>
<employee>
<name>User2</name>
<age>22</age>
</employee>
<employee>
<name>User3</name>
<age>22</age>
</employee>
<employee>
<name>User4</name>
<age>22</age>
</employee>
</employees>
<testing1>testing 1</testing1>
<testing2>testing 2</testing2>
<testing3>testing 3</testing3>
</Demo>
</data>
</httpadapterRequest>
XML sample of the HTTP adapter response with <data>
<httpAdapterResponse>
<metadata>
<status>success</status>
</metadata>
<status-line>
<code>200</code>
<reason>OK</reason>
</status-line>
<header-lines>
<Server>Apache-Coyote/1.1</Server>
<Content-Type>application/json</Content-Type>
<Content-Length>206</Content-Length>
<Date>Wed, 01 Aug 2012 10:38:20 GMT</Date>
</header-lines>
<message-body>
<non-xml-data-response>{"Demo":{"employees":[{"name":"ROHIT","age":"23"},{"name":"RATHI","age":"22"},{"name":"NITIN","age":"22"},{"name":"SHARMA","age":"22"}],"testing1":"testing 1","testing2":"testing 2","testing3":"testing 3"}}</non-xml-data-response>
</message-body>
</httpAdapterResponse>
Comments
Log in or register to comment.