Witsml/> Core Application Program Interface Version 1


PUBLISH Interface - WSDL File



Download 0.54 Mb.
Page15/21
Date31.07.2017
Size0.54 Mb.
#24987
1   ...   11   12   13   14   15   16   17   18   ...   21

8.9PUBLISH Interface - WSDL File


The Web Service Description Language (WSDL) file used to expose the PUBLISH interface to SOAP clients is listed below. A narrative describing several key points follows the file listing.


IMPORTANT



In order to ensure interoperability between implementations,

the only part of the WSDL file that should normally be modified is the

location attribute of the SOAP address element.

-

Other than the location attribute, the WSDL file should be used exactly as



shown in the following file listing.
The WSDL file is also provided in the WITSML distribution media.



8.9.1File Listing




xmlns:wsdlns='http://www.witsml.org/wsdl/120'

xmlns:soap='http://schemas.xmlsoap.org/wsdl/soap/'

xmlns:xsd='http://www.w3.org/2001/XMLSchema'

xmlns='http://schemas.xmlsoap.org/wsdl/'>

WITSML Version 1.2.0 PUBLISH interface WSDL file


, and
elements -->

element declares user-defined machine and language independent data types, and is not needed for the WITSML PUBLISH interface, which uses only W3C-defined data types -->
elements define request/response messages and their parameters-->



























element groups the functions (operations) into an interface -->


elements define the function signatures (operation name and parameters) and associate the input and output messages -->






































and elements -->
specifies the protocol binding for each operation in the
section -->









encoding />







encoding />












encoding />







encoding />












encoding />







encoding />












encoding />







encoding />







specifies the portType for each binding and the URL of the service -->




8.9.2Narrative


  • The only part of the WSDL file that should normally be modified is the location attribute of the SOAP address element. This should be set to the URL of the Web Service (see implementation specifics below):




location='http://yourorg.com/yourwebservice' />




  • The WSDL file complies with Version 1.1 of the Web Services Description Language (www.w3.org/TR/wsdl)




  • The target namespace and wsdlns prefix used in the WSDL file are both declared as:

'http://www.witsml.org/wsdl/120'



targetNamespace='http://www.witsml.org/wsdl/120'

xmlns:wsdlns='http://www.witsml.org/wsdl/120'


  • A default namespace declaration is used to make the document more readable:


xmlns:wsdlns='http://www.witsml.org/wsdl/120'

xmlns:soap='http://schemas.xmlsoap.org/wsdl/soap/'

xmlns:xsd='http://www.w3.org/2001/XMLSchema'



xmlns='http://schemas.xmlsoap.org/wsdl/'>


  • The soapAction attribute of the SOAP operation elements specify a WITSML-related URI: http://www.witsml.org/action/120/Publish.WMLP_xxxx

    The soapAction attribute is used by the HTTP transport as the value of the SOAPAction HTTP header. Its use is not clear as of this writing; SOAP 1.1 states that it can be used to identify the “intent” of messages.







soapAction='http://www.witsml.org/action/120/Publish.WMLP_Subscribe' />





  • The namespace attribute of the SOAP body elements also specify a WITSML-related URI: http://www.witsml.org/message/120





soapAction='http://www.witsml.org/action/120/Publish.WMLP_Subscribe' />





namespace='http://www.witsml.org/message/120'

encoding />









  • Although XML generally ignores white-space, the values of certain XML attributes and elements may be sensitive to the amount of white-space. For example, the parameterOrder attribute of the element must have only a single space between parameters:



For an easy-to-read, understandable introduction to WSDL files, see the article titled “Web Services Description Language (WSDL) Explained” by Carlos C. Tapang - Infotects (in the Microsoft MSDN Library and elsewhere).




Download 0.54 Mb.

Share with your friends:
1   ...   11   12   13   14   15   16   17   18   ...   21




The database is protected by copyright ©ininet.org 2024
send message

    Main page