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

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