OracleAS Portal Integration Solutions
Oracle Application Server Provider for SAP iViews - Installation Instructions

Contents

Introduction

The Oracle Application Server Provider for SAP iViews provides the OracleAS Portal user with Single Sign-On access to the SAP Enterprise Portal.  The OracleAS Provider for SAP iViews maintains SAP Portal user security and personalization on the SAP iViews. SAP iViews are the portal components in SAP Enterprise Portal, which deliver business content to the SAP Portal.

For recent updates to these installation instructions and other OracleAS Portal documentation, please refer to the Oracle Technology Network (OTN) Portal Center.  You can find valuable information related to the OracleAS Provider for SAP iViews in the 'Portal - Portal Development Kit' Discussion Forum on OTN.

Please see the Release Notes for further information on which all browsers and JPDK versions the OracleAS Provider for SAP iViews has been tested against.

"NOTE: The OracleAS Provider for SAP iViews is a sample released for test, evaluation, and education purposes. It is not supported through formal Oracle Support mechanisms. We are, however, very interested in receiving your feedback.  Please post any suggestions, questions, or issues to the 'Portal - Portal Development Kit' Discussion Forum on OTN.  We will respond as quickly as possible."

User Interface

Show Mode

Edit Mode

• Enter the PCD location or click the List Icon to select the iView from the Component Tree.
• Click Apply. After clicking Apply the iView title, width, and height from SAP Portal are displayed. You can modify these values to effect how the portlet is displayed in Show Mode.
  
• Provide any parameter values for a parameterized iView

Component Tree Mode

• Click on the relevant iView to populate the PCD Location field.
• Once the tree data is retrieved from the SAP Portal, it will be saved to cache for 30 minutes. User can manually refresh the cached data by clicking the Refresh Tree Data button on the List of IViews window..
  

SAP iViews Provider Installation

• Deploying the SAP IViews Provider

          Testing the Deployment

The OracleAS Provider for SAP iViews is now deployed. To test the deployment, access the provider's test page at the following URL:

http://your_server.com:port/iview/providers

This page displays the SAP iView Portlet Builder and the deployed JPDK version. If you are unable to get the provider's test page successfully, refer to Frequently Asked Questions on SAP iView Portlet for troubleshooting.

• Deploying the Oracle IView Agent on SAP Portal

• Login to SAP Portal as Administrator : http://host:port/irj/portal
• Go to System Administration > Support.
• On the left frame, under Top Level Areas click on Portal Runtime.
• Under Portal Anywhere Admin Tools click on Administration Console.
• From the Archive Uploader section, browse for PAR file and upload.
  
• Access the URL http://host:port/irj/servlet/prt/portal/prtroot/IViewAgent.IViewDetail. You should be able to see the welcome message.

• Deploying the Tree Components

• Copy the tree folder to $ORACLE_MIDTIER_HOME/portal.
  
• Edit the $ORACLE_MIDTIER_HOME/portal/conf/portal.conf file.
  
• Add Alias /tree/ "$ORACLE_MIDTIER_HOME/portal/tree/" within the following tag:
  
<IfModule mod_alias.c>
...
</IfModule>

• Add following Directory tag below the other Directory tags:
<Directory "$ORACLE_MIDTIER_HOME/portal/tree/">
    AllowOverride None
    Order allow,deny
    Allow from all
    ExpiresActive on
    ExpiresDefault A2592000
    <Files *>
        Header set Surrogate-Control 'max-age=2592000'
    </Files>
</Directory>

• Save the file and restart the Midtier.
  

Publishing the OracleAS Provider for SAP iView

Creating the External Application

• Log on to OracleAS Portal as a OracleAS Portal Administrator. 
  
• Go to the Administer tab of the OracleAS Portal Builder.
  
• In the SSO Server Administration portlet, click Administer External Applications.
• Click on Add External Application. 
  
• In the External Application Login and Authentication Method sections, enter the following:
• Application Name: SAPExternalApp
• Login URL: http://your_server:port/irj/portal
  
• User Name/ID Field Name: j_user
• Password Field Name: j_password
• Type of Authentication Used: Select POST
  
• In the Additional Fields section, enter the following: 

Field Name	Field Value	Display to User
j_authscheme	default	(unchecked)
uidPasswordLogon	Log on	(unchecked)
login_do_redirect	1	(unchecked)
login_submit	on	(unchecked)
no_cert_storing	on	(unchecked)

• Click OK. 
  
• Now click on the External Application link created with the name 'SAPExternalApp' and enter valid SAP Enterprise Portal user account credentials.
  
• The Remember My Login Information... checkbox must be checked.
• After logging on, you should see the SAP Enterprise Portal page with all the Worksets the user has access to.
  

Configure provider.xml

1. Open the provider.xml deployed on the Portal Mid-tier

2. Search for the tag iViewServerURL and change its value to SAP Enterprise Portal URL. The URL should point to the iView Runtime for Java (IRJ)

Registering the OracleAS Provider for SAP iViews

After deploying the OracleAS Provider for SAP iVIews, you must register the provider with OracleAS Portal before adding the iView Portlet Builder to the page.

1. Login to OracleAS Portal using an account that has build privileges.
2. If your home page is not the Build/Administer page, click on the Builder link in the top right corner of the screen.
3. Click on the Build tab if that is not the active tab.
4. Under the Build tab (on OracleAS Portal Home Page), click on Register Portlet Provider within the portlet called Providers.
5. Fill out provider information for the OracleAS Provider for SAP iViews.
• Name: iViewProvider
• Display Name: SAP iView Provider
• Timeout: 100
• Timeout Message: SAP iView Provider Timed Out
• Implementation Style: Web
6. Click on the Next button to enter the Web Provider specific information
7. Enter the Web Provider location URL:
http://your_oc4j_hostname:port/iview/providers

8. Select the checkbox 'Web provider is same cookie domain as the portal' option.
   
9. Select the radio button labeled The user's identity needs to be mapped to a different name....
10. In the External Application ID field, select the ID corresponding to the SAPExternalApp external application you created in the previous section.
11. Scroll down to the User/Session Information section and specify the login frequency
12. Select  the Login Frequency as:  Once Per User Session
13. Click on the Finish button to complete the registration.

Note: When registering a new provider with OracleAS Portal, only the user who registered the provider has privileges to see the provider/portlets.  If necessary, go to the Folder with the name of the provider within the Portlet Repository content area and update the provider privileges as required.

Adding the IView Provider Portlet to the OracleAS Portal Page

You are now ready to add the IView Provider Portlet to OracleAS Portal page. For more information on adding portlets to your page, please refer to Oracle Application Server Portal User's Guide, section 16.1 Adding a Portlet to a Page.

Note: After adding the iView Portlet on OracleAS Portal page,  you may be prompted to update the login information for the External Application before viewing the portlet. Click on the Update Login Information link and enter your SAP Portal user credentials. 

Trademarks

Oracle and the Oracle logo are trademarks or registered trademarks of Oracle Corporation in the United States and other countries.

All other names are trademarks and/or registered trademarks of their respective owners.