最新BOS内置服务函数说明手册.doc

《最新BOS内置服务函数说明手册.doc》由会员分享，可在线阅读，更多相关《最新BOS内置服务函数说明手册.doc（15页珍藏版）》请在淘文阁 - 分享文档赚钱的网站上搜索。

1、Four short words sum up what has lifted most successful individuals above the crowd: a little bit more.-author-dateBOS内置服务函数说明手册扩展Action手册 KINGDEEK/3 BOS 开发指导手册BOS内置服务函数说明手册 -金蝶软件（中国）有限公司 研发中心 K/3 BOS系统开发部BOS内置服务函数说明手册 金蝶软件（中国）有限公司研发中心 K/3 BOS系统开发部RaymondYao 2006.03.221 扩展Action1.1 简介现有扩展Action如下表：资

2、源IDAction名称Action描述100000BOSSer_ShowMsg显示提示信息100001BOSSer_POPriceAlert限价预警100002BOSSer_Break中止后续Action, 并提示100003BOSSer_PriceQueryPO采购价格查询100004BOSSer_GetSupplyInfo获取供应商供货信息100005BOSSer_HPriceQry历史价格查询100006BOSSer_VStockStatus库存状态查询 100007BOSSer_GetTaxRate获取税率100008BOSSer_CurrencyCal币别转化计算100009BOSS

3、er_GetExchangeRate获取币别的税率100010BOSSer_VItemReplace物料替代查询100011BOSSer_Reload重新加载数据100012BOSSer_GetMenuInfo获取菜单的信息100013BOSSer_SetMenuInfo设置菜单信息100014BOSSer_GetBillInfo获取单据信息100015BOSSer_ExecRtnSQL执行有简单返回值的SQL100016BOSSer_UpdateItemPrice更新物料价格100017BOSSer_UpdatePOPrice更新供应商价格资料100400MBOSSer_ExecSQL中间层

4、执行SQL100401MBOSSer_UpdateItemPrice中间层更新物料价格100402MBOSSer_ExecRtnSQL执行有简单返回值的SQL1.2 客户端适用的扩展Action1.2.1 BOSSer_ShowMsg - 显示提示信息资源ID100000Action名称BOSSer_ShowMsgAction描述显示提示信息公式BOSSer_ShowMsgsErrMsg,MessageType参数参数含义说明sErrMsg提示信息内容MessageType显示信息的方式0：代表一般的提示框，只有 OK 按钮和通知消息图标。1：代表交互的提示框，有OK 和 Cancel 按钮和

5、通知消息图标。备注1、 当为一般提示框时，且是序时簿触发的，则不会直接显示提示框，而是将信息包含在操作结束时的“序时簿操作事件执行结果”对话框中；2、 当为交互提示框时，如果用户选择了“Cancel ”，则会引发终止该Action序列中的后续Action执行。1.2.2 BOSSer_POPriceAlert - 采购价格预警资源ID100001Action名称BOSSer_POPriceAlertAction描述采购价格预警公式BOSSer_POPriceAlertPara=FKey,.;Return=FKey,.;BOSAction=FKey,.参数参数名边界描述P_SupplyKEY必须

6、传入供应商键值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

7、-审核P_UseSInvoiceDecimal默认值为0是否使用专用发票单价精度设置，1-使用，0-使用物料上的精度备注1、 按顺序选择单据上上述字段；2、 需要选择的是 字段.键 类型的；3、 如果有确认信息，确认后流程是否继续，取消后流程之后终止。1.2.3 BOSSer_Break - 中止后续Action资源ID100002Action名称BOSSer_BreakAction描述中止后续Action公式BOSSer_BreaksErrMsg参数参数含义说明sErrMsg提示信息内容可选。需要填写多语言信息。备注1、 如果包含信息，则信息在操作结束时显示在“操作事件执行结果”对话框中；2

8、、 结合“执行条件”设置，当条件满足时触发。1.2.4 BOSSer_PriceQueryPO - 采购价格查询资源ID100003Action名称BOSSer_PriceQueryPOAction描述采购价格查询公式BOSSer_PriceQueryPOPara=FKey,.;Return=FKey,.;BOSAction=FKey,.参数参数名称边界描述P_CallByBill默认值为true调用方式P_SupID默认值为0供应商IDP_PriceType默认值为1单价类型P_InvStyle默认值为0发票类型P_ICItemID默认值为0物料ID备注1.2.5 BOSSer_GetSup

