DIGITMAP配置详解Word下载.docx

1、09资料光盘更新Digitmap数据配置V1.012009-9-7增加对Digitmap结束事件、流程和匹配情况的说明。一.1 概述DigitMap，即号码采集规则描述符，它是驻留在媒体网关内的拨号方案，用于检测和报告终端接收的拨号事件。采用DigitMap 的主要目的是提高媒体网关发送被叫号码的效率，即当用户所拨的被叫号码符合DigitMap 所定义的拨号方案之一时，媒体网关将此被叫号码用一个消息集中发送。DigitMap 的格式由H.248 协议或MGCP协议严格定义，它由一系列代表一定含义的数字字符串组成，只要所收到的拨号序列与其中的一串字符相匹配就表示号码已经收齐。SS当前一般不会解析

2、Digitmap，SS将配置好的Digitmap下发给指定MG，MG通过解析Digitmap来完成收号功能，本文档以H.248协议为例说明SS上如何配置号码表。一.2 H.248 协议的DigitMap一.2.1 DigitMap的定义、创建、更新和删除号码表（DigitMap）指的是MG中的拨号方案，用于检测和报告在终端上接收到的拨号事件。DigitMap 描述符包含DigitMap 名称（DigitMapName）和指定的DigitMap。DigitMap 可以通过管理系统预先装载于MG，并通过在Events 描述符中指定DigtMap 名称进行引用；DigitMap 还可以动态定义,并随

3、后通过所定义的DigitMap 名称进行引用；还可以在Events 描述符中定义当前的DigitMap。在一个命令中的DigitMap 描述符中定义的DigitMap，可以被同一命令中的Events 描述符里的DigitMap Completion 事件所引用，而无需考虑相应描述符的传送顺序。H248协议规定的任何命令都可以使用DigitMap 描述符中定义的DigitMap。DigitMap 一经定义，则可以适用于命令中该TerminationID（可能为通配值）所指定的所有终端。根终端中定义的DigitMap 具有全局性，适用于MG 中的任意终端，只要名称相同的DigitMap 未在特定终

4、端中另作定义。H248协议规定可以按照以下方式在DigitMap 描述符中动态定义DigitMap： 创建新的DigitMap 可以通过定义一个未被使用的DigitMap 名称，并应给出取值。 更新DigitMap可以通过给一个已定义的DigitMap 名称赋一个新值。DigitMap 值更新后，当前正使用该DigitMap 的所有终端应该继续使用更新前的DigitMap 定义值；而后面的Events 描述符中的DigitMap 描述符如果包含了该DigitMap 名称，则应使用更新后的DigitMap 定义值。 删除DigitMap 可以通过给一个已被定义的DigitMap 名称赋一个空值。

5、DigitMap 删除后，当前正使用DigitMap 的所有终端应继续使用删除前的DigitMap。一.2.2 DigitMap定时器H248协议规定了三类定时器用于保护根据DigitMap 所收集的号码，这三类定时器为：起始定时器（T），短定时器（S）和长定时器（L）。（1） 起始定时器T用于任何已拨号码之前。如果起始定时器被设为0（T=0），此定时器就失效了；表示MG将无限期地等待拨号。（2） 若MG 确认号码串至少还需要一位号码来匹配DigitMap中的任意拨号方案，则数字间的定时器值应设置为长定时器（L）（例如16 秒）。（3） 若号码串已经匹配了DigitMap中的某一拨号方案，但还

6、有可能接收更多位数的号码而匹配其它不同的拨号方案，则不应立即报告匹配情况，MG 必须使用短定时器（S）等待接收更多位数的号码。DigitMap中的定时器为可配置参数。这些定时器的缺省值应当在MG中预先设定；但可以被DigitMap中指定的值所修改。一.2.3 DigitMap语法根据语法，DigitMap可以由字符串和字符串列表来定义。字符串列表中的每个字符串都是一个可选拨号事件序列,可以表示为一个DigitMap字符序列，也可以是DigitMap 字符序列的标准表达形式。DigitMap字符包括数字和字母，其中数字的范围从“0”到“9”，字母的范围从“A”到由相关信令系统所决定的字母最大值（

