值更新事件详细解析编辑菜单下功能描述.docx

1、值更新事件详细解析编辑菜单下功能描述1.1 动作详解1.1.1 概述K/3 BOS抽象的商业逻辑现在有三十八种，概要说明列表如下表动作代码说明TakeBaseData适用于字段事件。携带当前字段相关基础资料属性到指定列，详细设置请参考章节1.1.3。Calculate适用于字段事件。计算定义公式的值并填写到指定列，详细设置请参考章节1.1.4。UnitExchange适用于字段事件。计量单位变化后自动换算数量或单价，详细设置请参考章节1.1.5。LockByItemTrack适用于字段事件。物料为非批号管理时锁定批号对应列，详细设置请参考章节1.1.6。SetDecimal适用于字段事件。根据

2、物料上数量单价精度设置数量单价精度，详细设置请参考章节1.1.7。SetEquation适用于字段事件。设置当前编辑字段值到指定字段，详细设置请参考章节1.1.8。ShowHideField适用于字段事件。表达式为真/假时显示/隐藏字段，详细设置请参考章节1.1.9。Vertify适用于字段事件。单据合法性校验，详细设置请参考章节1.1.10。LockUsed适用于字段事件。单据被引用后锁定字段，详细设置请参考章节1.1.11。LockMenu适用于字段事件。条件成立时锁定菜单项，否则解锁菜单项，详细设置请参考章节1.1.12。VerifyUniquely合法性检查，检查字段唯一性，详细设置请

3、参考章节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适用于操作事件。采购

4、价格预警，详细设置请参考章节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_Cur

5、rencyCal币别转换，详细设置请参考章节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_UpdateItemPric

6、e更新物料价格，详细设置请参考章节1.1.33。BOSSer_GetStockQtyAndSecurityQty单据状态栏显示当前分录即时仓存、安全库存信息，详细设置请参考章节1.1.34。BOSSer_ReturnMultiMaterialF12 库存查询，详细设置请参考章节1.1.35。MBOSSer_ExecSQL中间层执行SQL，详细设置请参考章节1.1.36。MBOSSer_ExecRtnSQL执行有简单返回值的SQL，详细设置请参考章节1.1.37。BOSSer_MobileMessageHandler适用于操作事件。调出K/3消息、手机短信、电子邮件的发送界面，通过消息的定义将信

7、息发送给界面上指定的信息接收人，详细设置请参考章节1.1.38。SetTextFieldValue适用于操作事件。给指定文本（备注）字段赋值，详细设置请参考章节1.1.39。BOSSer_BasePriceQuery适用于操作事件。在单据界面进行销售基本价格的查询。详细设置请参考章节1.1.40。BOSSer_PriceInfoQuery适用于操作事件。在单据界面进行销售价格资料的查询。详细设置请参考章节1.1.41。VerifyEntryUniquely适用于字段值更新事件。在单据录入时检查指定单据体字段的唯一性。详细设置请参考章节1.1.42。HideTab适用于字段加载更新事件。在单据重

8、新加载时根据条件显示/隐藏指定的页签。详细设置请参考章节1.1.50。1.1.2 执行条件K/3 BOS中每个动作都增加了执行条件，每个动作只有满足了执行条件才会被执行。如单据未审核时就做了下推，下推成功后用户想再对该单据进行修改，修改并点保存时，弹出提示“单据已下推，是否仍要修改？”，图6-2为提示动作前的执行条件设置界面。 图6-2例如：1、2个（长）日期字段比较。 可以设置如：单据头.开始日期 单据头.结束日期2、和固定日期比较。 可以设置如：单据头.开始日期 #2004/02/12 13:30:00# 其中：a、日期必须是有效日期。 在 Microsoft Windows 中， 有效日

9、期的范围介于公元100年1月1日与公元9999年12月31日之间； 其有效范围随操作系统不同而不同； b、日期必须以 # 号开始，并以 # 号结束； c、日期书写格式必须是 年/月/日，其中以英文 / 号连接。3、判断（长）日期是否录入。 可以设置公式如: not is nothing (单据头.开始日期)V12.3版本开始action条件表达式支持like、not like比较，且支持定基础资料明细值（内码、代码、名称）返回用于公式设置。对单据事件的执行条件对话框进行如下改造：图6-3字段列表：1、列出常用变量以及单据字段；2、对当前单据定义规则时，系统需自动显示该单据的单据头字段（涉及基础

