Table of Contents

Header element

Specifies a parameter of which the contents will be put in one of the headers of the HTTP request.

Type

string

Parent

Headers

Attributes

Name Type Required Description
key HttpRequestHeader Yes Specifies the key of the key/value pair.
pid unsignedInt Specifies the ID of the parameter that contains the value to be put in the header.

Remarks

  • Via HTTP, this has to be done by means of key/value pairs.

  • Feature introduced in DataMiner 7.5.7 (RN 5509).

  • A value of type string that specifies the value of the header.

  • Prior to DataMiner 9.5.8, when a DataMiner protocol uses <Parameters> or <Data> tags to send data to an HTTP server via an HTTP connection, the SLPort process always converts the data to UTF-8 (i.e. the default encoding).

    However, from DataMiner 9.5.8 (RN 17214) onwards, you can specify a character set in the Content-Type request header. It will then be up to the protocol developer to correctly encode the data sent using <Data pid="x" />.

    If, for example, you specify the following request header, the data to be sent will have to be encoded using ISO-8859-1 encoding. The SLPort process will not be doing any encoding.

    <Header key="Content-Type">text/plain; charset=ISO-8859-1</Header>

    When no charset attribute is specified, the default UTF-8 encoding will be used.

  • From DataMiner 9.6.4 (RN 20462) onwards, support for gzip and deflate compression scheme has been introduced. Therefore, HTTP requests executed from DataMiner protocols via SLPort will automatically include the following header:

    Accept-Encoding: gzip, deflate

  • For requests using the POST or PUT verb, the content length is set by DataMiner. Therefore, the Content-Length header must not be specified in the protocol.

  • DataMiner automatically includes the “User-Agent: DataMiner/1.0“ and the “Connection: Keep-Alive” headers in the requests. Therefore, these headers should not be provided in the protocol unless another header value is desired.

Examples

If you specify ...

<Header key="Content-Type">application/soap+xml; charset=utf-8</Header>
<Header key="SOAPAction">http://www.skyline.be/api/v1/ConnectApp</Header>

... this will send a SOAP envelope and parse it into the following header:

<ConnectApp xmlns="http://www.skyline.be/api/v1/">
...
</ConnectApp>
Propose changes