ECMA 348-2012 Web Services Description Language (WSDL) for CSTA Phase III (5th Edition).pdf

1、 Reference numberECMA-123:2009Ecma International 2009ECMA-348 5thEdition / June 2012 Web Services Description Language (WSDL) for CSTA Phase III COPYRIGHT PROTECTED DOCUMENT Ecma International 2012 Ecma International 2012 iContents Page 1 Scope 1 2 Conformance . 1 3 Normative references 1 3.1 Ecma r

2、eferences 1 3.2 World Wide Web Consortium references 2 4 Definitions 2 5 Web Services Overview 2 6 WSDL Overview . 4 6.1 Namespaces . 4 6.2 Data Types . 4 6.3 Messages . 5 6.3.1 Message Names . 5 6.3.2 Message Parts . 5 6.3.3 Negative Response Message . 5 6.3.4 Example 5 6.4 Operations 6 6.4.1 Switc

3、hing Function WSDL 6 6.4.2 Computing Function WSDL 7 6.4.3 Summary of CSTA Request/Response & Event Models and WSDL Operation Types . 8 6.5 Port Types 8 6.5.1 Example 8 6.6 Bindings . 10 6.7 Port 10 6.8 Service 10 7 Capability Exchange Services Messages and Operations . 10 7.1 Messages . 10 7.2 Oper

4、ations 13 8 System Services Messages and Operations . 15 8.1 Messages . 15 8.2 Operations 19 9 Monitoring Services Messages and Operations . 22 9.1 Messages . 22 9.2 Operations 24 10 Snapshot Services Messages and Operations . 25 10.1 Messages . 25 10.2 Operations 27 11 Call Control Features Message

5、s and Operations . 28 11.1 Messages . 28 11.2 Operations 43 12 Call Associated Features - Messages and Operations 52 12.1 Messages . 52 12.2 Operations 55 13 Media Attachment Features - Messages and Operations . 58 13.1 Messages . 58 13.2 Operations 60 ii Ecma International 201214 Routeing Features

6、- Messages and Operations .61 14.1 Messages 61 14.2 Operations 64 15 Physical Device Features - Messages and Operations .66 15.1 Messages 66 15.2 Operations 78 16 Logical Device Features - Messages and Operations85 16.1 Messages 85 16.2 Operations 96 17 Device Maintenance Events - Messages and Opera

7、tions 103 17.1 Messages . 103 17.2 Operations . 104 18 I/O Services Features - Messages and Operations . 105 18.1 Messages . 105 18.2 Operations . 111 19 Data Collection Features - Messages and Operations 115 19.1 Messages . 115 19.2 Operations . 118 20 Voice Features - Messages and Operations 120 2

8、0.1 Messages . 120 20.2 Operations . 131 21 Call Detail Record Features - Messages and Operations . 138 21.1 Messages . 138 21.2 Operations . 141 22 Location Services - Messages and Operations . 143 22.1 Messages . 143 22.2 Operations . 148 23 Vendor Specific Features - Messages and Operations. 151

9、23.1 Messages . 151 23.2 Operations . 154 24 Basic Telephony Profile Port Type Pair 156 25 Routeing Profile - Port Type Pair 159 26 Level 1a Voice Browser Profile - Port Type Pair 160 27 Level 1b Voice Browser Profile - Port Type Pair . 163 28 Level 2a Voice Browser Profile - Port Type Pair 166 29 L

10、evel 2b Voice Browser Profile - Port Type Pair . 169 30 Minimal uaCSTA Call Control Profile Port Type . 172 31 Basic uaCSTA Call Control Profile Port Type Pair . 174 32 Advanced uaCSTA Call Control Profile Port Type Pair . 178 33 Conferencing uaCSTA with Basic Call Control Profile Port Type Pair 183

11、 34 Conferencing uaCSTA with Advanced Call Control Profile Port Type Pair . 187 35 Basic uaCSTA Device Feature with Basic Call Control Profile Port Type Pair . 193 36 Basic uaCSTA Device Feature with Advanced Call Control Profile Port Type Pair 198 37 Speaker uaCSTA Device Feature with Basic Call Co

12、ntrol Profile Port Type Pair . 204 38 Speaker uaCSTA Device Feature with Advanced Call Control Profile Port Type Pair . 209 Ecma International 2012 iiiAnnex A (normative) Event Channel Establishement . 215 A.1 General . 215 A.2 Event Channel from Switching Function 216 A.2.1 ECMA-269 7.1 Implicit As

13、sociation 217 A.2.2 ECMA-269 7.2 Implicit Association 217 A.3 Event Channel from Session 217 A.4 Event Channel from Event Sources in Switching Function (Option) . 217 Annex B (informative) Example SOAP 1.1/HTTP Binding . 221 Annex C (informative) WSDL Considerations 223 Annex D (informative) Summary

