监控管理工具开发手册.docVIP

监控管理工具开发手册 工具概述 简单描述 USE? For Telephone Supervisor是USE? For Telephone的监控管理工具，通过调用ICSC平台的核心层提供API开发接口函数，实时收集前置交换排队设备的状态信息，以图形化界面的方式实时提供各种报告。主要监控USE核心层的运行状况，USE各种资源的工作情况（包括座席、队列、IVR和Fax等），并对各种资源进行有效的管理。这里所提到的管理是指在监控状态下对其所监控的对象进行管理。通过USE? For Telephone Supervisor，可以实时的监控和管理系统内的所有资源。 功能说明 实时显示所有座席组的信息，包括座席总数、已登录座席数、正在通话座席数等 实时显示每个座席的工作状态 可以对座席进行管理，给单个座席发送消息或对全组广播 可以对座席进行管理，将座席通话强行挂断或将座席强行退出登录 实时显示所有IVR组的信息，包括通道总数、正在运行的通道等 实时显示每个IVR通道的工作状态 可以对IVR通道进行管理，登录、复位或退出IVR通道 实时显示所有中继组的信息，包括中继线总数和状态等 实时显示所有传真通道的状态信息 显示系统呼叫量曲线，排队数曲线及忙闲设备数曲线 图形界面 工具在界面上主要有如图所示的几个区域：菜单、工具条、组显示区、组的成员及成员状态显示区、组信息显示区。 实现方案 本工具主要是利用平台的核心层提供API开发接口函数来实现对信息的收集。关于平台核心层都提供哪些API函数，请参看“****************使用手册” 本次设计设置刷新时间为1秒。 在本工具加载时，通过底层API函数得到各种资源的配置情况(主要是各种分组情况及对应的组名)，并根据程序显示的要求对应进行显示。再得到监控对象的信息并显示，再得到各组各成员的状态，然后显示。为了实现实时监控，在间隔的刷新时间过了之后就去重新得到欲监控对象的信息及状态后再显示。以此循环显示。 程序总结构图如下示： 这里要说明的是在得到了数据，并不是马上显示出来，而是分类进行处理，一部分是当系统一运行就不会改变的数据，如分组情况或组名等，这些是由Server端的配置文件决定的，不会在系统运行当中改变(改变之后一定会重起Server，重起Server之后，本工具也得重起)。这一部分则直接显示出来。另一部分则是会随登录数的变化而改变的数据，也就是说在循环部分得重新去取值的数据。如登录的ID号，座席姓名等，这一部分则是采用分步式的流程，以使程序更加清晰。 通过API函数得到资源状况（取得Server端的配置信息） 主要是得到配置信息，这些是由Server端的配置文件决定的，不会在系统运行当中改变(改变之后一定会重起Server，重起Server之后，本工具也得重起)。得到之后得保存起来，保存在用于显示它的控件(TreeView控件)中的一些不太常用的属性中，如Tag属性，或Key属性的附加值中。这样做的目的是尽量少用到全局的变量。 通过所得配置信息显示资源状况 将上面得到的信息按所要监控的内容显示到图形界面上。 由资源状况通过API函数得到各资源(组)的信息 通过上面所得到的ID去取ID的信息及对组的资源统计(随状态的改变而变化)，包括各ID的状态，座席姓名，组内的登录数，忙闲数，排队数等 显示各资源(组)的信息 将上面得到的信息按所要监控的内容显示到图形界面上。 程序起动 程序起动时必须对所使用的OCX控件初始化，OCX的初始化要求输入服务器的IP地址(ServerIP)，这是在OCX的初始化函数中所要的参数。初始化函数为： long Init(ServerIP) 使用控件方法前必须执行该初始化方法，否则程序在运行期间会出现意想不到的错误。此初始化方法将有一个long型的返回值。初始化成功返回0，不成功返回非0。如果初始化成功，将全局变量udtGloablVars.blnOCXInit置为Ture。此变量是为了给使用控件方法提供保障。 注意：停止使用此OCX控件,必须使用控件方法”long Stop”终止使用。此终止方法不需要参数，成功返回0，不成功返回非0。 取得资源状况 取资源状况也就是初始化程序，分为初始化座席资源，初始化IVR资源，初始化中继资源，初始化Fax资源。 取得座席资源状况的流程如下所示： 获得工作组数目[Ctmon_getGroupCount] 所需参数：无 返回：返回工作组的数目 备注：返回工作组数目为一个Long型数据 ---获得工作组的ID[Ctmon_GetGroupID] 所需参数：工作组数目 返回：工作组的ID 备注：返回的工作组的ID为一Long型数组，数组长度等于工作组数目 ---获得指定工作组的状态数据[Ctmon_GetGroupStat