金蝶Bos基础二次开发.docx

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,在客户端的主控台编辑器启用企业界面即可。
1.2 主控台无界面登陆
适用版本：(K/3V11.0.1+PT016290或V12以上版本)
1) 域用户登录：提供命令行参数:KDMain.exe -LoginWin|账套代码|机构密码 ,无界面直接登录到K/3系统主控台
2）命名用户登录：提供命令行参数KDMain.exe -LoginUser|账套代码|机构密码|用户名|用户密码, 无界面直接登录K/3系统主控台
3） 参数之间的分隔符默认为”|”，由于用户密码可能包含特殊字符，用户可以通过修改注册表改变分隔符，注册表参数：
路径：HKEY_CURRENT_USER\SoftWare\KingDee\K3
键：LoginParm
4） 获取账套代码的接口
组件名：KdLogin.dll
组件部署：客户端%Kdsystem%
程序名：KdLogin.clsLogin
方法名：GetAccountList
参数描述
GetAccountList() As ADODB.Recordset
参数：无
返回值类型：ADODB.Recordset，包含字段：
序号
字段名
描述
1
FAcctID
账套ID
2
FAcctNumber
账套代码
3
FAcctName
账套名称

5） 测试登录参数设置是否成功的接口
组件名：KdLogin.dll
组件部署：客户端%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
参数:
序号
字段名
参数类型
描述
1
sLoginType
String
登录方式：
-LoginWin 域用户身份登录
-LoginUser 命名用户身份登录
2
sAcctNumber
String
账套代码
3
sOrgPass
String
组织机构密码
例如：账套代码为：10.02,则为组织机构10的密码.
4
sUserName
String
用户名,域用户身份登录时为空
5
sUserPass
String
用户密码,域用户身份登录时为空

返回值类型：String，空字符串代表登录成功，否则登陆不成功,内容为登录不成功的原因。
1.3 基础资料的图片读写 

1.显示图片
1.1）从数据库取得图片的二进制数据
    Dim bytFile() As Byte
  ‘根据取数SQL生成记录集:select FFile from t_Accessory
    bytFile= rs.Fields("FFILE")
1.2)保存到文件
     Dim smFile As adodb.Stream  
    Set smFile = New adodb.Stream
    smFile.Type = adTypeBinary
    smFile.Open
    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")
    dzip.Compress 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.4 K/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 类
该类定义了核算项目编辑界面所有的事件。

l Public Event AfterGridLoad()
加载各字段后触发，可以在该事件中处理界面初始化、默认编码等等

l Public Event GridChange(ByVal lRow As Long)
某一行单元格值更新后触发

l Public Event EnterGrid(ByVal lRow As Long)
焦点进入某一行触发 - 如判断使用后不允许修改

l Public Event OnPressF7 (ByVal lRow As Long,
ByRef RetCol As KDVBF.ReturnCollection, ByRef Cancel As Boolean)
按F7时触发，可以在该事件中自己处理弹出F7操作

l Public Event BeforeList(ByVal lRow As Long, ByRef strSqlReturn As String)
弹出下拉列表前触发，用strSqlReturn返回查询列表的SQL语句，要求包括FNumber、FName等字段。

l Public Event BeforeSave(Cancel As Boolean)
保存前触发 – 自定义校验数据

3、 K3BaseDataEvents. ItemEditInterface 类
该类定义了对核算项目编辑操作的一些属性、接口和方法

Ø 属性
l Public Property Get PropsString() As String
功能未公开(Reserved)
l Public Property Get Grid() As Object
功能未公开(Reserved)

l Public Property Get ItemObject() As EBCGL.Item
获得当前的核算项目对象，可以访问其属性

l Public Property Get ItemClass() As EBCGL.ItemClass
获取核算项目类别对象，如类别为物料

l Public Property Get ItemClassId() As Long
获取核算项目类别ID，如物料类别ID为4

l Public Property Get ParentID() As Long
获取核算项目上级组ID，为0则没有上级组

l Public Property Get ParentItemObject() As EBCGL.Item
获取上级组对象，通过该对象可访问上级组代码、名称等属性

方法

l Public Function GetRowNumber(FieldName As String) As Long
‘根据字段名称查找行号。

l Public Function GetRowFieldProp(ByVal lRow As Long) As CustomProperty
'根据行号 获得字段属性

l Public Sub SetRowFocus(ByVal lRow As Long)
'设置焦点

l Public Sub SetRowLock(ByVal Row As Long)
'设置单元只读。

l Public Sub SetRowUnLock(ByVal Row As Long)
'设置单元为缺省非只读

l Public Sub SetRowNotNull(ByVal Row As Long)
'设置为必录项

