ETSI ES 202 391-14-2008 Open Service Access (OSA) Parlay X Web Services Part 14 Presence (Parlay X 2)《开放业务接口(OSA) Parlay X互联网服务 第14部分 表示(Parlay X2)V1 3 1 包括磁盘》.pdf

《ETSI ES 202 391-14-2008 Open Service Access (OSA) Parlay X Web Services Part 14 Presence (Parlay X 2)《开放业务接口(OSA) Parlay X互联网服务 第14部分 表示(Parlay X2)V1 3 1 包括磁盘》.pdf》由会员分享，可在线阅读，更多相关《ETSI ES 202 391-14-2008 Open Service Access (OSA) Parlay X Web Services Part 14 Presence (Parlay X 2)《开放业务接口(OSA) Parlay X互联网服务 第14部分 表示(Parlay X2)V1 3 1 包括磁盘》.pdf（26页珍藏版）》请在麦多课文档分享上搜索。

1、 ETSI ES 202 391-14 V1.3.1 (2008-05)ETSI Standard Open Service Access (OSA);Parlay X Web Services;Part 14: Presence(Parlay X 2)floppy3 ETSI ETSI ES 202 391-14 V1.3.1 (2008-05) 2 Reference RES/TISPAN-01056-14-OSA Keywords API, OSA, service ETSI 650 Route des Lucioles F-06921 Sophia Antipolis Cedex -

2、FRANCE Tel.: +33 4 92 94 42 00 Fax: +33 4 93 65 47 16 Siret N 348 623 562 00017 - NAF 742 C Association but non lucratif enregistre la Sous-Prfecture de Grasse (06) N 7803/88 Important notice Individual copies of the present document can be downloaded from: http:/www.etsi.org The present document ma

3、y be made available in more than one electronic version or in print. In any case of existing or perceived difference in contents between such versions, the reference version is the Portable Document Format (PDF). In case of dispute, the reference shall be the printing on ETSI printers of the PDF ver

4、sion kept on a specific network drive within ETSI Secretariat. Users of the present document should be aware that the document may be subject to revision or change of status. Information on the current status of this and other ETSI documents is available at http:/portal.etsi.org/tb/status/status.asp

5、 If you find errors in the present document, please send your comment to one of the following services: http:/portal.etsi.org/chaircor/ETSI_support.asp Copyright Notification No part may be reproduced except as authorized by written permission. The copyright and the foregoing restriction extend to r

6、eproduction in all media. European Telecommunications Standards Institute 2008. The Parlay Group 2008. All rights reserved. DECTTM, PLUGTESTSTM, UMTSTM, TIPHONTM, the TIPHON logo and the ETSI logo are Trade Marks of ETSI registered for the benefit of its Members. 3GPPTM is a Trade Mark of ETSI regis

7、tered for the benefit of its Members and of the 3GPP Organizational Partners. ETSI ETSI ES 202 391-14 V1.3.1 (2008-05) 3 Contents Intellectual Property Rights5 Foreword.5 1 Scope 6 2 References 6 2.1 Normative references .6 3 Definitions and abbreviations.7 3.1 Definitions7 3.2 Abbreviations .8 4 De

8、tailed service description .8 4.1 Relationship to Similar or Supplanted Specifications 9 5 Namespaces9 6 Sequence diagrams.9 6.1 Interface flow overview9 7 XML Schema data type definition .11 7.1 PresenceAttributeType enumeration 11 7.2 ActivityValue enumeration 11 7.3 PlaceValue enumeration.12 7.4

9、PrivacyValue enumeration .12 7.5 SphereValue enumeration 12 7.6 CommunicationMeansType enumeration.13 7.7 CommunicationMeans structure.13 7.8 CommunicationValue structure13 7.9 OtherValue structure 13 7.10 PresenceAttribute structure 13 7.11 SubscriptionRequest structure 14 7.12 PresencePermission s

