Configuring Integrator for SAP
Before you can use the SAP navigation and the SAP integrator portlet, you need to perform the configuration.
About this task
The SAP navigation integration and the SAP integrator portlet use the same set of configuration parameters, but you must configure these parameters separately. You set the parameters for each of the two in different locations:
Procedure
- Configuring the SAP navigation page: By default,
the WebSphere® Portal installation
names the SAP integration page SAP and places
it as a subpage of Applications > IBM® WebSphere Portal Integrator for SAP.
If you want to change the title of the SAP navigation page or move the page to another location in your WebSphere Portal, use the standard tools of WebSphere Portal. For example, you can use Manage Pages in the WebSphere Portal administration.
All required page properties for configuring the SAP navigation page are stored in the page properties of the SAP navigation page. For a list of configuration parameters see the topic about Configuration parameters for the SAP navigation integration. You must check and verify these settings and change them as appropriate for your environment, if required. To perform this task, proceed as follows:
- Click Administration > Manage Pages.
- Select the page SAP, or however you might have renamed it.
- Select Edit Page properties > Advanced options > I want to set parameters.
- Change the page properties as required. For
a list of configuration parameters see the topic about Configuration
parameters for the SAP navigation integration.
If your values for the page properties remain within a length limit of 255 characters, you can set them directly in the page properties as described here.
If the values for any of the properties exceed 255 characters, you must 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 you configure the following settings:- In the WP Configuration Service: actual.SSO.tokenUrl = "your_URL"
- In the page properties: sap.SSOTokenUrl = "ConfigService:actual.SSO.tokenUrl"
- 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 WebSphere Portal Access Control.
- Optional: Like portal pages, you 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 by using the XMLAccess configuration interface. After you install Integrator for SAP, all integration pages are already configured to use a side navigation theme template. You can remove the side navigation by removing the parameter for the side navigation theme template from the label.
- Configuring the integrator portlet for Integrator for SAP: The WebSphere Portal installation names
the portlet IBM WebSphere Portal Integrator for SAP and
places it on a page named iView. Users get
to that page by clicking Applications > IBM WebSphere Portal Integrator for SAP > iView. To configure the SAP integrator portlet, set the parameters
in the Edit Shared Settings mode of the portlet. For a list of configuration
parameters see Configuration parameters for the SAP integrator
portlet. You can use multiple instances of the portlet to point
to different pieces of content. Place these portlet instances on the
same page or on different pages, and use the Edit Shared
Settings mode to configure each portlet instance. Instead,
you can also set shared parameters for the portlet instances in the
WP Configuration Service. For more details about how to perform this
task see Configuring properties in the WP Configuration Service.Note: You can clear the complete configuration with the Clear Parameters button in the Edit Shared Settings mode. You cannot clear individual entry fields.
What to do next
After you have completed the configuration, restart your WebSphere Portal server for your changes to take effect.
For more information about how to configure Integrator for SAP see these topics: