영문단체표준
제정일: 2005년 12월 21일
TTAx.xx-xx.xxxx
개정일: 2006년 xx월 xx일
TTA English Standard
개방형 서비스 액세스를 위한 Parlay X
웹서비스; Part 14: 프레즌스
(Open Service Access(OSA); Parlay X Web
Services; Part14: Presence)
영문단체표준
제정일: 2005년 12월 21일
개정일: 2006년 xx월 xx일
TTAx.xx-xx.xxxx
개방형 서비스 액세스를 위한 Parlay X
웹서비스; Part 14: 프레즌스
(Open Service Access(OSA); Parlay X Web Services; Part14: Presence)
본 문서에 대한 저작권은 TTA 에 있으며, 이 문서의 전체 또는 일부에 대하여 상업적
이익을 목적으로 하는 무단 복제 및 배포를 금합니다.
Copyrightⓒ Telecommunications Technology Associations(2005). All Rights Reserved.
영문단체표준
서 문
1. 표준의 목적
본 표준은 Parlay X 웹 서비스의 프레즌스를 규정하는 것으로 제1판 (TTAE.ETES.202391-14)에서 참조한 국제표준에 기술되었던 Parlay X API v2.0의 Part 14 이 개정되었
기에 국내표준을 개정한다.
2. 주요 내용 요약
본 표준은 BcN 개방형 서비스 망 구축에 필요한 개방형 서비스 게이트웨이인 Parlay X
게이트웨이 (gateway)와 Parlay X 응용 서버 (application server) 간에 적용되는 개방형
서비스 액세스 Parlay X API 중 프레즌스 (Presence)에 대하여 기술한다. 프레즌스 웹
서비스를 위해서, 네임스페이스, 순서도, 데이터 및 장애 정의, 인터페이스 규격에
상세한 방법 서술을 추가, 서비스 정책과 인터페이스에 대한 WSDL 서술을 내용으로
한다.
3. 표준 적용 산업 분야 및 산업에 미치는 영향
본 표준은 IT 개발자들이 통신망에 대한 전문지식이 없어도 통신망을 이용하는 서비스
를 용이하게 개발할 수 있도록 표준화된 인터페이스를 제공함으로써, 개방형 서비스 액
세스 인터페이스를 사용한 서비스 개발 시에 발생할 수 있는 혼란을 최소화하고 통신망
기반 응용 서비스가 통신망에 독립적으로 개발될 수 있도록 한다.
따라서, 통신망 기반 응용 서비스들의 비즈니스 모델 및 시장의 한계를 극복하고 더불
어 개방형 인터페이스 관련 기술의 발전과 관련 응용 서비스 활성화에 기여한다.
4. 참조 표준(권고)
4.1 국외표준(권고)
- ETSI ES 202 391-14 v1.2.1
- 3GPP TS 29.199-14 V6.4.0
4.2 국내표준
-TTAE.ET-ES.202391-14
5. 참조표준(권고)과의 비교
5.1 참조표준(권고)과의 관련성
i
TTAx.xx-xx.xxxx
영문단체표준
본 표준은 참조한 국외표준의 개정된 내용을 준용한 국내 표준이다. 국외 표준의
표준화 일정은 아래의 그림 1 을 따른다.
그림 1. OPEN API 표준화 로드맵
5.2 참조한 표준(권고)과 본 표준의 비교표
TTAx.xx-xx.xxxx
ETSI ES 202 391-14 v1.2.1
비고
1. 범위
1. Scope
동일
2. 참고문헌
2. References
동일
3. 정의와 약어
3. Definitions and abbreviations
동일
4. 상세한 서비스 서술
4. Detailed Service Description
동일
5. 네임스페이스
5. Namespaces
동일
6. 순서도
6. Sequence Diagrams
동일
7. XML 스키마 데이터 형 정의
7. XML Schema data type definition
동일
8. 웹 서비스 인터페이스 정의
8. Web Service interface definition
동일
9. 장애 정의
9. Fault definitions
동일
10. 서비스 정책
10. Service policies
동일
부록 A. 프레즌스 관리를 위한 WSDL
Annex A. WSDL for Presence
동일
부록 B. 참고문헌 목록
Annex B. Bibliography
동일
ii
TTAx.xx-xx.xxxx
영문단체표준
1 판과 2 판의 비교표
TTAx.xx-xx.xxxx
TTAE.ET-ES.202391-14
비고
1. 범위
1. 범위
동일
2. 참고문헌
2. 참고문헌
동일
3. 정의와 약어
3. 정의와 약어
동일
4. 상세한 서비스 서술
4. 상세한 서비스 서술
동일
5. 네임스페이스
5. 네임스페이스
동일
6. 순서도
6. 순서도
동일
7. XML 스키마 데이터 형 정의
7. XML 스키마 데이터 형 정의
동일
8. 웹 서비스 인터페이스 정의
8. 웹 서비스 인터페이스 정의
Response 필드의
이름을 result 로
변경,
파라메터 설명보완
9. 장애 정의
9. 장애 정의
10. 서비스 정책
10. 서비스 정책
동일
설명보완
부록 A. 프레즌스 관리를 위한 WSDL 부록 A. 프레즌스 관리를 위한 WSDL
동일
부록 B. 참고문헌 목록
동일
부록 B. 참고문헌 목록
6. 지적재산권 관련사항
Parlay의 IPR 정책에 따른다.
7. 적합인증 관련사항
7.1 적합인증 대상 여부
해당사항 없음.
7.2 시험표준제정여부(해당 시험표준번호)
해당사항 없음
8. 표준의 이력
판수
제/개정일
제․개정내역
제1판
2005.12.21
제정
제2판
2006
개정
iii
TTAx.xx-xx.xxxx
영문단체표준
Preface
1. The Purpose of Standard
The present document specifies the Presence of the Parlay X Web Services and is to be revised the
Presence part in international standard by the first edition (TTAE.ET-ES.202391-14) had been
updated.
2. The summary of contents
The present document describes a Parlay X API Address Presence applied to the interface between
the Parlay X gateway and Parlay X application server for open service access of BcN as follows:
namespace, sequence diagram, data definitions, faults definitions, service policies, and WSDL
description of the interfaces.
3. Applicable fields of industry and its effect
The present document provides standardized interface so enables IT developers who are not experts
in telecommunication networks to develop services which use telecommunication networks easily.
The present document may minimize confusion that can happen in service development that uses
Open Service Access interface and makes it possible that developers make those services without
concerning telecommunication networks.
Hence, the business models for those services can break their own market boundary limitations in
addition; present document contributes to the evolution of related technologies on Open Service
interfaces and service market.
4. Reference Standards (Recommendations)
4.1 International Standards (Recommendations)
- ETSI ES 202 391-14 v1.2.1
- 3GPP TS 29.199-14 V6.4.0
4.2 Domestic Standards
-TTAE.ET-ES.202391-14
5. Relationship to Reference Standards (Recommendations)
iv
TTAx.xx-xx.xxxx
영문단체표준
5.1 The relationship of Reference Standards
The present document is compliant to international standards which are referenced. The Figure 1
shows the status of standardizing roadmap.
Figure 1. OPEN API Standardization Roadmap
5.2 Differences between Reference Standard (recommendation) and this standard
TTAx.xx-xx.xxxx
ETSI ES 202 391-14 v1.2.1
Etc.
1. Scope
1. Scope
Same
2. References
2. References
Same
3. Definitions and abbreviations
3. Definitions and abbreviations
Same
4. Detailed Service Description
4. Detailed Service Description
Same
5. Namespaces
5. Namespaces
Same
6. Sequence Diagrams
6. Sequence Diagrams
Same
7. XML Schema data type definition
7. XML Schema data type definition
Same
8. Web Service interface definition
8. Web Service interface definition
Same
9. Fault definitions
9. Fault definitions
Same
10. Service policies
10. Service policies
Same
Annex A. WSDL for Presence
Annex A. WSDL for Presence
Same
Annex B. Bibliography
Annex B. Bibliography
Same
v
TTAx.xx-xx.xxxx
영문단체표준
Differences between 1st Edition and 2nd Edition
TTAx.xx-xx.xxxx
TTAE.ET-ES.202391-14
Etc.
1. Scope
1. Scope
Same
2. References
2. References
Same
3. Definitions and abbreviations
3. Definitions and abbreviations
Same
4. Detailed Service Description
4. Detailed Service Description
Same
5. Namespaces
5. Namespaces
Same
6. Sequence Diagrams
6. Sequence Diagrams
Same
7. XML Schema data type definition
7. XML Schema data type definition
8. Web Service interface definition
8. Web Service interface definition
9. Fault definitions
9. Fault definitions
Same
10. Service policies
10. Service policies
Modification
Annex A. WSDL for Presence
Annex A. WSDL for Presence
Same
Annex B. Bibliography
Annex B. Bibliography
Same
Same
Modification
6. The Statement of Intellectual Property Rights
It follows Parlay's Intellectual Property Rights (IPRs).
7. The Statement of Conformance Testing and Certification
None
8. The History of Standard
Edition
Issue Date
Contents
The 1st Edition
2005.12.21
Established
The 2nd Edition
2006
to be revised
vi
TTAx.xx-xx.xxxx
영문단체표준
목차
지적재산권 ............................................................................................................................................................１
머리말....................................................................................................................................................................１
1
범위................................................................................................................................................................３
2
참고문헌 ........................................................................................................................................................３
3
정의와 약어 ..................................................................................................................................................４
3.1
정의....................................................................................................................................................... ４
3.2
약어....................................................................................................................................................... ５
4
상세 서비스 서술 ........................................................................................................................................５
5
네임스페이스 ................................................................................................................................................７
6
순서도 ............................................................................................................................................................７
6.1
인터페이스 플로우 개요 .................................................................................................................... ７
XML 스키마 데이터 형 정의....................................................................................................................９
7
7.1
PRESENCEATTRIBUTETYPE ENUMERATION ............................................................................................ ９
7.2
ACTIVITYVALUE ENUMERATION ............................................................................................................ ９
7.3
PLACEVALUE ENUMERATION ............................................................................................................. １０
7.4
PRIVACYVALUE ENUMERATION .......................................................................................................... １０
7.5
SPHEREVALUE ENUMERATION ............................................................................................................ １１
7.6
COMMUNICATIONMEANSTYPE ENUMERATION ................................................................................... １１
7.7
COMMUNICATIONMEANS STRUCTURE ............................................................................................... １１
7.8
COMMUNICATIONVALUE STRUCTURE ................................................................................................ １２
7.9
OTHERVALUE STRUCTURE ................................................................................................................. １２
7.10
PRESENCEATTRIBUTE STRUCTURE ..................................................................................................... １２
7.11
SUBSCRIPTIONREQUEST STRUCTURE ................................................................................................. １２
7.12
PRESENCEPERMISSION STRUCTURE.................................................................................................... １３
웹 서비스 인터페이스 정의 ...................................................................................................................１３
8
8.1
PRESENCECONSUMER 인터페이스................................................................................................... １３
8.2
PRESENCENOTIFICATION 인터페이스 .............................................................................................. １７
8.3
PRESENCESUPPLIER 인터페이스 ...................................................................................................... ２０
장애 정의 ..................................................................................................................................................２４
9
9.1
10
서비스 예외 ..................................................................................................................................... ２４
서비스 정책 ..........................................................................................................................................２４
부록 A (NORMATIVE): 프레즌스를 위한 WSDL ....................................................................................２５
vii
TTAx.xx-xx.xxxx
영문단체표준
부록 B (INFORMATIVE): 참고문헌 목록 ..................................................................................................２６
연혁....................................................................................................................................................................２７
영문단체표준해설서 ......................................................................................................................................... 2 8
viii
TTAx.xx-xx.xxxx
영문단체표준
Contents
INTELLECTUAL PROPERTY RIGHTS .........................................................................................................１
FOREWORD........................................................................................................................................................１
1
SCOPE ..........................................................................................................................................................３
2
REFERENCES .............................................................................................................................................３
3
DEFINITIONS AND ABBREVIATIONS ..................................................................................................４
3.1
DEFINITIONS .......................................................................................................................................... ４
3.2
ABBREVIATIONS ..................................................................................................................................... ５
4
DETAILED SERVICE DESCRIPTION ....................................................................................................５
5
NAMESPACES ............................................................................................................................................７
6
SEQUENCE DIAGRAMS...........................................................................................................................７
6.1
7
8
INTERFACE FLOW OVERVIEW .................................................................................................................. ７
XML SCHEMA DATA TYPE DEFINITION ............................................................................................９
7.1
PRESENCEATTRIBUTETYPE ENUMERATION ............................................................................................ ９
7.2
ACTIVITYVALUE ENUMERATION ............................................................................................................ ９
7.3
PLACEVALUE ENUMERATION ............................................................................................................. １０
7.4
PRIVACYVALUE ENUMERATION .......................................................................................................... １０
7.5
SPHEREVALUE ENUMERATION ............................................................................................................ １１
7.6
COMMUNICATIONMEANSTYPE ENUMERATION ................................................................................... １１
7.7
COMMUNICATIONMEANS STRUCTURE ............................................................................................... １１
7.8
COMMUNICATIONVALUE STRUCTURE ................................................................................................ １２
7.9
OTHERVALUE STRUCTURE ................................................................................................................. １２
7.10
PRESENCEATTRIBUTE STRUCTURE ..................................................................................................... １２
7.11
SUBSCRIPTIONREQUEST STRUCTURE ................................................................................................. １２
7.12
PRESENCEPERMISSION STRUCTURE.................................................................................................... １３
WEB SERVICE INTERFACE DEFINITION.......................................................................................１３
8.1
INTERFACE: PRESENCECONSUMER..................................................................................................... １３
8.1.1
Operation: subscribePresence .................................................................................................. １３
8.1.1.1
Input message: subscribePresenceRequest ............................................................................................ １４
8.1.1.2
Output message: subscribePresenceResponse ....................................................................................... １４
8.1.1.3
Referenced faults ................................................................................................................................... １４
8.1.2
Operation: getUserPresence ..................................................................................................... １４
8.1.2.1
Input message: getUserPresenceRequest ............................................................................................... １５
8.1.2.2
Output message: getUserPresenceResponse .......................................................................................... １５
ix
TTAx.xx-xx.xxxx
영문단체표준
8.1.2.3
8.1.3
Input message: startPresenceNotificationRequest ................................................................................. １６
8.1.3.2
Output message: startPresenceNotificationResponse ............................................................................ １６
8.1.3.3
Referenced faults ................................................................................................................................... １６
Operation: endPresenceNotification ......................................................................................... １７
8.1.4.1
Input message: endPresenceNotificationRequest .................................................................................. １７
8.1.4.2
Output message: endPresenceNotificationResponse ............................................................................. １７
8.1.4.3
Referenced faults ................................................................................................................................... １７
INTERFACE: PRESENCENOTIFICATION ................................................................................................ １７
8.2.1
Operation: statusChanged ........................................................................................................ １７
8.2.1.1
Input message: statusChangedRequest .................................................................................................. １８
8.2.1.2
Output message: statusChangedResponse ............................................................................................. １８
8.2.1.3
Referenced faults ................................................................................................................................... １８
8.2.2
Operation: statusEnd ................................................................................................................ １８
8.2.2.1
Input message: statusEndRequest .......................................................................................................... １８
8.2.2.2
Output message: statusEndResponse ..................................................................................................... １８
8.2.2.3
Referenced faults ................................................................................................................................... １８
8.2.3
Operation: notifySubscription ................................................................................................... １９
8.2.3.1
Input message: notifySubscriptionRequest ............................................................................................ １９
8.2.3.2
Output message: notifySubscriptionResponse ....................................................................................... １９
8.2.3.3
Referenced faults ................................................................................................................................... １９
8.2.4
8.3
Operation: startPresenceNotification ....................................................................................... １５
8.1.3.1
8.1.4
8.2
Referenced faults ................................................................................................................................... １５
Operation: subscriptionEnded .................................................................................................. １９
8.2.4.1
Input message: subscriptionEndedRequest ............................................................................................ １９
8.2.4.2
Output message: subscriptionEndedResponse ....................................................................................... １９
8.2.4.3
Referenced faults ................................................................................................................................... １９
INTERFACE: PRESENCESUPPLIER ........................................................................................................ ２０
8.3.1
Operation: publish .................................................................................................................... ２０
8.3.1.1
Input message: publishRequest.............................................................................................................. ２０
8.3.1.2
Output message: publishResponse......................................................................................................... ２０
8.3.1.3
Referenced faults ................................................................................................................................... ２０
8.3.2
Operation: getOpenSubscriptions ............................................................................................. ２０
8.3.2.1
Input message: getOpenSubscriptionsRequest ...................................................................................... ２０
8.3.2.2
Output message: getOpenSubscriptionsResponse ................................................................................. ２１
8.3.2.3
Referenced faults ................................................................................................................................... ２１
8.3.3
Operation: updateSubscriptionAuthorization ........................................................................... ２１
8.3.3.1
Input message: updateSubscriptionAuthorizationRequest ..................................................................... ２１
8.3.3.2
Output message: updateSubscriptionAuthorizationResponse ................................................................ ２１
8.3.3.3
Referenced faults ................................................................................................................................... ２１
8.3.4
Operation: getMyWatchers ....................................................................................................... ２２
x
TTAx.xx-xx.xxxx
영문단체표준
8.3.4.1
Input message: getMyWatchersRequest ................................................................................................ ２２
8.3.4.2
Output message: getMyWatchersResponse ........................................................................................... ２２
8.3.4.3
Referenced faults ................................................................................................................................... ２２
8.3.5
Operation: getSubscribedAttributes .......................................................................................... ２２
8.3.5.1
Input message: getSubscribedAttributesRequest ................................................................................... ２２
8.3.5.2
Output message: getSubscribedAttributesResponse .............................................................................. ２２
8.3.5.3
Referenced faults ................................................................................................................................... ２３
8.3.6
Operation: blockSubscription ................................................................................................... ２３
8.3.6.1
Input message: blockSubscriptionRequest ............................................................................................ ２３
8.3.6.2
Output message: blockSubscriptionResponse ....................................................................................... ２３
8.3.6.3
Referenced faults ................................................................................................................................... ２３
FAULT DEFINITIONS ........................................................................................................................... ２４
9
9.1
10
SERVICEEXCEPTION ........................................................................................................................... ２４
9.1.1
SVC0220: No subscription request............................................................................................ ２４
9.1.2
SVC0221: Not a watcher ........................................................................................................... ２４
SERVICE POLICIES .......................................................................................................................... ２４
ANNEX A (NORMATIVE): WSDL FOR PRESENCE ................................................................................２５
ANNEX B (INFORMATIVE): BIBLIOGRAPHY........................................................................................２６
HISTORY .........................................................................................................................................................２７
영문단체표준해설서 ......................................................................................................................................... 2 8
xi
TTAx.xx-xx.xxxx
영문단체표준
Intellectual Property Rights
IPRs essential or potentially essential to the present document may have been declared to ETSI. The
information pertaining to these essential IPRs, if any, is publicly available for ETSI members and nonmembers, and can be found in ETSI SR 000 314: "Intellectual Property Rights (IPRs); Essential, or potentially
Essential, IPRs notified to ETSI in respect of ETSI 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 existence 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 Protocols for Advanced Networking (TISPAN), and is now submitted for the ETSI
standards Membership Approval Procedure.
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:
"Multimedia 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".
１
TTAx.xx-xx.xxxx
영문단체표준
The present document has been defined jointly between ETSI, The Parlay Group (http://www.parlay.org) and
the 3GPP.
The present document forms part of the Parlay X 2.1 set of specifications.
The present document is equivalent to 3GPP TS 29.199-14 V6.4.0 (Release 6).
２
TTAx.xx-xx.xxxx
영문단체표준
1
Scope
The present document is 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 specifies 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
The following documents contain provisions which, through reference in this text, constitute provisions of the
present document.

References are either specific (identified by date of publication and/or edition number or version
number) or non-specific.

For a specific reference, subsequent revisions do not apply.

For a non-specific reference, the latest version applies.
Referenced documents which are not found to be publicly available in the expected location might be found at
http://docbox.etsi.org/Reference.
[1]
ETSI TR 121 905: "Universal Mobile Telecommunications System (UMTS); Vocabulary
for 3GPP Specifications (3GPP TR 21.905)".
[2]
NOTE:
[3]
W3C Recommendation (2 May 2001): "XML Schema Part 2: Datatypes".
Available at http://www.w3.org/TR/2001/REC-xmlschema-2-20010502/.
ETSI ES 202 391-1: "Open Service Access (OSA); Parlay X 2 Web Services; Part 1:
Common".
３
TTAx.xx-xx.xxxx
영문단체표준
[4]
ETSI ES 202 915-14: "Open Service Access (OSA); Application Programming Interface
(API); Part 14: Presence and Availability Management SCF (Parlay 4)".
[5]
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 2 Web Services; Part 13:
Address List Management".
[8]
[9]
[10]
IETF RFC 3265: "Session Initiation Protocol (SIP)-Specific Event Notification".
Void.
ETSI ES 202 391-8: "Open Service Access (OSA); Parlay X 2 Web Services; Part 8:
Terminal Status".
[11]
ETSI ES 202 391-9: "Open Service Access (OSA); Parlay X 2 Web Services; Part 9:
Terminal Location".
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 Service. 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 Parlay/OSA PAM identities [4], clause 4.4.1.
presence attributes: Contain information about a presentity. An attribute has a name and a value and can be
supplied by any device, application or network module that can be associated to the presentity's 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 information: Consists of a 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
presentity.
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
４
TTAx.xx-xx.xxxx
영문단체표준
their presence can be addressed. Subscriptions can be also automatically handled 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: We use these names to denote the role of 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.
3.2
Abbreviations
For the purposes of the present document, the abbreviations defined 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
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 Language
XMPP
eXtensible Messaging and Presence Protocol
XSD
XML Schema Definition
4
Detailed service description
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 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. Parlay/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 servers) using the ISC (SIP/SIMPLE) protocol interface.
５
TTAx.xx-xx.xxxx
영문단체표준
watcher
client
watcher
application
presentity
client
Parlay X API
Parlay X Address List
Management Web
Service
Parlay X Presence Web Service
Parlay/OSA API
Policy
rules
Parlay/OSA PAM
SCF
Network protocols
(e.g. SIP)
Network elements
(e.g. SIP)
Figure 1: The Presence web service environment
Relationship to Similar or Supplanted Specifications:
The most important relations are to:

Parlay X 2 Terminal Status Web Service [10] and Parlay X 2 Terminal Location Web Service [11]:
Both services deal with information that could be considered part of the user's presence information.
Communication abilities can be derived from terminal status information, and the user's placetype can
be derived from his location.

Parlay/OSA PAM [4]: The Parlay/OSA Presence and Availability specification can be considered the
big brother of the present document. While Parlay X 2 Presence stays behind Parlay/OSA PAM in
terms of flexibility and power - especially concerning attributes and management interfaces - it also
extends PAM by introducing end-to-end authorization. The present document aims to be mappable to
Parlay/OSA PAM.

SIP SIMPLE [5]: The present document aims to be mappable to the SIP/SIMPLE architecture.

XMPP (Jabber) (see Bibliography): Many principles of XMPP have been adopted, especially the endto-end authorization.

IETF Rich Presence(see Bibliography). The set of attributes the present document specifies is closely
aligned with the IETF's Rich Presence ideas.

Group Management [7]: Presence of groups is supported by the present document, however their
creation and manipulation has to be done using the Parlay X 2 Address List Management Web Service.
６
TTAx.xx-xx.xxxx
영문단체표준
In the 3GPP presence context, contact lists and group manipulation is done with the XCAP protocol(see
Bibliography).
5
Namespaces
The PresenceConsumer interface uses the namespace:
http://www.csapi.org/wsdl/parlayx/presence/consumer/v2_3
The PresenceNotification interface uses the namespace:
http://www.csapi.org/wsdl/parlayx/presence/notification/v2_3
The PresenceSupplier interface uses the namespace:
http://www.csapi.org/wsdl/parlayx/presence/supplier/v2_3
The data types are defined in the namespace:
http://www.csapi.org/schema/parlayx/presence/v2_3
The 'xsd' namespace is used in the present document to refer to the XML Schema data types defined in
XML Schema [2]. The use of the name 'xsd' is not semantically significant.
6
Sequence diagrams
6.1
Interface flow overview
The sequence diagram shows the interactions in case both watcher application and presentity are Web Service
clients. Compared to the SIP interactions, the subscription notification is separated from the delivery of
presence information itself. Based on the subscription result, the watcher can select the polling or notification
mode for presence events. Changes in the authorization of presence attributes are propagated to the watchers via
the notifySubscription() operation, the blocking of a subscription by the presentity is propagated via a
subscriptionEnded operation.
The sequence diagram does not show the internal communication within the presence server. It is assumed that
the Presence Consumer and Supplier interfaces are implemented by the same instance. If an implementer of the
API find other solutions preferable, he has to take care of the internal communication himself.
７
TTAx.xx-xx.xxxx
영문단체표준
Watcher Application :
PresenceConsumerNotifications
Presence Web Service :
PresenceConsumer
Presence Web Service :
PresenceSupplier
Presentity Application
:
subscribePresence
check subscription policies
after a while the
user logs on
notifySubscription
getOpenSubscriptions
if there is a policy for this
subscription request, no
interaction with the
presentity is necessary.
get user answer
updateSubscriptionAuthorization
notifySubscription
publish
the watcher can access
presence data by polling...
getUserPresence
determine presence
... or through notifications
user status changes (for
whatever reason)
startPresenceNotification
publish
statusChanged
endPresenceNotification
subscription timeout
subscriptionEnded
getMyWatchers
a subscription can either
time out; or the presentity
can cancel it
getSubscribedAttributes
blockSubscription
subscriptionEnded
Figure 2: Message interaction overview
８
TTAx.xx-xx.xxxx
영문단체표준
7
XML Schema data type definition
Presence attributes are inspired by the IETF's Rich Presence ideas (see Bibliography).
7.1
PresenceAttributeType enumeration
The different types of attributes. For each entry in this enumeration there is a separate value type.
Enumeration value
Description
Activity
The presentity's activity (available, busy, lunch, etc.)
Place
At what kind of place the presentity is (home, office, etc.)
Privacy
The amount of privacy the user wants (public, quiet, etc.)
Sphere
The user's current environment (work, home)
Communication
The user's means of communication (phone, mail, etc.)
Other
A name - value pair for arbitrary presence information
7.2
ActivityValue enumeration
This enumeration shows the user's current activity. If the activity is unknown, the attribute value will be
ActivityNone, meaning the attribute was not set. If the user is doing something not in this list, the value will be
set to ActivityOther.
Enumeration value
Description
ActivityNone
Not set.
Available
The user is available for communication.
Busy
The user is busy and is only available for urgent matters.
DoNotDisturb
The user is very busy and does not wish to be disturbed.
OnThePhone
The user is on the phone.
Steering
The user is driving a car / train / airplane, etc.
Meeting
The user is in a meeting.
Away
No idea what the user is doing, but he is away.
Meal
The user is eating.
PermanentAbsence
The user is away and will not return for an extended period.
Holiday
The user is on holidays.
Performance
The user is in a theatre / concert.
InTransit
The user is in the transit area of an (air)port.
Travel
The user is travelling.
Sleeping
The user is sleeping.
ActivityOther
The user is doing something not in this list.
９
TTAx.xx-xx.xxxx
영문단체표준
7.3
PlaceValue enumeration
This enumeration shows the type of the user's current location. If the place type is unknown, the attribute value
will be PlaceNone, meaning the attribute was not set. If the user in a place not in this list, the value will be set
to PlaceOther.
Enumeration value
Description
PlaceNone
Not set.
Home
The user is at home.
Office
The user is in an office.
PublicTransport
The user is on public transport.
Street
Walking on the street.
Outdoors
Generally outdoors.
PublicPlace
The user is in a public place.
Hotel
The user is in a hotel.
Theater
The user is in a theatre or concert.
Restaurant
The user is in a restaurant / bar / etc.
School
The user is at school.
Industrial
The user is in an industrial building.
Quiet
The user is in a quiet area.
Noisy
The user is in a noisy area.
Aircraft
The user is on an aircraft.
Ship
The user is on a ship.
Bus
The user is in a bus.
Station
The user is in a bus- or railway station.
Mall
The user is in a mall.
Airport
The user is in an airport.
Train
The user is in a train.
PlaceOther
The user is in a kind of place not listed here.
7.4
PrivacyValue enumeration
This enumeration shows the amount of privacy a user currently has. If the privacy is unknown, the attribute
value will be PrivacyNone, meaning the attribute was not set. If the privacy is not in this list, the value will be
set to PrivacyOther.
１０
TTAx.xx-xx.xxxx
영문단체표준
Enumeration value
Description
PrivacyNone
Not set.
PrivacyPublic
The user is surrounded by other people and cannot discuss openly.
PrivacyPrivate
The user is alone and able to talk openly.
PrivacyQuiet
The user is in a quiet environment and cannot talk at all.
PrivacyOther
None of the other values applies.
7.5
SphereValue enumeration
This enumeration shows the sphere within which the user acts. If the sphere is unknown, the attribute value will
be SphereNone, meaning the attribute was not set. If the sphere is not in this list (neither work nor home), the
value will be set to SphereOther.
Enumeration value
Description
SphereNone
Not set.
SphereWork
The user is acting within his work sphere, i.e. as a member of his company.
SphereHome
The user is acting within his home sphere, i.e. as a private person.
SphereOther
The user is acting neither within his work nor within his home sphere.
7.6
CommunicationMeansType enumeration
This enumeration lists communication means. If the communication attribute refers to a means not in this list, it
will point to MeansOther.
Enumeration value
Description
Phone
The communication attribute refers to a phone (fixed line or mobile or SIP).
Chat
The communication attribute refers to a chat client.
SMS
The communication attribute refers to an SMS client.
Video
The communication attribute refers to a video phone (fixed line or mobile or SIP).
Web
The communication attribute refers to a web client.
EMail
The communication attribute refers to an e-mail client.
MMS
The communication attribute refers to an MMS client.
MeansOther
The communication attribute refers to any other client.
7.7
CommunicationMeans structure
This structure describes on way of reaching the presentity.
１１
TTAx.xx-xx.xxxx
영문단체표준
Element name
priority
Element type
Optional
xsd:float
Description
No
The priority of this communication means. Between 0 and
1, the latter meaning the highest priority.
contact
xsd:anyURI
No
The presentity's contact address for this communication
means.
type
CommunicationMeansType
7.8
No
The type of this communication means.
CommunicationValue structure
This structure describes the various ways of reaching a presentity.
Element name
Element type
means
Optional
CommunicationMeans
Yes
Description
The different ways of reaching the presentity.
[0..unbounded]
7.9
OtherValue structure
This structure can be used for storing arbitrary data about a presentity.
Element name
Element type
Optional
Description
name
xsd:string
No
Description of the content.
value
xsd:string
No
Attribute content.
7.10
PresenceAttribute structure
Presence data published by a presentity and retrieved by watchers.
Element name
Element type
Optional
Description
lastChange
xsd:dateTime
No
The time and date when the attribute was changed last.
note
xsd:string
Yes
An explanatory note..
type
PresenceAttributeType
No
Determines the type of the value field.
value
One of the six value types;
No
The actual value of the attribute.
depends on field "type"
This data structure is split into two types in the XSD file: A PresenceAttribute contains an
AttributeTypeAndValue.
7.11
SubscriptionRequest structure
This structure is returned to the presentity by the Presence Web Service and contains the requesting watcher and
１２
TTAx.xx-xx.xxxx
영문단체표준
the attributes he wants to subscribe.
Element name
Element type
Optional
Description
watcher
xsd:anyURI
No
The watcher who wants to gain access to data.
attributes
PresenceAttributeType
No
The attributes the watcher wants to see.
No
The name of the application running on behalf of the watcher. Note
[1..unbounded]
application
xsd:string
that this field has solely informative purposes, access rights
management is based on watcher id only.
7.12
PresencePermission structure
The answer from the service to the watcher in the notifySubscription operation.
Element name
Element type
Optional
Description
attribute
PresenceAttributeType
No
The name of the attribute the watcher wanted to subscribe.
decision
xsd:boolean
No
Whether the presentity accepted the subscription. If no, any
further fields should be ignored.
8
Web Service interface definition
This API is separated into three interfaces:

