Integrating Web Dynpro Applications into SAP Enterprise Portal. Dr.-Ing. Oliver Stiefbold Product Management, SAP AG

Transcription

1 Integrating Web Dynpro Applications into SAP Enterprise Portal Dr.-Ing. Oliver Stiefbold Product Management, SAP AG

2 Agenda Integrating Web Dynpro into SAP Enterprise Portal: Unified Rendering Portal Themes Work Protect Mode Portal Eventing Navigation OBN Outlook: Web Dynpro Portal Personalization Portal Development Kit and Netweaver Developer Cockpit SAP AG 2002, Title of Presentation, Speaker Name 2

3 Unified Rendering and Branding SAP application controls are unified and use portal design service Web Dynpro in Portal thus offers a unified end user experience Portal Portal Page Web Dynpro 4 Java SAP AG 2002, Title of Presentation, Speaker Name 3

4 Web Dynpro Theme Editor Custom Corporate Branding SAP Design Web Dynpro Theme Editor is available at SDN Service.KEY com.sap.portal.de sign.portaldesign data Custom Design Custom Design SAP AG 2002, Title of Presentation, Speaker Name 4

5 Agenda Integrating Web Dynpro into SAP Enterprise Portal: Unified Rendering Portal Themes Work Protect Mode Portal Eventing Navigation OBN Outlook: Web Dynpro Portal Personalization Portal Development Kit and Netweaver Developer Cockpit SAP AG 2002, Title of Presentation, Speaker Name 5

6 WorkProtect Mode 1 2 Web Dynpro applications can use WorkProtect mode to prevent unsaved data in the Web Dynpro application from being lost if the user navigates to another portal page. SAP AG 2002, Title of Presentation, Speaker Name 6

7 Agenda Integrating Web Dynpro into SAP Enterprise Portal: Unified Rendering Portal Themes Work Protect Mode Portal Eventing Navigation OBN Portal Personalization Summary and Outlook SAP AG 2002, Title of Presentation, Speaker Name 7

8 Web Dynpro and Portal Eventing 1 Sam Wilson HELLO! Sam Wilson 2 Portal eventing can be used to communicate between Web Dynpro and non Web Dynpro portal content SAP AG 2002, Title of Presentation, Speaker Name 8

9 Web Dynpro Portal Eventing Several Web Dynpro applications running on one portal page can communicate using portal eventing. If Web Dynpro Portal eventing is needed, depends on the use case and application design. loosely coupling No predefined user dialog No defined application flow Variing page composition Reuse of iviews strong coupling Defined user dialog Strong linear application flow control Web Dynpro based page composition No reuse of components Let the administrator decide Dont let the admin decide SAP AG 2002, Title of Presentation, Speaker Name 9

10 EPCF Portal Client Framework Enterprise Portal Client Framework provides a JavaScript function for event handling in Pages and iviews: EPCM.subscribeEvent('namespace', 'eventname', eventhandlingfunctionname); 'namespace' - an text string that uniquely identifies your domain. The recommended namespace format is 'urn:eventurn'. 'eventname' - an text string that uniquely identifies your event name. EventName and namespace together define a unique event type identifier. eventhandlingfunctionname - the name of a JavaScript function in your HTML code, without the function signature. The named function will be called upon event receival: function eventhandlingfunctionname( evt ) { dosth; } SAP AG 2002, Title of Presentation, Speaker Name 10

11 EPCF Raise an Event To raise an EPCF event the application calls: EPCM.raiseEvent('namespace', 'eventname', 'eventdata'); The arguments of the function are: 'namespace' - a text string that uniquely identifies your domain. The recommended namespace format is 'urn:eventurn'. 'eventname' - a text string that uniquely identifies your event name. EventName and namespace together define a unique event type identifier. eventdata - a JavaScript object identifier. This object is passed on to the event handling method. 'eventdata' can be a string or any other JavaScript object type. SAP AG 2002, Title of Presentation, Speaker Name 11

