ZHIS4公用库及常用模块使用说明

厦门智业软件工程有限公司.研发部ZHIS4项目组文档D:\temp\1578600658110.doc第1页共5页密级公开（）普通（√）秘密（）机密（）绝密（）ZHIS4公用库及常用模块使用说明文档编号：文档编号（按照文档编码规范）文档归类：文档归类作者：李程扬创建时间：2005-11-02修改时间：2005-11-02版本号：v1.0文档传阅：一、前言：本文主要讲述一些可重用/复用对象及与HIS业务相关的处理模块及注意事项二、常用全局变量说明：1、GS_OPERATOR登陆员工，姓名+工作牌号2、GS_LOGIN_DEPT_CODE登陆的工作科室代码3、GS_SUBSYSTEM_CODE登陆的子系统代码4、GS_HOSPITAL_NAME当前医院名称三、公用库(Powerbase)：1、公用库文件：ZHIS4\Source\Powerbase\base.pbta.PowerBase.pbl:基本类库,包括各类实用功能对象、祖先窗口及类库使用的数据窗口b.PowerFrame.pbl:框架库,包括各种窗口框架c.PowerButton.pbl:按钮库,包括常用按钮及各类数据窗口功能按钮d.PowerControl.pbl:控件库,包括各类系统控件及扩展控件2、公用库使用配置：应用相关全局变量缺省定义要修改，如下：a.transaction—n_transaction$b.error—n_error$c.message—n_message$3、窗口：a.w_main$b.w_response$c.w_mdi$4、窗口控件位置及大小自动缩放机制：a.自动缩放机制原理：窗口打开前保存控件位置及大小，再依据控件布局设置要求进行位置及大小的变化；b.控件所在窗口必须继承自w_main$c.据模块业务需要设置窗口变化时控制布局：设置控件Tag属性，格式如下：ToolTips@Move/Resize，分别是提示帮助信息@位置移动/大小改变，其中厦门智业软件工程有限公司.研发部ZHIS4项目组文档D:\temp\1578600658110.doc第2页共5页Move/Resize的值为(大小写无关)：Right向右方移动/向右边扩展Bottom向下方移动/向下边扩展Both向右下方移动/向右下方扩展None不改变位置与大小d.常用控件的缺省布局设置：i.u_ComandButton$@both/none与窗口右下角位置保持不变，大小不变ii.u_Treeview$@none/bottom位置不变，控件高度随窗口变化iii.u_DataWindow$@none/both位置不变，控件高度与宽度随窗口变化iv.u_HsplitBar$@none/right位置不变，控件宽度随窗口变化v.u_VsplitBar$@none/bottom位置不变，控件高度随窗口变化5、几组控件分隔（Split）设置：a.控件分隔原理：与控件自动缩放类似，在窗口打开前保存控件位置及大小，拖位分隔控制时取相关控件设置变化b.相关控件：i.u_HSplitBar$：水平分隔控制（即上下分隔），接口函数如下：of_registertop注册上方控件，一般为数据窗口of_registerbottom注册下方控件，一般为数据窗口of_registermove注册要移动的控件，一般是控钮ii.u_VSplitBar$：垂直分隔控制（即左右分隔），接口函数如下：of_registerleft注册左边控件，一般为树对象、数据窗口of_registerright注册右边控件，一般为数据窗口of_registermove注册要移动的控件，一般是控钮c.使用说明：i.界面设置时把水平或垂直分隔控制放置到要分隔的位置ii.一般是在分隔控件的constructor事件中使用接口函数注册要布局控件iii.控件最小缩放尺寸可设置控件属性ii_minsize$6、数据窗口相关按钮：相关按钮放置到界面上，一般在按钮constructor事件中调用按钮接口函数of_setdw设置此按钮关联的数据窗口a.u_dwbutton_print$打印按钮b.u_dwbutton_filter$过滤按钮c.u_dwbutton_sort$排序按钮d.u_dwbutton_excel$导出按钮e.u_dwbutton_columnselect$列选择按钮f.u_dwbuttom_find$：查找按钮7、其它常用按钮：使用公用库的按钮可支持上下文帮助提示，即设置按钮Tag属性为所需帮助文本a.u_cb_return$：返回按钮b.u_commandbutton$：一般按钮，除特定功能按钮外，其它界面按钮都应从它继承8、日期控件(u_datepicker$/u_daterange$)：支持Windows标准的日期选择控件，其主要接口事件与函数如下a.ue_changed日期改变后会触发此事件b.of_getdate要获取当前控件显示日期时调用此函数厦门智业软件工程有限公司.研发部ZHIS4项目组文档D:\temp\1578600658110.doc第3页共5页c.of_setdate设置日期控件缺省值（注意：切记从数据库中取得当前时间）9、树对象(u_treeview$)：公用库的树对象支持需要时才展开树节点，可提高效率,且支持树节点定位a.主要事件：i.ue_retrieve刷新树节点信息(F5)，可在此事件中删除所有树节点（of_deleteallitem）、创建树根节点(of_addroot)并展开下一级(of_expandlevel)，外部刷新树按钮一般直接调用此事件ii.ue_itempopulate展开下一级节点，在此事件中增加下一级节点信息(of_additem)iii.ue_child判断这一级树节点是否有下一级节点，若有则返回true，否则返回falseiv.ue_selectionchanged选择某一树节点时触发，一般在此事件中书写相关业务处理脚本v.ue_datatoparent定位树节点用，在树堆栈中找到其上一级节点信息vi.ue_labletodata定位树节点用，把输入文本转换为相关树节点data值，以便于比较b.重要函数：i.of_deleteallitem删除所有树节点ii.of_addroot增加树的根节点iii.of_expandlevel展开树的层次iv.of_additem增加某一级树节点c.相关对象：i.u_tv_locate$定位树节点用，设置相关树对象函数为of_settv；若输入框可弹出拼音码选择，则把控件属性ib_spell_select$ii.st_tvdata常用作树节点data参数10、数据窗口对象(u_datawindow$)：a.常用函数如下：i.of_setrowselect高亮显示选中的行ii.of_setmultiselect行多选(Ctrl/Shift)b.重要事件处理如下：i.ue_keydown回车换行或按空格键或F8弹出拼音码选择处理ii.dberror数据库SQL错误触发iii.itemerror其它数据窗错误时触发，如数据校验不通过11、拼音码选择(n_dw_spell$)：重要函数如下a.of_spell_dwc弹出的拼音码选择窗口与参数设置的子数据窗口内容一样，但参数设置的子数据窗口字段必须符合:code、name、spell_code、sequence_nob.of_setdw使用传列名参数的of_spell_dwc前必须选调用此函数四、ZHIS4常用函数：1、获取系统参数：影响全院流程的参数配置，相关数据库表为sys_parma.f_getsysparmb.f_getsysparmx在事务处理中调用此函数，防止出错回滚(rollback)c.添加系统参数时须注意做好相关SQL语法日志，其缺省值应是支持原来流程；厦门智业软件工程有限公司.研发部ZHIS4项目组文档D:\temp\1578600658110.doc第4页共5页d.系统参数名称必须统一为小写2、获取本地参数：可对某科室/个人/机器进行个性化参数设置，相关数据库表为subsystem_localini_dicta.f_inigetb.f_inigetx在事务处理中调用此函数c.本地参数设置相关对象为uo_ini，设置本地参数关联数据窗口应注意：i.加对应的文本对象，其名称必须是列名+[_t]ii.列的tag值为当前参数的缺省值d.本地参数名一般为大写e.获取参数值后应注意进行有效性判断(系统参数也一样)，如空值判断；并保证此参数缺省值应是原来的流程控制方式，以保证业务兼容3、数据库错误提示：f_sqlerr/f_sqlerror4、应用级错误提示：f_msgerr5、拼音码获取及五笔码获取:a.f_getspell/f_getspellxb.f_getwbzx6、获取系统时间：f_getsysdatetime7、菜单权限判断：f_checkpurview8、字符串参数截取：f_stringmid，以分号[;]隔开各字符串参数五、ZHIS4业务相关组件：1、应用主菜单设置：a.Tag值设置：用于菜单权限控制，同一子系统每个菜单的Tag值不能一样，若是无须控制权限的菜单(如退出系统菜单)，Tag值就设为none；b.隐式菜单：菜单不可见(visible=false)，主要用于权限控制2、读卡控件(uo_card)：对外主要事件接口如下a.ue_retrievesick用户刷卡后触发此事件，一般在此取得此病人ID及相关功能处理b.ue_reset用户清除卡信息会触发此事件，一般在此设置某些控件不可用3、病人基本信息控件(uo_sick_info$)：统一显示病人的基本信息，相关函数如下：a.设计时区分门诊或住院：IB_DISP_FLAG/IB_RESI_FLAGb.uf_retrieve传入病人ID获取病人信息c.uf_reset清空病人显示信息4、公用子数据窗对象(n_create_dwc$):一些常用子数据窗设置，便于支持拼音码选择5、动态标签页：支持可视对象运行时定制显示(opentab函数)，标签页必须使用用户自定义可视对象封装a.相关数据库表：subsystem_dyantab_dictb.打开的可视对象从u_uobase继承c.重要函数处理：i.uf_init初始化标签页对象ii.uf_reset清空标签页对象iii.uf_retrieve刷新标签页对象厦门智业软件工程有限公司.研发部ZHIS4项目组文档D:\temp\1578600658110.doc第5页共5页六、ZHIS4其它业务处理机制：1、自动更新/版本升级：auto_update2、消息处理：效率问题3、缓存机制：系统参数，本地参数，权限控制，拼音码选择字典4、二次开发接口机制：医院定制功能/PBD覆盖5、票据定制及打印设置(n_bill_set)：a.of_bill_set()b.of_bill_print_set:printset.dll（打印定制）6、报表：a.实施人员/医院系统管理员也可定制报表b.报表检索条件等其它要素都可定制c.基于PB的数据窗口技术实现：syntax/created.数据翻译配置可动态实现