通信基础知识
 产品使用手册
HXD09可编程智能语音交换机
HXD NGN IP Switch
系统软件
 
  首页>培训中心
 
产品使用手册
 


系统事件及系统变量说明
系统事件说明:

事件值

事件名称

说明

0

空事件

此事件表示没有任何事情发生,只是为了使当前操作做完之后转到下一操作 , 用空事件连接的两个节点相当于顺次做完两个操作(中间不等任何事件)

1

摘机

在呼出流程,摘机表示收到对方交换局的应答信号,在坐席流程,摘机表示坐席主动摘机,呼入流程不会有此事件,此事件一般跟在坐席流程的开始节点和呼出流程的等待节点

2

拨入

在呼入流程,此事件表示收到对方交换机的呼入消息(已经得到主被叫号码,不一定已经应答),在坐席流程,此事件表示坐席在振铃状态下摘机,呼出流程不会有此事件。此事件一般跟在坐席流程和呼入流程的开始节点。

3

挂机

ASL 、 ATU 、 DTV 、 IPV 类型的通道都可收到此事件,表示本通道被挂机(坐席主动挂机或者中继线收到挂机信令消息)。

4

闪断

收到 ASL 所连话机的闪断消息。

5

收号完成

在收号节点可跟此事件,表示通道的号码缓冲中的号码串达到了用户指定的收号完成条件,收号完成条件有两个:

•  收到指定特殊键

•  号码串达到用户指定最大长度

6

超时

此事件目前没有使用

7

收号超时

在收号节点或者录放语音节点,此事件有效,表示一次收号过程的总超时。

8

位间超时

在收号节点或者录放语音节点,此事件有效,表示两位收号之间的超时

9

久叫不应

1 号信令呼出通道等待应答超时,此超时值由系统配置设定,如果超时到,系统将自动释放此呼出通道

10

转移超时

此事件目前没有使用

11

录音超时

在录音节点有效,表示一次录音的总超时,超时值由流程中的录音节点参数设置。

12

放音结束

表示一次放音过程结束

13

次数到

在记数节点有效,表示之前设置的记数器值已经减为 0

14

次数未到

在记数节点有效,表示当前记数器值还没有减到 0

15

对方挂机

•  当一个通道收到挂机消息,并且做缺省处理时(也就是流程中没有跟挂机事件),那么关联通道将收到一个对方挂机消息。如果通道自己走到结束节点,那么将不会发送对方挂机给其关联通道。

•  需要注意,对于坐席通道,无论何时挂机,都会给其关联通道发送对方挂机消息。

16

已登录

在‘坐查'节点有效,表示此坐席已经登录。

17

未登录

在‘坐查'节点有效,表示此坐席没有登录。

18

成功

在‘呼叫'和‘排队'节点有效,表示此次呼叫或者排队操作成功(也就是找到了空闲通道)

19

失败

在‘呼叫'和‘排队'节点有效,表示此次呼叫或者排队操作失败(也就是找不到空闲通道)

20

回铃超时

当坐席通道振铃超时时,如果其关联通道是中继通道,那么将向该关联通道发送回铃超时消息。

22

振铃超时

表示坐席振铃超时,该超时值由系统配置设置。

23

对方摘机

当一个通道摘机时,如果其关联通道的值不为空,那么将向该关联通道发送对方摘机消息

24

对方忙

当呼出通道收到‘对方忙'信令时,将向该通道和其关联通道发送对方忙事件

25

呼出失败

当呼出通道收到‘呼出失败'信令时,将向该通道和其关联通道发送呼出失败事件

26

呼出空号

当呼出通道收到‘呼出空号'信令时,将向该通道和其关联通道发送呼出空号事件

27

排队超时

在排队节点可跟,表示排队超时,其超时值由排队节点设置

28

放音失败

表示放音节点放音失败,可能的原因包括:

•  找不到指定的语音文件名

•  无效的放音序列项设置

29

录音失败

表示录音失败,可能的原因有:

1 .找不到指定的语音文件名

40

等待超时

在等待节点可跟,表示等待时间到

48

呼出回铃

当呼出通道收到‘呼出回铃'信令时,将向该通道和其关联通道发送呼出回铃事件

49

拨出

主动呼出时,如果找到了呼出通道,将发送此消息到呼出通道,只有呼出流程可以使用。

58

呼出超时

表示从发起呼出占用到收到呼出通道的摘机之间的超时,此超时值由系统内部指定,当此超时到时,将释放此呼出通道,同时向其关联通道发送对方挂机消息。

59

调用函数超时

在‘调函'节点可用,表示调用函数等返回值的时间,其值由调用函数节点设置。

60

同步好

在‘同查'节点可用,表示主控 CPU 板目前以太网状况良好

61

同步坏

在‘同查'节点可用,表示主控 CPU 板目前以太网已经失同步