10、资料，还需显示基础资料的属性字段）、单据体字段；3、提供并支持以下运算符：+ - * / = ( ) and or like not like举例：不等于：为空：=”不为空：”基础资料：1、【类型】允许用户选择基础资料类型（BOS IDE中“常规字段库”：.基础资料，目前只有“BOS基础资料”及“核算项目”支持Action条件表达式规则改进）；2、【属性】：允许用户选择需要返回的基础资料的“内码”、“代码”、“名称”；3、【基础资料】：允许用户F7选择目标基础资料记录，系统返回该基础资料的对应属性值；4、【添加】：点击添加，系统自动将获取的属性值填到【表达式】区域；注：“类型”、“属性”、“基

11、础资料”禁止用户手工录入，只能选择，系统自动返回；举例：【属性】选择内码时，返回供应商.名称：鞍山东方实业发展总公司物供销处.内码9555【属性】选择代码时，返回供应商.名称：鞍山东方实业发展总公司物供销处.代码01.01.0004【属性】选择名称时，返回供应商.名称：鞍山东方实业发展总公司物供销处.名称鞍山东方实业发展总公司物供销处补充描述：日期比较公式编写规范：#2008/08/08# （即：#年/月/日#）#2008/08/08/08/00/00# （即：#年/月/日/小时/分/秒#）#08/00/00# （即：#小时/分/秒#）用户点击【确定】时，将进行表达式合法性检查，并显示检查结果

12、。保存action后，单据运行时触发action。1.1.3 携带当前字段相关基础资料属性到指定列“携带当前字段相关基础资料属性到指定列”（takebasedata）action中支持选择基础资料属性字段做为目标字段，当选择的目标字段是基础资料属性字段时，源字段的下拉列表列出当前基础资料字段的所有属性字段。增加该action的配置界面，如下图所示：图6-4运行时，执行该aciton可将上图中设置的源字段的值赋给目标字段。要注意的是：该action不支持执行条件的设置。1.1.4 计算定义公式的值并填写到指定列通过定义公式，确定业务对象某个字段的值。其中“指定列”应该是业务对象上已有的字段，公式

13、中的各项可以是业务对象中的字段或是字段的相关属性。例如当数量、单价数值变化后，设置金额字段的值等于数量*单价，此时需要在数量和单价字段上定义相应的计算公式。事件的定义界面如图6-5：图 6-5界面元素说明字段列表单据上的字段及字段相关属性列表。运算符计算公式支持的运算符号 1.1.5 计量单位变化后自动换算数量或单价这个事件适用于单位类型的字段，可以实现数量与单价类型的字段值根据计量单位的变化而自动根据变化后计量单位的换算率进行换算。事件的定义界面如图6-6，计量单位如果变化，相应数量、单价将会自动调整。图 6-61.1.6 物料为非批号管理时锁定批号对应列适用于物料类型的字段，目标字段是批号

14、类型字段，如果物料是非批号管理的物料，此动作将自动将批号类型的字段锁定。这个事件是系统预设事件，业务对象同时有批号类型字段与物料类型字段时，将自动为物料字段增加此事件，用户暂不能修改，但可以选择删除。1.1.7 根据物料上数量单价精度设置数量单价精度适用于物料类型的字段，目标字段是数量或单价类型字段，单据运行时依据物料的数量精度属性或单价精度属性设置对应字段的精度。该动作由K/3BOS自动维护，目前不支持直接设置，但可以选择删除。 1.1.8 设置当前编辑字段值到指定字段将当前基础资料字段的值复制到目标基础资料字段，此事件为系统预设动作，用户不能修改。1.1.9 表达式为真/假时显示/隐藏字段

15、此事件实现动态设置业务对象字段可见性的功能。用户可以使用业务对象的字段定义一个表达式，根据此表达式的值，设定业务一个或几个字段的可见性。例如当用户字段的等于“onesir”时，才能看到科目信息。该动作的定义界面如图6-7。图 6-71.1.10 表达式为真/假时锁定/解锁字段此事件实现动态设置业务对象字段锁定性的功能。用户可以使用业务对象的字段定义一个表达式，根据此表达式的值，设定业务一个或几个字段的锁定性。例如如果用户为“onesir”，单据头.科目字段不可编辑动作的定义界面如下图：图 6-8【锁定时清空目标字段值】如果勾选此选项，则在锁定动作发生时，将清空选择字段的值。1.1.11 单据合