l Public Sub SetRowBeNull(ByVal Row As Long)
'设置为非必录项

l Public Sub SetRowValue(ByVal Row As Long, Optional NewVal As Variant = "", Optional NewID As Variant = 0)
'设置行的值

l Public Function ReadCellText(ByVal lCol As Long, ByVal lRow As Long) As String
'读取Text

l Public Function ReadID(ByVal Row As Long) As Long
'读取内部ID

l Public Function ReadValue(ByVal Row As Long) As Variant
'读取数据

l Public Function GetAnyRecordset(ByVal SQL As String) As ADODB.Recordset
'保留的

l Public Function IsItemInUsed() As Boolean
'判断该项目是否被使用 -wScan

l Public Function GetDecimalDigits(ByVal dblVal As Double) As Long
'计算一个数值的小数位数

l Public Function GetSystemProfileValue(ByVal sCagegory As String, ByVal sKey As String, Optional ByVal sDefault As String = "") As String
'获得系统参数信息

l Public Function ItemIsDetail() As Boolean
'获得该核算项目是否是明细，还是上级组

l Public Sub SetRowCaption(ByVal lRow As Long, sCaption As String)
'设置行标题

4、 K3BaseDataEvents.ItemEditInterface对象
该对象不可直接创建，需由K3BaseDataEvents.ItemEvents的属性获得：
Public Property Get EditInterface() As ItemEditInterface

5、 插件编写方法
内部引用，初始化，并实现事件接口即可，（请参考组件K3BaseItemPlugin.dll的实现）
步骤如下：
a) 新建DLL工程如Test.dll，并引用插件类库K3BaseItemPlugin.dll
b) 新建类如MeterialPlug(物料插件)
c) 定义WithEvents的K3BaseDataEvents.ItemEvents对象，并处理其事件
d) 编写接口函数Public Sub Show(ByVal oEvents As ItemEvents)，在该函数中初始化插件对象，必须的！！
e) 可以使用K3BaseDataEvents.ItemEditInterface中提供的方法
f) 插件写好后，编译成Test.dll，向数据库表中插入数据注册该插件即可，如下SQL：
insert into t_ThirdPartyComponent
(FTypeID, FTypeDetailID, FIndex, FComponentName)
values (101,4, 1, 'Test. MeterialPlug')
-- 101表示基础资料，4表示物料
-- 该sql表示当编辑物料时，加载Test.MeterialPlug插件，若要该插件在所有核算项目编辑中都加载，只要将FTypeDetailID设为0即可
g) 测试、发布

'物料 -- 插件
Private Const ID_ITEMCLASSID = 4 ' 物料
Private WithEvents BaseItemEvents As K3BaseDataEvents.ItemEvents '事件引擎
Private m_EditInterface As K3BaseDataEvents.ItemEditInterface 'API接口

'该函数为接口函数，调用该函数进行初始化
Public Sub Show(ByVal oEvents As ItemEvents)
If oEvents.EditInterface.ItemClassID <> ID_ITEMCLASSID Then Exit Sub

Set BaseItemEvents = oEvents
Set m_EditInterface = BaseItemEvents.EditInterface
End Sub

'/********************************************************************/
'/*函数名称 : BaseItemEvents_AfterGridLoad
'/*日期 : 2009-06-11 14:18
'/*作者 : wScan
'/*描述 : 数据加载后触发，方便根据系统参数做某些特殊控制
'/*参数 :
'/********************************************************************/
Private Sub BaseItemEvents_AfterGridLoad()
''加载各字段后触发
End Sub

。。。。。。。

6、 实例：实现客户需要功能的代码

a) 定义插件对象并初始化
Private WithEvents BaseItemEvents As K3BaseDataEvents.ItemEvents '事件引擎
Private m_EditInterface As K3BaseDataEvents.ItemEditInterface 'API接口

'该函数为接口函数，调用该函数进行初始化
Public Sub Show(ByVal oEvents As ItemEvents)
Set BaseItemEvents = oEvents
Set m_EditInterface = BaseItemEvents.EditInterface
End Sub

b) 实现： 录入物料的时候，不需要录入上级组代码。系统自动带出上级组代码； 核算项目录入界面的前两个字段是代码和名称，对任何核算项目都是这样。客户要求加上前缀，如物料代码，客户代码。
Private Sub BaseItemEvents_AfterGridLoad()
''加载各字段后触发
Dim lRow As Long
Dim sParentNumber As String

On Error GoTo Err_Handler
lRow = m_EditInterface.GetRowNumber("FNumber")
If m_EditInterface.ParentID <> 0 Then
sParentNumber = m_EditInterface.ParentItemObject.Number
End If