9、plyInfo - 获取供应商供货信息资源ID100004Action名称BOSSer_GetSupplyInfoAction描述获取供应商供货信息公式BOSSer_GetSupplyInfoPara=FKey,.;Return=FKey,.;BOSAction=FKey,.参数参数名称边界描述P_SupplyID供应商IDP_CurrencyID默认值为1币别IDP_ExChangeRate默认值为1汇率P_PriceType默认值为1单价类型P_InvStyle发票类型P_ICItemID必须传入物料IDP_UnitID必须传入计量单位IDP_AuxQty默认值0数量P_GetICItem

10、POPrice默认值为1是否获取物料采购单价备注1.2.6 BOSSer_HPriceQry - 历史价格查询资源ID100005Action名称BOSSer_HPriceQryAction描述历史价格查询公式BOSSer_HPriceQryPara=FKey,.;BOSAction=FKey,.参数参数名称边界描述P_QueryType默认值为1查询类别（客户为1，供应商为2）P_CompanyID默认值为0客户或供应商IDP_ICItemID默认值为0物料ID备注1.2.7 BOSSer_VStockStatus - 库存状态查询资源ID100006Action名称BOSSer_VStoc

11、kStatusAction描述库存状态查询公式BOSSer_VStockStatusPara=FKey,.;BOSAction=FKey,.参数参数名称边界描述P_ICItemID默认值为”。如果需要返回全部表体物料，则类型为数组，否则为String物料ID备注1.2.8 BOSSer_GetTaxRate - 携带税率资源ID100007Action名称BOSSer_GetTaxRateAction描述携带税率公式BOSSer_GetTaxRatePara=FKey,.;Return=FKey,.;BOSAction=FKey,.参数参数名称边界描述P_SystemType0表示采购，1表示

12、销售系统P_CompanyType0表示客户，1表示供应商类别P_CompanyID客户或供应商IDP_ICItemID物料IDP_TaxRateOption0表示客户或供应商；1表示物料，缺省使用系统选项当前税率来源备注1.2.9 BOSSer_CurrencyCal - 币别转换资源ID100008Action名称BOSSer_CurrencyCalAction描述币别转换公式BOSSer_CurrencyCalPara=FKey,.;Return=FKey,.;BOSAction=FKey,.参数参数名称边界描述P_CurrencyID币别IDP_OldCurrencyID转换前币别P_

13、OldExchangeRate转换前汇率(和转换前币别参数二选一)P_CalField1需要计算的字段1P_CalField2需要计算的字段2P_CalField3需要计算的字段3P_CalField4需要计算的字段4P_CalField5需要计算的字段5备注1.2.10 BOSSer_GetExchangeRate - 获取币别的汇率资源ID100009Action名称BOSSer_GetExchangeRateAction描述获取币别的汇率公式BOSSer_GetExchangeRatePara=FKey,.;Return=FKey,.;BOSAction=FKey,.参数参数名称边界描述

14、P_CurrencyID币别ID备注1.2.11 BOSSer_VItemReplace - 物料替代查询资源ID100010Action名称BOSSer_VItemReplaceAction描述物料替代查询公式BOSSer_VItemReplacePara=FKey,.;BOSAction=FKey,.参数参数名称边界描述P_ICItemID默认值为”。如果需要返回全部表体物料，则类型为数组，否则为String物料ID备注1.2.12 BOSSer_Reload -刷新界面资源ID100011Action名称BOSSer_ReloadAction描述刷新界面公式BOSSer_Reload参数

15、备注本Action不需要配置。在序时簿和单据上，重新加载数据并刷新当前界面1.2.13 BOSSer_GetMenuInfo - 获取菜单信息资源ID100012Action名称BOSSer_GetMenuInfoAction描述获取菜单信息公式BOSSer_GetMenuInfo变量名=菜单.Visible,.参数备注1、 在单据或序时簿状态的Action环境获取菜单的状态；2、 获取菜单的Caption、Name、ToolTip属性返回值为字符串；3、 获取菜单的Visible、Checked、Enabled属性返回值为布尔型；4、 获取菜单的Tag属性返回值为变体；1.2.14 BOSS

