Configure the SOAP Monitor in SAM
The are two ways to configure the SOAP Monitor:
- By loading a WSDL file.
- By entering XML code manually.
Load WSDL files
The SOAP Monitor supports the WSDL schema, which must be exposed on a URL. After the WSDL file is successfully loaded, the file is parsed automatically, the fields populate (as shown next), and you can specify values for the available arguments. There are two types of arguments: simple and complex.
-
A simple argument is one where you define the value directly.
-
A complex argument (for example, one that includes structures, classes, and lists) must be user-defined in the XML format. SolarWinds recommends that only experienced users compose complex arguments.
Advanced Settings are read-only and display additional information. Because the SOAP envelope is based on the WSDL schema, the Advanced Settings values should not be changed.
The SOAP XML field contains the SOAP envelope generated by the WSDL and dynamically changes as you change the SOAP settings. Use this field to confirm what will be sent to the web service.
If you update any base SOAP settings, the content of the SOAP XML will be regenerated and overwrite any changes made.
Manually enter XML
You can also configure a SOAP Monitor by entering XML manually, as shown in the following example that includes a complex argument placed in the Parameters field. SAM automatically takes the code and place it where it belongs in the envelope:
<tempPhoneNumber xmlns:ns2="http://schemas.xmlsoap.org/soap/encoding/" xsi:type="ns2:Array" ns2:arrayType="ns1:TemporaryPhoneNumber[3]"> <item xsi:type="ns1:TemporaryPhoneNumber"> <startDate xsi:type="xsd:int">37060</startDate> <endDate xsi:type="xsd:int">37064</endDate> <phoneNumber xsi:type="xsd:string">+1-212-5551234</phoneNumber> </item> <item xsi:type="ns1:TemporaryPhoneNumber"> <startDate xsi:type="xsd:int">37074</startDate> <endDate xsi:type="xsd:int">37078</endDate> <phoneNumber xsi:type="xsd:string">+1-212-5554321</phoneNumber> </item> <item xsi:type="ns1:TemporaryPhoneNumber"> <startDate xsi:type="xsd:int">37088</startDate> <endDate xsi:type="xsd:int">37092</endDate> <phoneNumber xsi:type="xsd:string">+1-212-5557890</phoneNumber> </item> </tempPhoneNumber>
XML can also be entered manually by typing or pasting XML.