1、 ETSI ES 204 915-15 V1.1.1 (2008-05)ETSI Standard Open Service Access (OSA);Application Programming Interface (API);Part 15: Multi-Media Messaging SCF(Parlay 6)floppy3 ETSI ETSI ES 204 915-15 V1.1.1 (2008-05) 2 Reference DES/TISPAN-01032-15-OSA Keywords API, IDL, OSA, UML ETSI 650 Route des Lucioles
2、 F-06921 Sophia Antipolis Cedex - 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:/ww
3、w.etsi.org The present document may 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 printi
4、ng on ETSI printers of the PDF version 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:/po
5、rtal.etsi.org/tb/status/status.asp 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
6、 foregoing restriction extend to reproduction 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. 3G
7、PPTM is a Trade Mark of ETSI registered for the benefit of its Members and of the 3GPP Organizational Partners. ETSI ETSI ES 204 915-15 V1.1.1 (2008-05) 3 Contents Intellectual Property Rights8 Foreword.8 1 Scope 9 2 References 9 3 Definitions and abbreviations.9 3.1 Definitions9 3.2 Abbreviations .
8、9 4 Multi Media Messaging SCF .10 5 Sequence Diagrams 10 5.1 Sending messages and receiving delivery notification.10 5.2 Sending, and receiving messages in same context .12 5.3 Setting notification of received messages 13 5.4 Using Mailbox functions 14 5.5 Using Mailbox to send and receive 16 5.6 Se
9、tting notification of received messages 18 6 Class Diagrams.19 7 The Service Interface Specifications20 7.1 Interface Specification Format .20 7.1.1 Interface Class 20 7.1.2 Method descriptions20 7.1.3 Parameter descriptions20 7.1.4 State Model.20 7.2 Base Interface.20 7.2.1 Interface Class IpInterf
10、ace 20 7.3 Service Interfaces .21 7.3.1 Overview 21 7.4 Generic Service Interface .21 7.4.1 Interface Class IpService 21 7.4.1.1 Method setCallback()21 7.4.1.2 Method setCallbackWithSessionID()21 8 Multi Media Messaging Interface Classes .22 8.1 Interface Class IpMultiMediaMessagingManager .22 8.1.1
11、 Method openMailbox().23 8.1.2 Method openMultiMediaMessaging() 24 8.1.3 Method createNotification()25 8.1.4 Method destroyNotification() .25 8.1.5 Method changeNotification()26 8.1.6 Method getNextNotification() 26 8.1.7 Method enableNotifications() .27 8.1.8 Method disableNotifications() 27 8.2 In
12、terface Class IpAppMultiMediaMessagingManager.27 8.2.1 Method mailboxTerminated().28 8.2.2 Method reportNotification()28 8.2.3 Method notificationsInterrupted().29 8.2.4 Method notificationsResumed()29 8.2.5 Method multiMediaMessagingTerminated() 29 8.2.6 Method terminateMultipleMailboxes().29 8.2.7
13、 Method terminateMultipleMultiMediaMessagingSessions()29 8.3 Interface Class IpMailbox 30 8.3.1 Method close()31 8.3.2 Method getMessageInfoPropertiesReq() 31 ETSI ETSI ES 204 915-15 V1.1.1 (2008-05) 4 8.3.3 Method setMessageInfoPropertiesReq().31 8.3.4 Method createFolderReq()32 8.3.5 Method getFol
14、dersReq().32 8.3.6 Method deleteFolderReq()33 8.3.7 Method copyFolderReq()33 8.3.8 Method moveFolderReq().34 8.3.9 Method putMessageReq().34 8.3.10 Method copyMessageReq() 35 8.3.11 Method moveMessageReq() .36 8.3.12 Method deleteMessageReq() 36 8.3.13 Method listMessagesReq() .37 8.3.14 Method list
15、MessageBodyPartsReq() 37 8.3.15 Method getMessageBodyPartsReq() 38 8.3.16 Method getMessageHeadersReq()39 8.3.17 Method getMessageContentReq() 39 8.3.18 Method getFullMessageReq().40 8.3.19 Method getMailboxInfoPropertiesReq().40 8.3.20 Method getFolderInfoPropertiesReq()41 8.4 Interface Class IpApp
16、Mailbox .41 8.4.1 Method getMessageInfoPropertiesRes().43 8.4.2 Method setMessageInfoPropertiesRes() .43 8.4.3 Method setMessageInfoPropertiesErr() 44 8.4.4 Method getMailboxInfoPropertiesErr() 44 8.4.5 Method getFolderInfoPropertiesErr() .44 8.4.6 Method getMessageInfoPropertiesErr()45 8.4.7 Method
17、 createFolderRes() 45 8.4.8 Method createFolderErr() .46 8.4.9 Method getFoldersRes() .46 8.4.10 Method getFoldersErr() 46 8.4.11 Method deleteFolderRes() 47 8.4.12 Method deleteFolderErr() .47 8.4.13 Method copyFolderRes() 47 8.4.14 Method copyFolderErr().48 8.4.15 Method moveFolderRes() .48 8.4.16
18、 Method moveFolderErr()48 8.4.17 Method putMessageRes() .49 8.4.18 Method putMessageErr() 49 8.4.19 Method copyMessageRes().49 8.4.20 Method copyMessageErr() .50 8.4.21 Method moveMessageRes()50 8.4.22 Method moveMessageErr() 50 8.4.23 Method deleteMessageRes().51 8.4.24 Method deleteMessageErr()51
19、8.4.25 Method listMessagesRes()51 8.4.26 Method listMessagesErr().52 8.4.27 Method listMessageBodyPartsRes().52 8.4.28 Method listMessageBodyPartsErr()52 8.4.29 Method getMessageBodyPartsRes().53 8.4.30 Method getMessageBodyPartsErr()53 8.4.31 Method getMessageHeadersRes() 53 8.4.32 Method getMessag
20、eHeadersErr() .54 8.4.33 Method getMessageContentRes().54 8.4.34 Method getMessageContentErr()55 8.4.35 Method getFullMessageRes() .55 8.4.36 Method getFullMessageErr()55 8.4.37 Method getMailboxInfoPropertiesRes() .56 8.4.38 Method getFolderInfoPropertiesRes() 56 8.5 Interface Class IpMultiMediaMes
21、saging56 8.5.1 Method sendMessageReq().57 8.5.2 Method cancelMessageReq()58 8.5.3 Method queryStatusReq() .58 8.5.4 Method close()59 ETSI ETSI ES 204 915-15 V1.1.1 (2008-05) 5 8.5.5 Method sendMessageWithNotifyReq() 59 8.6 Interface Class IpAppMultiMediaMessaging.60 8.6.1 Method sendMessageRes() .61
22、 8.6.2 Method sendMessageErr()61 8.6.3 Method cancelMessageRes() 62 8.6.4 Method cancelMessageErr() .62 8.6.5 Method queryStatusRes() .62 8.6.6 Method queryStatusErr() 63 8.6.7 Method messageStatusReport() 63 8.6.8 Method messageReceived()64 8.6.9 Method sendMessageWithNotifyRes().64 8.6.10 Method s
23、endMessageWithNotifyErr()64 9 State Transition Diagrams65 10 Multi-Media Messaging Service Properties .65 11 Data Definitions .65 11.1 Multi-Media Messaging data definitions66 11.1.1 IpMultiMediaMessagingManager.66 11.1.2 IpMultiMediaMessagingManagerRef.66 11.1.3 IpAppMultiMediaMessagingManager66 11
24、.1.4 IpAppMultiMediaMessagingManagerRef 66 11.1.5 IpMailbox .66 11.1.6 IpMailboxRef66 11.1.7 IpAppMailbox.66 11.1.8 IpAppMailboxRef.66 11.1.9 IpMultiMediaMessaging.66 11.1.10 IpMultiMediaMessagingRef.66 11.1.11 IpAppMultiMediaMessaging66 11.1.12 IpAppMultiMediaMessagingRef 66 11.1.13 TpBodyPartDescr
25、iption 67 11.1.14 TpBodyPartDescriptionList 67 11.1.15 TpBodyPart.67 11.1.16 TpBodyPartList.67 11.1.17 TpDeliveryTime .67 11.1.18 TpDeliveryTimeType .68 11.1.19 TpFolderInfoProperty .68 11.1.20 TpFolderInfoPropertyName68 11.1.21 TpFolderInfoPropertySet 68 11.1.22 TpGenericHeaderField69 11.1.23 TpLis
26、tMessagesCriteria 69 11.1.24 TpMailboxFolderStatusInformation .69 11.1.25 TpMailboxIdentifier69 11.1.26 TpMailboxIdentifierSet 69 11.1.27 TpMailboxInfoProperty69 11.1.28 TpMailboxInfoPropertyName.70 11.1.29 TpMailboxInfoPropertySet.70 11.1.30 TpMailboxMessageStatus.70 11.1.31 TpMessageDeliveryType71
27、 11.1.32 TpMessageInfoProperty71 11.1.33 TpMessageInfoPropertyName 71 11.1.34 TpMessageInfoPropertySet 71 11.1.35 TpMessageHeaderFieldType 72 11.1.36 TpMessageHeaderField 73 11.1.37 TpMessageHeaderFieldSet .73 11.1.38 TpMessagePriority73 11.1.39 TpMessageDeliveryReportType.74 11.1.40 TpMessageTreatm
28、ent74 11.1.41 TpMessageTreatmentType .74 11.1.42 TpMessageTreatmentSet 74 11.1.43 TpMultiMediaMessagingIdentifier.75 11.1.44 TpMultiMediaMessagingIdentifierSet75 ETSI ETSI ES 204 915-15 V1.1.1 (2008-05) 6 11.1.45 TpQueryStatusReport .75 11.1.46 TpQueryStatusReportSet 75 11.1.47 TpTerminatingAddressL
29、ist.75 11.2 Event Notification data definitions.75 11.2.1 TpMessagingEventName75 11.2.2 TpMessagingEventCriteria .76 11.2.3 TpMessagingEventCriteriaSet 76 11.2.4 TpNewMailboxMessageArrivedCriteria 76 11.2.5 TpNewMessageArrivedCriteria76 11.2.6 TpMessagingEventInfo.77 11.2.7 TpMessagingEventInfoSet77
30、 11.2.8 TpNewMailboxMessageArrivedInfo77 11.2.9 TpNewMessageArrivedInfo .77 11.2.10 TpMessageDescription .78 11.2.11 TpMessageDescriptionList .78 11.2.12 TpMessagingNotificationRequested.78 11.2.13 TpMessagingNotificationRequestedSet78 11.2.14 TpMessagingNotificationRequestedSetEntry.78 11.2.15 TpNe
31、wMessageStatusReportArrivedInfo.79 11.3 Error type data definitions79 11.3.1 TpMessageInfoPropertyError .79 11.3.2 TpMessagingError 79 11.3.3 TpMessageInfoPropertyErrorSet 80 11.3.4 TpSetPropertyError.80 12 Exception Classes.80 Annex A (normative): OMG IDL Description of Multi-Media Messaging SCF 82
32、 Annex B (informative): W3C WSDL Description of Multi-Media Messaging SCF.83 Annex C (informative): Java API Description of the Multi-Media Messaging SCF84 Annex D (informative): Contents of 3GPP OSA R7 Multi-Media Messaging 85 Annex E (informative): Description of Multi Media Messaging for 3GPP2 cd
33、ma2000 networks86 E.1 General Exceptions.86 E.2 Specific Exceptions86 E.2.1 Clause 1: Scope 86 E.2.2 Clause 2: References 86 E.2.3 Clause 3: Definitions and abbreviations.86 E.2.4 Clause 4: Multi Media Messaging SCF86 E.2.5 Clause 5: Sequence Diagrams 86 E.2.6 Clause 6: Class Diagrams.86 E.2.7 Claus
34、e 7: The Service Interface Specifications 86 E.2.8 Clause 8: Multi Media Messaging Interface Classes87 E.2.9 Clause 9: State Transition Diagrams 87 E.2.10 Clause 10: Multi-Media Messaging Service Properties .87 E.2.11 Clause 11: Data Definitions87 E.2.12 Clause 12: Exception Classes.87 E.2.13 Annex
35、A (normative): OMG IDL Description of Multi-Media Messaging SCF .87 E.2.14 Annex B (informative): W3C WSDL Description of Multi-Media Messaging SCF .87 E.2.15 Annex C (informative): Java API Description of the Multi-Media Messaging SCF87 Annex F (informative): Record of changes 88 F.1 Interfaces 88
36、F.1.1 New 88 F.1.2 Deprecated88 F.1.3 Removed.88 ETSI ETSI ES 204 915-15 V1.1.1 (2008-05) 7 F.2 Methods88 F.2.1 New 88 F.2.2 Deprecated88 F.2.3 Modified.89 F.2.4 Removed.89 F.3 Data Definitions .89 F.3.1 New 89 F.3.2 Modified.89 F.3.3 Removed.89 F.4 Service Properties.89 F.4.1 New 89 F.4.2 Deprecate
37、d90 F.4.3 Modified.90 F.4.4 Removed.90 F.5 Exceptions 90 F.5.1 New 90 F.5.2 Modified.90 F.5.3 Removed.90 F.6 Others .90 History 91 ETSI ETSI ES 204 915-15 V1.1.1 (2008-05) 8 Intellectual Property Rights IPRs essential or potentially essential to the present document may have been declared to ETSI. T
38、he 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 ETSI standards“, which is available f
39、rom 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 E
40、TSI 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 (TISP
41、AN). The present document is part 15 of a multi-part deliverable covering Open Service Access (OSA); Application Programming Interface (API), as identified below. The API specification (ES 204 915) is structured in the following parts: Part 1: “Overview“; Part 2: “Common Data Definitions“; Part 3: “
42、Framework“; Part 4: “Call Control“; Part 5: “User Interaction SCF“; Part 6: “Mobility SCF“; Part 7: “Terminal Capabilities SCF“; Part 8: “Data Session Control SCF“; Part 9: “Generic Messaging SCF“; Part 10: “Connectivity Manager SCF“; Part 11: “Account Management SCF“; Part 12: “Charging SCF“; Part
43、13: “Policy Management SCF“; Part 14: “Presence and Availability Management SCF“; Part 15: “Multi-Media Messaging SCF“; Part 16: “Service Broker SCF“. The present document has been defined jointly between ETSI, The Parlay Group (http:/www.parlay.org) and the 3GPP, in co-operation with a number of JA
44、IN Community (http:/ member companies. The present document forms part of the Parlay 6.0 set of specifications. The present document is equivalent to 3GPP TS 29.198-15 V7.1.0 (Release 7). ETSI ETSI ES 204 915-15 V1.1.1 (2008-05) 9 1 Scope The present document is part 15 of the Stage 3 specification
45、for an Application Programming Interface (API) for Open Service Access (OSA). The OSA specifications define an architecture that enables application developers to make use of network functionality through an open standardised interface, i.e. the OSA APIs. The present document specifies the Multi Med
46、ia Messaging Service Capability Feature (SCF) aspects of the interface. All aspects of the Multi Media Messaging SCF are defined here, these being: Sequence Diagrams. Class Diagrams. Interface specification plus detailed method descriptions. State Transition diagrams. Data Definitions. IDL Descripti
47、on of the interfaces. The process by which this task is accomplished is through the use of object modelling techniques described by the Unified Modelling Language (UML). 2 References The references listed in clause 2 of ES 204 915-1 contain provisions which, through reference in this text, constitut
48、e provisions of the present document. ETSI ES 204 915-1: “Open Service Access (OSA); Application Programming Interface (API); Part 1: Overview (Parlay 6)“. 3 Definitions and abbreviations 3.1 Definitions For the purposes of the present document, the terms and definitions given in ES 204 915-1 apply.
49、 3.2 Abbreviations For the purposes of the present document, the abbreviations given in ES 204 915-1 apply. ETSI ETSI ES 204 915-15 V1.1.1 (2008-05) 104 Multi Media Messaging SCF The following clauses describe each aspect of the Multi Media Messaging Service Capability Feature (SCF). The order is as follows: The Sequence diagrams give the reader a practical idea of how each of the SCF is implemented. The Class relationships clause shows how each of the interfaces applicable to the SCF, relate to one another. The Interface spe
