SAP_NetWeaver_BPM技术文档

BPM与WEB Dynpro总结郑永文2007-4-18目录目录 (2)1基本步骤 (4)1.1创建BPM (4)1.2创建WEB UI (4)1.3建立PROCESS与WEB UI的关系 (4)1.3.1指定关联 (4)1.3.2指定TASK的interface (5)1.3.3指定process中的各activity的数据mapping,即在各个activity中可流转的数据 (6)1.4D EPLOY PROCESS (6)1.5访问 (6)2技术架构 (7)3结构 (7)3.1V IEW的LAYOUT (11)3.2C OMPOSITE UI E LEMENT (15)3.3字段属性 (17)4MESSAGE (17)5动态设置V ALUE-HELP (19)6动态编程，即动态设置CONTEXT (20)7外部MODEL数据 (27)8JA312: ADV ANCED WEBDYNPRO FOR JA V A (28)8.1设置弹出式窗口 (29)8.1.1OVS (31)8.2消息处理 (32)8.3高级CONTEXT (32)8.4动态UI (33)8.5M ODEL INTERFACE (33)8.6S TRUCTING APPLICATION (33)8.6.1dependencity (33)8.6.2structing (40)8.7附录 (42)9实用东西 (44)9.1查看日志 (44)9.2ABAP层次的WEB SERVICE (45)9.3T ASK层次的某些属性可在H UMAN ACTIVITY中覆盖 (45)9.4P ROCESS的WEB SERVICE (45)9.5调用WEB SERVICE (45)9.5.1WSDL 文档结构 (46)9.5.2WSDL 端口 (47)9.5.3WSDL 消息 (47)9.5.4WSDL types (47)9.5.5WSDL Bindings (47)9.5.6总结 (47)10实用类、接口 (49)10.1C LASS WDV ALUE S ERVICES (49)11连接外部数据库 (49)12账号权限 (51)12.1P ORTAL上UWL的权限 (51)12.2管理员权限 (51)13常用URL (51)13.1流程管理 (51)HTTP://192.168.0.233:50000/P ROCESS M ANAGEMENT/INDEX.JSP (51)13.2流程监控 (52)14问题 (52)15总结 (52)1基本步骤1.1 创建BPM在NWDS中，创建一个BPM流程实例。

在此步骤中，只设置流程图（在pool中，创建多个lane，在每个lane中设置流程活动，如activity、event、gatway等），在流程图中的每个human activity中，需要用到task,在该task中，指向web dynpro for java开发的WEB UI。

在activity中，可指定该步骤的用户，但此处指定的用户可被该process种的task的role取代。

1.2 创建WEB UI在该步骤中，创建process中人机交互的页面，此部主要就是web dynpro for java的开发，创建好后，需要每个compontent add to public part中，以便在process中可用1.3 建立process与web ui的关系此步在development infrastructure中完成，即将上述两步创建的process 与web ui关联起来，以便在process的task中可指定web ui的interface（即要用到第二步中add to public part的组件）、在process的owner中指定该步的执行者及流程中多个activity的数据mapping （包括input mapping 、output mapping等）1.3.1指定关联1.3.2指定TASK的interface在task的编辑器中，可指定task对应的UI interface，此处interface即需要用到1.2中add to public part中的compontent.在此处指定compontent后，即可在process的数据类型中可找到该compontent种定义的contezt中的数据，如下图所示：注意：在此处指定task的UI interface时，必须在WEB UI的Component的Interface controller中指定一个Complete event,否则无法指定。

同理，在interface controller中也要指定context,否则无法在process中mapping1.3.3指定process中的各activity的数据mapping,即在各个activity中可流转的数据此步完成后，即可●在process中加入数据对象●可在process的activity中作数据mapping操作(否则,在input mapping中无的TaskInput中无UIRequest,在output mapping的TaskOutput中无UIResponse)如此，即可在context与activity中的input/output做数据mapping。

在portal上的UWL中，将可以显示任务列表，此处的任务列表显示的内容可以定制并可用参数，在TASK的user text中定义，如下图所示：此处的参数也从绑定的userinterface（compontent）中而来，若不绑定，则无可选的context 数据(在UIRequest或UIResponse节点中)。

即context(从绑定的compontent中取到)数据与activity的taskInput中的UIRequest绑定；与taskOutput中的UIResponse绑定。