PresenceConsumer interface: watcher methods for requesting and subscribing presence data.

PresenceNotification interface: is the watcher notification interface for presence events.

PresenceSupplier interface: presentity methods for supplying presence data and managing
subscriptions.
8.1
Interface: PresenceConsumer
Client role: watcher.
This set of methods is used by the watcher to obtain presence data. After the subscription to presence data, the
watcher can select between a polling mode or a notification mode in order to receive presence data.
8.1.1
Operation: subscribePresence
We assume that the watcher has been previously authenticated, so that his identity is known and can be
associated with the subscription at the server.
The presentity is contacted and requested to authorize the watcher. As this process generally involves user
interaction there cannot be an immediate response. The watcher is notified with notifySubscription(). If the
presentity is a group, every member of the group will be contacted for authorization. The watcher will get one
１３
TTAx.xx-xx.xxxx
영문단체표준
notification for each member.
Only after the subscription is completed (and the presentity has allowed access to attributes) may the watcher
will get information when he uses getUserPresence() or startPresenceNotification().
Note that the SimpleReference contains the correlator string used in subsequent messages to the notification
interface.
At this interface level, the subscription has no expiration, although at can be ended from the presentity or the
underlying layers (see subscriptionEnded operation).
8.1.1.1
Input message: subscribePresenceRequest
Part name
presentity
Part type
Optional
xsd:anyURI
No
Description
A presentity or a group of presentities whose attributes the
watcher wants to monitor.
attributes
PresenceAttributeType
Yes
[0..unbounded]
The attributes the watcher wants to access. (the same for all the
group members). An empty array means subscription of all
attributes.
application
xsd:string
No
Describes the application the watcher needs the data for.
reference
common:SimpleReference
No
The notification interface.
8.1.1.2
Output message: subscribePresenceResponse
Part name
Part type
Optional
Description
None
8.1.1.3
Referenced faults
ServiceException from ES 202 391-1 [3]:

