值更新事件详细解析编辑菜单下功能描述.docx
《值更新事件详细解析编辑菜单下功能描述.docx》由会员分享，可在线阅读，更多相关《值更新事件详细解析编辑菜单下功能描述.docx（71页珍藏版）》请在冰豆网上搜索。
值更新事件详细解析编辑菜单下功能描述
1.1动作详解
1.1.1概述
K/3BOS抽象的商业逻辑现在有三十八种，概要说明列表如下表
动作代码
说明
TakeBaseData
适用于字段事件。
携带当前字段相关基础资料属性到指定列，详细设置请参考章节1.1.3。
Calculate
适用于字段事件。
计算定义公式的值并填写到指定列，详细设置请参考章节1.1.4。
UnitExchange
适用于字段事件。
计量单位变化后自动换算数量或单价，详细设置请参考章节1.1.5。
LockByItemTrack
适用于字段事件。
物料为非批号管理时锁定批号对应列，详细设置请参考章节1.1.6。
SetDecimal
适用于字段事件。
根据物料上数量单价精度设置数量单价精度，详细设置请参考章节1.1.7。
SetEquation
适用于字段事件。
设置当前编辑字段值到指定字段，详细设置请参考章节1.1.8。
ShowHideField
适用于字段事件。
表达式为真/假时显示/隐藏字段，详细设置请参考章节1.1.9。
Vertify
适用于字段事件。
单据合法性校验，详细设置请参考章节1.1.10。
LockUsed
适用于字段事件。
单据被引用后锁定字段，详细设置请参考章节1.1.11。
LockMenu
适用于字段事件。
条件成立时锁定菜单项，否则解锁菜单项，详细设置请参考章节1.1.12。
VerifyUniquely
合法性检查，检查字段唯一性，详细设置请参考章节1.1.13。
CalcAggregate
适用于字段事件。
按公式计算表体字段的值并填写到表头目标字段，详细设置请参考章节1.1.14。
TrigAction
适用于字段事件。
触发字段值更新事件，详细设置请参考章节1.1.15。
ClearFieldValue
适用于字段事件。
当前字段值改变时清空指定字段的值，详细设置请参考章节1.1.16。
SetFieldProperty
适用于字段事件。
根据表达式的值设置字段显示信息，详细设置请参考章节1.1.17。
BOSSer_ShowMsg
适用于操作事件。
显示提示信息，详细设置请参考章节1.1.18。
BOSSer_POPriceAlert
适用于操作事件。
采购价格预警，详细设置请参考章节1.1.19。
BOSSer_Break
适用于操作和字段事件。
中止后续动作，详细设置请参考章节1.1.20。
BOSSer_PriceQueryPO
适用于操作事件。
采购价格查询，详细设置请参考章节1.1.21。
BOSSer_GetSupplyInfo
适用于操作事件。
获取供应商采购价格，详细设置请参考章节1.1.22。
BOSSer_HPriceQry
历史价格查询，详细设置请参考章节1.1.23。
BOSSer_VStockStatus
库存状态查询，详细设置请参考章节1.1.24。
BOSSer_GetTaxRate
携带税率，详细设置请参考章节1.1.25。
BOSSer_CurrencyCal
币别转换，详细设置请参考章节1.1.26。
BOSSer_GetExchangeRate
获取币别的汇率，详细设置请参考章节1.1.27。
BOSSer_VItemReplace
物料替代查询，详细设置请参考章节1.1.28。
BOSSer_Reload
刷新界面，详细设置请参考章节1.1.29。
BOSSer_GetMenuInfo
获取菜单信息，详细设置请参考章节1.1.30。
BOSSer_SetMenuInfo
设置菜单信息，详细设置请参考章节1.1.31。
BOSSer_ExecRtnSQL
执行有简单返回值的SQL，详细设置请参考章节1.1.32。
BOSSer_UpdateItemPrice
更新物料价格，详细设置请参考章节1.1.33。
BOSSer_GetStockQtyAndSecurityQty
单据状态栏显示当前分录即时仓存、安全库存信息，详细设置请参考章节1.1.34。
BOSSer_ReturnMultiMaterial
F12库存查询，详细设置请参考章节1.1.35。
MBOSSer_ExecSQL
中间层执行SQL，详细设置请参考章节1.1.36。
MBOSSer_ExecRtnSQL
执行有简单返回值的SQL，详细设置请参考章节1.1.37。
BOSSer_MobileMessageHandler
适用于操作事件。
调出K/3消息、手机短信、电子邮件的发送界面，通过消息的定义将信息发送给界面上指定的信息接收人，详细设置请参考章节1.1.38。
SetTextFieldValue
适用于操作事件。
给指定文本（备注）字段赋值，详细设置请参考章节1.1.39。
BOSSer_BasePriceQuery
适用于操作事件。
在单据界面进行销售基本价格的查询。
详细设置请参考章节1.1.40。
BOSSer_PriceInfoQuery
适用于操作事件。
在单据界面进行销售价格资料的查询。
详细设置请参考章节1.1.41。
VerifyEntryUniquely
适用于字段值更新事件。
在单据录入时检查指定单据体字段的唯一性。
详细设置请参考章节1.1.42。
HideTab
适用于字段加载更新事件。
在单据重新加载时根据条件显示/隐藏指定的页签。
详细设置请参考章节1.1.50。
1.1.2执行条件
K/3BOS中每个动作都增加了执行条件，每个动作只有满足了执行条件才会被执行。
如单据未审核时就做了下推，下推成功后用户想再对该单据进行修改，修改并点保存时，弹出提示“单据已下推，是否仍要修改？
”，图6-2为提示动作前的执行条件设置界面。
图6-2
例如：
1、2个（长）日期字段比较。
可以设置如：
[单据头.开始日期]>[单据头.结束日期]
2、和固定日期比较。
可以设置如：
[单据头.开始日期]>#2004/02/1213:
30:
00#
其中：
a、日期必须是有效日期。
在MicrosoftWindows中，
有效日期的范围介于公元100年1月1日与公元9999年12月31日之间；
其有效范围随操作系统不同而不同；
b、日期必须以#号开始，并以#号结束；
c、日期书写格式必须是年/月/日，其中以英文/号连接。
3、判断（长）日期是否录入。
可以设置公式如:
notisnothing（[单据头.开始日期]）
V12.3版本开始action条件表达式支持like、notlike比较，且支持定基础资料明细值（内码、代码、名称）返回用于公式设置。
对单据事件的执行条件对话框进行如下改造：
图6-3
字段列表：
1、列出常用变量以及单据字段；
2、对当前单据定义规则时，系统需自动显示该单据的单据头字段（涉及基础资料，还需显示基础资料的属性字段）、单据体字段；
3、提供并支持以下运算符：
+-*/><=（）andorlikenotlike
举例：
不等于：
<>
为空：
=””
不为空：
<>””
基础资料：
1、【类型】允许用户选择基础资料类型（BOSIDE中“常规字段库”：
.基础资料，目前只有“BOS基础资料”及“核算项目”支持Action条件表达式规则改进）；
2、【属性】：
允许用户选择需要返回的基础资料的“内码”、“代码”、“名称”；
3、【基础资料】：
允许用户F7选择目标基础资料记录，系统返回该基础资料的对应属性值；
4、【添加】：
点击添加，系统自动将获取的属性值填到【表达式】区域；
注：
“类型”、“属性”、“基础资料”禁止用户手工录入，只能选择，系统自动返回；
举例：
【属性】选择内码时，返回
[供应商.名称：
鞍山东方实业发展总公司物供销处.内码~@~9555]
【属性】选择代码时，返回
[供应商.名称：
鞍山东方实业发展总公司物供销处.代码^@^01.01.0004]
【属性】选择名称时，返回
[供应商.名称：
鞍山东方实业发展总公司物供销处.名称^@^鞍山东方实业发展总公司物供销处]
补充描述：
日期比较公式编写规范：
#2008/08/08#（即：
#年/月/日#）
#2008/08/08/08/00/00#（即：
#年/月/日/小时/分/秒#）
#08/00/00#（即：
#小时/分/秒#）
用户点击【确定】时，将进行表达式合法性检查，并显示检查结果。
保存action后，单据运行时触发action。
1.1.3携带当前字段相关基础资料属性到指定列
“携带当前字段相关基础资料属性到指定列”（takebasedata）action中支持选择基础资料属性字段做为目标字段，当选择的目标字段是基础资料属性字段时，源字段的下拉列表列出当前基础资料字段的所有属性字段。
增加该action的配置界面，如下图所示：
图6-4
运行时，执行该aciton可将上图中设置的源字段的值赋给目标字段。
要注意的是：
该action不支持执行条件的设置。
1.1.4计算定义公式的值并填写到指定列
通过定义公式，确定业务对象某个字段的值。
其中“指定列”应该是业务对象上已有的字段，公式中的各项可以是业务对象中的字段或是字段的相关属性。
例如当数量、单价数值变化后，设置金额字段的值等于数量*单价，此时需要在数量和单价字段上定义相应的计算公式。
事件的定义界面如图6-5：
图6-5
界面元素
说明
字段列表
单据上的字段及字段相关属性列表。
运算符
计算公式支持的运算符号
1.1.5计量单位变化后自动换算数量或单价
这个事件适用于单位类型的字段，可以实现数量与单价类型的字段值根据计量单位的变化而自动根据变化后计量单位的换算率进行换算。
事件的定义界面如图6-6，计量单位如果变化，相应数量、单价将会自动调整。
图6-6
1.1.6物料为非批号管理时锁定批号对应列
适用于物料类型的字段，目标字段是批号类型字段，如果物料是非批号管理的物料，此动作将自动将批号类型的字段锁定。
这个事件是系统预设事件，业务对象同时有批号类型字段与物料类型字段时，将自动为物料字段增加此事件，用户暂不能修改，但可以选择删除。
1.1.7根据物料上数量单价精度设置数量单价精度
适用于物料类型的字段，目标字段是数量或单价类型字段，单据运行时依据物料的数量精度属性或单价精度属性设置对应字段的精度。
该动作由K/3BOS自动维护，目前不支持直接设置，但可以选择删除。
1.1.8设置当前编辑字段值到指定字段
将当前基础资料字段的值复制到目标基础资料字段，此事件为系统预设动作，用户不能修改。
1.1.9表达式为真/假时显示/隐藏字段
此事件实现动态设置业务对象字段可见性的功能。
用户可以使用业务对象的字段定义一个表达式，根据此表达式的值，设定业务一个或几个字段的可见性。
例如当[用户]字段的等于“onesir”时，才能看到[科目]信息。
该动作的定义界面如图6-7。
图6-7
1.1.10表达式为真/假时锁定/解锁字段
此事件实现动态设置业务对象字段锁定性的功能。
用户可以使用业务对象的字段定义一个表达式，根据此表达式的值，设定业务一个或几个字段的锁定性。
例如如果用户为“onesir”，[单据头.科目]字段不可编辑动作的定义界面如下图：
图6-8
【锁定时清空目标字段值】如果勾选此选项，则在锁定动作发生时，将清空选择字段的值。
1.1.11单据合法性校验
此事件用于单据保存前的合法性校验。
根据用户设定的检查表达式，一旦字段的值使表达式的值为假，则认为校验不通过，不通过时的提示，用户可以通过自定义。
例如数量不应该允许为0。
该动作的定义界面如图6-9：
图6-9
【单据录入时检查】指定在单据字段值改变时，立即作合法性的校验。
【保存时检查】指定在单据数据保存时，作合法性的校验。
1.1.12表达式为真/假时锁定/解锁菜单项
这个事件与“表达式为真/假时锁定/解锁字段”事件类似，唯一不同的是，一个是对菜单项的操作，另一个是对单据字段的操作。
定义界面如图6-10：
图6-10
1.1.13合法性校验，检查字段唯一性
业务对象保存时，许多字段都要求保证数据的唯一性。
此事件是为此而设计的。
例如：
单据编号字段不允许重复。
该动作的定义界面如图6-11
图6-11
1.1.14按公式计算表体字段的值并填写到表头目标字段
在业务设计中经常会有这样的情况，需要将表体中某一列数值类型的字段的值取其合计或平均值，将其填写到表头的某一字段。
此逻辑可以方便快捷地实现这样的需求。
目前提供的公式有“合计”、“平均值”、“最大值”和“最小值”四种，可以将表体上数值类型的列按公式计算并填写到表头上数值类型的字段上。
注：
此事件只针对表体字段。
例如：
当金额字段数值改变时，须更新单据头总额字段。
该动作的定义界面如图6-12：
图6-12
1.1.15触发字段值更新事件
在业务设计时，当字段需要连续触发值更新时，可通过该方法实现，目前只支持一级触发。
该动作主要用于减少动作重复定义的工作量。
例如：
当[数量]、[单价]字段改变时须刷新[金额]字段而当[金额]字段数值改变时，须计算[金额本位币]，更新[单据头.总额字段]以及[单据头.总额本位币]字段，为减少重复定义，可在[数量]、[单价]字段上通过增加触发[金额]字段值更新事件实现。
该动作的定义界面如图6-13：
图6-13
1.1.16当前字段值改变时清空指定字段的值
通过定义公式，当业务对象某个字段的值改变时清除指定字段的值。
例如：
当物料字段改变时须清除已经录入的计量单位，事件的定义界面如图6-14：
图6-14
1.1.17根据表达式的值设置字段显示信息
通过定义公式，当表达值为真时设置指定字段的显示属性。
事件的定义界面如图6-15：
图6-15
1.1.18显示提示信息
通过定义公式，显示提示信息，对于交互类型的提示，如果用户选择取消，则会抛出错误，中止后续代码的执行。
例如：
某业务单据业务员字段为非必录信息，但当业务员为空保存单据时需要提示客户是否继续保存。
该动作的定义界面如图6-16所示：
图6-16
注意：
如果未勾选[交互类型提示]选项且是序时簿事件触发时，则不会直接显示提示框，而是将信息包含在操作结束时的“序时簿操作事件执行结果”对话框中。
1.1.19采购价格预警
通过定义公式，在对应操作完成时对依据采购价格进行最高限价预警。
定义界面如图6-17所示：
图6-17
参数列表说明如下表：
公式
BOSSer_POPriceAlert{Para=[FKey,...];Return=[FKey,...];BOSAction={FKey,...}}
参数
参数名
边界
描述
P_SupplyKEY
必须传入
供应商键值
P_CurrencyKEY
必须传入
币别键值
P_ExChangeRate
必须传入
汇率键值
P_PriceType
默认值为1
单价类型，0-委外，1-外购
P_PriceKEY
必须传入
单价键值
P_TaxPriceKEY
可以为空
含税单价键值
P_ItemKEY
必须传入
物料键值
P_UnitKEY
必须传入
单位键值
P_TaxRateKEY
必须传入
税率键值
P_DiscountRateKEY
必须传入
折扣率键值
P_InvStyleKey
可以为空
业务类型键值，分为委外类型/外购类型。
如果指定这个字段，则“单价类型”则会取单据上的这个字段值来决定判断。
P_SaveOrApprove
默认值为0
操作类型，0-保存，1-审核。
P_UseSInvoiceDecimal
默认值为0
是否使用专用发票单价精度设置，1-使用，0-使用物料上的精度。
备注
按顺序选择单据上上述字段，如果有确认信息，确认后流程是否继续，取消后流程之后终止。
该action支持自动匹配。
系统自动选取与该参数类型一致的字段匹配给该参数。
当有多个与参数类型一致的字段时，选取这些字段中排在第一位的字段。
新增action时，可自动进行匹配，修改action时不自动匹配，但是可以通过点击下方的“重新匹配”按钮进行匹配。
1.1.20中止后续动作
通过定义公式，显示提示信息，中止后续代码的执行。
例如：
业务审核完成后才需要进行单据变更，当单据还未完成业务审核时提示客户。
该动作的定义界面如图6-18所示：
图6-18
1.1.21采购价格查询
通过定义公式，依据输入的物料或供应商信息调用“采购价格管理界面”。
定义界面如图6-19所示：
图6-19
参数列表说明如下表：
动作名称
BOSSer_PriceQueryPO
动作描述
采购价格查询
公式
BOSSer_PriceQueryPO{Para=[FKey,...];Return=[FKey,...];BOSAction=[FKey,...]}
参数
参数名称
边界
描述
P_CallByBill
输入参数，默认值为1
调用方式，1表示单据调用，0表示序时簿调用。
P_SupID
输入参数
供应商
P_CurrencyID
输入参数
币别
P_ICItemID
输入参数
物料
P_PriceType
输入参数
单价类型，0-委外，1-外购
P_InvStyle
输入参数
发票类型，0为普通发票，1为增值税发票
P_CalSupTax
输入参数
是否根据供应商税率计算，0为否，1为是
P_CalDiscount
输入参数
是否根据供应商折扣率计算，0为否，1为是
P_POOrderTaxInPrice
输入参数
当前税率选项（0表示订单单价不含税，1表示订单单价含税,默认为依据系统参数）
P_FSupID
输出参数
供应商
P_FCurrencyID
输出参数
币别
P_FItemID
输出参数
物料
P_FUnitID
输出参数
单位
P_FTaxPrice
输出参数
含税单价
P_FPrice
输出参数
单价
P_FDiscount
输出参数
折扣率
备注
按顺序选择单据上上述字段。
该action支持自动匹配。
系统自动选取与该参数类型一致的字段匹配给该参数。
当有多个与参数类型一致的字段时，选取这些字段中排在第一位的字段。
新增action时，可自动进行匹配，修改action时不自动匹配，但是可以通过点击下方的“重新匹配”按钮进行匹配。
1.1.22获取采购价格
通过定义公式，依据输入的物料或供应商信息填入价格字段。
定义界面如图6-20所示：
图6-20
参数列表说明如下表：
动作名称
BOSSer_GetSupplyInfo
动作描述
获取供应商采购价格
公式
BOSSer_GetSupplyInfo{Para=[FKey,...];Return=[FKey,...];BOSAction=[FKey,...]}
参数
参数名称
边界
描述
P_SupplyID
输入参数，默认值为空
供应商
P_CurrencyID
输入参数，默认值为本位币
币别
P_ExChangeRate
输入参数，默认值为1
汇率
P_PriceType
输入参数，默认值为1
单价类型，0-委外，1-外购
P_InvStyle
输入参数，默认值为0
发票类型，0-普通发票，1-增值税发票
P_ICItemID
输入参数，必须传入
物料
P_UnitID
输入参数，必须传入
计量单位
P_AuxQty
输入参数，默认值0
数量
P_GetICItemPOPrice
输入参数，默认值为1
是否获取物料采购单价
P_TaxPrice
输入参数，默认值为0
是否计算税率
P_Price
输入参数，默认值为1
当前税率选项（0表示订单单价不含税,1表示订单单价含税）
P_Discount
输入参数，默认值为0
是否计算折扣
P_TaxPrice
输出参数
含税单价
P_Pricet
输出参数
单价
P_Discount
输出参数
折扣率
备注
1.1.23历史价格查询
通过定义公式，依据输入的物料或供应商或客户信息调用“价格查询”界面。
定义界面如图6-21所示：
图6-21
参数列表说明如下表：
动作名称
BOSSer_HPriceQry
动作描述
历史价格查询
公式
BOSSer_HPriceQry{Para=[FKey,...];BOSAction=[FKey,...]}
参数
参数名称
边界
描述
P_QueryType
默认值为1
查询类别（客户为1，供应商为2）
P_CompanyID
默认值为0
客户或供应商内码
P_ICItemID
默认值为0
物料内码
备注
该action支持自动匹配。
系统自动选取与该参数类型一致的字段匹配给该参数。
当有多个与参数类型一致的字段时，选取这些字段中排在第一位的字段。
新增action时，可自动进行匹配，修改action时不自动匹配，但是可以通过点击下方的“重新匹配”按钮进行匹配。
1.1.24库存状态查询
通过定义公式，依据输入的物料信息调用“库存状态查询”界面。
定义界面如图6-22所示：
图6-22
参数列表说明如下表：
动作名称
BOSSer_VStockStatus
动作描述
库存状态查询
公式
BOSSer_VStockStatus{Para=[FKey,...];BOSAction=[FKey,...]}
参数
参数名称
边界
描述
P_ICItemID
默认值为””。
如果当前单元格没有数值，则查询全部物料的库存状态，否则查询当前单元格物料的库存状态
物料内码
备注
该action支持自动匹配。
系统自动选取与该参数类型一致的字段匹配给该参数。
当有多个与参数类型一致的字段时，选取这些字段中排在第一位的字段。
新增action时，可自动进行匹配，修改action时不自动匹配，但是可以通过点击下方的“重新匹配”按钮进行匹配。
1.1.25携带税率
通过定义公式，依据当前税率来源在字段值更新事件时携带税率。
定义界面如图6-23所示：
图6-23
参数列表说明如下表：
动作名称
BOSSer_GetTaxRate
动作描述
依据参数获得税率
公式
BOSSer_GetTaxRate{Para=[FKey,...];Return=[FKey,...];BOSAction=[FKey,...]}
参数
参数名称
边界
描述
P_SystemType
0表示采购，1表示销售
系统
P_CompanyType
0表示客户，1表示供应商
核算项目类别
P_CompanyID
客户或供应商
P_ICItemID
物料
P_TaxRateOption
0表示客户或供应商；1表示物料，缺省使用系统选项
当前税率来源
备注
1.1.26币别转换
通过定义公式，当币别转换时，重新刷新计算本位币金额字段。
定义界面如图6
升级会员 