16、法性校验此事件用于单据保存前的合法性校验。根据用户设定的检查表达式，一旦字段的值使表达式的值为假，则认为校验不通过，不通过时的提示，用户可以通过自定义。例如数量不应该允许为0。该动作的定义界面如图6-9：图 6-9【单据录入时检查】指定在单据字段值改变时，立即作合法性的校验。【保存时检查】指定在单据数据保存时，作合法性的校验。1.1.12 表达式为真/假时锁定/解锁菜单项这个事件与“表达式为真/假时锁定/解锁字段”事件类似，唯一不同的是，一个是对菜单项的操作，另一个是对单据字段的操作。定义界面如图6-10：图6-101.1.13 合法性校验，检查字段唯一性业务对象保存时，许多字段都要求保证数据

17、的唯一性。此事件是为此而设计的。例如：单据编号字段不允许重复。该动作的定义界面如图6-11图 6-111.1.14 按公式计算表体字段的值并填写到表头目标字段在业务设计中经常会有这样的情况，需要将表体中某一列数值类型的字段的值取其合计或平均值，将其填写到表头的某一字段。此逻辑可以方便快捷地实现这样的需求。目前提供的公式有“合计”、“平均值”、“最大值”和“最小值”四种，可以将表体上数值类型的列按公式计算并填写到表头上数值类型的字段上。注：此事件只针对表体字段。例如：当金额字段数值改变时，须更新单据头总额字段。该动作的定义界面如图6-12：图 6-121.1.15 触发字段值更新事件在业务设计时

18、，当字段需要连续触发值更新时，可通过该方法实现，目前只支持一级触发。该动作主要用于减少动作重复定义的工作量。例如：当数量、单价字段改变时须刷新金额字段而当金额字段数值改变时，须计算金额本位币，更新单据头.总额字段以及单据头.总额本位币字段，为减少重复定义，可在数量、单价字段上通过增加触发金额字段值更新事件实现。该动作的定义界面如图6-13：图6-131.1.16 当前字段值改变时清空指定字段的值通过定义公式，当业务对象某个字段的值改变时清除指定字段的值。例如：当物料字段改变时须清除已经录入的计量单位，事件的定义界面如图6-14：图6-141.1.17 根据表达式的值设置字段显示信息通过定义公式

19、，当表达值为真时设置指定字段的显示属性。事件的定义界面如图6-15：图6-151.1.18 显示提示信息通过定义公式，显示提示信息，对于交互类型的提示，如果用户选择取消，则会抛出错误，中止后续代码的执行。例如：某业务单据业务员字段为非必录信息，但当业务员为空保存单据时需要提示客户是否继续保存。该动作的定义界面如图6-16所示：图6-16注意：如果未勾选交互类型提示选项且是序时簿事件触发时，则不会直接显示提示框，而是将信息包含在操作结束时的“序时簿操作事件执行结果”对话框中。1.1.19 采购价格预警通过定义公式，在对应操作完成时对依据采购价格进行最高限价预警。定义界面如图6-17所示：图6-1

20、7参数列表说明如下表：公式BOSSer_POPriceAlertPara=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_I

21、nvStyleKey可以为空业务类型键值，分为 委外类型/外购类型。如果指定这个字段，则“单价类型”则会取单据上的这个字段值来决定判断。P_SaveOrApprove默认值为0操作类型，0-保存，1-审核。P_UseSInvoiceDecimal默认值为0是否使用专用发票单价精度设置，1-使用，0-使用物料上的精度。备注按顺序选择单据上上述字段，如果有确认信息，确认后流程是否继续，取消后流程之后终止。该action支持自动匹配。系统自动选取与该参数类型一致的字段匹配给该参数。当有多个与参数类型一致的字段时，选取这些字段中排在第一位的字段。新增action时，可自动进行匹配，修改action时不