SVC0001: Service error.

SVC0002: Invalid input value.

SVC0004: No valid addresses - if the presentity address does not exist.
PolicyException from ES 202 391-1 [3]:

POL0006: Groups not allowed.

POL0007: Nested groups not allowed.
8.1.2
Operation: getUserPresence
Returns the aggregated presence data of a presentity. Only the attributes which the watcher is entitled to see will
be returned. This method does not support group identities.
Before getting these attributes, the watcher has to subscribe to them (see above). The presentity needs not be
informed of the access, as he has already consented when the watcher called subscribePresence().
１４
TTAx.xx-xx.xxxx
영문단체표준
8.1.2.1
Input message: getUserPresenceRequest
Part name
Part type
Optional
Description
presentity
xsd:anyURI
No
The presentity whose data the watcher wants to see.
attributes
PresenceAttributeType
Yes
The attributes the watcher wants to see. An empty array means all
[0..unbounded]
8.1.2.2
attributes.
Output message: getUserPresenceResponse
Part name
result
Part type
PresenceAttribute
Optional
Yes
Description
The actual presence data.
[0..unbounded]
8.1.2.3
Referenced faults
ServiceException from ES 202 391-1 [3]:

SVC0001: Service error.

SVC0002: Invalid input value.

SVC0004: No valid addresses - if the presentity address does not exist.
PolicyException from ES 202 391-1 [3]. The presentity has the possibility to cancel or block a subscription by
manipulating the policy rules. The exception informs the watcher about this status change.