10、tructure .14 8 Web Service interface definition14 8.1 Interface: PresenceConsumer .14 8.1.1 Operation: subscribePresence .14 8.1.1.1 Input message: subscribePresenceRequest15 8.1.1.2 Output message: subscribePresenceResponse.15 8.1.1.3 Referenced faults.15 8.1.2 Operation: getUserPresence15 8.1.2.1

11、Input message: getUserPresenceRequest 15 8.1.2.2 Output message: getUserPresenceResponse .15 8.1.2.3 Referenced faults.16 8.1.3 Operation: startPresenceNotification 16 8.1.3.1 Input message: startPresenceNotificationRequest.16 8.1.3.2 Output message: startPresenceNotificationResponse16 8.1.3.3 Refer

12、enced faults.17 8.1.4 Operation: endPresenceNotification .17 8.1.4.1 Input message: endPresenceNotificationRequest17 8.1.4.2 Output message: endPresenceNotificationResponse.17 8.1.4.3 Referenced faults.17 8.2 Interface: PresenceNotification 17 8.2.1 Operation: statusChanged .18 8.2.1.1 Input message

13、: statusChangedRequest18 8.2.1.2 Output message: statusChangedResponse.18 8.2.1.3 Referenced faults.18 8.2.2 Operation: statusEnd.18 8.2.2.1 Input message: statusEndRequest .18 ETSI ETSI ES 202 391-14 V1.3.1 (2008-05) 4 8.2.2.2 Output message: statusEndResponse 18 8.2.2.3 Referenced faults.18 8.2.3

14、Operation: notifySubscription.18 8.2.3.1 Input message: notifySubscriptionRequest .19 8.2.3.2 Output message: notifySubscriptionResponse 19 8.2.3.3 Referenced faults.19 8.2.4 Operation: subscriptionEnded.19 8.2.4.1 Input message: subscriptionEndedRequest .19 8.2.4.2 Output message: subscriptionEnded

15、Response 19 8.2.4.3 Referenced faults.19 8.3 Interface: PresenceSupplier19 8.3.1 Operation: publish 19 8.3.1.1 Input message: publishRequest .20 8.3.1.2 Output message: publishResponse 20 8.3.1.3 Referenced faults.20 8.3.2 Operation: getOpenSubscriptions .20 8.3.2.1 Input message: getOpenSubscriptio

16、nsRequest20 8.3.2.2 Output message: getOpenSubscriptionsResponse.20 8.3.2.3 Referenced faults.20 8.3.3 Operation: updateSubscriptionAuthorization .20 8.3.3.1 Input message: updateSubscriptionAuthorizationRequest 21 8.3.3.2 Output message: updateSubscriptionAuthorizationResponse .21 8.3.3.3 Reference

17、d faults.21 8.3.4 Operation: getMyWatchers.21 8.3.4.1 Input message: getMyWatchersRequest .21 8.3.4.2 Output message: getMyWatchersResponse 21 8.3.4.3 Referenced faults.21 8.3.5 Operation: getSubscribedAttributes22 8.3.5.1 Input message: getSubscribedAttributesRequest 22 8.3.5.2 Output message: getS

18、ubscribedAttributesResponse .22 8.3.5.3 Referenced faults.22 8.3.6 Operation: blockSubscription .22 8.3.6.1 Input message: blockSubscriptionRequest22 8.3.6.2 Output message: blockSubscriptionResponse.22 8.3.6.3 Referenced faults.22 9 Fault definitions23 9.1 ServiceException23 9.1.1 SVC0220: No subsc

19、ription request.23 9.1.2 SVC0221: Not a watcher 23 10 Service policies 23 Annex A (normative): WSDL for Presence .24 Annex B (informative): Bibliography.25 History 26 ETSI ETSI ES 202 391-14 V1.3.1 (2008-05) 5 Intellectual Property Rights IPRs essential or potentially essential to the present docume

20、nt may have been declared to ETSI. The information pertaining to these essential IPRs, if any, is publicly available for ETSI members and non-members, and can be found in ETSI SR 000 314: “Intellectual Property Rights (IPRs); Essential, or potentially Essential, IPRs notified to ETSI in respect of E

