Configure the size of the SAP integrator portlet

By default, the IBM WebSphere Portal Integrator for SAP portlet is sized automatically. By alternative, we can control the size of the portlet using CSS styles.

The integrator portlet displays an HTML iframe element in its view mode. Configure the integrator portlet to either resize the iframe automatically , or we can provide CSS styles to control its size. The automatic resize function displays the iframe with 100 percent width of the portlet view container. The portal calculates its height dynamically based on the current height of the browser window. To determine the best size for the SAP NetWeaver Portal views, we can override the automatic resizing. To do this, set the following preference:

integrationDivStyle = "css_style_properties"

Use this preference to define CSS styles that control the size and behavior of the <div> element in which the iframe is embedded. This preference provides flexible control of the size of the iframe. The integrator feature writes the value specified by this preference to the markup as follows: <div style="css_style_properties">.

For example, these values yield these results:

height:500px;width:800px;

Sets the iframe to a static size of 800 by 500 pixels.

height:100%;width:800px;

Sets the height to 100% of the portlets view area and the width to 800 pixels.

height:500px;width:800px;overflow:scroll;

Sets the iframe to a static size of 800 by 500 pixels and defines the overflow property as scroll. If the iframe content is larger than the portlet container, scroll bars are displayed.

For more information about CSS dimension and positioning properties, see the CSS reference about Dimension Properties and Positioning Properties.

We can set the preference values using the WebSphere Portal XML configuration interface.

1. Select Administration > Portal user interface > Manage Pages.

2. Locate the page that holds the integrator portlet.

3. To export the page, click the Export icon for that page and follow the instructions.

4. Edit the exported file.

5. Locate the preference that is embedded in the exported output file. Example:

   ...
   <portletinstance action="update" ...>
        ...
        <preferences name="integrationDivStyle" update="set">
             <value><![CDATA[height:600px; width:400px;]]></value>
        </preferences>
        ...
   </portletinstance>
   

6. Create or modify the preference value in the CDATA section as required.

7. Import the file into the portal.

   1. Select Administration > Import XML.

   2. Provide the file location.

   3. Click Import.
   For more information about the portal xmlaccess.sh and how to use it, see the topics about xmlaccess.sh, especially Work with xmlaccess.sh.

Parent: Configure Integrator for SAP
Related:
Configure Tivoli Federated Identity Manager with SAML for single sign-on to SAP NetWeaver Portal
Related:
Work with xmlaccess.sh

CSS Reference Dimension Properties

CSS Reference Positioning Properties