POL0002: Privacy error - if the watcher is not subscribed to the requested data.

POL0006: Groups not allowed.
8.1.3
Operation: startPresenceNotification
The notification pattern with correlation is used in order to be able to correlate the notification events with the
request. The attributes represent a subset of the attributes subscribed and can be used as filter.
The watcher sets a notification trigger on certain user presence attribute changes. If the list of attributes is empty,
the watcher wants to be notified on all subscribed attributes.
In case the presentity is a group the watcher will receive notifications for every single member of the group. The
watcher will only get notifications for those attributes and presentities he subscribed successfully prior to the
call. The service will return a list of presentities where the notifications could not be set up.
The presentity needs not be informed of the access, as he has already consented when the watcher called
subscribePresence().
Note that the SimpleReference contains the correlator string used in subsequent messages to the notification
interface.
１５
TTAx.xx-xx.xxxx
영문단체표준
8.1.3.1
Input message: startPresenceNotificationRequest
Part name
presentity
Part type
Optional
xsd:anyURI
No
Description
The presentity or group whose attributes the watcher wants to
monitor.
attributes
PresenceAttributeType
Yes
The attributes the watcher wants to see.
[0..unbounded]
reference
common:SimpleReference
No
The notification interface.
frequency
common:TimeMetric
No
Maximum frequency of notifications (can also be considered
minimum time between notifications). In case of a group
subscription the service must make sure this frequency is not
violated by notifications for various members of the group,
especially in combination with checkImmediate.
duration
common:TimeMetric
Yes
Length of time notifications occur for, do not specify to use
default notification time defined by service policy.
count
xsd:int
Yes
Maximum number of notifications.For no maximum, either do
not specify this part or specify a value of zero.
checkImmediate
xsd:boolean
No
Whether to check status immediately after establishing
notification.
8.1.3.2
Output message: startPresenceNotificationResponse
Part name
result
Part type
xsd:anyURI
Optional
Yes
[0..unbounded]
8.1.3.3
Description
The presentities whose attributes the watcher did not subscribe. Empty
if all went fine.
Referenced faults
ServiceException from ES 202 391-1 [3]:

