Configure Integrator for SAP navigation

Before use the SAP navigation, we need to perform the configuration.

The SAP navigation integration uses a set of configuration parameters, but configure these parameters separately:

Configure the SAP navigation page: By default, the HCL WebSphere Portal installation names the SAP integration page SAP and places it as a subpage of...

Applications | HCL WebSphere Portal Integrator for SAP

To change the title of the SAP navigation page or move the page to another location in the HCL WebSphere Portal, use the standard tools of HCL WebSphere Portal. For example, use Manage Pages in the HCL WebSphere Portal administration.

All required page properties for configuring the SAP navigation page are stored in the page properties of the SAP navigation page. Check and verify these settings and change them as appropriate for our environment, if required.

To perform this task:

1. Click...
   Portal User Interface | Manage Pages | Content root | Applications | HCL WebSphere Portal Integrator for SAP

2. Click Edit page properties for the page named SAP, or however we might have renamed it.

3. Select...
   Advanced options | I want to set parameters

4. Change the page properties as required.

   If the values for the page properties remain within a length limit of 255 characters, we can set them directly in the page properties as described here.
   If the values for any of the properties exceed 255 characters, set that property in the WP Configuration Service, reference it in the page properties, and prefix its value in the page properties with...

   ConfigService:

   For example, the most likely parameter to have a value that exceeds 255 characters is...

   sap.SSOTokenUrl

   In this case we configure the following settings:

   • In the WP Configuration Service:
     actual.SSO.tokenUrl = "your_URL"

   • In the page properties:
     sap.SSOTokenUrl = "ConfigService:actual.SSO.tokenUrl"

   For the parameter sap.SSOTokenUrl, we can specify a page URL of the SAP portal of the choice, except the sap.BaseUri.

5. Restrict the access to the SAP navigation page to the correct audience, for example to all or selected SAP users.

   To perform this task, use the HCL WebSphere Portal Access Control.

6. Optional: Like portal pages, we can configure the navigational integration label to use a theme template. Within the navigational integration, integrated SAP NetWeaver portal pages inherit that configuration from the label.

   To perform this configuration, add the page parameter...

   com.ibm.portal.theme.template.file.name.htm

   ...to the label using the xmlaccess configuration interface. After installing Integrator for SAP, all integration pages are already configured to use a side navigation theme template. We can remove the side navigation by removing the parameter for the side navigation theme template from the label.

What to do next

After completing the configuration, restart the HCL WebSphere Portal server for the changes to take effect.

For more information about how to configure Integrator for SAP see these topics:

• Configure Basic Authentication for SSO for the SAP navigation integration
• Configure Tivoli Federated Identity Manager with SAML for single sign-on to SAP NetWeaver Portal
• Configure logout handling
• Complete the configuration
• Page properties for configuring the SAP navigation integration

Parent Integrate with SAP NetWeaver Portal

Related concepts:
Configure authentication filters
Set service configuration properties
Performance tuning for Integrator for SAP
Page properties for configuring the SAP navigation integration
Configuration Service