二开案例.单据插件.获取单据编号

栏目:云星空知识作者:金蝶来源:金蝶云社区发布:2024-09-23浏览:3

二开案例.单据插件.获取单据编号

【应用场景】平台封装的保存操作会给单据自动填充单据编号,平台也提供了接口,支持用户手动获取指定编码规则下的新的单据编号。

【案例演示】采购订单,编辑界面,演示获取单据类型为【标准采购订单】,编码规则为【采购订单标准编码规则】的新的单据编号。

【实现步骤】

<1>编写单据插件,代码如下。

using Kingdee.BOS.Core.Bill.PlugIn;

using Kingdee.BOS.Core.DynamicForm.PlugIn.Args;

using Kingdee.BOS.ServiceHelper;

using Kingdee.BOS.Util;

using System.Collections.Generic;

using System.ComponentModel;

using System.Linq;


namespace Jac.XkDemo.BOS.Business.PlugIn

{

    /// <summary>

    /// 【单据插件】获取单据编号

    /// </summary>

    [Description("【单据插件】获取单据编号"), HotUpdate]

    public class GetBillNoBillPlugIn : AbstractBillPlugIn

    {

        /// <summary>

        /// 主菜单点击事件

        /// </summary>

        /// <param name="e"></param>

        public override void BarItemClick(BarItemClickEventArgs e)

        {

            base.BarItemClick(e);

            var billNoField = this.View.BillBusinessInfo.GetBillNoField();

            if (e.BarItemKey.EqualsIgnoreCase("tbGetBillNo"))

            {

                #region 给指定业务对象的单据编号字段获取新的单据编号


                var options = new Dictionary<string, object>();

                options["CodeTime"] = 1; // 执行时机,0表示新增时获取单据编号,1表示保存时获取单据编号

                options["UpdateMaxNum"] = 1; // 是否更新最大流水号

                this.Model.DataObject[billNoField.PropertyName] = "";

                var billNos = BusinessDataServiceHelper.GetBillNo(this.Context, this.View.BillBusinessInfo, new[] { this.Model.DataObject }, options);

                this.View.UpdateView(billNoField.Key);

                this.View.ShowMessage("获取到新的单据编号为:" + string.Join(",", billNos.Select(o => o.BillNo)));

                return;


                #endregion

            }


            if (e.BarItemKey.EqualsIgnoreCase("tbGetBillNos"))

            {

                #region 给指定业务对象的单据编号字段【批量】获取新的单据编号


                // 一次性获取10个单据编号

                var billNos = BusinessDataServiceHelper.GetListBillNO(this.Context, this.View.BillBusinessInfo.GetForm().Id, 10, "ffa5c9cf40984e9d9ab5574bb257c1a7");

                this.View.ShowMessage("获取到新的单据编号为:" + string.Join(",", billNos));

                return;


                #endregion

            }

        }

    }

}


/*

-- 获取编码规则数据

SELECT a.FRULEID AS 编码规则内码,b.FNAME AS 编码规则名称,a.* FROM T_BAS_BILLCODERULE

LEFT JOIN T_BAS_BILLCODERULE_L b ON a.FRULEID=b.FRULEID AND b.FLOCALEID=2052

WHERE b.FNAME='采购订单标准编码规则'

 */


<2>拷贝插件组件到应用站点的WebSite\Bin目录下,重启IIS。


<3>BOSIDE扩展采购订单,主菜单新增2个菜单项,注册表单插件,保存元数据,开发完毕。


现在可以登录业务站点,打开采购订单,检验一下插件效果啦。

获取一个新的单据编号:

批量获取10个新的单据编号:




【知识点】

<1>编码规则相关表:

-- 编码规则数据

SELECT a.FRULEID AS 编码规则内码,b.FNAME AS 编码规则名称,a.* FROM T_BAS_BILLCODERULE a LEFT JOIN T_BAS_BILLCODERULE_L b ON a.FRULEID=b.FRULEID AND b.FLOCALEID=2052 WHERE b.FNAME='采购订单标准编码规则'

-- 编码规则的规则明细

SELECT * FROM T_BAS_BILLCODERULEENTRY WHERE FRULEID='ffa5c9cf40984e9d9ab5574bb257c1a7'

-- 编码规则的生成模板

SELECT * FROM T_BAS_BILLCODES WHERE FRULEID='ffa5c9cf40984e9d9ab5574bb257c1a7'


<2>编码规则优先级:

单据类型绑定的编码规则>默认编码规则>元数据绑定的编码规则。



<3>支持一个单据多套编码规则,更多获取编号的接口可参考BusinessDataServiceHelper.GetBillNo的多个重载函数。




















【金蝶云星空BOS二次开发案例演示】https://vip.kingdee.com/article/94751030918525696

二开案例.单据插件.获取单据编号

【应用场景】平台封装的保存操作会给单据自动填充单据编号,平台也提供了接口,支持用户手动获取指定编码规则下的新的单据编号。【案例演示...
点击下载文档
确认删除?
回到顶部
客服QQ
  • 客服QQ点击这里给我发消息