Skip to main content

Reference

 

OutSystems

EnhancedWebReferences API

API to dynamically change Web Service and Web Reference URLs, SOAP headers, credentials, and proxies.

Summary

Actions
ClearWebReferenceHeadersUse this action after a call to SetWebReferenceSoapHeaders to make a new Web Reference request without SOAP headers.

NOTE: since this action receives the Web Reference name as parameter, if two Web References have the same name both are affected by this action.
This only occurs in Consumer/Producer scenarios.
GetWebReferenceSoapHeadersObtain the SOAP headers sent in the response of a Web Reference call. Use this action after invoking a Web Reference action.

NOTE: since this action receives the Web Reference name as parameter, if two Web References have the same name both are affected by this action.
This only occurs in Consumer/Producer scenarios.
GetWebServiceSoapHeadersGets the SOAP headers sent to the Web Service. Use this action inside the Web Service logic.
SetWebReferenceCredencialsSets Web Reference HTTP credentials. The username can be used in the form of DOMAIN\USER.
The HTTP credentials persist for the request duration: all Web Reference calls placed during the same request use the specified credentials.
To invoke Web References in the same request without the credentials, use this action without specifying the Username and Password.

NOTE: since this action receives the Web Reference name as parameter, if two Web References have the same name both are affected by this action.
This only occurs in Consumer/Producer scenarios.
SetWebReferenceProxySpecifies a proxy through which a Web Reference action can be invoked.
This action allows specifying the credentials to authenticate in the proxy. The specified proxy persists for the request duration: all Web Reference calls placed during the same request use that proxy.
To invoke Web References in the same request using the default internet configurations, use this action without specifying the ProxyURL.

NOTE: since this action receives the Web Reference name as parameter, if two Web References have the same name both are affected by this action.
This only occurs in Consumer/Producer scenarios.
SetWebReferenceSoapHeadersSets SOAP headers to be used in Web Reference calls.
The SOAP headers persist for the request duration: all Web Reference calls placed during the same request use the specified headers.
To invoke Web References in the same request without the SOAP headers, use the ClearWebReferenceHeaders action.

NOTE: since this action receives the Web Reference name as parameter, if two Web References have the same name both are affected by this action.
This only occurs in Consumer/Producer scenarios.
SetWebReferenceURLSets another effective URL for the Web Reference
The specified URL persists for the request duration: all Web Reference calls placed during the same request use the URL.
To invoke Web References in the same request using the default URL, use this action without specifying the URL.

NOTE: since this action receives the Web Reference name as parameter, if two Web References have the same name both are affected by this action.
This only occurs in Consumer/Producer scenarios.
SetWebServiceSoapHeadersSets the SOAP headers to be sent by the Web Service in the response. Use this action inside the Web Service Logic.

Structures
SOAPHeader 

Actions

ClearWebReferenceHeaders

Use this action after a call to SetWebReferenceSoapHeaders to make a new Web Reference request without SOAP headers.

NOTE: since this action receives the Web Reference name as parameter, if two Web References have the same name both are affected by this action.
This only occurs in Consumer/Producer scenarios.

Inputs