16、er_SetMenuInfo - 设置菜单信息资源ID100013Action名称BOSSer_SetMenuInfoAction描述设置菜单信息公式BOSSer_SetMenuInfo变量名=菜单.Visible,.参数备注1、 在单据或序时簿状态的Action环境设置菜单新的状态和信息；2、 设置菜单的Caption、Name、ToolTip属性，使用值为字符串；3、 设置菜单的Visible、Checked、Enabled属性，使用值为布尔型；1.2.15 BOSSer_GetBillInfo - 获取单据的一些信息资源ID100014Action名称BOSSer_GetBillInfo

17、Action描述获取单据的一些信息公式BOSSer_GetBillInfo$.Var1=BillInfo1,$.Var2=BillInfo2,.参数备注1、在单据操作过程中，获取单据的一些运行时信息1.2.16 BOSSer_ExecRtnSQL - 执行有简单返回值的SQL资源ID100015Action名称BOSSer_ExecRtnSQLAction描述执行有简单返回值的SQL公式BOSSer_ExceRtnSQLSQL=;Params=;Return=;参数参数名称描述SQL运行的SQL语句Para配置参数值列表Return返回值配置列表备注在客户端直接运行指定SQL，如果SQL中包含

18、了变量，则配置变量数据; 如果还需要返回值，则可以配置返回值1.2.17 BOSSer_UpdateItemPrice - 更新物料价格资源ID100016Action名称BOSSer_UpdateItemPriceAction描述更新物料价格公式BOSSer_UpdateItemPricePara=FKey,.;BOSAction=FKey,.参数参数名称边界描述P_PriceType价格类型P_ItemKEY物料字段P_CurrencyKEY币别字段P_ExChangeRateKEY汇率字段P_UnitKEY单位字段P_PriceKEY价格字段P_TaxRateKEY税率字段P_Disco

19、untRateKEY折扣字段P_ROBKEY红蓝字字段P_TaxInPrice价格字段是否已含税P_TargetTaxInPrice目标价格资料是否含税备注1.2.18 BOSSer_UpdatePOPrice - 更新供应商价格资料资源ID100017Action名称BOSSer_UpdatePOPriceAction描述更新供应商价格资料公式BOSSer_UpdatePOPricePara=FKey,.;BOSAction=FKey,.参数参数名称边界描述P_InterID单据内码备注1.3 中间层适用的扩展Action1.3.1 MBOSSer_ExecSQL -中间层执行SQL资源ID

20、100400Action名称MBOSSer_ExecSQLAction描述中间层执行SQL公式MBOSSer_ExecSQLSQL,Para.参数参数名称描述SQL中间层运行的SQL语句ParaSQL语句中可能包含的变量以及取值来源字段。变量在SQL中，必须以作为前后缀备注在中间层直接运行指定SQL，如果SQL中包含了变量，则按照变量取值来源字段，先取值，替换SQL中变量后再执行1.3.2 MBOSSer_UpdateItemPrice - 更新物料价格资料资源ID100401Action名称MBOSSer_UpdateItemPriceAction描述更新物料价格资料公式MBOSSer_Up

21、dateItemPricePara=FKey,.;BOSAction=FKey,.参数参数名称边界描述P_PriceType价格类型P_ItemKEY物料字段P_CurrencyKEY币别字段P_ExChangeRateKEY汇率字段P_UnitKEY单位字段P_PriceKEY价格字段P_TaxRateKEY税率字段P_DiscountRateKEY折扣字段P_ROBKEY红蓝字字段P_TaxInPrice价格字段是否已含税P_ApplyPriceManageParam应用启用价格管理参数备注1.3.3 MBOSSer_ExecRtnSQL - 执行有简单返回值的SQL资源ID100402A

