U8门户开发手册 - 图文

U8门户开发手册

1. 功能概述

如何使伙伴二次开发的程序很好地和U8产品集成在一起？需要满足什么条件的程序才能和门户集成？如何开发一个满足这个条件的程序？本文将为您解答这些问题。

2. 名词解释

2.1菜单调整工具

功能：调整菜单位置；新增、修改、删除菜单（除U8系统菜单外）。 菜单调整工具在UAP中，通过菜单“工具－>菜单调整工具”进入。

2.2 idt.dll文件

位置：在U8安装目录的Portal目录里。

该文件其实是一个xml文件，可以用任何文本编辑器打开。 其内容描述了双击每个末级菜单项目时需要调用的物理程序。

在872版本里，idt.dll并不在安装盘里，而是U8门户第一次运行时通过UFSystem..UA_IDT表里的内容动态生成的。当UFSystem..UA_IDT有变化时，U8门户会重新生成idt.dll文件。有了这种机制后，菜单调整工具就可以通过维护UFSystem..UA_IDT里的内容，从而达到维护idt.dll的目的。

3. 如何开发可与门户集成的VB dll

3.1代码修改

3.1.1引用工程UFPortalProxyInterface

文件位置：U8安装路径\\Portal\\UFPortalProxyInterface.dll

3.1.2相关代码修改

clsProductFacade文件为门户的入口文件，即在idt.dll文件后assembly项所对应的类名。如下所描述的：

首先，idt.dll中assembly属性描述的对应类要实现接口ILoginalbe。 比如idt.dll中描述了如下信息：

则要在clsProductFacade中实现ILoginable接口。即用代码： Implements UFPortalProxyInterface.ILoginable

然后在该接口的实现函数中转发调用原先工程中的Login,CallFunction,Logoff三个方法，具体参见后附的例子。在左树启动一项命令时依次调用Login和CallFunction。在门户退出或在权限管理中结束该产品时调用LogOff。

子系统必须自己维护是否已经进行了子系统登录过程，业务系统须维护子系统是否已经登录。

Login对象从g_business中通过调用GetVBclsLogin方法获得。 各接口含义如下：

1、Login接口( Private Function ILoginable_Login() As Boolean )，不管弹出的是模式窗体还是非模式窗体，此接口在成功登录后须返回True,而且要保证登录成功后，第二次调用此接口时也要返回True。只有在登录失败后方可返回False。也就是说此接口返回值的含义是是否已经成功登录子系统。

2、LogOff接口( Private Function ILoginable_LogOff() As Boolean )，此接口的含义是执行LogOff过程，如查成功使该子系统牌LogOff状态返回True，否则返回False。也就是说，如果该子统还未登录，则真接返回False就可以了。如果系统处于已经登录的过程，则执行业务组原有所需的LogOff过程，如果执行功能，正确LogOff了子系统，则返回True，否则返回False。如果在实际程序中没有此过程，则直接返回True即可。

3、CallFunction接口(Private Function ILoginable_CallFunction() As Boolean)。如果861