7、最大值不超过K）。这些字符应与该DigitMap所适用的终端上的Events 描述符所指定的事件一一对应。DigitMap 字符与拨号事件之间的映射关系在与随路信令系统（如DTMF，MF，R2）相关的包中进行了规定。从“0”到“9” 的数字字符必须映射到信令系统相应的拨号事件。DigitMap字母应当按一定的逻辑结构来分配，以便使用范围表示法（range notation）表示可选拨号事件。DigitMap 中字母“X”为通配值，可代表与“0”“9”范围内的符号相关的任何拨号事件。字符串可包含明确的范围，及明确的符号集，以代表任意一个满足该DigitMap 相应位置的拨号事件。符号“.”代表0

8、 次或多次重复在“.”之前的拨号事件（事件、事件范围、可选事件集合或通配符）。根据规定的定时器规则，与符号“.”匹配的事件之间的定时器缺省地采用短定时器S。除了这些事件符号，字符串可以包含“S”和“L”位间定时指示符以及“Z”持续时间修改符。“S”与“L”分别表示MG 对于后续拨号事件应采用短定时器S 或长定时器L，取代先前规定的定时规则。若明确的定时指示符在一个DigitMap 字符序列中生效，但在任何其他的DigitMap 字符序列中没有规定定时指示符，则必须使用该定时指示符规定的定时器。若所有带有明确定时控制的序列从可选号码序列集合中删除，则定时器会恢复到上述缺省值。如果不同可选号码序列

9、中定时指示符发生冲突，应当采用长定时器（L）。“Z”表示一个长持续时间的拨号事件：“Z”被放在满足给定字符位置的事件符号之前，它表示只有在事件的持续时间超过时间门限时，拨号事件才会满足该位置。该门限值由MG 预先设定。一.2.4 DigitMap 结束事件当引用DigitMap的Events描述符处于激活状态，且DigitMap未结束时，DigitMap 也处于激活状态。H248协议规定当以下情况发生时，DigitMap结束：1. 定时器超时；2. 已经匹配某一部分拨号事件序列，再收到其他拨号事件已不可能再匹配DigitMap中的其他拨号事件序列，即明确匹配（Unambiguous Match

10、）；3. 检测到一个拨号事件使得以后无论收到什么事件都不可能匹配DigitMap中一个完整的事件序列。DigitMap 结束后，应产生一个带有已经匹配的字符串的 “DigitMap Completion”事件，此时DigitMap进入去激活状态。以后收到的事件将按当前激活的Events描述符的处理机制进行处理。一.2.5 DigitMap流程在连续的拨号事件没有结束之前，H248协议规定应根据如下规则进行处理：（1） “当前拨号串”是一个内部变量，起始值为空。候选拨号事件序列集合包括DigitMap中规定的所有候选拨号事件。（2） 在每一步中，设置一个定时器等待下一拨号事件。定时器或者采用缺省

11、的定时原则，或者采用一个或多个拨号事件序列中明确规定的定时器。若定时器超时，且能与候选拨号事件集中的一个拨号事件完全匹配，则报告“定时器超时，完全匹配”（Full Match，简写为FM）。若定时器超时，且不能与候选拨号事件集完全匹配，或没有候选拨号事件可以匹配，则报告“定时器超时，部分匹配”（Partial Match，简写为PM）。（3） 如果定时器超时前检测到拨号事件，就将拨号事件映射成号码字符，并将其加到当前拨号字符串的后面。当且仅当事件的持续时间与当前位置相关时（因为至少有一个候选的拨号事件序列在此位置有一个 “Z”指示符），事件的持续时间（不论长短）才会被记录。（4） 当前的拨号字

12、符串与候选的拨号事件序列相比较。当且仅当在该位置上具有长持续时间的拨号事件序列与之相匹配时，即拨号事件具有长持续时间并满足该位置的要求，则任何该位置上未规定长持续时间的候选拨号事件序列都将被丢弃，并且在代表最近拨号事件的符号前插入“Z”以修改当前拨号字符串。如果该位置上可能的长持续时间拨号事件的任意序列不能与正在被检测到的拨号事件相匹配，则该长持续时间拨号事件将会从候选集中丢弃。如果拨号事件序列在给定位置未规定长持续时间拨号事件，并且应用上述规则之后仍然保留在候选拨号集中，则在进行评估匹配时，被观察的拨号事件持续时间将视为无关。（5） 如果恰好只剩下一个候选事件序列且完全匹配，就会产生一个明确