通过这种方式来实现UI与process的数据绑定及流转。

1.4 Deploy process1.5 访问http://192.168.0.233:50000/index.html的san链接中，通过Configuration Management--→processes and tasks----→process reposity来启动在1.4中deploy的流程2技术架构DC关系：3结构对于每个VIEW，分别对应有两个interface,假设view的名称为MMM，则接口名分别为IPrivateMMMView和IPublicMMMView,前者用于VIEW的对内数据操作，后者用于对外的数据交换，在VIEW中定义的ACTION在前者中定义，在private的view中，1.context中所选的每个node都对应有两个静态内部类，分别为I{NodeNmae}Node、I{NodeName}Element,在这两个内部类中分别定义node的操作、属性等东西。

通过提供的这些方法来操作VIEW中的数据，如查找按钮等。

2.view中定义的method、action也在此接口中定义3.每个view均实现java.io.Serializable类，有个IPrivateMMMView类型的变量wdThis, public PurchaseRequestView(IPrivatePurchaseRequestView wdThis){this.wdThis = wdThis;this.wdContext = wdThis.wdGetContext();this.wdControllerAPI = wdThis.wdGetAPI();this.wdComponentAPI = wdThis.wdGetAPI().getComponent();}对于每个web dynpro for java的组件，均有controller、view、window，其中controller对应有接口IPublic{组件名}、IPrivate{组件名}的接口，其中IPrivate extends IPublic,在IPublic中，有两个内部类，分别为IContextNode继承自DataNode 表示节点，IContextElement继承自DataNodeElement表示元素，在对应的Controller 的JAVA文件中，有一个私有成员wdThis变量类型为IPrivate的，故通过这个变量即可实现对Context的访问. 其中wdContext变量类型为上述IPublic中的内部类IcontextNode,通过该变量实现对Context的访问；此外，另两个变量wdComponentAPI/wdControllerAPI的类型均未IWDCompontent,通过这两个变量可实现对message、尽量不要使用Custom Controller,只有在优化、简单化开发时才考虑使用wdDoPostProcessing()在复杂的应用中，用于校验来自多个组件的数据wdDoBeforeNavigation在不同的congtroller中共享数据External-mapping在设置internal mapping时，需要将cardinality设为1..n，否则在界面上不能输入。

若view 的context为从control映射过来，则需在controller的context中设置cardinality，在view中不能设置。

目前还不支持structure字段context属性的更名。

注意在VIEW中的BUTTON中，不要直接在VIEW中写代码更改屏幕中元素的值，而是应该在controller中更改值，方法是在controll中定义method,然后在view的layout的outline 中，选中button，右键在出来的菜单中选择apply templete，在此定义action并在后续步骤中选择controll中定义的方法。

当然也可在view中action中写代码，但这种方法应该是违反了mvc的原理，即在view中直接更改了元素的值，理论上view应该只用于显示数据，而不应该操作数据。

即在controll中定义方法，然后在view中通过wdThis.wdGet{StartComp}Controller()去调用controll中的数据，如下例所示：其中{}中即为Compontent的名称。

public voidonActionInitialValue(com.sap.tc.webdynpro.progmodel.api.IWDCustomEven t wdEvent ){//$$begin Action Button(-750211490)wdThis.wdGetStartCompController().initPersonInfo();//$$end}3.1 View的layout3.2 Composite UI Element3.3 字段属性在controller 的context 中，可将字段属性的calculated 属性设为true ，则该在controller 中可在该字段的set/getter 方法中写代码操作该字段的值，在该代码中修改该字段的值后，在mapping 过的view 中可直接显示该字段的值4 Message3种类型：Standard, Warning, Error在IMessage{Nc}中作为常量存在，如component 为 StartComp,则该类名为 IMessageStartComp. 访问方式：IWDTextAccessor txtAccessor = wdComponentApi.getTextAccessor(); String msg = txtAccessor.getText(“{MessageKey}”);IWDMessageManager msgMgr = wdComponentAPI.getMessageManager();将Message与UI元素关联：抛出错误信息：wdComponentAPI.getMessageManager().raisePendingException();在NWDS中在deploy时，经常会提示服务不可用，但经查系统，发现服务端无任何问题，此时，在NWDS中将SAP AS JA V A中的服务重配即可。