1、 ETSI ES 203 915-13 V1.2.1 (2007-01)ETSI Standard Open Service Access (OSA);Application Programming Interface (API);Part 13: Policy Management SCF(Parlay 5)floppy3 ETSI ETSI ES 203 915-13 V1.2.1 (2007-01) 2 Reference RES/TISPAN-01029-13-OSA Keywords API, IDL, OSA, UML ETSI 650 Route des Lucioles F-0
2、6921 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:/www.et
3、si.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 printing o
4、n 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:/portal
5、.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 for
6、egoing restriction extend to reproduction in all media. European Telecommunications Standards Institute 2007. The Parlay Group 2007. All rights reserved. DECTTM, PLUGTESTSTM and UMTSTM are Trade Marks of ETSI registered for the benefit of its Members. TIPHONTMand the TIPHON logo are Trade Marks curr
7、ently being registered by ETSI for the benefit of its Members. 3GPPTM is a Trade Mark of ETSI registered for the benefit of its Members and of the 3GPP Organizational Partners. ETSI ETSI ES 203 915-13 V1.2.1 (2007-01) 3 Contents Intellectual Property Rights9 Foreword.9 1 Scope 10 2 References 10 3 D
8、efinitions and abbreviations.10 3.1 Definitions10 3.2 Abbreviations .10 4 Policy Management SCF11 5 Sequence Diagrams 11 5.1 Use of Policy Repository11 5.2 Introduce condition and action into rule.13 5.3 Create event15 5.4 Create and modify domain .17 5.5 ASP offering services to prepaid subscribers
9、 .18 5.6 Create Signature for an evaluation context.21 5.7 Request Evaluation of Policies.23 5.8 Register for and Receive Notification of a Policy Event23 6 Class Diagrams.24 6.1 PM Provisioning SCF Class Diagrams.24 6.2 PM Policy Evaluation SCF Class Diagrams.26 7 The Service Interface Specificatio
10、ns26 7.1 Interface Specification Format .26 7.1.1 Interface Class 26 7.1.2 Method descriptions26 7.1.3 Parameter descriptions26 7.1.4 State Model.26 7.2 Base Interface.27 7.2.1 Interface Class IpInterface 27 7.3 Service Interfaces .27 7.3.1 Overview 27 7.4 Generic Service Interface .27 7.4.1 Interfa
11、ce Class IpService 27 7.4.1.1 Method setCallback()27 7.4.1.2 Method setCallbackWithSessionID()28 8 Policy Management (PM) Interface Classes 28 8.1 PM Provisioning SCF Interface Classes.28 8.1.1 Interface Class IpPolicyManager28 8.1.1.1 Method createDomain() 29 8.1.1.2 Method getDomain().29 8.1.1.3 M
12、ethod removeDomain()30 8.1.1.4 Method getDomainCount() .30 8.1.1.5 Method getDomainIterator() .30 8.1.1.6 Method findMatchingDomains().30 8.1.1.7 Method createRepository()31 8.1.1.8 Method getRepository() 31 8.1.1.9 Method removeRepository() .31 8.1.1.10 Method getRepositoryCount().32 8.1.1.11 Metho
13、d getRepositoryIterator().32 8.1.1.12 Method startTransaction().32 8.1.1.13 Method commitTransaction()33 8.1.1.14 Method abortTransaction()33 ETSI ETSI ES 203 915-13 V1.2.1 (2007-01) 4 8.1.2 Interface Class IpPolicy33 8.1.2.1 Attributes.34 8.1.2.2 Method getAttribute() .34 8.1.2.3 Method setAttribut
14、e()35 8.1.2.4 Method getAttributes()35 8.1.2.5 Method setAttributes() 35 8.1.3 Interface Class IpPolicyDomain .36 8.1.3.1 Attributes.37 8.1.3.2 Method getParentDomain().38 8.1.3.3 Method createDomain() 38 8.1.3.4 Method getDomain().39 8.1.3.5 Method removeDomain()39 8.1.3.6 Method getDomainCount() .
15、39 8.1.3.7 Method getDomainIterator() .39 8.1.3.8 Method createGroup().40 8.1.3.9 Method getGroup()40 8.1.3.10 Method removeGroup() 40 8.1.3.11 Method getGroupCount()41 8.1.3.12 Method getGroupIterator()41 8.1.3.13 Method createRule()41 8.1.3.14 Method getRule() 42 8.1.3.15 Method removeRule() .42 8
16、.1.3.16 Method getRuleCount() 42 8.1.3.17 Method getRuleIterator() 42 8.1.3.18 Method createEventDefinition() .43 8.1.3.19 Method getEventDefinition() 43 8.1.3.20 Method removeEventDefinition().43 8.1.3.21 Method getEventDefinitionCount() 44 8.1.3.22 Method getEventDefinitionIterator() 44 8.1.3.23 M
17、ethod createVariableSet() 44 8.1.3.24 Method getVariableSet().45 8.1.3.25 Method removeVariableSet()45 8.1.3.26 Method getVariableSetCount() .45 8.1.3.27 Method getVariableSetIterator() .45 8.1.3.28 Method createVariable().46 8.1.3.29 Method setVariableValue() 46 8.1.3.30 Method getVariableType() .4
18、6 8.1.3.31 Method getVariableValue()47 8.1.3.32 Method getVariable()47 8.1.3.33 Method removeVariable() 48 8.1.3.34 Method createSignature() .48 8.1.3.35 Method getSignature()48 8.1.3.36 Method removeSignature().49 8.1.3.37 Method getSignatureCount() 49 8.1.3.38 Method getSignatureIterator() 49 8.1.
19、4 Interface Class IpPolicyGroup50 8.1.4.1 Attributes.51 8.1.4.2 Method getParentDomain().51 8.1.4.3 Method getParentGroup() .51 8.1.4.4 Method createGroup().52 8.1.4.5 Method getGroup()52 8.1.4.6 Method removeGroup() 52 8.1.4.7 Method getGroupCount()53 8.1.4.8 Method getGroupIterator()53 8.1.4.9 Met
20、hod createRule()53 8.1.4.10 Method getRule() 53 8.1.4.11 Method removeRule() .54 8.1.4.12 Method getRuleCount() 54 8.1.4.13 Method getRuleIterator() 54 8.1.5 Interface Class IpPolicyRepository.55 8.1.5.1 Attributes.55 8.1.5.2 Method getParentRepository() 56 ETSI ETSI ES 203 915-13 V1.2.1 (2007-01) 5
21、 8.1.5.3 Method createRepository()56 8.1.5.4 Method getRepository() 57 8.1.5.5 Method removeRepository() .57 8.1.5.6 Method getRepositoryCount().57 8.1.5.7 Method getRepositoryIterator().57 8.1.5.8 Method createCondition() .58 8.1.5.9 Method getCondition()58 8.1.5.10 Method removeCondition().59 8.1.
22、5.11 Method getConditionCount() 59 8.1.5.12 Method getConditionIterator() 59 8.1.5.13 Method createAction() 59 8.1.5.14 Method getAction().60 8.1.5.15 Method removeAction()60 8.1.5.16 Method getActionCount() .60 8.1.5.17 Method getActionIterator() .61 8.1.6 Interface Class IpPolicyRule.61 8.1.6.1 At
23、tributes.63 8.1.6.2 Method getParentGroup() .65 8.1.6.3 Method getParentDomain().65 8.1.6.4 Method createCondition() .65 8.1.6.5 Method getCondition()66 8.1.6.6 Method removeCondition().66 8.1.6.7 Method getConditionCount() 66 8.1.6.8 Method getConditionIterator() 67 8.1.6.9 Method createAction() 67
24、 8.1.6.10 Method getAction().67 8.1.6.11 Method removeAction()68 8.1.6.12 Method getActionCount() .68 8.1.6.13 Method getActionIterator() .68 8.1.6.14 Method setValidityPeriodConditionByName().69 8.1.6.15 Method setValidityPeriodCondition().69 8.1.6.16 Method getValidityPeriodCondition() 69 8.1.6.17
25、 Method unsetValidityPeriodCondition().69 8.1.6.18 Method setConditionList() 70 8.1.6.19 Method getConditionList()70 8.1.6.20 Method setActionList() .70 8.1.6.21 Method getActionList().70 8.1.7 Interface Class IpPolicyCondition 71 8.1.7.1 Attributes.72 8.1.7.2 Method getParentRepository() 72 8.1.7.3
26、 Method getParentRule() 73 8.1.8 Interface Class IpPolicyTimePeriodCondition .73 8.1.8.1 Attributes.74 8.1.9 Interface Class IpPolicyAction .77 8.1.9.1 Attributes.77 8.1.9.2 Method getParentRepository() 78 8.1.9.3 Method getParentRule() 78 8.1.10 Interface Class IpPolicyEventDefinition 78 8.1.10.1 A
27、ttributes.79 8.1.10.2 Method setRequiredAttributes()80 8.1.10.3 Method setOptionalAttributes() 80 8.1.10.4 Method getRequiredAttributes() .80 8.1.10.5 Method getOptionalAttributes()80 8.1.10.6 Method getParentDomain().81 8.1.11 Interface Class IpPolicyEventCondition.81 8.1.11.1 Attributes.81 8.1.12
28、Interface Class IpPolicyExpressionCondition 82 8.1.12.1 Attributes.82 8.1.13 Interface Class IpPolicyEventAction83 8.1.13.1 Attributes.83 8.1.14 Interface Class IpPolicyExpressionAction84 8.1.14.1 Attributes.84 ETSI ETSI ES 203 915-13 V1.2.1 (2007-01) 6 8.1.15 Interface Class IpPolicyIterator 85 8.1
29、.15.1 Attributes.85 8.1.15.2 Method getList() .86 8.1.16 Interface Class IpPolicySignature.86 8.1.16.1 Attributes.87 8.1.16.2 Method setInputVariables()88 8.1.16.3 Method setOutputVariables() .88 8.1.16.4 Method getInputVariables() .89 8.1.16.5 Method getOutputVariables().89 8.1.16.6 Method setGroup
30、Names() 89 8.1.16.7 Method setPolicyRoles() 90 8.1.16.8 Method getGroupNames()90 8.1.16.9 Method getPolicyRoles()90 8.1.16.10 Method getParentDomain() 90 8.2 PM Policy Evaluation SCF Interface Classes.91 8.2.1 Interface Class IpPolicyEvalManager.91 8.2.1.1 Method evalPolicy() .91 8.2.1.2 Method eval
31、PolicyReq().92 8.2.1.3 Method abortEvalPolicyReq()93 8.2.1.4 Method generateEvent() .93 8.2.1.5 Method createNotification() .93 8.2.1.6 Method destroyNotification() .94 8.2.2 Interface Class IpAppPolicyDomain 94 8.2.2.1 Method reportNotification()95 8.2.2.2 Method evalPolicyRes() .95 8.2.2.3 Method
32、evalPolicyErr() 95 9 State Transition Diagrams95 9.1 PM Provisioning SCF State Transition Diagrams 95 9.2 PM Policy Evaluation SCF State Transition Diagrams95 10 PM Service Properties95 11 Data Definitions .96 11.1 Policy Management Data Definitions.96 11.1.1 TpPolicyConditionListType .97 11.1.2 TpP
33、olicyConditionListElement 97 11.1.3 TpPolicyConditionList97 11.1.4 TpPolicyConditionType97 11.1.5 TpPolicyActionListElement .97 11.1.6 TpPolicyActionList.97 11.1.7 TpPolicyActionType.97 11.1.8 TpPolicyEvent 98 11.1.9 TpPolicyKeyword.98 11.1.10 TpPolicyKeywordSet99 11.1.11 TpPolicyError .99 11.1.12 I
34、pPolicyDomain99 11.1.13 IpPolicyDomainRef 99 11.1.14 IpPolicyRepository .99 11.1.15 IpPolicyRepositoryRef99 11.1.16 IpPolicyGroup.99 11.1.17 IpPolicyGroupRef.100 11.1.18 IpPolicyRule .100 11.1.19 IpPolicyRuleRef .100 11.1.20 IpPolicyEventDefinition .100 11.1.21 IpPolicyEventDefinitionRef .100 11.1.2
35、2 IpAppPolicyDomain .100 11.1.23 IpAppPolicyDomainRef .100 11.1.24 IpPolicyCondition.100 11.1.25 IpPolicyConditionRef .100 11.1.26 IpPolicyTimePeriodCondition 100 11.1.27 IpPolicyTimePeriodConditionRef 100 11.2 Data Types for PM Variables.100 ETSI ETSI ES 203 915-13 V1.2.1 (2007-01) 7 11.2.1 TpPolic
36、yVar100 11.2.2 TpPolicyVarSet.101 11.2.3 TpPolicyRecordType101 11.2.4 TpPolicyListType .101 11.2.5 TpPolicyTypeInfo.101 11.2.6 TpPolicyType .101 11.2.7 TpPolicyNameValue.102 11.2.8 TpPolicyNameValueList 102 11.3 eBNF for Condition and Action expressions102 11.3.1 Basic Definition102 11.3.2 Definitio
37、ns of Constant (Literals) .103 11.3.3 Definition of Operators.103 11.3.4 Allowable arithmetic expressions 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:
38、/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
39、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). The present document is part 13 of a multi-part deliverable covering Open Servi
40、ce Access (OSA); Application Programming Interface (API), as identified below. The API specification (ES 203 915) is structured in the following parts: Part 1: “Overview“; Part 2: “Common Data Definitions“; Part 3: “Framework“; Part 4: “Call Control“; Part 5: “User Interaction SCF“; Part 6: “Mobilit
41、y 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 13: “Policy Management SCF“; Part 14: “Presence and Availability Management SCF“; Pa
42、rt 15: “Multi-Media Messaging 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 JAIN Community (http:/ member companies. The present document forms part of the Parlay 5.1 set of specifications. The
43、 present document is equivalent to 3GPP TS 29.198-13 V6.4.0 (Release 6). ETSI ETSI ES 203 915-13 V1.2.1 (2007-01) 101 Scope The present document is part 13 of the Stage 3 specification for an Application Programming Interface (API) for Open Service Access (OSA). The OSA specifications define an arch
44、itecture 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 Policy Management Service Capability Feature (SCF) aspects of the interface. All aspects of the Policy Management SCF are de
45、fined here, these being: Sequence Diagrams. Class Diagrams. Interface specification plus detailed method descriptions. State Transition diagrams. Data Definitions. IDL Description of the interfaces. The process by which this task is accomplished is through the use of object modelling techniques desc
46、ribed by the Unified Modelling Language (UML). 2 References The references listed in clause 2 of ES 203 915-1 contain provisions which, through reference in this text, constitute provisions of the present document. ETSI ES 203 915-1: “Open Service Access (OSA); Application Programming Interface (API
47、); Part 1: Overview (Parlay 5)“. 3 Definitions and abbreviations 3.1 Definitions For the purposes of the present document, the terms and definitions given in ES 203 915-1 apply. 3.2 Abbreviations For the purposes of the present document, the abbreviations given in ES 203 915-1 apply. ETSI ETSI ES 20
48、3 915-13 V1.2.1 (2007-01) 114 Policy Management SCF It is expected that more and more OSA services will use policies to express operational criteria. It is also expected that network providers will host policy-enabled services that have been written by 3rdparty application service providers. In orde
49、r to manage policy information, control access to it and to request evaluation of policies a policy management service is needed. Consistent with this, a policy management provisioning manager, IpPolicyManager, and a policy evaluation manager, IpPolicyEvalManager have been defined. APIs have been defined to offer provisioning services. These include APIs to create, update or view policy information for any policy enabled service. Similarly APIs have been defined to facilitate interactions between clients (e.g. a 3rdparty applicatio