SVC0001: Service error.

SVC0002: Invalid input value.

SVC0004: No valid addresses - if the presentity URI does not exist.

SVC0005: Duplicate correlator.
PolicyException from ES 202 391-1 [3]. The presentity has the possibility to cancel or block a subscription by
manipulating the policy rules. The exception informs the watcher about this status change.

POL0001: Policy error.

POL0004: Unlimited notifications not supported.

POL0005: Too many notifications requested.
１６
TTAx.xx-xx.xxxx
영문단체표준

POL0006: Groups not allowed.

POL0007: Nested groups not allowed.
8.1.4
Operation: endPresenceNotification
Indicates that the watcher does not want further notifications for a specific notification request (identified by the
correlator). Note that the subscription to presence data stays active; the caller of this method remains a watcher
and can still use getUserPresence() or reactivate the notifications.
8.1.4.1
8.1.4.2
Input message: endPresenceNotificationRequest
Part name
Part type
correlator
xsd:string
Optional
No
Description
The notification the watcher wants to cancel.
Output message: endPresenceNotificationResponse
Part name
Part type
Optional
Description
None
8.1.4.3
Referenced faults
ServiceException from ES 202 391-1 [3]:

SVC0001: Service error.

SVC0002: Invalid input value.
PolicyException from ES 202 391-1 [3]:

8.2
POL0001: Policy error.
Interface: PresenceNotification
This client callback interface is used by the presence consumer interface to send notifications.
8.2.1
Operation: statusChanged
The asynchronous operation is called by the Web Service when an attribute for which notifications were
requested changes.
１７
TTAx.xx-xx.xxxx
영문단체표준
8.2.1.1
Input message: statusChangedRequest
Part name
Part type
Optional
Description
correlator
xsd:string
No
Identifies the notification request.
presentity
xsd:anyURI
No
The presentity whose presence status has changed.
changedAttributes
PresenceAttribute
No
The new presence data.
[1..unbounded]
8.2.1.2
Output message: statusChangedResponse
Part name
Part type
Optional
Description
None
8.2.1.3
Referenced faults
None.
8.2.2
Operation: statusEnd
The notifications have ended for this correlator. This message will be delivered when the duration or count for
notifications have been completed. This message will not be delivered in the case of an error ending the
notifications or deliberate ending of the notifications (using endPresenceNotification operation).
8.2.2.1
8.2.2.2
Input message: statusEndRequest
Part name
Part type
Optional
correlator
xsd:string
No
Description
Correlator provided in request to set up this notification.
Output message: statusEndResponse
Part name
Part type
Optional
Description
None
8.2.2.3
Referenced faults
None.
１８
TTAx.xx-xx.xxxx
영문단체표준
8.2.3
Operation: notifySubscription
This asynchronous method notifies the watcher that the server or the presentity handled the pending
subscription.
8.2.3.1
Input message: notifySubscriptionRequest
Part name
Part type
Optional
Description
presentity
xsd:anyURI
No
The presentity whose attributes the watcher wants to monitor.
decisions
PresencePermission
Yes
Denote the attributes the server/presentity accepted to expose.
[0..unbounded]
8.2.3.2
Output message: notifySubscriptionResponse
Part name
Part type
Optional
Description
None
8.2.3.3
Referenced faults
None.
8.2.4
Operation: subscriptionEnded
This asynchronous operation is called by the Web Service to notify the watcher (application) that the
subscription has terminated. Typical reasons are a timeout of the underlying SIP soft state subscription (in
accordance with [8] and [5]) or the decision of the presentity to block further presence information to that
watcher. Since the subscription request has no expiration parameters, the service implementation may provide
an inactivity timer that also triggers the subscriptionEnded operation.
8.2.4.1
Input message: subscriptionEndedRequest
Part name
Part type
Optional
Description
presentity
xsd:anyURI
No
The presentity to which the subscription has terminated.
reason
xsd:string
No
Timeout, Blocked.
8.2.4.2
Output message: subscriptionEndedResponse
Part name
Part type
Optional
Description
None
8.2.4.3
Referenced faults
None.
１９
TTAx.xx-xx.xxxx
영문단체표준
8.3
Interface: PresenceSupplier
These methods are used by the presentity to supply presence data and manage access to the data by its watchers.
We assume that the presentity has been previously authenticated, so that his Identity is known.
8.3.1
Operation: publish
The presentity publishes data about herself. This data will then be filtered by the system and forwarded to the
watchers who have ordered notifications.
8.3.1.1
Input message: publishRequest
Part name
presence
Part type
PresenceAttribute
Optional
Yes
Description
The presence attributes the devices of the presentity supports.
[0..unbounded]
8.3.1.2
Output message: publishResponse
Part name
Part type
Optional
Description
None
8.3.1.3
Referenced faults
ServiceException from ES 202 391-1 [3]:

