【应用场景】

在单据界面上使用单据状态字段展示状态值，当状态切换时，可联动控制单据上的字段或者菜单的锁定性。

单据状态是一种特殊的下拉列表，其下拉值通过状态列表来定义。可以通过状态值来控制单据上的字段或者菜单的锁定性。

【案例演示】

采购订单，新增单据状态字段，设置状态值，通过插件显示单据状态字段的状态值。

【实现步骤】

<1>编写表单插件，代码如下。

using Kingdee.BOS.Core.Bill.PlugIn;
using Kingdee.BOS.Core.DynamicForm.PlugIn.Args;
using Kingdee.BOS.Core.Metadata.FieldElement;
using Kingdee.BOS.Util;
using System.ComponentModel;
using System.Linq;
namespace Jac.XkDemo.BOS.Business.PlugIn
{
    /// <summary>
    /// 【单据插件】单据状态
    /// </summary>
    [Description("【单据插件】单据状态"), HotUpdate]
    public class BillStatusBillPlugIn : AbstractBillPlugIn
    {
        public override void BarItemClick(BarItemClickEventArgs e)
        {
            base.BarItemClick(e);
            if (e.BarItemKey.EqualsIgnoreCase("test1"))
            {
                // 查看单据状态的状态列表
                //var billStatusField = this.View.BillBusinessInfo.GetBillStatusField();
                var billStatusField = (BillStatusField)this.View.BillBusinessInfo.GetField("FDocumentStatus");
                var msg = string.Join("\r\n", billStatusField.StatusItems.Select(o => string.Format("单据状态名称：{0}，单据状态值：{1}", o.StatusName, o.StatusValue)));
                this.View.ShowMessage(msg);
                return;
            }
        }
    }
}

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

<3>BOSIDE扩展采购订单，新增单据状态字段，设置状态列表，注册表单插件，保存元数据，开发完毕。

【功能验证】

<1>登录业务站点，打开采购订单，此时，推送状态已经可以显示预设的状态值。

<2>点击菜单【查看单据状态的状态列表】，如下图。

---------------------------------------------------------------------------------------------------------

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