Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from space WDESIGNER and version 22.2a

...

AttributeTypeDescriptionValues/Example
headersArray of HeaderFieldAll HTTP response header fields as an array of HeaderField classes containing name/value pairs.
statusCodeIntegerThe resulting HTTP status code. If not set explicitly using this object, the service returns 200 if no exception occurred, or 500 otherwise.404
errorObjectAnyObject of the type defined with stereotype <<RESTError>>.

RequestOptions

Multiexcerpt
MultiExcerptNameRequestOptions
shouldDisplayInlineCommentsInIncludesfalse
AttributeTypeDescriptionAllowed Values/Example
additionalHeadersArray of HeaderFieldAll REST request header fields as an array of HeaderField classes containing name/value pairs.
optionsArray of Option

Specify native cURL options as listed in Setting cURL Options on the URL Adapter .

Use one of the following syntax rules:

  • values separated by ',' in one line
  • values separated by ' ' in one line
  • list of tagged values

sslSSLUse this parameter to supply SSL information.
proxyProxyUse this parameter to supply necessary proxy information.
additionalQueryParametersArray of Parameter Use this parameter to provide additional query parameters to the REST service call.
followRedirectsIntegerSpecify here the maximum number of redirects to follow.any integer
basicAuthAuthenticationThis parameter provides an object of type Authentication containing the user and the password.
basePathStringOverwrite here the base path of the REST service.

a valid path, e.g. /support

hostStringOverwrite here the host running the REST service that has been defined in the component diagram.

a valid host, e.g. scheer-acme.com

portIntegerOverwrite here the port through which the REST service is accessible.a valid port number, e.g. 12345
protocol
StringOverwrite here the protocol through which the REST service is accessible.http

...

Use the HTTP protocol to access the service (default).
httpsUse the HTTPS protocol to access the service.
ignoreHttpErrors
BooleanIf true,  Default value is true.trueHTTP error codes >= 400 will not cause an exception in the

...

service (default). This implies, that the response body is accessible even if HTTP errors occur.

...

...

false
HTTP error codes >= 400 will cause an exception in the service.
jsonComposerOptionsComposerOptionsUse this parameter to specify JSON composer options on the REST call. You can use these options to e.g. overwrite jsonKeepNulls from the REST alias.Valid composer options as described below.

AdapterResponse

AttributeTypeDescriptionValues/Example
httpStatusIntegerHTTP status code of the adapter call.500
bodyBlobHTTP body of HTTP response.
responseObjectAny

Response Object of the REST adapter call.

  • If the adapter had an error, the responseObject is an <<RESTError>> class. It could be the default error class or a specific error class dependent on the <<RESTResponseDefinition>> dependencies and the HTTP status code.
  • If the adapter call had no error, the responseObject is the same as the response output parameter.

httpHeaderMapMap of EntryHeader information as a map. The map contains arrays of header value strings whereas the header name is the key of the map.
  • Header names are lowercase and treated case insensitive.
  • Multiple headers with the same name are treated as arrays.

Refer to HTTP Header Support for more information on the standard xUML HTTP headers.


Request and Response Types

Multiexcerpt
MultiExcerptNameRequest_and_Response_Types
shouldDisplayInlineCommentsInIncludesfalse
REST TypeAttributeTypeDescriptionAllowed Values/Example
AuthenticationusernameString

...

Specify a username.
passwordString

...

Specify a password.

Anchor
Certificate
Certificate
Certificate

fileString

...

Provide name of a certificate file.
typeString

...

Specify the type of the certificate file.One of PEM or DER.

Anchor
ComposerOptions
ComposerOptions
ComposerOptions

jsonKeepNullsBooleanSpecify the handling of NULL values.true

...

Keep NULL values during JSON composing.

...

falseDo not serialize NULL values during JSON composing.
jsonCompactBooleanSpecify the generated JSON format.trueSerialize to JSON without pretty-printing.
falseProduce a pretty JSON.
jsonWriteTypeDiscriminatorBooleanSpecify whether to write type information to the generated JSON.trueWrite a type discriminator to the generated JSON.
falseDo not write a type discriminator to the generated JSON.
EntrykeyStringSpecify the key of a map entry.
valueArray of AnyProvide a list of values of the map entry. The dynamic type for httpHeaderMap is String.
HTTPMethod
enumerationCan be one of the listed HTTP methods.DELETE, GET, HEAD, OPTIONS, PATCH, POST, PUT
HeaderFieldnameStringSpecify the name of the header field.
valueStringProvide a header value.

Anchor
Ke<
Ke<
Key



fileStringSpecify the name of the file that contains the private key.
typeStringSpecify the type of the private key.
passwordStringSpecify the password for the private key.

Anchor
Option
Option
Option

nameStringSpecify the name of the cURL option.
valueStringProvide a value.
ParameternameStringSpecify the name of the parameter.
valueStringProvide a value.

Anchor
Proxy
Proxy
Proxy

urlStringSpecify a URL to the proxy server.A valid URL.
typeStringSpecify a proxy typeHTTPThe proxy is a HTTP proxy.
SOCKS5The proxy is a SOCKS5 proxy.
authenticationAuthenticationSee above.

Anchor
SSL
SSL
SSL

verifyPeerStringSpecify whether to verify the peer information from the SSL connection.trueVerify the peer information (default).
falseDo not verify the peer information.
verifyHostStringSpecify whether to verify the host information from the SSL connection.OnVerify the host information (default).
OffDo not verify the host information.
ExistenceOnly check for existence of the host.
caInfoStringSpecify the name of the file that contains additional certificates for the connection verification.
certificateCertificateSpecify the certificate information (see above).
keyKeySpecify the private key information (see above).

...