SVC0001: Service error.

SVC0002: Invalid input value.
PolicyException from ES 202 391-1 [3]:

8.3.2
POL0001: Policy error.
Operation: getOpenSubscriptions
Called periodically by the presentity to see if any watcher wants to subscribe to presence data. The client will
answer open requests with updateSubscriptionAuthorization().
8.3.2.1
Input message: getOpenSubscriptionsRequest
Part name
Part type
Optional
Description
None
２０
TTAx.xx-xx.xxxx
영문단체표준
8.3.2.2
Output message: getOpenSubscriptionsResponse
Part name
Part type
result
Optional
SubscriptionRequest [0..unbounded]
8.3.2.3
Yes
Description
Any open requests.
Referenced faults
ServiceException from ES 202 391-1 [3]:

SVC0001: Service error.
PolicyException from ES 202 391-1 [3]:

POL0001: Policy error.
8.3.3
Operation: updateSubscriptionAuthorization
The presentity answers with this operation to watcher subscriptions for which no authorization policy exists.
The answer consists of the attribute and the watcher involved and the permissions for each attribute.
Subscription requests that are not answered are assumed pending.
The operation can be used by the presentity to change anytime the authorization for a certain watcher or group
to monitor one or several attributes.
If the watcher did not try to subscribe the attribute - i.e. there is no pending subscription from this watcher to an
attribute in the decisions array, a Presence-specific ServiceException (SVC0220) will be raised and the entire
authorization request ignored.
8.3.3.1
Input message: updateSubscriptionAuthorizationRequest
Part name
Part type
Optional
Description
watcher
xsd:anyURI
No
watcher or group of watchers.
decisions
PresencePermission [1..unbounded]
No
The answers to open requests.
8.3.3.2
Output message: updateSubscriptionAuthorizationResponse
Part name
Part type
Optional
Description
None
8.3.3.3
Referenced faults
ServiceException from ES 202 391-1 [3]:

SVC0001: Service error.

SVC0002: Invalid input value.

SVC0004: No valid addresses.

SVC0220: No subscription request.
２１
TTAx.xx-xx.xxxx
영문단체표준
PolicyException from ES 202 391-1 [3]:

POL0001: Policy error.
8.3.4
Operation: getMyWatchers
Returns an array of watching identities that are subscribed to the presentity's attributes. They are not necessarily
users of the notification system, the mere fact that they are allowed to see the presentity's attributes is enough to
be on this list.
8.3.4.1
Input message: getMyWatchersRequest
Part name
Part type
Optional
Description
None
8.3.4.2
Output message: getMyWatchersResponse
Part name
Part type
result
Optional
xsd:anyURI
Yes
[0..unbounded]
8.3.4.3
Description
The list of identities who currently have access to the
presentity's attributes.
Referenced faults
ServiceException from ES 202 391-1 [3]:

SVC0001: Service error.
PolicyException from ES 202 391-1 [3]:

POL0001: Policy error.
8.3.5
Operation: getSubscribedAttributes
Returns an array of attributes that a specific watcher has subscribed.
8.3.5.1
Input message: getSubscribedAttributesRequest
Part name
watcher
8.3.5.2
Part type
xsd:anyURI
Optional
No
Description
The watcher whose subscriptions the presentity wants to know.
Output message: getSubscribedAttributesResponse
Part name
result
Part type
PresenceAttributeType
Optional
Yes
Description
The attributes the watcher is subscribed to.
[0..unbounded]
２２
TTAx.xx-xx.xxxx
영문단체표준
8.3.5.3
Referenced faults
ServiceException from ES 202 391-1 [3]:

SVC0001: Service error.

SVC0004: No valid addresses.

SVC0221: Not a watcher - if the URI in the watcher part is not a watcher of the presentity.
PolicyException from ES 202 391-1 [3]:

POL0001: Policy error.
8.3.6
Operation: blockSubscription
With this operation the presentity can block entirely the flow of presence information to a certain subscribed
watcher by cancelling the subscription. The watcher will be notified with a subscriptionEnded() message.
8.3.6.1
Input message: blockSubscriptionRequest
Part name
watcher
Part type
xsd:anyURI
8.3.6.2
Optional
No
Description
The watcher whose subscriptions the presentity wants to cancel.
Output message: blockSubscriptionResponse
Part name
Part type
Optional
Description
None
8.3.6.3
Referenced faults
ServiceException from ES 202 391-1 [3]:

SVC0001: Service error.

SVC0002: Invalid input value.

SVC0004: No valid addresses.

SVC0221: Not a watcher - if the URI in the watcher part is not a watcher of the presentity.
PolicyException from ES 202 391-1 [3]:

