1 事件介绍

该事件通知插件字段发生了改变，可以同步调整其他字段值。

2 事件触发时机

修改字段值之后触发。

说明：

• 界面数据初始时，不触发此事件，即在afterCreateNewData事件中，修改字段值，不会触发此事件；

• 此事件在实体服务规则执行之后发生：用户手工录入字段值时，先执行与此字段相关的实体服务规则，然后再触发插件propertChanged事件。

3 代码模板

package kd.bos.plugin.sample.dynamicform.pcform.field.template;
 
import kd.bos.dataentity.utils.StringUtils;
import kd.bos.entity.datamodel.events.PropertyChangedArgs;
import kd.bos.form.plugin.AbstractFormPlugin;
 
public class PropertyChanged extends AbstractFormPlugin {
 
       private final static String KEY_TEXTFIELD1 = "textfield1";
 
       @Override
       public void propertyChanged(PropertyChangedArgs e) {
              String fieldKey = e.getProperty().getName();
              if (StringUtils.equals(KEY_TEXTFIELD1, fieldKey)){
                     // TODO 在此添加业务逻辑
              }
       }
}

说明：常量KEY_TEXTFIELD1是示例字段标识。

4 参数说明

public class PropertyChangedArgs
    public IDataEntityProperty getProperty()：值发生了改变的字段属性对象；
        public ChangeData[] getChangeSet()：正在发生改变的数据
        public class ChangeData  extends RowDataEntity
       public int getRowIndex()：分录行号；如果字段在单据头，此属性为0；如果字段在单据体，此属性为单据体数据行索引，从0开始；
      public Object getOldValue()：字段旧值；
      public Object getNewValue()：字段新值；
      public DynamicObject getDataEntity()：分录数据包；如果字段在单据头，此属性为表单数据包；如果字段在单据体，此属性为单据体数据行；