22、自动匹配，但是可以通过点击下方的“重新匹配”按钮进行匹配。1.1.20 中止后续动作通过定义公式，显示提示信息，中止后续代码的执行。例如：业务审核完成后才需要进行单据变更，当单据还未完成业务审核时提示客户。该动作的定义界面如图6-18所示：图6-181.1.21 采购价格查询通过定义公式，依据输入的物料或供应商信息调用“采购价格管理界面”。定义界面如图6-19所示：图6-19参数列表说明如下表：动作名称BOSSer_PriceQueryPO动作描述采购价格查询公式BOSSer_PriceQueryPOPara=FKey,.;Return=FKey,.;BOSAction=FKey,.参数参数名

23、称边界描述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输

24、出参数供应商 P_FCurrencyID输出参数币别 P_FItemID输出参数物料 P_FUnitID输出参数单位 P_FTaxPrice输出参数含税单价 P_FPrice输出参数单价 P_FDiscount输出参数折扣率备注按顺序选择单据上上述字段。该action支持自动匹配。系统自动选取与该参数类型一致的字段匹配给该参数。当有多个与参数类型一致的字段时，选取这些字段中排在第一位的字段。新增action时，可自动进行匹配，修改action时不自动匹配，但是可以通过点击下方的“重新匹配”按钮进行匹配。1.1.22 获取采购价格通过定义公式，依据输入的物料或供应商信息填入价格字段。定义界面如图

25、6-20所示：图6-20参数列表说明如下表：动作名称BOSSer_GetSupplyInfo动作描述获取供应商采购价格公式BOSSer_GetSupplyInfoPara=FKey,.;Return=FKey,.;BOSAction=FKey,.参数参数名称边界描述P_SupplyID输入参数，默认值为空供应商P_CurrencyID输入参数，默认值为本位币币别P_ExChangeRate输入参数，默认值为1汇率P_PriceType输入参数，默认值为1单价类型，0-委外，1-外购P_InvStyle输入参数，默认值为0发票类型，0-普通发票，1-增值税发票P_ICItemID输入参数，必须传

26、入物料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参数列表说

27、明如下表：动作名称BOSSer_HPriceQry动作描述历史价格查询公式BOSSer_HPriceQryPara=FKey,.;BOSAction=FKey,.参数参数名称边界描述P_QueryType默认值为1查询类别（客户为1，供应商为2）P_CompanyID默认值为0客户或供应商内码P_ICItemID默认值为0物料内码备注该action支持自动匹配。系统自动选取与该参数类型一致的字段匹配给该参数。当有多个与参数类型一致的字段时，选取这些字段中排在第一位的字段。新增action时，可自动进行匹配，修改action时不自动匹配，但是可以通过点击下方的“重新匹配”按钮进行匹配。1.1.2

28、4 库存状态查询通过定义公式，依据输入的物料信息调用“库存状态查询”界面。定义界面如图6-22所示：图6-22参数列表说明如下表：动作名称BOSSer_VStockStatus动作描述库存状态查询公式BOSSer_VStockStatusPara=FKey,.;BOSAction=FKey,.参数参数名称边界描述P_ICItemID默认值为”。如果当前单元格没有数值，则查询全部物料的库存状态，否则查询当前单元格物料的库存状态物料内码备注该action支持自动匹配。系统自动选取与该参数类型一致的字段匹配给该参数。当有多个与参数类型一致的字段时，选取这些字段中排在第一位的字段。新增action时，

29、可自动进行匹配，修改action时不自动匹配，但是可以通过点击下方的“重新匹配”按钮进行匹配。1.1.25 携带税率通过定义公式，依据当前税率来源在字段值更新事件时携带税率。定义界面如图6-23所示：图6-23参数列表说明如下表：动作名称BOSSer_GetTaxRate动作描述依据参数获得税率公式BOSSer_GetTaxRatePara=FKey,.;Return=FKey,.;BOSAction=FKey,.参数参数名称边界描述P_SystemType0表示采购，1表示销售系统P_CompanyType0表示客户，1表示供应商核算项目类别P_CompanyID客户或供应商P_ICItemID物料P_TaxRateOption0表示客户或供应商；1表示物料，缺省使用系统选项当前税率来源备注1.1.26 币别转换通过定义公式，当币别转换时，重新刷新计算本位币金额字段。定义界面如图6