新一代BILLING系统研发详细设计说明书分拣模块v.doc

新一代新一代 BILLING 系统系统研发项目研发项目 详细设计说明详细设计说明-计计费帐务引擎费帐务引擎 版本版本 文档信息文档信息 项目名称项目名称 项目经理项目经理文档版本文档版本V1.0 质量评审方法质量评审方法 文档编写人文档编写人编写日期编写日期 文档评审人文档评审人评审日期评审日期 分发分发 FromDatePhone/Fax To Action*Due DatePhone/Fax * Action Types: Approve, Review, Inform, File, Action Required, Attend Meeting, Other (please specify) 修订文档历史记录修订文档历史记录 日期日期版本版本说明说明作者作者 V1.0 创建初稿 版权说明版权说明 All rights reserved. Neither the whole nor any parts of this document may be reproduced, stored in any retrieval system or transmitted, in any form or by any means, without the prior written consent of the copyright owner. Copyright 2008 by 联创科技 All rights reserved. 目目 录录 1.引言引言.6 1.1软件名称.6 1.2文档说明.6 1.3文档读者.6 1.4参考资料.6 1.5名词与缩写.6 2.XX 模块模块/子系统设计子系统设计.7 2.1功能描述.7 2.2处理流程.10 2.3输入数据.11 2.3.1预处理后话单文件.11 2.3.2SP包月话单文件.11 2.4输出数据.12 2.4.1分拣后的话单文件.12 2.5内部数据.13 2.5.1配置信息.13 2.5.2内存数据.24 2.6模块结构.25 2.6.1总控类.27 2.6.1.1 类总体描述.27 2.6.1.2 方法实现设计.28 2.6.2配置参数管理类.30 2.6.2.1 类总体描述.30 2.6.2.2 方法实现设计.32 2.6.3输入输出类.36 2.6.3.1 类总体描述.36 2.6.3.2 方法实现设计.38 2.6.4过程处理类.41 2.6.4.1 类总体描述.41 2.6.4.2 方法实现设计.43 2.6.5日志类.44 2.6.4.1 类总体描述.44 2.6.4.2 方法实现设计.45 2.7性能设计.45 2.8异常机制.46 2.9与其他模块/子系统关系 .46 2.10设计约定.46 3.参数管理子模块设计参数管理子模块设计.46 3.1模块描述.46 3.2类描述.47 3.2.1PMGlobalManager类.47 3.2.1.1类总体描述.47 3.2.1.2方法实现设计.47 3.2.2PM_Filter类.48 3.2.2.1类总体描述.48 3.2.2.2方法实现设计.49 3.2.3MdbInfo类.50 5.2.3.1 类总体描述.50 5.2.3.2 方法实现设计.50 3.2.4Mdb_Property.51 5.2.4.1 类总体描述.51 5.2.4.2 方法实现设计.51 3.2.5MDB_ServInfo_Crm类.52 5.2.5.1 类总体描述.52 5.2.5.2 方法实现设计.52 3.3性能设计.53 3.4与其他子模块关系.53 4.话单类子模块设计话单类子模块设计.53 4.1模块描述.53 4.2CDRPROC类描述.53 4.2.1语音类.53 4.2.1.1类总体描述.53 4.2.1.2方法实现设计.53 4.3性能设计.54 5.YY2 子模块设计子模块设计.55 5.1模块描述.55 5.2类描述.55 5.2.1XX类.55 5.2.1.1类总体描述.55 5.2.1.2方法实现设计.55 5.3性能设计.55 6.遗留问题遗留问题.55 1.1.引言引言 1.11.1软件名称软件名称 说明软件的名称。如： 联创科技新一代 BILLING 产品分拣模块。 1.21.2文档说明文档说明 说明软件的目的和内容等。如： 本文档详细描述分拣模块所涉及到的模块的设计思路和主要的数据结构以及主要的算法。 文档的目的是为程序编码提供流程逻辑、设计约束；为其他模块应用程序开发人员提供接口调用 说明； 为软件维护人员提供软件详细设计说明。 1.31.3文档读者文档读者 说明文档面向的读者对象。如： 本技术方案面向的读者对象包括： BILLING 研发项目组所有成员：包括需求分析人员、设计人员、编码和测试人员等； 技术中心规划部、设计部和产品部成员； 技术中心领导； 公司范围内感兴趣的领导或同事。 1.41.4参考资料参考资料 【联创科技】：新一代 BILLING 系统研发技术方案 【联创科技】：新一代 BILLING 系统研发需求规格书 【联创科技】：新一代 BILLING 系统研发概要设计说明书 1.51.5名词与缩写名词与缩写 说明文档中涉及的名词、缩写。各模块中特有的说明即可。 2.2.XXXX 模块模块/ /子系统设计子系统设计 2.12.1功能描述功能描述 说明该模块/子系统在整个 BILLING 系统中的功能定位，总结归纳该模块/子系统应具备的功能点。 可以引用概要设计的内容或在概要设计的基础上进行完善。 分拣模块在 BILLING 系统中的位置如下： 分拣模块负责处理从综合采集模块传输来的标准话单、回收回退处理后的标准话单、其他模块生 成的包月话单，针对各种不同业务不同格式的话单进行字段解析，格式转换，字段提取，变成综合计 费帐务系统内部统一的格式，并且能够支持按照各种可配置的标准进行话单分拣，将话单分目录输出。 具体功能如下： 一次分拣：基于基本话单属性，基本参数表区分漫游来访话单，省内话单，无效话单 计费方设定 排重字段提取 属性求解 一次通道分拣 二次分拣：基于用户资料，局数据参数表属性对省内话单进行属性求取，相关稽核，排重字 段提取，资料绑定，按不同用户通道输出到相应路径，各个环节出现的错单也输出到相应路 径供错单接收流程处理 属性求解 订购关系、用户状态、用户服务许可状态、费用校验稽核 资料绑定 二次通道分拣 分拣处理主要包括：输入输出、计费方设定、属性求解、稽核、资料绑定、通道分拣等功能模块。 属性求解模块要设计的相对独立，可以直接提供给批价模块、OCS 模块直接使用。 考虑话单输入输出目录（或内存结构） 、结构等可灵活配置。话单的处理过程可灵活配置。 输入输出输入输出 输入模块负责从文件或内存中读取话单，并按照指定的格式转换为内部格式保存在内部话单结构 中。 输出模块负责将话单从内存话单结构中按照指定的格式输出（文件格式），也可以采用直接写回 内存队列方式。 分拣处理规则分拣处理规则 业务处理模块主要是处理语音、短信、GPRS、MISC、CDMA1X、17911/193IP 长途话单以及统计类 型的神州行短信、统计类型话单。处理流程图详设附上。 计费方设定计费方设定 短信业务中有根据短信中心号码、SP 代码、服务代码号码来确定计费方，还有一些主叫付费、被 叫付费业务，都在此确定计费方号。 排重字段提取排重字段提取 根据设定的排重字段提取配置，将排重关键字输出，减少流程复杂度，重做日志等诸多配置改造。 暂考虑 MISC 平台话单排重字段提取。 属性求解属性求解 属性求解模块负责根据话单基本属性，结合计费基本参数信息（比如：号段、IMSI 段、网元参数 等）求取计费要素（比如：GSM 的漫游类型、长途类型、计费方业务类型、对方业务类型。短信：网 内点对点、网间点对点、上下行标记等）。 要求：独立封装，并可按照要求灵活部署在分拣模块、批价处理模块或者 OCS 相应模块中。 稽核稽核 对相关业务进行必要的订购关系、用户状态、用户服务许可状态、费用等进行稽核检查。 资料绑定资料绑定 资料绑定模块根据计费号码通过内存数据库提供的查询接口获取用户资料，动态绑定所需资料， 计费要素，获取不到资料的话单判为无主。 2.22.2处理流程处理流程 开始 分拣初始化 (配置信息、输入输出、参 数管理配置、处理过程等) 读取标准话单 读取记录 选择子通道 (分拣采用单进程多 通道处理模式) 话单文件存在 N 结束 (处理异常或 正常终止) 按通道类别输出标 准话单 调用过程开始 根据话单种类处理 (无效话单等初步判断，语音、短 信、GPRS、MISC、固网、宽带 业务等) 属性求取 排重字段提取 (可选) 计费方确定(可选) 稽核(可选) (根据规则结合用户 资料核查) 用户资料绑定(可选) (部分话单属性重求) 调用过程结束 记录读取完毕 N 处理的文件数目文件名命名规则、内存）； 输入数据的内容格式（有哪些字段、字段长度、分隔符号）； 2.3.12.3.1 预处理后话单文件预处理后话单文件 功能功能 经过预处理模块处理后的标准话单文件，包括各种业务的话单（GSM 大类、SM 大类、GPRS 大类、 MISC 大类、固网语音大类、宽带数据业务、固网代收业务、统计类话单等），实时方式提供。 来源 BILLING 系统预处理模块 文件名 原始文件名：MSC 或短信中心或集团下发等文件名，采集系统也可能统一命名提供，没特定规律 分割符号 逗号 “,” 也可以支持其他字符 文件格式 见系统模块间接口和清账单模型设计（清单流）.xls文件的各 Sheet 页中预处理输出结构。 2.3.22.3.2 SPSP 包月话单文件包月话单文件 功能功能 BILLING 系统 SP 包月话单模块生成的文件，文件实时方式提供。 来源来源 BILLING 系统 SP 包月话单生成模块 文件名文件名 待定 分隔符号分隔符号 逗号 “,” 文件格式 见系统模块间接口和清账单模型设计（清单流）.xls文件的各 Sheet 页中包月费计算输出 SP 话单结构。 2.42.4输出数据输出数据 描述该模块/子系统输出的数据信息，应该包含下面内容： 输出数据的去向描述(比如是分拣、固定费生成模块等)； 输出数据的作用描述（比如是清单、帐单等）； 输出数据载体以及载体描述（文件-文件名命名规则、内存）； 输出数据的内容格式（有哪些字段、字段长度、分隔符号）； 2.4.12.4.1 分拣后的话单文件分拣后的话单文件 功能功能 用于批价、统计 去向去向 排重、批价、入库 文件名文件名 业务种类业务种类 省内（省内（GSM/CDMA/GSM/CDMA/出出 访访/ /智能网）智能网） 国内来访国内来访国际来访国际来访无主话单无主话单错误话单错误话单 移动网语音业务 VOPVON00VOI00VOP00EVOP0 固网语音业务 FIPFIP00EFIP0 短信业务 SMSSMN00SMS00ESMS0 增值业务 SPPSPP00ESPP0 移动 MISC 业务 MICMIC00EMIC0 电信代收费计费业务 FICFIC00EFIC0 gprsGPPGPN00GPI00GPP00EGPP0 CDMA1X 业务 1XP1XN001XI001XP00E1XP0 宽带窄带数据业务 NEPNEP00ENEP0 IP 业务 IPPIPP00EIPP0 A2SMA;A3SMB ppc,pps 短信(统计） B2SMA;B3SMB ppc,pps 语音(统计） A1VOI;B1VOI ppc1X(统计) A41XS;B41XS ppc1xsp(统计) A5SPS;B5SPS; A6SPS;B6SPS 宝视通(统计） C7VES;C8VES PPC、PPS 充值 A7IVS;B7IVS 193/17911(统计） C1VPS;C2VPS;C3VPS; C4VPS;C5VPS 电信代收费（统计查 询） D1MIC;D2MIC 分隔符号分隔符号 逗号 “,” 文件格式文件格式 见系统模块间接口和清账单模型设计（清单流）.xls文件的各 Sheet 页中分拣输出清单结构 2.52.5内部数据内部数据 描述该模块/子系统内部处理使用到的配置文件/配置表的配置信息、内部处理使用的内存数据格 式（比如用户帐单格式、帐户帐单格式、累计量格式）等； 2.5.12.5.1 配置信息配置信息 描述配置文件/配置表的配置信息，应该包含下面内容： 配置信息的作用描述； 配置信息的载体（文件文件名称；表-表名称）； 配置信息的组织方式（比如是 XML 还是用分割符隔开）； 配置信息包含的字段信息（字段名称、包含的信息、作用），最好能实例化说明； 配置信息以文件方式保存，以以“#”字符开头的为配置中的注释，实际配置中可以不追加，蓝 色字体为为注解，格式如下： #分拣配置说明 # 1 separate 为话单分隔符标识，默认为逗号,，也可以在不同通道下单独制定，例如 /filter/1/channel_1/separate = | # 2 bind_method 绑定资料方式，默认为1，根据手机号码来求取，通道内不单独制定，跟 分 隔符标识一样默认缺省 filter.CDR_ATTRIBUTES_MACRO.cfg 是对记录各字段的宏定义，程序内部使用 INCLUDE_CONFIG = $BOSS_HOME/etc/filter/filter.CDR_ATTRIBUTES_MACRO.cfg filter.file_format.cfg 输入输出字段格式定义 INCLUDE_CONFIG = $BOSS_HOME/etc/filter/filter.file_format.cfg 求 A 归属地方法 get_a_home_method = 2 #A_HOME_BY_IMSI = 1,A_HOME_BY_MSISDN 求 A 到访地方法 get_a_visit_method = 5 #A_VISIT_BY_MSC_LAC = 1,A_VISIT_BY_MSC_LAC_CELLID,A_VISIT_BY_CELLID,A_VISIT_BY_MSC_CELLID,A_VISIT_BY_LAC,A_ VISIT_BY_MSC,A_VISIT_BY_LAC_CELLID 求 GPRS 中 A 到访地方法 get_gprs_a_visit_method = 6 #A_VISIT_BY_PROV_CODE = 1 求 B 归属地方法 get_b_home_method = 1 #B_HOME_BY_MSISND = 1,B_HOME_BY_MSISDN_IMSI 求 B 到访地方法 get_b_visit_method = 2 #B_VISIT_BY_LAC_CELLID_MSRN = 1,B_VISIT_BY_MSRN,B_VISIT_BY_HOME,B_VISIT_BY_MSRN1 求漫游来访 A 归属地方法 get_ro_a_home_method = 1 #A_RO_HOME_BY_MSISDN = 1 求漫游来访 A 到访地方法 get_ro_a_visit_method = 1 #A_RO_VISIT_BY_MSC = 1,A_RO_VISIT_BY_ORG 求漫游来访 B 归属地方法 get_ro_b_home_method = 1 #B_RO_HOME_BY_MSISND = 1 求漫游来访 B 到访地方法 get_ro_b_visit_method = 1 #B_RO_VISIT_BY_MSRN = 1 求省内边界漫游类型方法 get_prov_edgeroam_method = 7 #EDGE_ROAM_BY_CELLID=1,EDGE_ROAM_BY_LAC_CELLID,EDGE_ROAM_BY_MSC_LAC_CELLID,EDGE_ROAM _ROAMOUT_BY_CELLID,EDGE_ROAM_ROAMOUT_BY_LAC_CELLID,EDGE_ROAM_ROAMOUT_BY_MSC_LAC_CELLI D,EDGE_ROAM_BY_MSC_CELLID 求省际边界漫游类型方法 get_roamout_edgeroam_method = 7 #EDGE_ROAM_BY_CELLID=1,EDGE_ROAM_BY_LAC_CELLID,EDGE_ROAM_BY_MSC_LAC_CELLID,EDGE_ROAM _ROAMOUT_BY_CELLID,EDGE_ROAM_ROAMOUT_BY_LAC_CELLID,EDGE_ROAM_ROAMOUT_BY_MSC_LAC_CELLI D,EDGE_ROAM_BY_MSC_CELLID #origin system config 绑定用户资料方式 1-根据 MSISDN 号 2-根据 IMSI 号 3-先根据 MSISDN 号找，找不到再根据 IMSI 号 default_bind_method = 1 #(BIND_BY_MSISDN = 1,BIND_BY_IMSI,BIND_BY_MSISDN_IMSI)二分绑资料方式 本地彩信类型求取方式 get_local_mms_b_method = 2 #B_BY_SP_SERVICE = 1,B_BY_SP_SERVICE_OPER 稽核用户状态时间选择方式 get_status_audit_method = 2 #FINISH_TIME,CURRENT_TIME,DELAY_TIME,DELAY_CURRENT_TIME 稽核用户业务许可状态顺序 1-先进行用户业务许可状态稽核，再进行用户其余状态稽核 2-反之 get_svc_allowance_method = 1 #AUDIT_TO_FREE = 1,FREE_TO_AUDIT 失效话单默认路径 delay_time = 600 #get_status_audit_method 方式中延长指定时间处理 file_error_path = $BOSS_DATA/filter/ferr/ 默认话单分隔符 default_separate = , 目录下文件排序方式 sort_method = 2 #SF_NONE = 0,SF_NAME,SF_MODIFYTIME 物理数据库名称 server_name = gbossbilling 参数表用户 user_name = ucr_param 参数表用户密码 password = ucrparamcba 省代码 province_code = 731 内存数据库名 mdb_servername = testmdb 内存数据库主机名 mdb_hostname = 内存数据库端口号 mdb_port =0 #分通道要素 前缀:BIZ_TYPE 简易化，暂不考虑规则法取分通道要素 业务大类 biz_type = 1 #GSM 分通道关键字段 field_factors = ATTRI_BIZ_TYPE;ATTRI_SOURCE_TYPE;ATTRI_CALL_TYPE;ATTRI_ROAM_TYPE;ATTRI_USER_HOME_TYPE _A;ATTRI_TD_TYPE;ATTRI_NATIONAL_CHANNEL;ATTRI_RATE_INDICATE;ATTRI_ERROR_FLAG;ATTRI_BE GIN_DATE;ATTRI_BEGIN_TIME biz_type = 2 #SM field_factors = ATTRI_BIZ_TYPE;ATTRI_SOURCE_TYPE;ATTRI_CALL_TYPE;ATTRI_SEND_STATUS;ATTRI_CHARGE_TYPE; ATTRI_TON_TYPE;ATTRI_SM_SERV_TY