SoapSOIHelper Class

The SoapSOIHelper is an utility class that helps to implement SOAP request handling in SOIs.


Constructors

NameDescription
SoapSOIHelper(IServerObjectHelper, String)The SoapSOIHelper constructor should be called from the IServerObjectExtension.Init implementation.

SoapSOIHelper(IServerObjectHelper, String) Constructor

The SoapSOIHelper constructor should be called from the IServerObjectExtension.Init implementation.

1
public SoapSOIHelper (ESRI.ArcGIS.Server.IServerObjectHelper soHelper, String wsdlFilePath )
NameDescription
soHelperReference to an instance of the IServerObjectHelper interface.
wsdlFilePathFull pathname of the WSDL schema file. For example, MapServer SOIs can use the <Server install path>\framework\runtime\ArcGIS\Resources\XmlSchema\MapServer.wsdl.

Methods

NameDescription
SoapSOIHelper.AddObjectToXMLSerializeData(String, Object, String, IXMLSerializeData)Adds object to IXmlSerializeData property bag.
SoapSOIHelper.ConvertBinaryRequestToMessage(Byte[])Converts binary SOAP request to the IMessage reference via ArcGIS SOAP deserialization.
SoapSOIHelper.ConvertMessageToBinaryRequest(IMessage)Converts IMessage to binary SOAP request.
SoapSOIHelper.ConvertMessageToStringRequest(IMessage)Converts IMessage to SOAP string request.
SoapSOIHelper.ConvertStringRequestToMessage(String)Converts SOAP request string to the IMessage reference via ArcGIS SOAP deserialization.
SoapSOIHelper.CreateNewIMessage(IMessage)Creates new IMessage and sets NamespaceURI and Name properties from the provided original IMessage.
SoapSOIHelper.GetObjectFromXMLSerializeData(Int32, String, String, IXMLSerializeData)Retrieves property of the IXmlSerializeData and converts it to managed object by value.
SoapSOIHelper.GetSoapOperationParameterName(String, Int32)Gets the name of the SOAP operation parameter by SOAP operation name and parameter index.
SoapSOIHelper.GetSoapOperationParameterTypeName(String, Int32)Gets the typename of the SOAP operation parameter by SOAP operation name and parameter index.

SoapSOIHelper.AddObjectToXMLSerializeData(String, Object, String, IXMLSerializeData) Method

Adds object to IXMLSerializeData property bag.

1
2
3
4
public void AddObjectToXMLSerializeData ( String name,
    Object value,
    String typeName,
    IXMLSerializeData data )
ParameterDescription
nameProperty name.
valueProperty value
typeNameSOAP type of the property.
dataProperty data as IXMLSerializeData.

SoapSOIHelper.ConvertBinaryRequestToMessage(Byte[]) Method

Converts binary SOAP request to the IMessage reference via ArcGIS SOAP deserialization.

1
public static IMessage ConvertBinaryRequestToMessage ( byte[] request )
ParameterDescription
requestBinary request data.

SoapSOIHelper.ConvertMessageToBinaryRequest(IMessage) Method

Converts IMessage to binary SOAP request.

1
public static byte[] ConvertMessageToBinaryRequest(IMessage iMessage )
ParameterDescription
iMessageNon-null IMessage reference.

SoapSOIHelper.ConvertMessageToStringRequest(IMessage) Method

Converts IMessage to SOAP string request.

1
public static String ConvertMessageToStringRequest(IMessage iMessage)
ParameterDescription
iMessageNon-null IMessage reference.

SoapSOIHelper.ConvertStringRequestToMessage(String) Method

Converts SOAP request string to the IMessage reference via ArcGIS SOAP deserialization.

1
public static IMessage ConvertStringRequestToMessage(String request )
ParameterDescription
requestString request content.

SoapSOIHelper.CreateNewIMessage(IMessage) Method

Creates new IMessage and sets NamespaceURI and Name properties from the provided original IMessage.

1
public IMessage CreateNewIMessage(IMessage originalIMessage)
ParameterDescription
originalIMessageOriginal IMessage. Must be not null.

SoapSOIHelper.GetObjectFromXMLSerializeData(Int32, String, String, IXMLSerializeData) Method

Retrieves property of the IXmlSerializeData and converts it to managed object by value.

1
2
3
4
public Object GetObjectFromXMLSerializeData(int index,
    String typeNamespace,
    String typeName,
    IXMLSerializeData data )
ParameterDescription
indexThe index of the requested property.
typeNamespaceType namespace of the requested property. Only makes sense for the complex types.
typeNameSOAP type of the requested property.
dataReference to source IXMLSerializeData interface.

For simple types like xs:string it will return boxed value as an Object. For ArcGIS enumerations, it will return enum value as a boxed string. For complex types, it will return boxed object reference.

SoapSOIHelper.GetSoapOperationParameterName(String, Int32) Method

Gets the name of the SOAP operation parameter by SOAP operation name and parameter index.

1
public String GetSoapOperationParameterName (String operationName, int index)
ParameterDescription
operationNameSOAP operation name.
indexAn index of the requested parameter of the SOAP operation.

SoapSOIHelper.GetSoapOperationParameterTypeName(String, Int32) Method

Gets the typename of the SOAP operation parameter by SOAP operation name and parameter index.

1
public String GetSoapOperationParameterTypeName(String operationName, int index)
ParameterDescription
operationNameSOAP operation name.
indexAn index of the requested parameter of the SOAP operation.

Inheritance Hierarchy

Inheritance: ESRI.Server.SOESupport.SOI.SOIBaseESRI.Server.SOESupport.SOI.SoapSOIHelper

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.

You can no longer sign into this site. Go to your ArcGIS portal or the ArcGIS Location Platform dashboard to perform management tasks.

Your ArcGIS portal

Create, manage, and access API keys and OAuth 2.0 developer credentials, hosted layers, and data services.

Your ArcGIS Location Platform dashboard

Manage billing, monitor service usage, and access additional resources.

Learn more about these changes in the What's new in Esri Developers June 2024 blog post.

Close