62

统计好

目前没有使用

63

统计坏

目前没有使用

64

没有语音资源

表示录放语音时没有找到语音资源(语音资源已经用完)

65

没有 DTMF 资源

表示 DTMF 收码时没有找到 DTMF 资源( DTMF 资源已经用完)

80

准备传真好

在‘备收'和‘备发'节点可以使用,表示找到了空闲传真通道,并且传真文件已经准备好

81

准备传真错

在‘备收'和‘备发'节点可以使用,表示找不到空闲传真通道,或者传真文件找不到

82

传真成功

在‘收传'和‘发传'节点可以使用,表示传真收发正确完成

83

传真失败

在‘收传'和‘发传'节点可以使用,表示传真收发失败

112

放音收号完成

表示放音节点收号完成

113

录音收号完成

表示录音节点收号完成

128

AT 拨入

在呼入流程可以使用,表示模拟中继线有呼叫进来(收到振铃,已经摘机),跟在‘开始'节点可以使用

129

AT 呼出

在呼出流程可以使用,表示找到了空闲模拟中继线,并且向模拟中继线发了摘机命令

130

AT 拨号

表示模拟中继线检测到了拨号音,可以开始 DTMF 拨号过程,在呼出流程可以使用

254

调函失败

表示 CTIserver 没有找到指定的函数,在‘调函'节点可以使用

768

应答完成

目前没有使用

1025

一号定时到

表示 1 号定时器到,在‘定时'节点之后可以使用

1026

二号定时到

表示 2 号定时器到,在‘定时'节点之后可以使用

1027

三号定时到

表示 3 号定时器到,在‘定时'节点之后可以使用

1217

V---------

以‘ V '开头的事件表示软键盘消息,其含义和使用方法请参阅‘附录 C '

1280

非法会议号

表示会议号不是系统认定可以使用的会议号( 1-40 ),在会议节点可以跟。

1281

会议资源满

表示找不到可以使用的会议资源,在‘会议'节点可以使用。

1282

会议未开

当加入一个会议时,可能发生此事件,表示要加入的会议目前还没有召开

1283

会议已开

当开始一个新会议时,可能发生此事件,表示要开始的会议已经召开

1361

队列满

当进入一个队列时,可能发生此事件,表示队列已满或者因为某种原因无法进入队列。

30001

子图事件 n

子图事件共有 10 个,只能跟到‘子图'节点之后,当你在子图中想跳到主图时,可以有几个出口,这些不同的出口可以在主图中走不同的流程。

系统变量说明:

系统变量从 1 号变量到 27 号变量,全部为局部变量,局部指对不同通道有不同的值。类型由下列字段说明:

BYTE : 1 个字节长

STRING :最长 80 个字节(带 0 结束符)

LONG : 4 个字节,长整数

SHORT : 2 个字节,短整数

FLOAT : 4 个字节,浮点数

SYSTEMTIME : systemtime 时间结构

STRUCT :结构变量

DYNAMIC MEMERY :动态内存,最长 2048 个字节

变量号

变量名称

类型

说明

1

pnLangType

long

表示语言种类: 1 、普通话 2 、粤语

3 、英语

2

sCallerId

string

表示主叫电话号码,当呼入时,该变量自动填入主叫号码,呼出时,由用户填入

3

sCalledId

string

表示被叫电话号码,当呼入时,该变量自动填入被叫电话号码,呼出时,由用户填入

4

pnOperatorType

short

登录类别,对 ASL 通道有用,表示当前 ASL 通道属于哪个分组和哪个级别

5

sCallOutNum

string

表示呼出用到的被叫号码,呼出时,由用户填入这个变量

6

pnMeetingId

short

表示当前通道的会议号,当这个通道需要加入会议时,用户可以给这个变量赋值,并在会议节点中指定使用这个变量中的值(或者用一个固定会议号)加入会议。

7

pnChannel

short

当前通道号

8

pnLinkChannel

short

关联通道号,呼叫或者排队成功之后,系统自动赋值,当监听时,用户需要为这个变量赋值,表示要监听的通道

9

pnTalkChannel

short

通话通道,调用连接节点之后,系统自动为这个变量赋值

10

pnSpecifyChannel

short

指定通道,当用户呼叫指定坐席,或者排队到指定坐席队列时,或者连接当前通道和指定通道时,用户需要填入这个变量,系统使用此变量进行排队或呼叫或连接。

11

pnMsgId

short

表示消息 ID 号

12

pnMsgLength

short

表示消息长度

13

sMsgContent

dynamic

表示消息内容, 2048 个字节,主动呼出时,用户填入的变量就存在这个变量中。软键盘的用户消息发过来的时候,消息内容也填到这个变量里。

14

psMsgStruct

struct

此结构包含以上三项内容

15

sInsideMsgValue

