Getting Started: OBN Examples 

Use

This section describes the steps required to run the object-based navigation code samples provided with the PDK.

There is the com.sap.portal.unification.OBNExamples PAR file available in the Portal Platform. This PAR file contains examples that illustrate different uses of OBN and the steps for implementing them.

Prerequisites

A running portal.

Procedure

In order to make the examples work, perform the following steps that follow.

...

       1.      Deploy the com.sap.portal.unification.OBNExamples PAR file. The PAR file comes as a part of OBN PDK.

       2.      Create a system and its alias.

                            a.      Create a JDBC Connector System on top of an SQL Server pubs database.

                            b.      Define an alias for the system.

For our purposes, the alias name must be OBNTestSysAlias.

                            c.      Make sure there is user mapping for this alias.

       3.      In the portal, open the Business Object Importer and import the authors, titles, and titleauthor business objects form the OBNTestSysAlias.

       4.      Create an OBNExamples folder in the portal content tree.

You can use any name for the folder instead of OBNExamples mentioned above.

This folder will hold iViews imported from the com.sap.portal.unification.OBNExamples PAR file.

       5.      Import all the iViews from the PAR file into the folder.

The iViews are:

¡        WelcomeOp_iView

¡        ParamPassOp_iView

¡        ParamScriptOp_iView

¡        DfltOpAuthors_iView

¡        RelationOpAuthors_iView

¡        ParamDisplay_iView

¡        Titles_iView

       6.      Assign your user to eu_role (relevant for Sample 1 only).

       7.      Create the roles OBNExamSrcRole and OBNExamplRole, and assign the roles to your user.

       8.      Create an OBNSrcIViews workset for OBNExamSrcRole.

This workset will contain iViews from which to activate OBN for all the examples available in the com.sap.portal.unification.OBNExamples PAR file.

       9.      Add all the iViews listed below from the OBNExamIViews folder to the workset. Add them as Delta Links:

¡        WelcomeOp_IView

¡        ParamPassOp_iView

¡        ParamScriptOp_iView

¡        DfltOpAuthors_iView

¡        RelationOpAuthors_iView

   10.      Create the workset OBNImplViews workset for OBNExamplRole.

Place all operation-implementing iViews supplied by the com.sap.portal.unification.OBNExamples PAR file in this workset.

¡        ParamDisplay_iView

¡        Titles_iView

Set the Entry Point property of both the worksets to ‘Yes’ in order to permit seeing it at runtime.

   11.      Create operations and attach the implementing iViews to them as determined by the examples included in the PAR.

Create an operation under the authors business object of OBNTestSysAlias for each example available in the OBNExamples PARfile.

It is important to place the operation in the right place in the portal Content Catalog, and to keep their names as they appear the examples included in the PAR.