13、匹配（UnambiguousMatch，简写为UM）的“DigitMap Completion”事件。如果没有候选拨号序列相匹配，则最近的事件将会从当前拨号字符串中删除。如果在检测到最近的拨号事件之前，已有一个候选拨号序列完全满足匹配，则将相应产生一个完全匹配（Full Match）的“DigitMap Completion”事件，否则将相应产生一个部分匹配（Partial Match）的“DigitMap Completion”事件。从当前拨号字符串中删除的拨号事件随后将按照当前激活的事件处理机制进行报告。关于UM、PM、FM的具体例子在1.2.7给了说明。（6） 如果经过前面5 个步骤都没

14、有报告“DigitMap Completion”事件（即候选拨号集仍然包含多个拨号事件序列），则返回到第2 步进行处理。一.2.6 DigitMap业务配置规范配置4个业务DigitMap的模板，如下：1） 新业务*#0-90-9*.#|*xx|*#xx#|#2） 特服10xxS.|1102479|1113568Sx.|12026789|121xx|123-5Sx.|168xxxxx|179xSx.|18xSx|200|201|202-9xSx|400xS.|444S.|600x|800xxxxxxx|9xxxxSx.3）市话7位 2-81-9xxxxx|13xxxxxxxxx|145Sx.|

15、4）国内国际长途013xxxxxxxxx|010xxxSxxxxx|02xxxxSxxxxx|03-9xxxxxSxxxx|0311xxxSxxxxx|0371796xxSxxxxx|04151xxxSxxxxx|051023xxxSxxxxx|05312xxxxxxxx|057147xxxSxxxxx|05915xxxSxxxxx|07557xxxSxxxxx|0769xxxSxxxxx|0898xxxSxxxxx|00xxSx.|0159xxxxxxxx|068x这个长途模板是最新更新过的（截至到2008年3月份），已经涵盖了国内升位的所有城市。号码分析子的DigitMap配置选择如上的4

16、个模板，如果有一些特殊的号码没有包括进去，请分析这些号码是专用还是通用，如果是通用，就设法加入模板。一.2.7 DigitMap示例当拨号方案如下所示时：表格 1.21 拨号方案11X紧急呼叫和特服呼叫6XXXXXXX本地号码长途号码00国际长途*xx补充业务如果收集拨号字符时采用“DTMF Detection”（PackageId:dd）包（dd 包的定义参见RFC3015的附录E.6），则该拨号方案的DigitMap 如下所示：11x |6 XXXXXXX|019XXX. |00XXX. |Exx再如：某拨号方案的DigitMap如下形式：DigitMap= Dialplan0 （0| 0

17、0|1-7xxx|8xxxxxxx|Fxxxxxxx|Exx|91xxxxxxxxxx|9011x.）注意为便于理解，对照以上两个例子说明一下各个部分格式规范，特别是空格和回车换行等符号出现的条件。以第二个例子为例，“DigitMap=”是关键字，或者写成“DM=”，拨号方案名为Dialplan0，该拨号方案是由7个字符串组成的列表，每个字符串间用“|”区隔，在“|”的前后都可以有（也可没有）若干空格和换行，所以可以写成以下形式：DigitMap= Dialplan0 （0|00|1-7xxx|8xxxxxxx|Fxxxxxxx|Exx|91xxxxxxxxxx|9011x.）在字符串列表前后

18、的“（”和“）”符号的前后同样可以加（也可不加）若干空格和换行，在表示数字取值范围的“”“”和 “-”，的前后也是如此。在一个字符串中不允许出现空格和换行（开头和结束处除外）。1、下面两个形式是错误的：1）、DigitMap= Dialplan0 （0| 00|1-7xxx|8xxxxxxx|Fxxxxxxx|Exx|91xxxx xxxxxx|9011x.） 不该在字符串中加空格；2）、DigitMap= Dialplan0 （0| 00|1-7xxx|8xxxxxxx|Fxxxxxxx|Exx|91xxxxxxxxxx|9011x.） 不该在字符串中换行；2、关于UM、PM、FM的例子：1