''自动根据上级组编码填入前缀
If m_EditInterface.ItemObject.ItemID = 0 And m_EditInterface.ParentID <> 0 Then '新增
m_EditInterface.SetRowValue lRow, sParentNumber & "."
End If

''设置个性化的行标题，如 物料代码、物料名称等
m_EditInterface.SetRowCaption 1, m_EditInterface.ItemClass.Name & "代码"
m_EditInterface.SetRowCaption 2, m_EditInterface.ItemClass.Name & "名称"
m_EditInterface.SetRowCaption 3, m_EditInterface.ItemClass.Name & "全名"

Exit Sub
Err_Handler:

End Sub

c) 自动编码实现和上面原理一样，指定一个规则，自动生成代码，并锁定不允许修改即可。

d) 客户要求自动带出上级组代码，由于按上面的方法上级组代码仍然可以被修改掉，因此一种方法是：可以让客户只录最后一级代码，在保存前自动加上其上级组代码，处理BeforeSave事件即可。

2.实现对物料的默认仓库属性的F7功能和下拉列表功能的进一步过滤，使其只显示包含“6.”的仓库

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(ByVal oEvents As AccessEvents)，在该函数中初始化插件对象，必须的！！
e) 插件写好后，编译成K3BaseAccessPlugin.dll，向数据库表中插入数据注册该插件即可，如下SQL：
insert into t_ThirdPartyComponent
(FTypeID, FTypeDetailID, FIndex, FComponentName)
values (102,1, 1, 'K3BaseAccessPlugin.CBIAccessEdit')
-- 102表示权限修改的插件类对该类插件是固定的。在权限修改界面会加载所有定义成该类型的用户插件
-- 该sql表示当修改用户权限时，加载K3BaseAccessPlugin.CBIAccessEdit插件。
f) 测试、发布

Private Const ID_TypeDetailID = 1 'BI权限管理
Private WithEvents m_BaseAccessEvents As K3BaseDataEvents.AccessEvents '事件引擎

'该函数为接口函数，调用该函数进行初始化
Public Sub Show(ByVal oEvents As AccessEvents)
Set m_BaseAccessEvents = oEvents
End Sub
'卸载例程
Private Sub Class_Terminate()
Set m_BaseAccessEvents = Nothing
End Sub
4.实例：实现客户需要功能的代码

a) 定义插件对象并初始化
'该函数为接口函数，调用该函数进行初始化
Public Sub Show(ByVal oEvents As AccessEvents)
Set m_BaseAccessEvents = oEvents
End Sub

b) 实现：
'权限修改完成后触发,请在这里填写你的业务逻辑代码
Private Sub m_BaseAccessEvents_AfterSaveUserAccessDetail(ByVal ObjectType As Long, ByVal ObjectID As Long, ByVal SecurityInfo As Object, ByVal UserID As Long, ByVal sUserName As String, ByVal sMachineName As String, ByVal sIPAddress As String, ByVal vctDelAccess As KFO.Vector)
Dim strRet As String
Dim strFaccessType As String
Dim strFaccessMask As String

If Not SecurityInfo Is Nothing Then
strFaccessType = SecurityInfo(1)("FaccessType")
strFaccessMask = SecurityInfo(1)("FaccessMask")
End If

strRet = "ObjectType=" & CStr(ObjectType) & vbCrLf & _
"ObjectID=" & CStr(ObjectID) & vbCrLf & _
"FaccessType=" & strFaccessType & vbCrLf & _
"FaccessMask=" & strFaccessMask & vbCrLf & _
"UserID=" & CStr(UserID) & vbCrLf

MsgBox strRet
End Sub

'权限修改完成后触发,请在这里填写你的业务逻辑代码
Private Sub m_BaseAccessEvents_AfterSaveUserAccessGroup(ByVal UserID As Long, vctPermData As KFO.Vector, ByVal UserName As String, ByVal sMachineName As String, ByVal sIPAddress As String)
Dim strRet As String
Dim strFaccessType As String
Dim strFaccessMask As String
Dim strGroupID As String
Dim strSubSys As String

If Not vctPermData Is Nothing Then
strFaccessType = vctPermData(1)("Faccess")
strFaccessMask = vctPermData(1)("FMask")
strSubSys = vctPermData(1)("FSubSys")
strGroupID = vctPermData(1)("FGroupID")
End If

strRet = "FSubSys=" & CStr(strSubSys) & vbCrLf & _
"FGroupID=" & CStr(strGroupID) & vbCrLf & _
"FaccessType=" & strFaccessType & vbCrLf & _
"FaccessMask=" & strFaccessMask & vbCrLf & _
"UserID=" & CStr(UserID) & vbCrLf

MsgBox strRet
End Sub

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.Vec