12 Web Dynpro Subcribe a Portal Event You can reuse a Web Dynpro action for several portal events. WDPortalEventing.subscribe( urn:myurn.test.portal, TestEvent, wdthis.wdgettesteventaction() ); You may define the following parameters for your Web Dynpro action: Namespace: name space of the received portal event. Name: This parameter contains the name of the received portal event. dataobject: the transported parameter of the portal event. SAP AG 2002, Title of Presentation, Speaker Name 12

13 Web Dynpro Unsubscribe a Portal Event Unsubscribing for a portal event is very similar to subscribing: WDPortalEventing.unsubscribe( urn:myurn.test.portal, TestEvent, wdthis.wdgettesteventaction() ); Note: Be sure that you unsubscribe every single Web Dynpro view, as the subscription and unsubscription is valid only for the current view. SAP AG 2002, Title of Presentation, Speaker Name 13

14 Web Dynpro Raise a Portal Event The following example demonstrates how to raise a portal event: WDPortalEventing.fire ( urn:myurn.test.portal, TestEvent, AParameter ); You can fire a portal event at any place in your Web Dynpro application. The event is transported with the next response to the client. You can also raise more than one portal event in one request-response cycle. Typically, you will fire a portal event in a Web Dynpro action event handler (for example, pressing a button). SAP AG 2002, Title of Presentation, Speaker Name 14

15 Agenda Integrating Web Dynpro into SAP Enterprise Portal: Unified Rendering Portal Themes Work Protect Mode Portal Eventing Navigation OBN Outlook: Web Dynpro Portal Personalization Portal Development Kit and Netweaver Developer Cockpit SAP AG 2002, Title of Presentation, Speaker Name 15

16 Portal Navigation for Web Dynpro ecosystem Main window SAP AG 2002, Title of Presentation, Speaker Name 16

17 Navigation Connector A custom navigation connector may enhance the portal standard navigation connector Portal Content Directory PCD PCD A navigation connector can be merged on top level All functionality is available Navigation and structure can be created dynamically Custom Navigation Connector Example Example available in PDK SAP AG 2002, Title of Presentation, Speaker Name 17

18 EPCM - Navigation Client Functionality Enterprise Portal offers a JavaScript function for Navigation EPCM.doNavigate = function( target, mode, winfeatures, winname, history, targettitle, context, postbody) Target: Mode: Context: Winfeatures: ROLES://dir1/dir2/role1/page1 0/1/2 new /same window, with/wo portal header ROLES://dir1/dir2/role1/page2 Example: "width=400,height=500". Winname: this window has my name History: Postbody: a breadcrumb control to help users find back If you dont like GET SAP AG 2002, Title of Presentation, Speaker Name 18

19 EPCM - Navigation Client Functionality Relative Navigation EPCM.doRelativeNavigate(basenodename, levelsup, pathnameslist, mode, winfeatures, winname, history, addparams, targettitle, context) basenodename = current presented URL levelsup = Number of levels to ascend in the tree pathnameslist = list of all atomic names of children from the point reached by going number of levels up the tree Rendered link EXAMPLE: <A HREF="myLink2" onclick="return EPCM.doRelativeNavigate ('ROLES://portal_content/Roles/MyRole/Level1/Level2/Level3', 1, '{PortalEventing}',0)"> This is a link using dorelativenavigate</a> SAP AG 2002, Title of Presentation, Speaker Name 19

20 Summary and Review of Navigation API The Navigation API allows application to navigate not only in between a known application, but between the complete Portal content. Navigation targets are iviews, Pages, Worksets, Roles Navigation Targets are a Portal Content Directory URL Dynamic Navigation windows offer an additonal dynamic navigation context for application designers Related Targets offer also an additonal navigation context. Object Based Navigation decouples Navigation Link and Navigation Target (next chapter) SAP AG 2002, Title of Presentation, Speaker Name 20