19、）、DigitMap= Dialplan0 （0|00|1-7xxx|8xxxxxxx|Fxxxxxxx|Exx|91xxxxxxxxxx|9011x.） 当收到80111222，精确匹配了8xxxxxxx，即ds”,MethUM。2）、DigitMap= Dialplan0 （0|00|1-7xxx|8xxxxxxx|Fxxxxxxx|Exx|91xxxxxxxxxx|9011x.）当收到71235，部分匹配了1-7xxx，即ds”7123”,MethPM；或者收到812，部分匹配了8xxxxxxx，即ds”812”,Meth=PM。3）、DigitMap= Dialplan0 （0|00|

20、1-7xxx|8xxx|8xxxxxxx|Fxxxxxxx|Exx|91xxxxxxxxxx|9011x.）当收到号码为8234，完全匹配了8xxx，ds”8234”,即为MethFM。一.3 号码图表的配置方法在号码分析配置中，一个号码分析子对应一个号码图表。在号码分析配置界面左侧号码分析结构树中依次选择号码分析子和网络类型，然后点击号码分析子界面上方的号码图表标签，可以看到此号码分析子配置的号码图表，如下图所示。此时点击“修改（M）”按钮，在号码分析子配置界面点击号码图表标签，来进行配置或修改操作。要使号码图表的形式包含所有已配置的局码相应的用户号码，因此号码图表要随着局码的新增或删除进行

21、相应的修改。配置好以后，按“确定（O）”键确认修改，按“退出”键取消修改。如图表1所示。需要提醒的是，号码图表的配置一定要按照实际需要进行配置，尽量简化，以避免拨号等号时间过长。几点补充说明：1 DigitMap作用范围SS当前不会解析DigitMap，SS将配置好的DigitMap下发给指定MG，MG通过解析DigitMap来完成收号功能。2 DigitMap长度配置规范DigitMap字符串长度不超过1024个字节，目前已在版本中限制，输入超长报错。图 1.31 号码图表配置一.4 实际应用举例说明一.4.1 中国移动IMS项目DigitMap在中国移动IMS项目中，SS1b实现的主要是扩

22、展功能，号码图表的下发也是在外网用户拨打总机号码后，由SS下发给MG，所以号码图表相对比较简单，主要涉及到的就是传真、会议、内部小号（分机号码）、扩展功能。具体如下：集团的号码分析子对应的号码图表：|0|9955|9966|1-9xxx|*xx*x.|*xx#|#xx#|#|#|北京的号码分析子对应的号码图表：|0|9955|9966|1-8xxxx|90-8xxx|990-5xx|997-9xx|9960-5x|9967-9x|*xx*x.|*xx#|#xx#|#|#|注：江西的比较特殊，小号为6位。|0|1-8xxxxx|9xxxSxx|9xxx|27966xxxx|27967xxxx|2

23、7999xxxx|*xx*x.|*xx#|#xx#|#|#|在用户拨打9xxx后将等待定时器S时间若后来又输入两位xx则触发9xxxSxx业务，若定时器超时则触发9xxx业务。一.4.2 四川电信IMS项目DigitMap四川电信IMS项目集团目前放号4000，号码图表涉及到的号码主要有会议和内部分机号码，其号码图表为：|0|9966|1-9xxx|*xx*x.|*xx#|#xx#|#|#|图 1.41 号码图表一般可以根据分析号码的位长，设置号码分析模板如四川电信IMS项目：五位短号：|0|9966|1-8xxxx|90-8xxx|990-5xx|997-9xx|9960-5x|9967-9

24、x|*xx*x.|*xx#|#xx#|#|#|图 1.42 配置实例一.5 附件表格 1.51 DigitMap字符对应表字符作用备注“0”到“9”“A”到“K”“X”通配符，表示“0”“9”中的某一个“.”重复符，代表0 次或多次重复在“.”之前的拨号事件“S”位间定时指示符，表示MG 对于后续拨号事件应采用短定时器，取代先前规定的定时规则定时时长没有限制“L”位间定时指示符，表示MG 对于后续拨号事件应采用长定时器，取代先前规定的定时规则“Z”持续时间修改符，“Z”被放在满足给定字符位置的事件符号之前，它表示只有在事件的持续时间超过时间门限时，拨号事件才会满足该位置。该门限值由MG 预先设定“|”如果DigitMap由字符串列表构成，则各个字符串之间用“|”间隔“ ”字符串中某个位置的取值为某个区间的任意值“-”取值区间，与“ ”一起使用空格参见1.2.5举例回车换行EE 表示DTMF 方式中的“*”FF 表示DTMF 方式中的“#”