Class Reference
EnsLib.SOAP.InboundAdapter
Server:appadmin-00044-deployment-6bf4cbc86d-9f4xc
Instance:IRIS
User:SuperUser
 
-
  [USER] >  [EnsLib] >  [SOAP] >  [InboundAdapter]
Private  Storage

class EnsLib.SOAP.InboundAdapter extends EnsLib.TCP.InboundAdapter

Base adapter class for Automatic SOAP WebServices

Inventory

Parameters Properties Methods Queries Indices ForeignKeys Triggers
2 6 7


Summary

Properties
%CredentialsObj %PoolLimit %SplitBody %ToLowerHeaderVars
%WarnedLatest %logConnections %outIPAddr AdapterURL
AllowedIPAddresses BusinessHost CallInterval Connected
Credentials Device EnableStandardRequests IOAddr
JobPerConnection KeepaliveInterval LocalInterface OldIO
Port QSize ReadTimeout RegistryID
SSLConfig Socket StayConnected Terminators

Methods
%AddToSaveSet %ClassIsLatestVersion %ClassName %ConstructClone
%DispatchClassMethod %DispatchGetModified %DispatchGetProperty %DispatchMethod
%DispatchSetModified %DispatchSetMultidimProperty %DispatchSetProperty %Extends
%GetParameter %IsA %IsModified %New
%NormalizeObject %ObjectModified %OriginalNamespace %PackageName
%RemoveFromSaveSet %SerializeObject %SetModified %ValidateObject
AssignOneSetting ClearAllAppData ClearRuntimeAppData ClearStaticAppData
ConnectOut ConnectedSet CredentialsSet Disconnect
EnumerateSettingsClose EnumerateSettingsExecute EnumerateSettingsFetch FlushWrite
GetAddress GetSettings IsReadError IsWriteError
OnConnected OnInit OnKeepalive OnTask
OnTearDown TestConnection connectedJob faultStream
faultString


Parameters

• parameter Mode = "SW";
Override the Device Mode that will be used to open the TCP socket
• parameter SETTINGS = "EnableStandardRequests:Connection,AdapterURL:Connection";
List of properties can be set as settings in the configuration file format is a comma separated list of property names

Properties

• property %SplitBody as %Integer(VALUELIST=",0,1,2") [ InitialExpression = 0 ];
Set to 1 to enable splitting of the SOAP Body into a separate stream and excluding it from the Envelope and Headers stream. This avoids a full XML parse of the Body and also injects any namespace declarations from the Envelope into the opening Body tag. Set to 2 to do this and call ProcessBody() directly without processing any of the SOAP headers.
• property %ToLowerHeaderVars as %Boolean [ InitialExpression = 1 ];
Set this to 0 to prevent normalizing of HTTP header variable names to lowercase
• property AdapterURL as %String(MAXLEN=1000);
A specific URL for the Service to accept requests on. For SOAP Services invoked through the SOAP Inbound Adapter on a custom local port, this setting allows a custom URL to be used instead of the standard csp/namespace/classname style of URL.
• property EnableStandardRequests as %Boolean [ InitialExpression = 0 ];
Listen via the CSP WebServer, if any, in addition to listening on the custom local port.

Note that SSLConfig only applies to the custom local port. To use SSL via the CSP WebServer, you must configure the WebServer separately.

Also note that AdapterURL only applies to the custom local port. If the Service is invoked via the CSP WebServer, the ?CfgItem= URL parameter may be used to distinguish between multiple configured same-class Services but the standard csp/namespace/classname URL must be used.

• property Port as Ens.DataType.TCPAgentPort [ InitialExpression = "1980",Required ];
Local TCP port to listen on for SOAP requests (possibly in addition to listening via the CSP WebServer, if any).
• property Terminators as %String [ InitialExpression = $C(10) ];
Read-terminator character or characters, if any, for subclasses that do terminated reads.

Methods

• method OnConnected() as %Status
• method OnInit() as %Status
This user callback method is called just after %OnNew()
• classmethod faultStream(pStatus As %Status, pBHost As EnsLib.SOAP.Service, pSOAPVer As %String) as %GlobalCharacterStream
• classmethod faultString(pStatus As %Status, pBHost As EnsLib.SOAP.Service, pSOAPVer As %String = "1.1") as %String


Copyright (c) 2025 by InterSystems Corporation. Cambridge, Massachusetts, U.S.A. All rights reserved. Confidential property of InterSystems Corporation.