22、ction名称MBOSSer_ExecRtnSQLAction描述执行有简单返回值的SQL公式MBOSSer_ExceRtnSQLSQL=;Params=;Return=;参数参数名称边界描述SQL运行的SQL语句Para配置参数值列表Return返回值配置列表备注在中间层直接运行指定SQL，如果SQL中包含了变量，则配置变量数据; 如果还需要返回值，则可以配置返回值2 典型Action序列说明2.1 关闭、反关闭2.1.1 关闭类别序号Action说明单据操作前事件1BOSSer_CheckCancel自定义扩展业务服务函数（可选）账套是否做初始化结束检查，如果不通过则结束后续Action2

23、BOSSer_Break根据执行条件判断单据头.单据状态字段的值来判断单据是否已经关闭；如果字段的值等于3，代表该单据已经关闭，则提示用户，并终止后续Action3BOSSer_Break根据执行条件判断单据头.单据状态字段的值来判断单据是否已经审核；如果字段的值等于0，代表该单据没有审核，则提示用户，并终止后续Action单据操作事件1MBOSSer_ExecSQL执行SQL，更新POOrder表FStatus字段值为3，代表为关闭状态；更新POOrderEntry表FMRPClosed字段，表示该单据分录行业务关闭。单据操作后事件1BOSSer_ShowMsg提示用户单据关闭成功2BOSS

24、er_Reload重新加载单据序时簿操作前事件序时簿操作事件1BOSSer_CheckCancel自定义扩展业务服务函数（可选）账套是否做初始化结束检查，如果不通过则结束后续Action2BOSSer_ExecRtnSQL执行SQL，从POOrder表中获取FStatus的值，并保存在变量中3BOSSer_Break根据执行条件判断变量FStatus的值来判断单据是否已经关闭；如果值等于3，代表该单据已经关闭，则提示用户，并终止后续Action4BOSSer_Break根据执行条件判断变量FStatus 的值来判断单据是否已经审核；如果值等于0，代表该单据没有审核，则提示用户，并终止后续Act

25、ion5MBOSSer_ExecSQL执行SQL，更新POOrder表FStatus字段值为3，代表为关闭状态；更新POOrderEntry表FMRPClosed字段，表示该单据分录行业务关闭。序时簿操作后事件1BOSSer_Reload重新加载序时簿2.1.2 反关闭类别序号Action说明单据操作前事件1BOSSer_CheckCancel自定义扩展业务服务函数（可选）账套是否做初始化结束检查，如果不通过则结束后续Action2BOSSer_Break根据执行条件判断单据头.单据状态字段的值来判断单据是否已经关闭；如果字段的值不等于3，代表该单据没有关闭，则提示用户，并终止后续Action

26、单据操作事件1BOSSer_ExecRtnSQL执行SQL，获取单据上存在分录的关联数量该行数量的行数2BOSSer_Break如果上面取得的行数等于0，代表单据上所有物料的数量均已选完，不能进行反关闭，提示用户并终止后续Action3BOSSer_ExecRtnSQL执行SQL获取单据分录中关关连数量不为0的分录数4BOSSer_ExecRtnSQL如果上述分录数为0，令变量FStatus值为1，否则为25MBOSSer_ExecRtnSQL执行SQL更新POOrder表中获取FStatus的值等于上面的变量值；更新所有表体分录中入库数量该行数量分录的行业务关闭标志为0单据操作后事件1BOS

27、Ser_ShowMsg提示用户单据反关闭成功2BOSSer_Reload重新加载单据序时簿操作前事件序时簿操作事件1BOSSer_CheckCancel自定义扩展业务服务函数（可选）账套是否做初始化结束检查，如果不通过则结束后续Action2BOSSer_ExecRtnSQL执行SQL，从POOrder表中获取FStatus的值，并保存在变量中3BOSSer_Break根据执行条件判断变量FStatus的值来判断单据是否已经关闭；如果值不等于3，代表该单据没有关闭，则提示用户，并终止后续Action4BOSSer_ExecRtnSQL执行SQL，获取单据上存在分录的关联数量该行数量的行数5BO

