2024年2月6日发(作者:)

UniMedia®电话语音系列产品

UniMedia®

ActiveX控件安装与导入手册

(版本号:1.0)

1/29

目 录

UniMedia®电话语音系列产品......................................................................................1

1.

ActiveX控件安装环境...........................................................................................4

2.

B/S方式下MSIX控件的发布和部署.....................................................................4

2.1

2.2

建立网站并创建网站虚拟目录...............................................................4

将控件部署到网站的虚拟目录下.........................................................13

3.

B/S方式在网页中使用MSIX控件.......................................................................13

3.1

3.2

3.3

3.4

修改IE安全设置避免弹出控件安装提示框.........................................13

JavaScript中声明MSIX控件..................................................................15

MSIX控件的方法调用...........................................................................16

MSIX控件的事件处理...........................................................................16

4.

DELPHI7/CB6下MSIX控件的安装和清除.......................................................17

4.1

MSIX控件的安装步骤...........................................................................17

4.1.1

安装MSIX控件的第一步................................................................17

4.1.2

安装MSIX控件的第二步................................................................17

4.1.3

安装MSIX控件的第三步................................................................18

4.1.4

安装MSIX控件的第四步................................................................19

4.1.5

安装MSIX控件的第五步................................................................20

4.1.6

安装MSIX控件的第六步................................................................21

4.1.7

安装MSIX控件的第七步................................................................21

4.2

MSIX控件清除步骤...............................................................................22

4.2.1

清除MSIX控件的第一步................................................................22

4.2.2

清除MSIX控件的第二步................................................................22

4.2.3

清除MSIX控件的第三步................................................................23

4.2.4

清除MSIX控件的第四步................................................................24

4.2.5

清除MSIX控件的第五步................................................................25

4.2.6

清除MSIX控件的第六步................................................................26

4.2.7

清除MSIX控件的第七步................................................................27

2

5.

VB6下MSI控件的安装和清除...........................................................................27

5.1

5.2

安装MSI控件.........................................................................................27

清除MSI控件.........................................................................................28

3

1. ActiveX控件安装环境

UniMedia系列产品中,COM控件包括:MSIX座席控件、CTIX引擎控件、NETX网络控件。这些控件可用于各种IDE编程环境,以满足不同的程序员开发的需要。

为指导用户进行ActiveX控件的安装,下面分别在BS网页、DELPHI7/CB6、Delphi7.0、VC6.0、2003、VB6.0以及PowerBuilder8.0等IDE开发环境下详细说明控件的安装步骤。具体安装说明以座席控件MSIX为例,其他控件的安装步骤完全一致。

2. B/S方式下MSIX控件的发布和部署

B/S方式下要在网页中正确使用控件,其前提条件是:

2.1 建立网站并创建网站虚拟目录

建立网站方式很多,如:基于WebLogic/Tomcat等应用服务器,或者基于Windows IIS,他们有一个共同点,一旦建立了网站,都会创建网站的默认路径。

为描述方便,我们在WindowsXP/Windows2000的操作系统环境下,简单描述如何建立Windows IIS网站:

1)确认机器安装了IIS系统服务

打开“控制面板”的“添加/删除程序”子菜单,单击左边的“添加/删除windows组件”按钮。

4

“添加/删除windows组件”按钮后将出现“windows组件向导”窗口。

5

从上面的窗口可以判断是否已经安装了IIS信息服务,如果“Internet信息服务”子项已经打勾,则说明已经安装,否则没有安装,则必须安装下才能建立基于本机的网站。

安装IIS比较简单,选中“Internet信息服务”子项,并单击“下一步(N)”按钮,出现下列提示窗口,取默认选项,继续操作。

单击“下一步(N)”按钮,将开始安装IIS组件,出现如下界面:

6

在安装过程中,将出现如下窗口,提示插入WindwsXP安装盘。

单击“确定”按钮,出现下面目录选择提示框:

在光驱中插入WindowsXp安装盘,按“浏览(B)” :

7

选择安装盘的具体目录,确定后按“打开(O)” ,打开后继续安装,根据提示可以很容易安装成功。

2)创建IIS网站的虚拟目录

IIS成功安装后,则可以创建IIS网站的虚拟目录msitest,一旦创建成功后,则可以将MSIX控件部署到该目录下即可。

打开“控制面板”的“管理工具”子项,出现下面的提示窗口:

8

单击窗口里面的子项“Internet信息服务” ,出现如下窗口:

9