POL0001: Policy error.
２３
TTAx.xx-xx.xxxx
영문단체표준
9
Fault definitions
9.1
ServiceException
9.1.1
SVC0220: No subscription request
Name
Description
messageId
SVC0220.
text
No subscription request from watcher %1 for attribute %2.
variables
%1 - watcher URI.
%2 - type of attribute, from clause 7.1.
9.1.2
SVC0221: Not a watcher
Name
Description
messageId
SVC0221.
text
%1 is not a watcher.
variables
%1 - watcher URI.
10
Service policies
Service policies for this service.
Name
MaximumNotificationFrequency
Type
common:TimeMetric
Description
Maximum rate of notification delivery (also can be considered
minimum time between notifications).
MaximumNotificationDuration
common:TimeMetric
Maximum amount of time a notification may be set up for.
DefaultNotificationDuration
common:TimeMetric
Default amount of time for which a notification will be set up.
MaximumCount
xsd:int
Maximum number of notifications that may be requested.
UnlimitedCountAllowed
xsd:boolean
Allowed to specify unlimited notification count (i.e. either by
not specifying the optional count part in the
startPresenceNotificationRequest message or by specifying a
value of zero).
GroupSupport
xsd:boolean
Groups may be included with addresses.
NestedGroupSupport
xsd:boolean
Are nested groups supported in group definitions.
２４
TTAx.xx-xx.xxxx
영문단체표준
Annex A (normative):
WSDL for Presence
The document/literal WSDL representation of this interface specification is compliant to ES 202 391-1 [3] and
is contained in text files (contained in archive es_20239114v005m0.zip) which accompany the present
document.
２５
TTAx.xx-xx.xxxx
영문단체표준
Annex B (informative):
Bibliography
3GPP: "IETF Dependencies and Priorities".
draft-ietf-simple-event-filter-funct-05:
http://www.3gpp.org/tb/Other/IETF_archive_07.03.05/IETF.htm
"Functional
Description
of
http://www.ietf.org/internet-drafts/draft-ietf-simple-event-filter-funct-05.txt.
16, 2005.
Event
Notification
Filtering".
This version expires September
Also reference item #42 in 3GPP: "IETF Dependencies and Priorities".
draft-ietf-simple-rpid-10: "RPID: Rich Presence: Extensions to the Presence Information Data Format (PIDF)".
http://www.ietf.org/internet-drafts/draft-ietf-simple-rpid-10.txt.
This version expires June 23, 2006.
Also
reference item #54 in 3GPP: "IETF Dependencies and Priorities".
draft-ietf-simple-xcap-11: "The Extensible Markup Language (XML) Configuration Access Protocol (XCAP)".
http://www.ietf.org/internet-drafts/draft-ietf-simple-xcap-11.txt.
This version expires November 6, 2006.
Also reference item #57 in 3GPP: "IETF Dependencies and Priorities".
ETSI TS 123 141: "Universal Mobile Telecommunications System (UMTS); Presence service; Architecture
and functional description; Stage 2 (3GPP TS 23.141)".
Repository of information about the Extensible Messaging and Presence Protocol (XMPP), which was
contributed by the Jabber Software Foundation (JSF) to the IETF,
２６
http://www.xmpp.org/.
TTAx.xx-xx.xxxx
영문단체표준
History
Document history
v0.0.1
September 2004
1st draft of DES-TISPAN-01007-14: i.e. part 14 of a 14-part specification.
V1.1.1
January 2005
Membership Approval Procedure
v0.0.2
May 2005
1st draft of ES 202 391-14, Parlay X 2.1 Web Services.
Implements the following
CRs:
V1.1.2

v0.0.3
MV 20050318: 2005-01-18 to 2005-03-18
June 2005
[N5-040871] Correct the Presence WSDL source code
2nd draft of ES 202 391-14, Parlay X 2.1 Web Services.
Implements the following
CRs and other agreements in Osaka:
V1.1.3

New ETSI Work Item reference on page 2: “RES/TISPAN-01033-01-OSA”

Rename “Parlay X Web Services” to “Parlay X 2 Web Services”

Update Clause 5, Namespaces, & Annex A: consistent with new WSDL file versions

[C5-050284] Add “Optional” column with “Yes” or “No” values for message part and data
structure definitions

[C5-050287] Fix numerous message name errors in the behavior sections

v0.0.4
December 2005
[C5-050304] Update and move informative references to new Bibliography annex
rd
3 draft of ES 202 391-14, Parlay X 2.1 Web Services.
Implements the following
CRs and other agreements in London & Boston:
v0.0.5
June 2006

[C5-050505] Inconsistent definition of how to specify an unlimited notifications count

[C5-050523] Inconsistent part naming in PX response messages
4th draft of ES 202 391-14, Parlay X 2.1 Web Services.
Implements the following
CRs and other agreements in Denver & Prague:

[C5-060163] Apply Union data type element naming convention (in .xsd file)
２７
TTAx.xx-xx.xxxx
영문단체표준
영문단체표준 해설서
(※영문단체표준에 한해 목차 대항목별 주요 내용 요약 작성)
1. Scope
본 표준은 OSA 를 위한 Stage 3 Parlay X 웹 서비스 규격의 Part 14 으로서 프레즌스 웹
서비스를 규정하기 위해서 네임스페이스, 순서도, 데이터 및 장애 정의, 인터페이스
규격에 상세한 방법 서술을 추가, 서비스 정책과 인터페이스에 대한 WSDL 서술을
내용으로 한다.
2. References
본 표준에서 참고하고 있는 참고문서들의 목록.
3. Definitions and abbreviations
본 표준에서 사용하고 있는 정의들과 용어의 정의를 기술한다.
4. Detailed Service Description
프레즌스에 웹 서비스 환경과 프레즌스와 관계된 스펙들간의 관계 등에 관한 상세 사
항을 기술한다.
5. Namespaces
프레즌스 인터페이스가 사용하는 네임스페이스를 설명한다.
6. Sequence Diagram
워쳐 어플리케이션과 프리젠터티가 웹 서비스 클라이언트인 경우의 메시지 흐름 순서
도를 기술한다.
7. XML Schema data type definition
프레즌스에 적용되는 XML 스키마의 데이터 형을 정의한다.
8. Web Service interface definition
프레즌스 웹 서비스가 외부에 제공하는 인터페이스들을 설명한다.
9. Fault definitions
프레즌스 서비스에 예외를 정의한다.
10. Service Policies
프레즌스 서비스의 정책을 정의한다.
２８
TTAx.xx-xx.xxxx
영문단체표준
Annex A. WSDL for Terminal Location
다큐먼트/리터럴 방식의 WSDL 이 ES 202 391-1 문서에 기술된 사항들을 따르며
배포본에 포함되어 있음을 설명한다.
Annex B. Bibliography
참조한 문헌의 목록을 기술한다.
２９
TTAx.xx-xx.xxxx
영문단체표준
표준작성 공헌자
표준 번호 : TTAx.xx-xx.xxxx
이 표준의 제․ 개정 및 발간을 위해 아래와 같이 여러분들이 공헌하였습니다.
구분
성명
과제 제안
최영일
표준 초안 제출
위원회 및 직위
연락처
(Tel, e-mail)
TTA NGN 전담반 위원
042-860-5330
BcN 포럼 위원
[email protected]
소속사
ETRI
042-860-6718
박유미
ETRI
[email protected]
정일영
TTA TC2 PG205 의장
031-330-4229
한국외국어대학교
[email protected]
표준 초안 검토
및 작성
이병선
최영일
BcN 포럼
042-860-1760
통합망분과위원회 의장
[email protected]
BcN 포럼 위원
ETRI
042-860-5330
ETRI
[email protected]
042-860-6718
박유미
ETRI
[email protected]
민경선
전송기술위원회 의장
042-870-8340
KT
[email protected]
표준안 심의
외 기술위원회 위원
김영재
선임
031-724-0195
TTA
[email protected]
사무국 담당
김선
팀장
031-724-0080
TTA
[email protected]
３０
TTAx.xx-xx.xxxx
(뒷 표지)
정보통신(영문)단체표준
개방형 서비스 액세스를 위한 Parlay X 웹서비스; Part 14: 프레즌스
(Open Service Access (OSA); Parlay X Web Services; Part 14: Presence)
발행인 : 김홍구
발행처 : 한국정보통신기술협회
463-824, 경기도 성남시 분당구 서현동 267-2
Tel : 031-724-0114, Fax : 031-724-0019
발행일 : 200x.xx