WebReferenceName
Type: Text. Mandatory.
The Name of the WebReference In Service Studio (#assert NameExists WebReference)

GetWebReferenceSoapHeaders

Obtain the SOAP headers sent in the response of a Web Reference call. Use this action after invoking a Web Reference action.

NOTE: since this action receives the Web Reference name as parameter, if two Web References have the same name both are affected by this action.
This only occurs in Consumer/Producer scenarios.

Inputs

WebReferenceName
Type: Text. Mandatory.
The Name of the WebReference In Service Studio (#assert NameExists WebReference)

Outputs

SoapHeaders
Type: RecordList of SOAPHeader.
Structure representing the SOAP headers.

GetWebServiceSoapHeaders

Gets the SOAP headers sent to the Web Service. Use this action inside the Web Service logic.

Outputs

SoapHeaders
Type: RecordList of SOAPHeader.
Structure representing the SOAP headers.

SetWebReferenceCredencials

Sets Web Reference HTTP credentials. The username can be used in the form of DOMAIN\USER.
The HTTP credentials persist for the request duration: all Web Reference calls placed during the same request use the specified credentials.
To invoke Web References in the same request without the credentials, use this action without specifying the Username and Password.

NOTE: since this action receives the Web Reference name as parameter, if two Web References have the same name both are affected by this action.
This only occurs in Consumer/Producer scenarios.

Inputs

WebReferenceName
Type: Text. Mandatory.
The Name of the WebReference In Service Studio (#assert NameExists WebReference)
UserName
Type: Text. Mandatory.
Password
Type: Text. Mandatory.

SetWebReferenceProxy

Specifies a proxy through which a Web Reference action can be invoked.
This action allows specifying the credentials to authenticate in the proxy. The specified proxy persists for the request duration: all Web Reference calls placed during the same request use that proxy.
To invoke Web References in the same request using the default internet configurations, use this action without specifying the ProxyURL.

NOTE: since this action receives the Web Reference name as parameter, if two Web References have the same name both are affected by this action.
This only occurs in Consumer/Producer scenarios.

Inputs

WebReferenceName
Type: Text. Mandatory.
The Name of the WebReference In Service Studio (#assert NameExists WebReference)
ProxyURL
Type: Text. Mandatory.
ProxyUserName
Type: Text.
ProxyPassword
Type: Text.

SetWebReferenceSoapHeaders

Sets SOAP headers to be used in Web Reference calls.
The SOAP headers persist for the request duration: all Web Reference calls placed during the same request use the specified headers.
To invoke Web References in the same request without the SOAP headers, use the ClearWebReferenceHeaders action.

NOTE: since this action receives the Web Reference name as parameter, if two Web References have the same name both are affected by this action.
This only occurs in Consumer/Producer scenarios.

Inputs

WebReferenceName
Type: Text. Mandatory.
The Name of the WebReference In Service Studio (#assert NameExists WebReference)
SoapHeaders
Type: RecordList of SOAPHeader. Mandatory.
Structure representing the SOAP headers.

SetWebReferenceURL

Sets another effective URL for the Web Reference
The specified URL persists for the request duration: all Web Reference calls placed during the same request use the URL.
To invoke Web References in the same request using the default URL, use this action without specifying the URL.

NOTE: since this action receives the Web Reference name as parameter, if two Web References have the same name both are affected by this action.
This only occurs in Consumer/Producer scenarios.

Inputs

WebReferenceName
Type: Text. Mandatory.
The Name of the WebReference In Service Studio (#assert NameExists WebReference)
URL
Type: Text. Mandatory.
The URL of the new Web Reference to point to.
The Web Reference in the specified URL must be compatible with the previous one.
Generally this action is used to specify the same Web Reference as the original, made available in a different machine.

SetWebServiceSoapHeaders

Sets the SOAP headers to be sent by the Web Service in the response. Use this action inside the Web Service Logic.

Inputs

SoapHeaders
Type: RecordList of SOAPHeader. Mandatory.
Structure representing the SOAP headers.

Structures

SOAPHeader

 

Attributes
Actor
Type: Text (500).
Recipient of the SOAP header
DidUnderstand
Type: Boolean.
A value indicating whether an XML Web service method properly processed a SOAP header
Element
Type: Text (500000). Mandatory.
XML Header element for a SOAP request or response.
EncodedMustUnderstand
Type: Text (10).
Default: "0"
Value of the mustUnderstand XML attribute for the SOAP header when communicating with SOAP protocol version 1.1. Valid Values are 0, 1 , true or false
EncodedMustUnderstand12
Type: Text (10).
Default: "0"
Value of the mustUnderstand XML attribute for the SOAP header when communicating with SOAP protocol version 1.2.Valid Values are 0, 1 , true or false
EncodedRelay
Type: Text (10).
Default: "0"
Relay attribute of the SOAP 1.2 header.Valid Values are 0, 1 , true or false
MustUnderstand
Type: Boolean.
Value indicating whether the SoapHeader must be understood.
Relay
Type: Boolean.
Value that indicates whether the SOAP header is to be relayed to the next SOAP node if the current node does not understand the header.
Role
Type: Text (500).
Recipient of the SOAP header.
  • Was this article helpful?