21 Agenda Integrating Web Dynpro into SAP Enterprise Portal: Unified Rendering Portal Themes Work Protect Mode Portal Eventing Navigation Object Based Navigation Outlook: Web Dynpro Portal Personalization Portal Development Kit and Netweaver Developer Cockpit SAP AG 2002, Title of Presentation, Speaker Name 21

22 Object Based Navigation Maintaining Content SAP AG 2002, Title of Presentation, Speaker Name 22

23 Object Based Navigation Maintaining Content The objective of OBN is to determine the Application flow at runtime, based on: Customizing of the Portal User Decisions User Roles SAP AG 2002, Title of Presentation, Speaker Name 23

24 EPCM - Navigation Client Functionality Object Based Navigation JavaScript API EPCM.doObjBasedNavigate = function( systemalias, businessobjname, objvalue, operation ){ } EPCM.raiseEvent('urn:com.sapportals:navigation','ObjBasedNavigate', { systemalias: systemalias, businessobjname: businessobjname, objvalue: objvalue, operation: operation} ); systemalias businessobjname objvalue operation Portal system ID of the navigation target businness object optional pass a parameter optional specific operation of a BO SAP AG 2002, Title of Presentation, Speaker Name 24

25 Use Navigation Java API for OBN // Cast the navigation service object to IClientNavigationGenerator IClientNavigationGenerator navgenerator; navgenerator = (IClientNavigationGenerator) PortalRuntime.getRuntimeResources().getService("com.sap.portal.navigation.service.navigation"); // use navgenerator to generate the link String objectnavigateclientcall = navgenerator.createobjectnavigateclientcall( systemalias,businessobjectid,parameter,opid); //Bind to a link object link.setonclientclick(objectnavigateclientcall); SAP AG 2002, Title of Presentation, Speaker Name 25

26 Agenda Integrating Web Dynpro into SAP Enterprise Portal: Unified Rendering Portal Themes Work Protect Mode Portal Eventing Navigation OBN Outlook: Web Dynpro Portal Personalization Portal Development Kit and Netweaver Developer Cockpit SAP AG 2002, Title of Presentation, Speaker Name 26

27 Easy Integration of Web Dynpro Applications Netweaver 04 - No automatic Integration of Web Dynpro Applications (see Wizard) No tight integration into Portal personalization SAP AG 2002, Title of Presentation, Speaker Name 27

28 WD Portal Personalization with next Pagebuilder <component-profile> <property name="systemalias" value="pdkdummysystem"> <property name="personalization" value="dialog"/> <property name="inheritance" value="non-final"/> </property> <property name="businessobjectid" value="pdkdummyobjectid"> <property name="personalization" value="dialog"/> <property name="inheritance" value="non-final"/> </property> </component-profile> SAP AG 2002, Title of Presentation, Speaker Name 28

29 Agenda Integrating Web Dynpro into SAP Enterprise Portal: Unified Rendering Portal Themes Work Protect Mode Portal Eventing Navigation OBN Outlook: Web Dynpro Portal Personalization Portal Development Kit and Netweaver Developer Cockpit SAP AG 2002, Title of Presentation, Speaker Name 29

30 Download PDK and Sneak Preview on SDN SAP AG 2002, Title of Presentation, Speaker Name 30

31 What is Portal Development Kit? What it is: a collection of Netweaver Developer samples for released Netweaver Java APIs a set of additional tools to ease developers life supports the SAP Java Developer Community with the Netweaver 04 Sneak Preview Edition And it will be: a business package with ready to run Netweaver Developer and Business Administrator scenarios SAP AG 2002, Title of Presentation, Speaker Name 31

32 Portal Development Kit 6.0.x - Example Portal Development SAP AG 2002, Title of Presentation, Speaker Name 32

33 Get Support on SDN for Web Dynpro Integration page=webdynpro_ep_integration.htm SAP AG 2002, Title of Presentation, Speaker Name 33

34 Questions? Q&A SAP AG 2002, Title of Presentation, Speaker Name 34