YD/T 1939.3-2009 开放业务接入主程序接口（Parlay API）映射技术要求 第3部分：与智能网应用规程（INAP）的映射 YD/T1939.3-2009 标准下载解压密码：www.bzxz.net

ICS33.040.40
中华人民共和国通信行业标准
YD/T1939.3-2009
开放业务接入程序接口（ParlayAPl）映射技术要求
第3部分：与智能网应用规程
（INAP）的映射
Technical Requirements for Parlay API MappingPart 3: Parlay API to Intelligent Network Application Protocol (INAP) Mapping2009-06-15发布
2009-09-01实施
中华人民共和国工业和信息化部发布前
规范性引用文件·
3术语、定义和缩略语
4ParlayAPI和INAP映射的网络环境5ParlayAPI到INAP的映射·
5.2基本呼叫控制业务API到INAP的映射5.3多方呼叫控制业务API到INAP的映射5.4用户交互业务API到INAP的映射附录A（资料性附录）映射流程示例·参考文献
YD/T1939.3-2009
《开放业务接入程序接口（PariayAPI）映射要求》分为3个部分：一第1部分：与会话初始协议（SIP）的映射：YD/T1939.3-2009
一第2部分：与900/1800MHzTDMA数字蜂窝移动通信网移动应用部分（MAP）和CAMEL应用部分（CAP）的映射；
一第3部分：与智能网应用规程（INAP）的映射。本部分为《开放业务接入程序接口（ParlayAPI）映射要求》的第3部分。本部分中的ParlayAPI协议采用ParlayGroup组织的Parlay5.0，INAP协议采用行标YD/T1226-2002《能力集2(CS-2)阶段的智能网应用规程(INAP)》。附录A为资料性附录。
本标准由中国通信标准化协会提出并归口。本标准起草单位：工业和信息化部电信研究院、中国电信集团公司本标准主要起草人：减磊、林玮平、吴宏建、凌颖1范围
YD/T1939.3-2009
开放业务接入程序接口（ParlayAPI）映射技术要求第3部分：与智能网应用规程（INAP）的映射本部分规定了ParlayAPI和INAP协议的映射要求，包括了ParlayAPI中基本呼叫控制业务，多方呼叫控制业务，用户交互业务中各接口、方法和参数与INAP协议各操作和参数的映射。本部分适用于使用ParlayAPI和INAP协议映射的Parlay网关等实体。2规范性引用文件
下列文件中的条款通过本部分的引用而成为本部分的条款。凡是注日期的引用文件，其随后所有的修改单（不包括勘误的内容）或修订版均不适用于本部分。然而，鼓励根据本部分达成协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件，其最新版本适用于本部分。YD/T1226-2002
ETSIES203915-4-2V1.1.1
能力集2（CS-2）阶段的智能网应用规程(INAP)开放业务接入（OSA）；应用编程接口（API）第4部分：呼叫控制：第2子部分：基本呼叫控制SCF
开放业务接入（OSA）；应用编程接口（API）第4部分：呼叫控制；ETSIES203915-4-3V1.1.1
第3子部分：多方呼叫控制SCF
ETSIES203915-5V1.1.1
3术语、定义和缩略语
3.1术语和定义
开放业务接入（OSA）；应用编程接口（API）第5部分：用户交互SCF下列术语和定义适用于本部分。3.1.1
业务能力特征ServiceCapabilityFeature对网络的各种能力或资源的抽象。它向Parlay应用提供接入到网络能力的接口。业务能力特征也可以简称为业务（service）。
业务能力服务器ServiceCapabilityServer提供或支持一个或多个业务能力特征的逻辑实体。在本部分中，如没有特别说明，指的就是Parlay网关。
Parlay应用ParlayApplication
一种软件或程序，它需要通过接入到一个或多个ParlaySCF来完成具体的应用功能。它一般由业务提供商和独立软件商（ISV）提供，基至由客户自已来编写。Parlay应用一般在第三方应用服务器上运行，并通过Parlay网关获得网络的能力。在有些文献里也将其称为Parlay客户应用，或简称为应用。1
YD/T1939.3-2009
Parlay网关ParlayGateway
是核心网络网关，为Parlay客户提供各种基本业务能力的支持，使Parlay的业务能够有控制地、安全地进入到各通信网内。
3.2缩略语
下列缩略语适用于本部分。
ApplicationProgrammingInterfaceCall Control
Generic Call Control
Generic Call Control ServiceIntelligent Network Application ProtocolMulti-PartyCall Control
IntelligentNetworkServiceControlFunctionService Capability Feature
Service Capability Server
gsm Special Resource FunctiongsmServiceSwitchFunction
TransactionCapabilitiesApplicationPart4ParlayAPI和INAP映射的网络环境应用程序接口
呼叫控制
基本呼叫控制
基本呼叫控制业务
智能网应用规程
多方呼叫控制
智能网中的业务控制功能
业务能力特征
业务能力服务器
专用资源功能
业务交换功能
事务处理能力应用部分
图1给出了ParlayAPI和INAP映射的网络环境。Parlay网关面向Parlay应用一侧，提供各类业务能力特征的接口；面向核心网络一侧，提供智能网中的SCF功能。Parlay网关完成ParlayAPI到INAP协议的映射，根据具体NAP操作的不同，Parlay网关将与SSF或SRF进行交互。本部分的范围
ParlayGW
核心网络
5ParlayAPI到INAP的映射
5.1概述
智能网中
的SCF
Parlay中
的SCF
图1PariayAPI与INAP的映射
ParlayAPI
Parlay应用
ParlayAPI定义了框架接口和多种业务能力特征的接口，但并不是所有ParlayAPI定义的接口都可以或需要映射到INAP协议。在本部分中，规定了ParlayAPI中定义的基本呼叫控制业务、多方呼叫控制业务、用户交互业务与INAP协议的映射。ParlayAPI与INAP协议映射能力见表1。2
ParlayAPI
基本呼叫控制
呼州控制SCF
用户交互SCF
移动性SCF
终端能力SCF
多方呼训控制
多媒体呼叫控制
会议呼叫控制
数据会话控制SCF
基本消息SCF
连通性管理SCF
账户管理SCF
计费SCF
策略管理SCF
垦现信息管理SCF
多媒体消息SCF
表1ParlayAPI与INAP协议映射能力映射在本文中是否包含
与INAP协议无映射关系
用于支持用户的基本呼叫处理
用于支持用户的多方呼叫处理
与INAP协议无映射关系
与INAP协议无映射关系
用于支持用户的放音收号处理
与INAP协议无映射关系
与INAP协议无映射关系
与INAP协议无映射关系
与INAP协议无映射关系
与INAP协议无映射关系
与INAP协议无映射关系
与INAP协议无映射关系
与INAP协议无映射关系
与INAP协议无映射关系
与INAP协议无映射关系
注1：在可以映射的SCF中，并非所有接口、方法和参数都可以或需要映射。YD/T1939.3-2009
注2：对于没有映射关系的参数，如果因业务逻辑或协议规定需要在操作中携带，则应由Pariay网关根据协议要求进行添加
本部分中ParlayAPI基于ParlayAPI5.0版本（ETSIES203915-4-2、ETSIES203915-4-3、ETSIES203915-5）进行描述，INAP协议基于YD/T1226-2002《能力集2(CS-2)阶段的智能网应用规程(INAP)》进行描述。但由于ParlayAPI和INAP协议均具有后向兼容性，因此并不意味着本部分中的规定仅适用于ParlayAPI5.0与INAPCS-2两个版本之间的映射。其他版本间的映射应遵循以下原则：一如果不同版本具有某些相同的能力，包括操作和参数等，则相关的映射同样适用。一如果高版本拥有低版本所不具备的能力，包括操作和参数等，则相关的映射对低版本自动失效。5.2基本呼叫控制业务API到INAP的映射5.2.1接口类lpCallControlManager的映射接口类IpCallControManager继承IpService。其中setCalILoadControl方法与INAP协议有映射，其他没有映射的方法不再单独列出。
5.2.1.1setCallLoadControl
setCallLoadControl (duration : in TpDuration, mechanism : in TpCallLoadControiMechanism, treatment :inTpCallTreatment,addressRange:inTpAddressRange):TpAssignmentiD此方法用于进行呼叫负荷控制。此方法与INAP协议的映射如图2所示。3
YD/T1939.3-2009
正常程序见表2。
CallGap
CalGap
GCCSCF
Application
setCallLoadControl
图2setCallLoadControl呼叫流程表2正常程序
前提案件解叫控制管理接回处于正帝状态应用调用setCallLoadControl方法2
GCCSCF向INSCF发送等效的消息
INSCF向相应的SSF发送CallGap消息。该消息只在SSF已通过InitialDP打开了一个对话后发送参数映射见表3。
表3setCallLoadControl和CallGap的参数映射FromasetCallLoadConurol
duration
mechanism
callLoadControlPerInterval
treatment
ReleaseCause
AdditionalTreatmentInfo
InformationToSend
addressRange
gapIndicators
duration
gapndicators
gapInterval
gapTreatment
ReleaseCause
TorCallCap
InformationToSend
gapCriteria
calledAddressValue
assignmentID（用于关联应用和ParlaySCF间的请求和响应）N/A5.2.2接口类lpAppCallControlManager的映射接口类IpAppCallControlManager继承IpInterface。其中callEventNotify方法与INAP协议有映射，其他没有映射的方法不再单独列出。5.2.2.1callEventNotify
callEventNotify (caliReference : in TpCalldentifier, eventInfo : in TpCallEventInfo, assignmentD : inTpAssignmentID)：IpAppCaliRef此方法通知应用与呼叫相关的事件到达。此方法与INAP协议的映射如图3所示。SSF
InitiaIDp
GCCSCF
图3callEventNotify呼叫流程
Application
callEventNotify
正常程序见表4。
正常程序
魔提条件呼通u色经边特embiccaiNoimcanon方法在呼的管理接尚危动呼川到达SSF，根据初始触发条件向INSCF发送InitialDP2
INSCF向GCCSCF传递触发信息
GCCSCF确定应用需要控制呼川并调用calIEventNotify方法参数映射见表5和表6。
FromInitialDp
calledPartyNumber
calling Party Number
originalCalledPartyID
redirectingParyID
highLaycrCompatibility
bearerCapability
callingPartysCategory
additionalCallingPartyNumbereventTypeBCSM
serviceKey
cGEncountered
iPSSPCapabilities
locationNumber
redirectionInformation
YD/T1939.3-2009
5InitialDP和callEventNotify的参数映射表5
eTo.calEvenNoriry
callReference
eventinfo(TpCallEventinfo):
destinationAddress
originatingAddress
originalDestinationAddress
redirectingAddress
callAppInfo (TpCallAppInfoSet):CallAppAlertingMechanism
CallAppNetworkAccessType
CallAppTeleService
CallAppBearerService
CallAppPartyCategory
CallAppPresentationAddress
CallAppGenericInfo
CallAppAdditionalAddress
callEventName（见表3）
callNotificationType
assignmentID（用于关联应用和ParlaySCF间的请求和响应）appCall
eventTypeBCSM和callEventName的参数映射From: InitialDP parametereventTypeBCSM nTo:calEventNotify parameter callEventNameinevenunfoP_EVENT_NAME_UNDEFINED
P_EVENT_GCCS_OFFHOOK_EVENT
collectedlnfo,tcrmAltemptAuthorizedanalyzedinforniation
oCalledPartyBusy /Busy
oCalledPartyBusy/tBusy（见注释）oNoAnswcr/tNoAnswer
routcSclcctFailure
oAnswer/Answcr
注释：根据cause参数中具体原因值确定P_EVENT_GCCS_ADDRESS_COLLECTED_EVENTP_EVENT_GCCS_ADDRESS_ANALYSED_EVENTP_EVENT_GCCS_CALLED_PARTY_BUSYP_EVENT_GCCS_CALLED_PARTY_UNREACHABLEP_EVENT_GCCS_NO_ANSWER_FROM_CALLED_PARTYP_EVENT_GCCS_ROUTE_SELECT_FAILUREP_EVENT_GCCS_ANSWER_FROM_CALL_PARTY5
YD/T1939.3-2009
5.2.3接口类lpCall的映射
接类IpCall继承IpService。其中routeReq、release、deassignCall、getCallInfoReq、setCallChargePlan、superviseCaliReq、continueProcessing方法与INAP协议有映射，其他没有映射的方法不再单独列出。5.2.3.1 routeReg
routeReq (caliSessionD : in TpSessionD, responseRequested : in TpCallReportRequestSet, targetAddress :in TpAddress,originatingAddress: in TpAddress, originalDestinationAddress: in TpAddress, redirectingAddresstin TpAddress.appInfo : in TpCallAppInfoSet): TpSessionID此方法是异步方法，用于请求将呼叫路由到被叫方。此方法与INAP协议的映射如图4和图5所示。SSF
RequestReporBCSMEvent（t果需要）Connect（场景）
Continue（场景2）
ContinueWithArgument（场景3）GCCSCF
TouteReg
图4routeReq呼叫流程（场景1、场景2和场景3）SSF
InitiateCallArtempt
RequestReportBCSMEvent
Continue（场景4）
GCCSCF
roufeRea
图5routeReq呼叫流程（场景4）存在4种可能的场景：
场景1：应用需要改变目的地地址；场景2：应用不需要修改目的地地址并且不提供任何应用的信息；场景3：应用不需要修改目的地地址并且提供应用的信息；场景4：应用主动发起试呼。
场景1、场景2和场景3的正常程序见表7。表7正常程序
Application
Application
前提系件，应用已被通知有新的呼叫发生并且呼叫对象存在scicalichargePlan和getcalinfoRcq方法可能已经被调用应用调用roulteReq方法
GCCSCF发送等效的内部消息给INSCF如果应用需要被通知请求的结果，则INSCF发送RequestReportBCSMEvent消息INSCF根据具体场景，发送Connect、Continue或ContinueWithArgument消息场景4的正常程序见表8。
3正常程序
前提条件应用有权限主动发起微呼1
应用调用routeReq方法
GCCSCF发送等效的内部消息给INSCFINSCF发送InitiatcCallAttempt、RequestReportBCSMEvent和Continue消息参数映射见表9、表10、表11、表12和表13。表9
routeReq和RequestReportBCSMEvent的参数映射From:routeReg
callSessionID
responseRequested(TpCallReportRequestSet)：MonitorMode (TpCallMonitorMode)CallReportType (TpCallRepor'Type)AdditionalReportCriteria
(TpCallReportAdditionalCriteria):noAnswerDuration
scrviceCodewwW.bzxz.Net
argctAddress
originatingAddress
originalDestinationAddress
redirectingAddress
appInfo
callLegSessionID
YD/T1939.3-2009
To:RequestReporBCSMEvent
N/A（用于关联当前的TCAP会话）bcsmEvent:
monitorMode
eventTypeBCSM
dPSpecificCriteria :
applicationTimer
routeReq和Connect的参数映射
romrouteReg
.To:Connect
caliSessionID
responseRequested
targetAddress
originatingAddress
originalDestinationAddress
redirectingAddress
appInfo (TpCallAppInfoSet) :CallAppAlertingMechanism
CallAppNetworkAccessType
CallAppTeleService
CallAppBcarerService
CallAppPartyCategory
PresentationAddress
CallAppGenericInfo
CallAppAdditionalAddress
callLegSessionID
N/A（用于关联当前的TCAP会话）NIA
destinationRoutingAddress
callingPartyNumber
originalCalledPartyID
redirectingPartyID
alertingPattern
callingPartysCategory
genericNumbers（见注释）
genericNumbers
serviceInteractionIndicatorsTworedirectionInformation
注释：如果CallAppAdditionalAddress不用于映射genericNumbers参数，则可使用此参数7
YD/T1939.3-2009
routeReq和Continue的参数映射eFrom roueRe To.cohinckh
callSessionID
responseRequested
targetAddress
originatingAddress
originalDestinationAddress
redirectingAddress
applnfo
callLegSessionID
N/A（用于关联当前的TCAP会话）NIA
routeReg和ContinueWithArgument的参数映射LxPromirouteReqw
callSessionID
responseRequested
targetAddress
originatingAddress
originalDestinationAddress
redirectingAddress
appInfo:
CallAppAlertingMechanism
CallAppNetworkAccessType
CallAppTeleService
CallAnnBearerService
CallAppPartyCategory
PresentationAddress
CallAppGenericInfo
CallAppAdditionalAddress
callLegSessionID
ysTo.continuewithArgumentm
N/A（用于关联当前的TCAP会话）N/A
alertingPattem
serviceInteractionIndicatorsTwo表13routeReg和InitiateCallAttempt的参数映射omFoutReeTonicchiAienpe
calISessionID
responseRequested
argetAddress
originatingAddress
originalDestinationAddress
redirectingAddress
appInfo (TpCallAppInfoSet) :CallAppAlertingMechanism
CailAppNetworkAccessType
CallAppTeleService
CallAppBearerService
CallAppPartyCategory
PresentationAddress
CallAppGenericInfo
CallAppAdditionalAddress
callLegSessionID
N/A（用于关联当前的TCAP会话）N/A
destinationRoutingAddress
CallingPartyNumber
alertingPattern
servicelnteractionlndicatorsTwo
小提示：此标准内容仅展示完整标准里的部分截取内容，若需要完整标准请到上方自行免费下载完整标准文档。