K3常用二次开发
1常用二次开发方法
1.1登陆界面图片修改
1)在中间层方式：在中间层KDCOM目录新建两个图片文件：
LOGIN_PIC_LOG_TOP.bmp适用于10.4版本+PT007378，或V11版本及以后版本
LOGIN_PIC_LOG_BOTTOM.bmp适用于10.4版本+PT007378，或V11版本及以后版本
MAIN_PIC_LOG_RIGHT_FLOWCHART.bmp,适用于10.4版本+PT007378，或V11版本
MAIN_PIC_LOG_LEFT_FLOWCHART.bmp,适用于10.4版本+PT007378，或V11版本
MAIN_PIC_LOG_LEFT.bmp,适用于10.4版本+PT007378，或V11版本
MAIN_PIC_LOG_RIGHT.bmp,适用于10.4版本+PT007378，或V11版本
该方式不需要每个客户端机器安装图片，登陆时自动显示。
2)客户端方式：直接修改以下图片文件，适用于V12及以后版本：
F:\Program Files\Kingdee\K3ERP\k3Standard\KDSYSTEM\KEE_imgLogo.bmp
3)企业LOG方式
在中间层新建一个文件夹，命名为eptlogo并将其设置为只读共享，然后制作两个BMP 格式的图片，分别作为logo和背景图，大小为145×180，分别命名为enterprise_logo.bmp,enterprise_bg.bmp,在客户端的主控台编辑器启用企业界面即可。
4)图标替换
LOG 替换图片：KDCOM文件夹下
名称长*宽(像素) 说明
LOGIN_PIC_LOG_BOTTOM.bmp 142*39 登录界面底部
LOGIN_PIC_LOG_TOP.bmp 331*101 登录界面顶部
需要登录主控台->系统->设置->主控台编辑->选项->取消启用企业界面应用方案。
V12.0以后不需要下面文件：
MAIN_PIC_LOG_LEFT.bmp 614*63 主控台左上
MAIN_PIC_LOG_RIGHT.bmp 186*36 主控台右上
MAIN_PIC_LOG_LEFT_FLOWCHART.bmp 614*71 流程图左上
MAIN_PIC_LOG_RIGHT_FLOWCHART.bmp 191*36 流程图右上
主控台子系统图标替换：
把图标文件后缀名改为.dat文件，替换为：
D:\Program Files\Kingdee\K3ERP\SYSTEMICON
sys_SubsysID.dat
登录界面图片替换：(该替换方式不支持只替换中间层后客户端自动替换)
V12.1 V12.2：(图片名称以成长版简体中文为例，如是WISE则将KEE替换为KUE，
如是繁体或英文环境则将CHS替换为CHT或EN)
KEE_imgLogo.bmp 370*87 登录界面左上角
KEE_ImgLogin.bmp 617*408 登录界面背景
KEE_imgLogoys.bmp 92*52 登录界面右下角友商网图标kee_imglogo2.bmp 110*52 登录界面右下角Kindee图标
KEE_help_CHS.gif 618*76 用户手册顶部图标
KEE_KDTool_CHS.gif 793*75 客户端工具包顶部图标
KEE_Login_ACCT_CHS.bmp 440*270 帐套管理背景图片KEE_About_logo_CHS.bmp 365*102 关于界面LOGO
1.2主控台无界面登陆
组件部署：客户端%Kdsystem%
程序名：KdLogin.NoUILogin
方法名：LoginUser
参数描述
Public Function LoginUser(ByVal sLoginType As String _
, ByVal sAcctNumber As String _
, ByVal sOrgPass As String _
, ByVal sUserName As String _
, ByVal sUserPass As String) As String
smFile.Write bytFile
smFile.SaveToFile m_sTempFileName, adSaveCreateOverWrite 1.3)解压缩
Dim ozip As Object
Set ozip = CreateObject("KDZIP.ZIP")
ozip.DeCompress m_sTempFileName, sFileName
1.4)显示出来
Set Img.Picture = LoadPicture(sFileName)
1.保存图片
2.1)对图片进行压缩，压缩强度为 6
Set dzip = CreateObject("KDZIP.ZIP")
https://www.360docs.net/doc/d119014360.html,press App.Path & "\1.bmp", App.Path & "\1.zip", 6
2.2)读取文件
Set mstream = New ADODB.Stream
mstream.Type = adTypeBinary
mstream.Open
mstream.LoadFromFile App.Path & "\1.zip"
Dim varFile() As Byte
varFile = mstream.Read()
2.3)修正字节数,必须是偶数个(从0到奇数)
lFileSize = UBound(varFile) + 1 - (UBound(varFile) Mod 2)
ReDim Preserve varFile(0 To lFileSize) As Byte
2.4)把压缩后的图片导入到t_accessory表中
con = "Persist Security Info=True;Provider=SQLOLEDB.1;User ID=sa;Password=;Data Source=?;Initial Catalog=AIS20091116094820"
sql1 = "select * from t_accessory where FID=1"
Set rs = New ADODB.Recordset
rs.Open sql1, con, adOpenDynamic, adLockOptimistic
rs.Fields("FFile").AppendChunk varFile()
rs.Update
1.4K/3自定义认证开发方法
目的：提供用户可定义的K/3主控台登陆方法，用户可以按自己的方式验证，例如：实现指纹认证，声音认证。适用于K/3V10.3及以后版本。：
1. 新建VB工程：SelfIdentity.VBP
2. 添加一个窗体Form.frm
3. 添加一个模块Module1.mod
包含以下定义：
Public g_strAcctName As String
Public g_UserName As String
Public g_UserPassWord As String
4. 添加类ClsIdentity.cls
包含以下两个接口
Public Function SeftClientSign(strAcctName As String, UserName As String, UserPassWord As String, ErrMsg As String) As Long
If UserName = g_UserName And g_strAcctName = strAcctName And
g_UserPassWord = Trim(UserPassWord) Then
SeftClientSign = 1
End If
End Function
Public Function GetSelfPassWord(ByVal strAcctName As String, ByRef UserPassWord As String) As String
'弹出指纹任证界面,直到GetSelfPassWord返回值不为空
Form1.Show vbModal
GetSelfPassWord = "test"
UserPassWord = "123"
g_strAcctName = strAcctName
g_UserName = GetSelfPassWord
g_UserPassWord = UserPassWord
End Function
5. 在账套管理>账套>参数设置，选择“自定义认证方式”
6. 在用户管理，设置用户test属性为“自定义认证方式”
7. 以test用户登陆。
1.5基础资料插件化开发
基础资料-插件接口由K3BaseDataEvents.dll提供：
1、概述
要使用插件，需要写一个插件的DLL，引用K3BaseDataEvents.dll，处理其提供的接口即可。编写好插件DLL后，需要在数据库表中增加该插件的注册记录，如下：
表名：t_ThirdPartyComponent
关键字段及意义：
FTypeID：101
FTypeDetailID：1-19，>=2000,核算项目类别ID
FComponentName：客户端插件类的ProgID
FComponentSrv：服务端插件类的ProgID –未实现
FDescription：描述
注：其中FTypeDetailID为0时表示该插件对所有核算项目都有效，比如对所有核
算项目指定统一的编码规则、自定义某个通用行的名称等。
2、K3BaseDataEvents.ItemEvents 类
该类定义了核算项目编辑界面所有的事件。
●Public Event AfterGridLoad()
加载各字段后触发，可以在该事件中处理界面初始化、默认编码等等
●Public Event GridChange(ByVal lRow As Long)
某一行单元格值更新后触发
●Public Event EnterGrid(ByVal lRow As Long)
焦点进入某一行触发- 如判断使用后不允许修改
●Public Event OnPressF7 (ByVal lRow As Long,
ByRef RetCol As KDVBF.ReturnCollection, ByRef Cancel As Boolean)
按F7时触发，可以在该事件中自己处理弹出F7操作
●Public Event BeforeList(ByVal lRow As Long, ByRef strSqlReturn As String)
弹出下拉列表前触发，用strSqlReturn返回查询列表的SQL语句，要求包括FNumber、FName 等字段。
●Public Event BeforeSave(Cancel As Boolean)
保存前触发–自定义校验数据
3、K3BaseDataEvents. ItemEditInterface 类
该类定义了对核算项目编辑操作的一些属性、接口和方法
属性
●Public Property Get PropsString() As String
功能未公开(Reserved)
●Public Property Get Grid() As Object
功能未公开(Reserved)
●Public Property Get ItemObject() As EBCGL.Item
获得当前的核算项目对象，可以访问其属性
●Public Property Get ItemClass() As EBCGL.ItemClass
获取核算项目类别对象，如类别为物料
●Public Property Get ItemClassId() As Long
获取核算项目类别ID，如物料类别ID为4
●Public Property Get ParentID() As Long
获取核算项目上级组ID，为0则没有上级组
●Public Property Get ParentItemObject() As EBCGL.Item
获取上级组对象，通过该对象可访问上级组代码、名称等属性
方法
●Public Function GetRowNumber(FieldName As String) As Long
‘根据字段名称查找行号。
●Public Function GetRowFieldProp(ByVal lRow As Long) As CustomProperty
'根据行号获得字段属性
●Public Sub SetRowFocus(ByVal lRow As Long)
'设置焦点
●Public Sub SetRowLock(ByVal Row As Long)
'设置单元只读。
●Public Sub SetRowUnLock(ByVal Row As Long)
'设置单元为缺省非只读
●Public Sub SetRowNotNull(ByVal Row As Long)
'设置为必录项
●Public Sub SetRowBeNull(ByVal Row As Long)
'设置为非必录项
●Public Sub SetRowValue(ByVal Row As Long, Optional NewVal As Variant = "", Optional NewID
As Variant = 0)
'设置行的值
●Public Function ReadCellText(ByVal lCol As Long, ByVal lRow As Long) As String
'读取Text
●Public Function ReadID(ByVal Row As Long) As Long
'读取内部ID
●Public Function ReadValue(ByVal Row As Long) As Variant
'读取数据
●Public Function GetAnyRecordset(ByVal SQL As String) As ADODB.Recordset
'保留的
●Public Function IsItemInUsed() As Boolean
'判断该项目是否被使用-wScan
●Public Function GetDecimalDigits(ByVal dblVal As Double) As Long
'计算一个数值的小数位数
●Public Function GetSystemProfileValue(ByVal sCagegory As String, ByVal sKey As String,
Optional ByVal sDefault As String = "") As String
'获得系统参数信息
●Public Function ItemIsDetail() As Boolean
'获得该核算项目是否是明细，还是上级组
Public Sub SetRowCaption(ByVal lRow As Long, sCaption As String)
'设置行标题
4、K3BaseDataEvents.ItemEditInterface对象
该对象不可直接创建，需由K3BaseDataEvents.ItemEvents的属性获得：Public Property Get EditInterface() As ItemEditInterface
”
1.6用户权限管理插件化开发
用户权限管理-插件接口由K3BaseDataEvents.dll提供：
组件位置：
$/CodePublic/K3BASE/BaseData/client/K3BaseDataEvents/K3BaseDataEvents.vbp
实例插件代码位置：
$/CodePublic/K3BASE/BaseData/client/K3BaseAccessPlugin/K3BaseAccessPlugin.vbp
1.概述
要使用插件，需要写一个插件的DLL，引用K3BaseDataEvents.dll，处理其提供的接口即可。编写好插件DLL后，需要在数据库表中增加该插件的注册记录，如下：
表名：t_ThirdPartyComponent
关键字段及意义：
FTypeID：102
FTypeDetailID：从1开始，按照已有顺序+1定义。
FComponentName：客户端插件类的ProgID
FComponentSrv：服务端插件类的ProgID –未实现
FDescription：描述
2.K3BaseDataEvents.AccessEvents类
该类定义了权限管理保存后的相关事件。
Public Event AfterSaveUserAccessGroup(ByVal UserID As Long, vctPermData As Vector, ByVal UserName As String, ByVal sMachineName As String, ByVal sIPAddress As String)
用户组权限保存后触发
Public Event Public Event AfterSaveUserAccessDetail(ByVal ObjectType As Long, _ ByVal ObjectID As Long, _
ByVal vctSecurityInfo As Object, _
ByVal UserID As Long, _
ByVal sUserName As String, _
ByVal sMachineName As String, _
ByVal sIPAddress As String, _
ByVal vctDelAccess As KFO.Vector)
用户明细权限保存后触发
3.插件编写方法
内部引用，初始化，并实现事件接口即可，（请参考组件K3BaseAccessPlugin.dll的实现）步骤如下：
a)新建DLL工程如K3BaseAccessPlugin.dll，并引用插件类库K3BaseDataEvents.dll
b)新建类如CBIAccessEdit (BI模块在权限修改后做相关处理的插件)
c)定义WithEvents的K3BaseDataEvents.AccessEvents对象，并处理其事件
d)编写接口函数Public Sub Show(ByV al oEvents As AccessEvents)，在该函数中初始化
插件对象，必须的！！
e)插件写好后，编译成K3BaseAccessPlugin.dll，向数据库表中插入数据注册该插件即
可，如下SQL：
f)
1.7系统参数平台插件化开发
用户权限管理-插件接口由K3ParaConsoleEvents.dll提供：
组件位置：
$/CodePublic/K3BASE/K3ParameterConsole/Client/K3ParaConsoleEvents/K3ParaConsoleEvents .vbp
实例插件代码位置：
1.概述
要使用插件，需要写一个插件的DLL，引用K3BaseDataEvents.dll，处理其提供的接口即可。编写好插件DLL后，需要在数据库表中增加该插件的注册记录，如下：
表名：t_ThirdPartyComponent
关键字段及意义：
FTypeID：103
FTypeDetailID：按照对应功能的子系统ID*1000~子系统ID*999定义
FComponentName：客户端插件类的ProgID
FComponentSrv：服务端插件类的ProgID –未实现
FDescription：描述
方法：
Public Sub AddPara（dctPara as KFO.Dictionary）
添加一个系统参数,dctPara是系统参数的详细信息，包括参数类型，参数值，相关组件等信息。如果参数这中有一个名为” vctParas”的值的话，
系统会认它是一个KFO.Vector，这时进行批量添加系统参数，该原则同样适用于SetPara中的参数值。这样可以尽量减少接口的数量。
FParaID：参数的唯一标识。可以为长度50的任意字符，该参数为必填。
FParaType（0：CheckBox,1:TextBox,2: DropDownList,3:Button,4: Number），该参数为必填。
FParaValue（
CheckBox复选框参数，值用0,1表示；
TextBox文本框参数，值直接填充；
DropDownList下拉列表参数，值用chr(1)分隔显示名称和值，用chr(2)分隔每个DropDownList 的值；
Chr(3)分隔下拉列表的初始化值和当前选中的值
Button按钮参数，值用来填写要调用组件的名称，参数和要调用的方法，
组件名称也就是用CreateObject调用的“工程名.类名”，
用chr(1)分隔组件名称，参数和要调用的方法，如有多个参数，用chr(2)分隔各个参数，程序解析时，首先用chr(1)为分隔符分组，可以将参数分为一个ary(2),其中
ary(0)= “工程名.类名”
ary(1)= 系统参数的集合（用chr(2)分隔）
ary(2)= 被调用的接口方法
如果想触发ClickButtonPara事件而不想使用系统本身的方法调用相关组件请使用
dct("FValue")=Chr(1)
Number 数值参数。值只能输入数值。
）
参数扩展属性:
FSubSysName：参数子系统名称，指定参数所属的子系统。
FParaName：参数名称
FSysDefaultValue:系统参数默认值.
可以不同，在界面上显示FTradeDisplay,但保存时使用FTradeValue
FDisplay:系统参数显示值
FValue:系统参数真实值。如类型为TextBox的参数，真实值与显示值可以不同，如果没有指定显示值，则系统使用真实值显示在界面上。
FTradeValue:系统参数所属行业值
FTradeDisplay:系统参数所属行业显示值。
FDiffValue: “存在差异”列对应的值。
FMaxEditLen:系统参数类型为TextBox时，可以为参数文本框指定一个最大长度。FNumberDecPlaces:系统参数类型为Number时，用该参数来指定小数位数，默认为0. FNumberMin: 系统参数类型为Number时，用该参数来指定数值可使用的最小值. FNumberMax: 系统参数类型为Number时，用该参数来指定数值可使用的最大值.
Flock:若要锁定某参数，使其在界面上无法编辑，这可以指定Flock=1锁定参数。
FTips:参数提示信息Tips
Public Sub SetCellFocus(ByVal lRow As Long, ByVal lCol)
设置单元获得焦点焦点
Public Sub SetCellLock(ByVal lRow As Long, ByVal lCol, bLock As Boolean)
设置单元只读属性
Public Function GetCellText(ByVal lRow As Long, ByVal lCol As Long) As String
读取某个单元格的Text
Public Function SetCellText(ByVal lRow As Long, ByVal lCol As Long, Optional NewVal As Variant = "") As String
'设置某个单元格的Text
'同步显示值和真实的值
Public Sub SyncParaValue(ByVal lRow As Long)
'得到当前参数值，即调整后状态值
Public Function GetParaValue(ByVal lRow As Long) As String
'得到当前参数值，即调整后状态值
Public Function GetParaValueByParaID(ByVal ParaID As String) As String
'通过ParaID获取当前参数所在的行号，如果该参数没有在界面上显示，则返回-1
Public Function GetParaRowByParaID(ByVal ParaID As String) As Long
‘用子系统ID重新刷新该子系统下的所有参数到界面
Public Sub RefreshParaBySubSysID(ByVal lSubSysID As Long)
'设置参数值
Public Sub SetParaValue(ByVal lRow As Long, ByVal dctData As KFO.Dictionary)
Public Sub SetParaValueByParaID(ByVal ParaID As String, ByVal dctData As KFO.Dictionary)
事件：
'修改系统参数值时触发，dctPara 为被修改参数的相关数据，Cancel=True取消修改Public Event ChangeParaValue(ByVal dctPara As KFO.Dictionary)
'系统参数平台点保存，在更新数据库值之前触发
Public Event BeforeSave(ByRef Cancel As Boolean)
'系统参数平台点保存，在修改数据库值之后触发
Public Event AfterSave()
'点击按钮类型的系统参数后触发
Public Event ClickButtonPara(ByVal dctPara As KFO.Dictionary)
'行业配置改变时触发
Public Event TradeChange(ByVal dctPara As KFO.Dictionary)
'子系统改变时触发
Public Event SubSysNodeClick(ByVal dctPara As KFO.Dictionary)
'点击参数平台
Public Event GridClick(ByVal dctPara As KFO.Dictionary)
'KeyDown事件，F7功能可以在该事件中实现
Public Event GridKeyDown(ByVal dctPara As KFO.Dictionary)
'点击工具栏上的刷新Refresh时触发该事件事件
Public Event ClickRefresh(ByVal dctPara As KFO.Dictionary)
2.系统参数定义表
')
Insert Into t_SystemProfile (FCategory,FKey,FValue) Values ('Base_Trade','Trade_1','机械行业') Insert Into t_SystemProfile (FCategory,FKey,FValue) Values ('Base_Trade','Trade_2','汽配行业') Insert Into t_SystemProfile (FCategory,FKey,FValue) Values ('Base_Trade','Trade_3','食品行业') Insert Into t_SystemProfile (FCategory,FKey,FValue) Values ('Base_Trade','Trade_4','医药行业')
GO
FTradeID与对应的ID保持一致：即0:标准行业；1:机械行业；2: 汽配行业；3: 食品行业；4: 医药行业
注：系统预设值其实总是与0：标准行业的值是一样的。换句话说，初始化系统预设值实际上就
是读取0:标准行业的值
T_ParaData与T_ParaTradeData中的预定义数据需要业务组根据需求插入。
可以通过下面语句得到当前帐套设置的行业值
Select FValue from t_SystemProfile Where FCategory='Base' and FKey='CurrentTradeID'
3.系统参数平台界面列定义
Public Enum GridColDefine
COL_FID = 1 '参数ID [ID根据下面公式计算：子系统ID*10000~ ID*10000 + 9999]目前该子系统已有最大编号+1
COL_SUBSYS_ID = 2 '子系统ID
COL_PARA_Type = 3 '系统参数类型0：CheckBox,1:TextBox,2: DropDownList,3:Button
COL_PARA_ID = 4 '系统参数ID[可以用字符表示的参数ID，全局唯一]
COL_SYSDEFAULT_V ALUE = 5 '系统预设默认值
COL_TRAD_V ALUE = 6 '行业配置状态值
COL_V ALUE = 7 '调整后状态值
COL_SUBSYS_NAME = 8 '子系统名称
COL_PARA_NAME = 9 '参数名称
COL_SYSDEFAULT_DISPLAY = 10 '系统预设默认值显示列
COL_TRAD_DISPLAY = 11 '行业配置状态值显示列
COL_V ALUE_DISPLAY = 12 '调整后状态值显示列
COL_DIFF = 13 '差异分析
End Enum
'参数类型
Public Enum ParaType
PT_CHECKBOX = 0
PT_TEXTBOX = 1
PT_DROWDOWNLIST = 2
PT_BUTTON = 3
PT_NUMBER = 4
End Enum
37.8主控台插件化开发
主控台-插件接口由KDMainDataEvents.dll提供：
组件位置：
$/CodePublic/K3BASE/kdMainNew/client/KDMainDataEvents