1 插件介绍

• 单据状态字段，是特殊的下拉框字段，可以在设计时预先定义几个状态枚举值；运行时，根据关键事件的发生，切换状态值，标注单据状态；

• 单据状态字段，不允许用户手工选择；必须在执行操作、工作流处理到关键步骤时，由系统自动切换；

• 系统预置的单据模板上，已经添加了一个单据状态字段；

• 数据状态，定义了创建(A)、重新审核(D)、审核中(B)、已审核(C)等几个状态；

• 在执行单据保存、提交、审核、反审核操作时，系统自动切换数据状态值；从数据状态字段值，就可以判断出单据进行了那些操作，或者在工作流中走过了哪些关键步骤；

• 一个单据上，可以添加多个单据状态字段，标注出不同维度的单据状态，如禁用状态、关闭状态、冻结状态、业务进展状态等。

如图：

2 控件编程模型

2.1 控件编程模型定义

单据状态字段的控件编程模型BillStatusEdit，派生自下拉框字段控件编程模型ComboEdit：

package kd.bos.form.field;
public class BillStatusEdit extends ComboEdit {

2.2 控件方法清单

BillStatusEdit 重写、新增了如下方法：

3 数据模型

单据状态字段的属性对象BillStatusProp，派生自ComboProp，存储状态枚举值，String类型。

BillStatusProp定义：

package kd.bos.entity.property;
public class BillStatusProp extends ComboProp {

BillStatusProp 重写、新增了如下方法：

4 插件事件

单据状态字段，不支持手工录入，不会触发插件事件。
系统在后台切换状态值时，也不会触发字段值改变事件。