21、TSI standards“, which is available from the ETSI Secretariat. Latest updates are available on the ETSI Web server (http:/webapp.etsi.org/IPR/home.asp). Pursuant to the ETSI IPR Policy, no investigation, including IPR searches, has been carried out by ETSI. No guarantee can be given as to the existen

22、ce of other IPRs not referenced in ETSI SR 000 314 (or the updates on the ETSI Web server) which are, or may be, or may become, essential to the present document. Foreword This ETSI Standard (ES) has been produced by ETSI Technical Committee Telecommunications and Internet converged Services and Pro

23、tocols for Advanced Networking (TISPAN). The present document is part 14 of a multi-part deliverable covering Open Service Access (OSA); Parlay X 2 Web Services, as identified below: Part 1: “Common“; Part 2: “Third Party Call“; Part 3: “Call Notification“; Part 4: “Short Messaging“; Part 5: “Multim

24、edia Messaging“; Part 6: “Payment“; Part 7: “Account Management“; Part 8: “Terminal Status“; Part 9: “Terminal Location“; Part 10: “Call Handling“; Part 11: “Audio Call“; Part 12: “Multimedia Conference“; Part 13: “Address List Management“; Part 14: “Presence“. The present document has been defined

25、jointly between ETSI, The Parlay Group (http:/www.parlay.org) and the 3GPP. The present document forms part of the Parlay X 2.2 set of specifications. The present document is equivalent to 3GPP TS 29.199-14 V6.7.0 (Release 6). ETSI ETSI ES 202 391-14 V1.3.1 (2008-05) 6 1 Scope The present document i

26、s part 14 of the Stage 3 Parlay X 2 Web Services specification for Open Service Access (OSA). The OSA specifications define an architecture that enables application developers to make use of network functionality through an open standardized interface, i.e. the OSA APIs. The present document specifi

27、es the Presence Web Service. The following are defined here: Name spaces. Sequence diagrams. Data definitions. Interface specification plus detailed method descriptions. Fault definitions. Service Policies. WSDL Description of the interfaces. 2 References References are either specific (identified b

28、y date of publication and/or edition number or version number) or non-specific. For a specific reference, subsequent revisions do not apply. Non-specific reference may be made only to a complete document or a part thereof and only in the following cases: - if it is accepted that it will be possible

29、to use all future changes of the referenced document for the purposes of the referring document; - for informative references. Referenced documents which are not found to be publicly available in the expected location might be found at http:/docbox.etsi.org/Reference. For online referenced documents

30、, information sufficient to identify and locate the source shall be provided. Preferably, the primary source of the referenced document should be cited, in order to ensure traceability. Furthermore, the reference should, as far as possible, remain valid for the expected life of the document. The ref

31、erence shall include the method of access to the referenced document and the full network address, with the same punctuation and use of upper case and lower case letters. NOTE: While any hyperlinks included in this clause were valid at the time of publication ETSI cannot guarantee their long term va

32、lidity. 2.1 Normative references The following referenced documents are indispensable for the application of the present document. For dated references, only the edition cited applies. For non-specific references, the latest edition of the referenced document (including any amendments) applies. 1 ET

33、SI TR 121 905: “Digital cellular telecommunications system (Phase 2+); Universal Mobile Telecommunications System (UMTS); Vocabulary for 3GPP Specifications (3GPP TR 21.905 version 7.2.0 Release 7)“. ETSI ETSI ES 202 391-14 V1.3.1 (2008-05) 7 2 W3C Recommendation (2 May 2001): “XML Schema Part 2: Da

34、tatypes“. NOTE: Available at http:/www.w3.org/TR/2001/REC-xmlschema-2-20010502/. 3 ETSI ES 202 391-1: “Open Service Access (OSA); Parlay X Web Services; Part 1: Common (Parlay X 2)“. 4 ETSI ES 202 915-14: “Open Service Access (OSA); Application Programming Interface (API); Part 14: Presence and Avai

35、lability Management SCF (Parlay 4)“. 5 IETF RFC 3856: “A Presence Event Package for the Session Initiation Protocol (SIP)“. http:/www.ietf.org/rfc/rfc3856.txt. 6 Void. 7 ETSI ES 202 391-13: “Open Service Access (OSA); Parlay X Web Services; Part 13: Address List Management (Parlay X 2)“. 8 IETF RFC