28、SSer_Break如果上面取得的行数等于0，代表单据上所有物料的数量均已选完，不能进行反关闭，提示用户并终止后续Action6BOSSer_ExecRtnSQL执行SQL获取单据分录中关关连数量不为0的分录数7BOSSer_ExecRtnSQL如果上述分录数为0，令变量FStatus值为1，否则为28MBOSSer_ExecRtnSQL执行SQL更新POOrder表中获取FStatus的值等于上面的变量值；更新所有表体分录中入库数量该行数量分录的行业务关闭标志为0序时簿操作后事件1BOSSer_Reload重新加载序时簿2.2 审核、反审核2.2.1 审核类别序号Action说明单据操作前事

29、件1单据操作事件1BOSSer_GetBillInfo获取当前单据是否需要保存的信息2BOSSer_Break如果未保存，则提示保存并中止退出3BOSSer_ExecRtnSQL获取相关的系统参数信息和单据的信息4BOSSer_Break判断系统是否初始化，如果没有初始化，则中止退出5BOSSer_Break判断单据是否已作废，如果作废，则中止退出6BOSSer_Break判断单据是否已审核，如果已审核，则中止退出7BOSSer_Break判断单据是否已关闭，如果已关闭，则中止退出8BOSSer_Break判断是否没有启用“审核与制单可为同一个人”参数，而且单据审核制单位同一人，则提示中止退出

30、9BOSSer_Break对于分销订单，如果未确认，则提示不能审核，中止退出10BOSSer_POPriceAlert采购价格预警，如果预警提示后用户取消，则需要中止退出11BOSSer_ExecRtnSQL更新单据审核标记12BOSSer_UpdatePOPrice更新采购价值资料单据操作后事件1BOSSer_ShowMsg提示用户单据审核成功2BOSSer_Reload重新加载单据序时簿操作前事件1序时簿操作事件1BOSSer_ExecRtnSQL获取相关的系统参数信息和单据的信息2BOSSer_Break判断系统是否初始化，如果没有初始化，则中止退出3BOSSer_Break判断单据是否

31、已作废，如果作废，则中止退出4BOSSer_Break判断单据是否已审核，如果已审核，则中止退出5BOSSer_Break判断单据是否已关闭，如果已关闭，则中止退出6BOSSer_Break判断是否没有启用“审核与制单可为同一个人”参数，而且单据审核制单位同一人，则提示中止退出7BOSSer_Break对于分销订单，如果未确认，则提示不能审核，中止退出8BOSSer_POPriceAlert采购价格预警，如果预警提示后用户取消，则需要中止退出9BOSSer_ExecRtnSQL更新单据审核标记10BOSSer_UpdatePOPrice更新采购价值资料序时簿操作后事件1BOSSer_Reloa

32、d重新加载序时簿2.2.2 反审核类别序号Action说明单据操作前事件11BOSSer_ExecRtnSQL获取相关的系统参数信息和单据的信息2BOSSer_Break判断系统是否初始化，如果没有初始化，则中止退出3BOSSer_Break判断单据是否已作废，如果作废，则中止退出4BOSSer_Break判断单据是否未审核，如果未审核，则中止退出5BOSSer_Break判断单据是否已执行，如果已执行，则中止退出6BOSSer_Break判断单据是否已关闭，如果已关闭，则中止退出7BOSSer_Break对于分销订单，如果已确认，则提示不能反审核，中止退出8BOSSer_Break判断是否没

33、有启用“反审核人与审核人为同一人”参数，而且单据反审核和审核不为同一人，则提示中止退出9BOSSer_Break判断是否被其它单据关联10BOSSer_ExecRtnSQL清除审核标记单据操作后事件1BOSSer_ShowMsg提示用户单据反审核成功2BOSSer_Reload重新加载单据序时簿操作前事件1序时簿操作事件1BOSSer_ExecRtnSQL获取相关的系统参数信息和单据的信息2BOSSer_Break判断系统是否初始化，如果没有初始化，则中止退出3BOSSer_Break判断单据是否已作废，如果作废，则中止退出4BOSSer_Break判断单据是否未审核，如果未审核，则中止退出5