14、 of Changes in this Edition 225 iv Ecma International 2012 Ecma International 2012 vIntroduction This Standard defines a Web Services Description Language (WSDL) for Phase III of Computer Supported Telecommunications Applications (CSTA). This Standard is part of a Suite of Standards and Technical Re

15、ports for Phase III of CSTA. All of the Standards and Technical Reports in the Suite are based upon the practical experience of Ecma member companies and each one represents a pragmatic and widely based consensus. This 5th Edition of ECMA-348 is fully aligned with ECMA-269 9th Edition and it imports

16、 the CSTA XML schemata from ECMA-323 6th Edition. This edition introduces WS-Eventing to establish event channels and implicit associations, and recasts outbound operations into inbound operations in the Computing Function WSDL. This change is fully conformant to WS-I and supports SOAP/HTTP as a com

17、plete binding of the WSDL. This Ecma Standard has been adopted by the General Assembly of June 2012. vi Ecma International 2012WSDL Tools Acknowledgement The WSDL definition files, for the computing function, switching function and common messages, reflecting the WSDL specifications in this Standard

18、 have been verified using the XML SPY tool. Ecma International 2012 vii“COPYRIGHT NOTICE This document may be copied, published and distributed to others, and certain derivative works of it may be prepared, copied, published, and distributed, in whole or in part, provided that the above copyright no

19、tice and this Copyright License and Disclaimer are included on all such copies and derivative works. The only derivative works that are permissible under this Copyright License and Disclaimer are: (i) works which incorporate all or portion of this document for the purpose of providing commentary or

20、explanation (such as an annotated version of the document), (ii) works which incorporate all or portion of this document for the purpose of incorporating features that provide accessibility, (iii) translations of this document into languages other than English and into different formats and (iv) wor

21、ks by making use of this specification in standard conformant products by implementing (e.g. by copy and paste wholly or partly) the functionality therein. However, the content of this document itself may not be modified in any way, including by removing the copyright notice or references to Ecma In

22、ternational, except as required to translate it into languages other than English or into a different format. The official version of an Ecma International document is the English language version on the Ecma International website. In the event of discrepancies between a translated version and the o

23、fficial version, the official version shall govern. The limited permissions granted above are perpetual and will not be revoked by Ecma International or its successors or assigns. This document and the information contained herein is provided on an “AS IS“ basis and ECMA INTERNATIONAL DISCLAIMS ALL

24、WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION HEREIN WILL NOT INFRINGE ANY OWNERSHIP RIGHTS OR ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.“ Ecma International 2012 1Web Services Description Language (WSDL)

25、 for CSTA Phase III 1 Scope Web Services Description Language (WSDL) is an XML schema for describing Web services and how they can be accessed by Web based applications. WSDL facilitates the creation and deployment of web based applications. For example, by using WSDL with many industry Web services

26、 development environments, a web services developer can access features provided by an implementation without knowing details of the network or underlying transport protocols. This Standard specifies two WSDL documents: Computing Function WSDL and Switching Function WSDL, for ECMA-269, Services for

27、Computer Supported Telecommunications Applications (CSTA) Phase III. All CSTA features (e.g., services and events) specified in ECMA-269 are specified in this Standard. This Standard specifies pairs of port types, one from the Computing Function WSDL and one from the Switching Function WSDL, for all

28、 the profiles specified in ECMA-269. A full WSDL document contains both abstract definitions (WSDL messages and port type elements) and concrete protocol specific definitions (WSDL bindings, ports, and service elements). This CSTA WSDL Standard specifies only the abstract definitions of a WSDL docum

29、ent. The concrete and protocol specific definitions are implementation specific and are outside the scope of this Standard. Annex B illustrates an example SOAP over HTTP binding. WSDL is defined in XML and XML Schemata. This Standard builds upon the XML data types and imports all message formats spe

30、cified in ECMA-323. Annex A specifies mechanisms to establish event channels based on WS-Eventing. The event channels allow the Switching Function and Computing Function to be both a Service Requester and a Service Provider. 2 Conformance In addition to the conformance requirements specified in Clau

31、se 2 of ECMA-269 and Clause 2 of ECMA-323, a conformant implementation supports at least one pair of the port types defined in this Standard. Each port type pair in this Standard corresponds to a profile specified in 2.3.1 of ECMA-269. To support one pair of these port types, an implementation must

32、support all the WSDL operations specified in the port type pair. A conformant implementation supports an operation by adhering to the corresponding service definition in ECMA-269 and by using the message formats and data types as specified in ECMA-323. A conformant implementation also supports the e