36、3265: “Session Initiation Protocol (SIP)-Specific Event Notification“. 9 Void. 10 ETSI ES 202 391-8: “Open Service Access (OSA); Parlay X Web Services; Part 8: Terminal Status (Parlay X 2)“. 11 ETSI ES 202 391-9: “Open Service Access (OSA); Parlay X Web Services; Part 9: Terminal Location (Parlay X

37、2)“. 3 Definitions and abbreviations 3.1 Definitions For the purposes of the present document, the terms and definitions given in ES 202 391-1 3 and the following apply: applications: for Instant Messaging, Push to Talk, or call control and other purposes may become clients of the presence Web Servi

38、ce. We assume that these applications belong to a watcher and authenticate to the services in the name of the watcher identity: represents a user in the real world NOTE: See clause 4.4.1 in ES 202 915-14 4. presence attributes: contain information about a presentity. An attribute has a name and a va

39、lue and can be supplied by any device, application or network module that can be associated to the presentitys identity. A watcher can obtains attributes only after he has successfully subscribed to them. Examples for attributes are activity, location type, communication means, etc. presence informa

40、tion: set of attributes that characterize the presentity such as current activity, environment, communication means and contact addresses. Only the system and the presentity have direct access to this information, which may be collected and aggregated from several devices associated to the presentit

41、y subscription: before a watcher can access presence data, he has to subscribe to it. One possibility the API provides is an end-to-end subscription concept, in which only identities that have accepted a subscription to their presence can be addressed. Subscriptions can be also automatically handled

42、 by server policies edited by the presentity or other authorized users. The service/protocol to manage those policies is out of the scope of the present document NOTE: This definition is not related to the term “subscription“ in TR 121 905 1. watcher and presentity: names used to denote the role of

43、the client connected to the presence services. As in Parlay/OSA PAM 4 the watcher and the presentity have to be associated to identities registered to the system, i.e. users, groups of users or organizations ETSI ETSI ES 202 391-14 V1.3.1 (2008-05) 8 3.2 Abbreviations For the purposes of the present

44、 document, the abbreviations given in ES 202 391-1 3 and the following apply: IETF Internet Engineering Task Force IMS IP Multimedia Subsystem ISC IP multimedia subsystem Service Control interface MMS Multimedia Message Service PAM Presence and Availability Management SCF Service Capability Feature

45、SIMPLE SIP for Instant Messaging and Presence Leveraging Extensions SIP Session Initiation Protocol SMS Short Message Service XCAP XML Configuration Access Protocol XML eXtensible Markup LanguageXMPP eXtensible Messaging and Presence Protocol XSD XML Schema Definition 4 Detailed service description

46、The presence service allows for presence information to be obtained about one or more users and to register presence for the same. It is assumed that the typical client of these interfaces is either a supplier or a consumer of the presence information. An Instant Messaging application is a canonical

47、 example of such a client of this interface. Figure 1 shows the architecture of the Presence Web Service and the underlying services. The Parlay/OSA PAM SCF is the straightforward option and implements the presence server with extended identity, device capability, and presence agent management. Parl

48、ay/OSA PAM allows aggregation of presence information from internet, mobile and enterprise users, etc. using a presence transport network of SIP or XMPP servers. The Presence Web Service can however communicate directly for example with IMS presence network elements (presence and resource list serve

49、rs) using the ISC (SIP/SIMPLE) protocol interface. Parlay X Address List Management Web Service Parlay/OSA PAM SCF watcher client watcher application presentity client Parlay X API Parlay X Presence Web Service Parlay/OSA API Policy rules Network protocols (e.g. SIP) Network elements (e.g. SIP) Figure 1: Presence web service environment ETSI ETSI ES 202 391-14 V1.3.1 (2008-05) 9 4.1 Relationship to Similar or Supplanted Specifications The most important relations are to: Parlay X 2 Terminal Status Web Service 10 and Pa