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

上传人:b****5 文档编号:4041962 上传时间:2022-11-27 格式:DOCX 页数:71 大小:1.01MB
下载 相关 举报
值更新事件详细解析编辑菜单下功能描述.docx_第1页
第1页 / 共71页
值更新事件详细解析编辑菜单下功能描述.docx_第2页
第2页 / 共71页
值更新事件详细解析编辑菜单下功能描述.docx_第3页
第3页 / 共71页
值更新事件详细解析编辑菜单下功能描述.docx_第4页
第4页 / 共71页
值更新事件详细解析编辑菜单下功能描述.docx_第5页
第5页 / 共71页
点击查看更多>>
下载资源
资源描述

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

《值更新事件详细解析编辑菜单下功能描述.docx》由会员分享,可在线阅读,更多相关《值更新事件详细解析编辑菜单下功能描述.docx(71页珍藏版)》请在冰豆网上搜索。

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

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

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

展开阅读全文
相关资源
猜你喜欢
相关搜索

当前位置:首页 > PPT模板 > 艺术创意

copyright@ 2008-2022 冰豆网网站版权所有

经营许可证编号:鄂ICP备2022015515号-1