鼠标右键点击“默认网站”,并选择子菜单项“新建(N)”后将出现二级子菜单“虚拟目录(V)…” ,点击“虚拟目录(V)…” 后将开始创建网站虚拟目录。

单击“下一步(N)” ,出现虚拟目录创建向导窗口:

10

在这里我们设为msitest,继续单击“下一步(N)” ,提示选择网站内容目录:

按“浏览(R)”选择网站内容所在的目录路径,如:D:msitest,单击下一步,出现虚拟目录访问权限访问窗口:

一般去默认选项即可,单击“下一步(N)” ,出现虚拟目录创建成功提示窗口,如下所示:

11

点击“完成”完成虚拟目录的创建。

说明:一旦虚拟目录创建成功后,则可以在“控制面板”的“管理工具”的子项“Internet信息服务”中看到默认网站中该虚拟目录已经存在,如下图所示:

创建成功后,则可以在它机上访问该默认网站的网页,如果把MSIX控件放12

到该虚拟目录(或其子目录下),则可以在网页中访问在该控件。如在其他机器的IE浏览器的地址栏中键入:192.168.1.131/msitest/,即可访问包含控件的网页。

2.2 将控件部署到网站的虚拟目录下

MSIX控件的部署非常简单,CTI引擎安装成功后,将在系统目录C:WINNTSystem32(对于windows2000来说是C:Windowssystem32)下将自动生成控件)。

将该拷贝到指定网站目录下即可,为描述方便,我们假设网站机器IP地址为:192.168.1.131,虚拟目录为msitest。

3. B/S方式在网页中使用MSIX控件

当在网站中正确的发布和部署了MSIX控件后,就可以在网页中使用控件,具体用法如下:

3.1 修改IE安全设置避免弹出控件安装提示框

为避免载入控件的网页在打开时弹出提示框,需要对IE的安全设置进行修改。

1) 第一步:单击菜单项“工具(T)” 的子菜单项“Internet选项(O)” ,如下图。

13

2) 点击“Internet选项(O)”后出现下面提示框,点击按钮“自定义级别(C)…” 。

3) 点击后出现下面的安全设置框,其中有有关ActiveX控件和插件的几个选项, 如ActiveX控件自动提示,对标记为可安全执行脚本的ActiveX控件执行脚本,对没有标记为安全的ActiveX控件进行初始化和脚本运行,二进制和脚本 14

行为,下载未签名的ActiveX控件,下载已签名的ActiveX控件,运行ActiveX控件和控件。

对这些选项,可以分别选择“启用”即可。

3.2 JavaScript中声明MSIX控件

在JavaScript中声明MSIX控件的方法比较简单,在页面中加入如下脚本即可:

height="2" codebase="192.168.0.1/msitest/#version=1,0" >

OBJECT的关键参数说明:

1) id

ID是被加入的ActiveX控件ID,这里为“msictl”,一旦设定后则可以在随后的JavaScript中用“msictl” 编写该控件的相应事件处理函数;

2)

classid

15

ClassID是该控件在生成时的唯一UUID号,MSIX的控件ClassID为:clsid:F212E459-0DFE-4A18-86E0-CF9FC11AAB96。

3)

codebase

CODEBASE指向的是ActiveX控件的安装位置(来源)和版本号,如果版本升级了,客户端会自动更新。

需要你写当前控件的版本号,这个地方和自动下载有密切关系!当你远端的Web浏览器检查到本机的控件版本号和服务器上不一样的时候,浏览器就会自动从服务器下载新版本控件进行安装。

3.3 MSIX控件的方法调用

在JavaScript中调用控件的方法,首先声明一个JavaScript函数,在函数中获得对应的方法参数,并调用MSIX控件的方法,一旦设置了该函数,则可以在网页的按钮的click中调用,如onclick="SubmitSetConnInfo_onclick()" :

3.4 MSIX控件的事件处理

ActiveX中的事件可以抛出到页面,用javascript处理,下面的例子显示了OnCallIncome的事件处理函数。

4. DELPHI7/CB6下MSIX控件的安装和清除

如果MSIX控件是第一次在DELPHI7/CB6中安装,其步骤如下:

4.1 MSIX控件的安装步骤

如果MSIX控件是第一次在DELPHI7/CB6中安装,其步骤如下:

4.1.1 安装MSIX控件的第一步

打开DELPHI7/CB6环境,点击“Component”菜单,选择子菜单项“Import

ActiveXControl”,结果如下图所示:

4.1.2 安装MSIX控件的第二步

点击子菜单项“Import ActiveXControl”后出现如下图的控件列表提示框,点击“Add”按钮。

17

4.1.3 安装MSIX控件的第三步