34、BOSSer_Break判断单据是否已执行，如果已执行，则中止退出6BOSSer_Break判断单据是否已关闭，如果已关闭，则中止退出7BOSSer_Break对于分销订单，如果已确认，则提示不能反审核，中止退出8BOSSer_Break判断是否没有启用“反审核人与审核人为同一人”参数，而且单据反审核和审核不为同一人，则提示中止退出9BOSSer_Break判断是否被其它单据关联10BOSSer_ExecRtnSQL清除审核标记序时簿操作后事件1BOSSer_Reload重新加载序时簿2.3 作废、反作废2.3.1 作废类别序号Action说明单据操作前事件1BOSSer_ShowMsg提示用

35、户是否确认作废，如果用户取消，则中止后续Action单据操作事件1BOSSer_CheckCancel自定义扩展业务服务函数（可选）账套是否做初始化结束检查，如果不通过则结束后续Action2BOSSer_BreakAction执行条件为单据内码FID等于0，如果条件成立，则终止后续Action，并报出提示，提示用户新建单据未保存，不允许作废3BOSSer_BreakAction执行条件为单据已经作废，如果执行条件成立，则终止后续Action，并报出提示，单据已经作废了4BOSSer_BreakAction执行条件为单据状态大于0，如果执行条件成立，则终止后续Action，并报出提示5MBOS

36、Ser_ExecSQL执行SQL，更新作废状态字段为16MBOSSer_WriteBack自定义扩展业务服务函数（可选）执行本单据的反向反写任务单据操作后事件1BOSSer_ShowMsg提示用户单据作废成功2BOSSer_Reload重新加载单据序时簿操作前事件1BOSSer_ShowMsg提示用户是否确认作废，如果用户取消，则中止后续Action序时簿操作事件1BOSSer_CheckCancel自定义扩展业务服务函数（可选）账套是否做初始化结束检查，如果不通过则结束后续Action2BOSSer_BreakAction执行条件为单据内码FID等于0，如果条件成立，则终止后续Action，

37、并报出提示，提示用户新建单据未保存，不允许作废3BOSSer_BreakAction执行条件为单据已经作废，如果执行条件成立，则终止后续Action，并报出提示，单据已经作废了4BOSSer_BreakAction执行条件为单据状态大于0，如果执行条件成立，则终止后续Action，并报出提示5MBOSSer_ExecSQL执行SQL，更新作废状态字段为16MBOSSer_WriteBack自定义扩展业务服务函数（可选）执行本单据的反向反写任务序时簿操作后事件1BOSSer_Reload重新加载序时簿2.3.2 反作废类别序号Action说明单据操作前事件单据操作事件1VariableDefin

38、e定义一个Action全局变量CtlCommitQty，控制执行数量，数值型2BOSSer_CheckCancel自定义扩展业务服务函数（可选）账套是否做初始化结束检查，如果不通过则结束后续Action3MBOSSer_ExecRtnSQL查询本单据控制执行数量，并写入到Action全局变量CtlCommitQty中4BOSSer_BreakAction执行条件为全局变量CtlCommitQty大于零，如果执行条件成立，则终止后续Action，并报出提示，合同严格控制执行数量，不能反作废5MBOSSer_ExecSQL执行SQL，更新作废状态字段为0，即未作废6MBOSSer_WriteBac

39、k自定义扩展业务服务函数（可选）执行本单据的正向反写任务单据操作后事件1BOSSer_ShowMsg提示用户单据反作废成功2BOSSer_Reload重新加载单据序时簿操作前事件1序时簿操作事件1VariableDefine定义一个Action全局变量CtlCommitQty，控制执行数量，数值型2BOSSer_CheckCancel自定义扩展业务服务函数（可选）账套是否做初始化结束检查，如果不通过则结束后续Action3MBOSSer_ExecRtnSQL查询本单据控制执行数量，并写入到Action全局变量CtlCommitQty中4BOSSer_BreakAction执行条件为全局变量CtlCommitQty大于零，如果执行条件成立，则终止后续Action，并报出提示，合同严格控制执行数量，不能反作废5MBOSSer_ExecSQL执行SQL，更新作废状态字段为0，即未作废6MBOSSer_WriteBack自定义扩展业务服务函数（可选）执行本单据的正向反写任务序时簿操作后事件1BOSSer_Reload重新加载序时簿