当我们在使用RDP报表时,AX会根据Data Contract,自动生成报表参数对话框上的字段控件。一般情况下,该对话框能够满足我们的需求,但是如果有较为复杂或特殊的需求,就要我们对该对话框进行客制化。
Reinhard这里就有一张报表,需要使用员工编号作为参数。但是AX系统中默认的员工编号EDT,没有提供lookup方法。Reinhard将该员工编号EDT放在报表参数窗体上后,只能手工录入员工编号,不能通过下拉框进行选择。
默认效果是这样:
但是 Reinhard想要的效果是这样:
Reinhard经过不断地研究,发现AX提供了一种可以客制化报表参数对话框字段控件的技术——SysOperation Framework。如果你也和 Reinhard一样,想要改变自动生成的对话框上的字段,就可以使用该框架。
SysOperation Framework提供了一个SysOperationAutomaticUIBuilder类,通过继承该类,可以在系统基于我们服务操作的数据契约来生成对话框的过程中,添加自己的逻辑。一般包括以下业务逻辑:
- 设置字段控件的属性,如强制和启用
- 覆盖字段控件的方法,如lookup()和modifiedField()
- 覆盖addDialogField()方法,阻止控件被添加
如果你有大量的控件要使用UI Builder添加到对话框中,取而代之,可以考虑在控制器中使用模板窗体。
如果你在UI Builder中有大量的验证代码,取而代之,可以考虑在数据契约中实现验证。这样做,是为了遵循MVC哲学。
先来看看Reinhard的DataContract:
[DataContractAttribute] public class [email protected]_DataContract { HcmPersonnelNumberId hcmPersonnelNumberId; } [DataMemberAttribute(‘HcmPersonnelNumberId‘)] public HcmPersonnelNumberId parmHcmPersonnelNumberId(HcmPersonnelNumberId _hcmPersonnelNumberId=hcmPersonnelNumberId) { hcmPersonnelNumberId=_hcmPersonnelNumberId; return HcmPersonnelNumberId; }
Reinhard的DataContract中,只有一个属性——员工编号。想在报表参数对话框中,为该字段控件添加lookup方法。下面创建UI Builder类:
class [email protected]_UIBuilder extends SysOperationAutomaticUIBuilder { DialogField hcmPersonnelNumberIdField; } public void hcmPersonnelNumberIdLookUp(FormStringControl _control) { HcmWorkerLookup lookup=HcmWorkerLookup::newWorkersInCurrentCompany(); lookup.lookupWorker(_control); } public void build() { super(); hcmPersonnelNumberIdField=this.bindInfo().getDialogField( this.dataContractObject(), methodStr(HPRN_1416_DC,parmHcmPersonnelNumberId) ); } public void postRun() { super(); hcmPersonnelNumberIdField.registerOverrideMethod( methodStr(FormStringControl,lookup), methodStr(HPRN_1416_UIBuilder,hcmPersonnelNumberIdLookUp), this); }
可以看到,Reinhard的UI Builder中的第一个方法,是用于覆盖员工编号字段控件的lookup()方法。
第二个方法,获取到员工编号字段控件。
第三个方法,将我们的第一个方法,注册到字段控件的lookup()方法上。
最后,Reinhard修改Data Contract的声明:
[DataContractAttribute, SysOperationContractProcessingAttribute( classStr([email protected]_UIBuilder))] public class [email protected]_DataContract { HcmPersonnelNumberId hcmPersonnelNumberId; }
其他部分依然遵循RDP报表的开发方式,不变。至此,打开报表参数对话框上的员工编号字段控件,已经有了下拉效果。