dynamic

目前没有用到

16

sUserCode

string

用户号码,当系统配置中特服号对应的用户号长度不为 0 时,收到的用户号码保存在此变量中

17

sFirstCalledId

string

表示原被叫,呼叫转移时使用

18

pnCalledType

short

表示被叫类别,一般没有用处

19

pnIfShowCaller

short

表示主叫显示,一般没有用处

20

sOutCallerId

string

呼出主叫号码,呼出时由用户填入

21

pnExtOpType1

short

扩展登录类型 1 , ASL 通道登录时,可以最多填入 6 个登录代号,表示一条 ASL 通道最多可以同时在 6 个组中,也就是靠这种登录机制支持交叉分组。

22

pnExtOpType2

short

扩展登录类型 2

23

pnExtOpType3

short

扩展登录类型 3

24

pnExtOpType4

short

扩展登录类型 4

25

pnExtOpType5

short

扩展登录类型 5

26

pnSpecGroup

short

表示指定组号,当用户呼出或者进入指定分组队列时,都需要为这个变量赋值,这样,系统将根据这个变量的值寻找呼出通道或者坐席通道

27

pnCall_ID

long

唯一的呼叫 ID 号,表示当前通道当前的呼叫序号,这个值从机器运行时开始一直递增,每次呼叫进来或者出去增 1 ,用于话务统计使用

28

sCallerIP

string

主叫 IP 地址, VoIP 呼出时,本机地址

29

sCallerGateWayIP

string

主叫网关 IP 地址, VoIP 呼出时,主叫方通过的第一个网关地址。

30

sCalledIP

string

被叫 IP 地址, VoIP 呼出时,最终的目的 IP 地址

31

sCalledGateWayIP

string

被叫网关 IP 地址, VoIP 呼出时,到达最终目的 IP 地址时的转接网关 IP 地址。

32

pnMonChannel

short

被监听的通道号 , 目前没有使用。

33

sRcvDTMFPropertiy

string

DTMF 收号规则,见放音节点说明。

34

sPlayVocContent

dynamic

放音规则,见放音节点说明。

35

pnIsdnUUI

dynamic

Isdn 通道用户数据变量。

注:任何节点都可以跟的事件:

1 )所有用户自定义事件(以 m 开头命名)

2 )所有以 V 开头命名的事件,即 appserver 发到交换机的消息

HXD09 外部信令网关接口说明

服务器发出的数据包结构

•  呼出: 2002

开始: SS7_STX (0x02) 1byte

命令值: 2002 4bytes

逻辑线号: 4bytes

被叫号码串: 最长: 20bytes

空格 1byte

主叫号码串: 最长: 20bytes

空格 1byte

被叫类型

空格 1byte

主叫显示

空格 1byte

呼出超时

空格 1byte

结束: SS7_ETX(0x03) 1bytes

注:除开始和结束标志外其它各项都以字符表示。下同

•  挂机: 2003

开始: SS7_STX (0x02) 1byte

命令值: 2003 4bytes

逻辑线号: 4bytes

结束: SS7_ETX(0x03) 1bytes

•  接通: 2004

开始: SS7_STX (0x02) 1byte

命令值: 2004 4bytes

逻辑线号: 4bytes

结束: SS7_ETX(0x03) 1bytes

4 .系统复位:

开始: SS7_STX (0x02) 1byte

命令值: 9999 4bytes

逻辑线号: 4bytes

结束: SS7_ETX(0x03) 1bytes

服务器接收的数据包结构

•  呼入: 2001

开始: SS7_STX (0x02) 1byte

命令值: 2001 4bytes

逻辑线号: 4bytes

被叫号码: 最长: 20bytes

无: '*'

空格 1byte

主叫号码: 最长: 20bytes

无: '*'

空格 1byte

原被叫: 最长: 20bytes

无: '*'

空格 1byte

被叫类型

空格 1byte

主叫显示

结束: SS7_ETX(0x03) 1bytes

 

2. 挂机: 2003 , 2010

3 .呼出回铃: 2005

•  呼出忙音: 2006

•  无应答: 2007

•  摘机: 2008

•  失败: 2011

•  系统复位: 9999

以上各项( 2-7 )的包结构如下,其中命令值字段为相应的值

开始: SS7_STX (0x02) 1byte

命令值: 4bytes

逻辑线号: 4bytes

结束: SS7_ETX(0x03) 1bytes

广东恒讯达通讯技术有限公司 Copyright © 2004 HXD®Communication Tech,CO.,LTD.All Rights Reserved
公司地址:深圳市福田区深南大道都市阳光名苑3栋14A
公司电话: 0755-26716900 传真:0755-26716861 客服邮箱:job@hxd09.com
华南区域电话:0755-82046834 华北区域电话:010-62026930;82014893 设计维护:网络时代