33、vent channel establishment specified in Annex A. 3 Normative references The following referenced documents are indispensable for the application of this document. For dated references, only the edition cited applies. For undated references, the latest edition of the referenced document (including an

34、y amendments) applies. 3.1 Ecma references ECMA-269, Services for Computer Supported Telecommunications Applications (CSTA) Phase III, 9th Edition (December 2011) 2 Ecma International 2012ECMA-323 XML Protocol for Computer Supported Telecommunications Applications (CSTA) Phase III, 6th Edition (Dece

35、mber 2011) ECMA-366 WS-Session - Web Services for Application Session Services, 3rd Edition (December 2011) ECMA TR/72 Glossary of Definitions and Terminology for Computer Supported Telecommunications Applications (CSTA) Phase III, 3rd Edition (June 2000) 3.2 World Wide Web Consortium references SOA

36、P 1.1, Simple Object Access Protocol (SOAP) 1.1, W3C Note 08 May 2000 XML 1.0, Extensible Markup Language (XML) 1.0 (Second Edition), W3C Recommendation 06 October 2000 XML Schema 1.0, XML Schema Language Part 1: Structures. W3C Recommendation 2 May 2001 and XML Schema Language Part 2: Datatypes. W3

37、C Recommendation 2 May 2001 WSDL 1.1, Web Services Description Language (WSDL) 1.1, W3C Note 15 March 2001 WS-Addressing, Web Services Addressing 1.0 Core, ISO/IEC 40240 Web Services Addressing 1.0 - SOAP Binding, ISO/IEC 40250 Web Services Addressing 1.0 Metadata, ISO/IEC 40260 WS-Eventing, Web Ser

38、vices Eventing (WS-Eventing) W3C Recommendation 13 December 2011 4 Definitions CSTA-specific terminology is defined in ECMA TR/72. 5 Web Services Overview A Web service is the name for a service that is accessed by applications over the Internet. Conceptually this corresponds to a CSTA application (

39、client) invoking services provided by a CSTA implementation (server) in a distributed environment. Web services are more formally defined as: “encapsulated, loosely coupled contracted functions offered via standard protocols” where: Encapsulated means the implementation of the function is never seen

40、 from the outside Loosely coupled means changing the implementation of one function does not require a change of the invoking function and Contracted means there are publicly available descriptions of the functions behaviour, how to bind to the function as well as its input and output parameters. Th

41、e goal of Web services is a seamless integration of services across the different technologies (networks, software, hardware, etc.) available on the Internet. Web services require: 1. A standard way to represent data 2. A common, extensible message format 3. A common, extensible service description

42、language Ecma International 2012 34. A common way to discover service providers The first two requirements, a standard way to represent data and a common extensible message format, have already been achieved with ECMA-323. The ECMA-323 Standard includes extensible XML schemas for all of the categori

43、es of services defined in ECMA-269. NOTE This Standard satisfies the third requirement, a common, extensible service description language, by providing WSDL definitions for CSTA. UDDI (Universal Discovery, Description, and Integration Registry) and other procedures to satisfy the forth requirement a

44、re outside the scope of this Standard. There are three components involved with Web services: Service Requester provides the following major functions: 1) optionally queries a Service Broker for where to find a suitable Service Provider and 2) binds and interacts with a Service Provider. Service Pro

45、vider provides the following major functions: 1) publishes its services (e.g. WSDL document) and 2) interacts with a Service Requester. Service Broker acts as a look up service between a Service Provider and a Service Requester. A Service Broker is an optional component of a Web service. For the pur

46、poses of this Standard: A CSTA Service Requester is a Service Requester. A CSTA Service Provider is a Service Provider. A Service Broker is outside the scope of this Standard. A WS-SF is a Switching Function that acts as a CSTA Service Requester and Provider. A WS-CF is a Computing Function that act

47、s as a CSTA Service Requester and Provider. 4 Ecma International 20126 WSDL Overview WSDL enables applications to communicate with each other in an automated way. A WSDL document describes Web services both in an abstract (network independent) and concrete (with network protocol bindings, e.g. SOAP)

48、 way. A WSDL document consists of sets of definitions. There are six major elements in a WSDL document: types provides the data type definitions used to describe the messages exchanged message defines the messages contents operation defines how input and output messages are associated with a logical

49、 operation portType groups a set of operations together binding specifies concrete protocol and data format specifications for the operations and messages for a particular portType port specifies an address for a binding service used to group a set of related ports For interoperability, this Standard disallows WSDL 1.1 Notification and Solicit-response operations. Instead, this Standard uses a Switching Function WSDL to represent the Switching Function Services defined in ECMA-269