二开案例.单据插件.提交状态下设置字段可用
【应用场景】单据提交后,界面所有的字段都将被锁定进入不可编辑状态,如何将某个字段放开锁定性,使之可以被再次修改呢?
【注意】此操作乃非常规操作,原则上单据进入审核流程后数据不可再显示修改,使用时注意评估业务数据合法性风险。
【案例演示】打开单据状态为【审核中】的采购订单,变更原因字段默认是锁定状态,通过表单插件,将变更原因字段设置为可用。
【实现步骤】
<1>编写单据插件,代码如下。
using Kingdee.BOS.Core.Bill.PlugIn;
using Kingdee.BOS.Core.DynamicForm.PlugIn.Args;
using Kingdee.BOS.Util;
using System.ComponentModel;
namespace Jac.XkDemo.BOS.Business.PlugIn
{
/// <summary>
/// 【单据插件】提交状态下设置字段可用
/// </summary>
[Description("【单据插件】提交状态下设置字段可用"), HotUpdate]
public class SubmitStatusSetFieldEnableBillPlugIn : AbstractBillPlugIn
{
/// <summary>
/// 主菜单点击事件
/// </summary>
/// <param name="e"></param>
public override void BarItemClick(BarItemClickEventArgs e)
{
base.BarItemClick(e);
if (e.BarItemKey.EqualsIgnoreCase("tbSetFieldEnable"))
{
// 设置变更原因字段可见
this.View.StyleManager.SetEnabled("FChangeReason", "BillStatusByHead", true);
this.View.StyleManager.SetEnabled("FChangeReason", "", true);
this.View.ShowMessage("变更原因字段已被设置为可用!");
}
}
}
}
<2>拷贝插件组件到应用站点的WebSite\Bin目录下,重启IIS。
<3>BOSIDE扩展采购订单,菜单集合添加新菜单,注册表单插件,保存元数据,开发完毕。
现在可以登录业务站点,打开采购订单编辑界面,检验一下插件效果啦。
【知识点】
字段可用性支持策略模式,只有在所有策略下都可见,该字段才可见,任意策略下不可见,则该字段就不可见(不可见性属于一票否决式)。
单据在单据状态为【审核中】时,字段可用性存在两种策略模式,因此,仅设置View.StyleManager.SetEnabled("FChangeReason", "", true)或View.GetControl("FChangeReason").Enabled = true是无法解锁该字段的。
那么,怎么知道当前字段使用了哪些控制策略呢?通过VS附加进程,启动插件调试,监视下StyleManager内部即可获取。
【金蝶云星空BOS二次开发案例演示】https://vip.kingdee.com/article/94751030918525696
二开案例.单据插件.提交状态下设置字段可用
本文2024-09-23 04:21:09发表“云星空知识”栏目。
本文链接:https://wenku.my7c.com/article/kingdee-k3cloud-164750.html