点击“Add”后,出现控件选择框,选择带安装控件的位置(一般缺省安装在..UniMedialib目录下),如果是安装在D,则选择“D:”,选中后按“打开”按钮。

18

4.1.4 安装MSIX控件的第四步

点击“打开”按钮后,DELPHI7/CB6将自动注册该控件,并将最近注册的控件显示在“Import ActiveX”控件列表框中,如下图所示,到这一步,则控件成功注册到系统中。

19

注:该步也可以用命令行方式实现,在Dos方式下,键入:regsvr32 ,将对该控件进行注册,注册成功后,在DELPHI7/CB6的IDE环境下,同样可以看到已注册成功的MSIX控件(MSIProj Library(Version 1.0))。

4.1.5 安装MSIX控件的第五步

控件注册成功后,下一步将进行install,以使控件安装到DELPHI7/CB6的ActiveX面板上,点击下方的“Install”按钮后,如果控件是第一次安装,则出现下面的提示框,提示是否将控件信息更新到用户组件包中,点击“OK” 即可。

20

4.1.6 安装MSIX控件的第六步

点击后出现下面的提示框,选择“Yes”,更新用户组件包 ,DELPHI7/CB6将重新编链接译用户组件包,成功后提示组件已更新,按“OK”结束。

4.1.7 安装MSIX控件的第七步

到此,MSIX控件成功注册并安装到DELPHI7/CB6的面板上,打开ActiveX面板,可以看到上面的MSIX控件,一旦组件安装成功,则可以将该控件拖拉到应用系统中,并利用该控件进行编程,具体的编程过程请参考编程指南手册。

21

4.2 MSIX控件清除步骤

控件在系统中已经安装成功,如果控件接口发生了变化则必须重新安装,新接口才能生效,为确保安装成功,必须先从系统注册表中清除已安装的控件信息,同时更新用户组件包,再重新安装新控件(重新安装的过程与新控件的安装完全一致),下面列出了已安装MSIX控件的清除步骤。

4.2.1 清除MSIX控件的第一步

打开CB环境,点击“Component”菜单,选择子菜单项“Import

ActiveXControl” 。

4.2.2 清除MSIX控件的第二步

点击子菜单项“Import ActiveXControl”后出现下列控件列表框,选中需要从注册表清除的控件MSIX。

22

4.2.3 清除MSIX控件的第三步

点击“Remove”按钮后出现删除确认提示窗口,按“Yes”后DELPHI7/CB6将该控件自动从注册表中清除,清除成功后,可以看到控件列表中该控件将不再存在。

23

注:该步也可以用命令行方式实现,在Dos方式下,键入:regsvr32 /u

,将对该控件进行清除,清除成功后,在DELPHI7/CB6的IDE环境下,可以看到控件列表中该控件(MSIProj Library(Version 1.0))将不再存在。

4.2.4 清除MSIX控件的第四步

从注册表中成功删除后,下一步将更新用户组件包,以确保MSIX的控件信息从DELPHI7/CB6面板中清除,更新的过程简单,打开,该工程在DELPHI7/CB6安装目录的子目录lib下。

打开工程后,将出现用户组件包的信息,可以看到组件包中包含以前成功安装的MSIX控件信息(MSIProj_OCX_cpp/MSIProj_)。由于控件的接口发生变化,因为必须清除这两个文件,并重新编译和链接。分别选中上述两个文件,并按删除键,删除时将会出现删除确认提示框,确认即可。

24

4.2.5 清除MSIX控件的第五步

清除完MSIX控件文件后,重新build该工程,如下图所示:

25

4.2.6 清除MSIX控件的第六步

重新编译成功后,出现如下窗口,表明用户组件包已经成功更新,不再包含MSIX控件的任何信息,同时DELPHI7/CB6的ActiveX面板上也没有该控件的拖拉图标。到此MSIX控件的以前的信息被成功清除,可以对新控件进行重新安装。

26

4.2.7 清除MSIX控件的第七步

一旦MSIX控件成功从注册表和DELPHI7/CB6面板中清除后,就可以重新安装MSIX控件,安装过程同系统第一次安装新控件完全一致,不再复述。

5. VB6下MSI控件的安装和清除

5.1 安装MSI控件

在菜单中选择“工程”-“部件”,显示如下窗口:

选中 MSIProj Library并按确定。

27

在控件面板中增加了一个图标,用户可直接使用。

5.2 清除MSI控件

在菜单中选择“工程”-“部件”,显示如下窗口:

28

清除MSIProj Library的选择并按确定。

29