Configuring the size of the SAP integrator portlet

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

About this task

The integrator portlet displays an HTML iframe element in its view mode. You can configure the integrator portlet to either resize the iframe automatically , or you 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. If you want to determine the best size for your SAP NetWeaver Portal views, you 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;
This value sets the iframe to a static size of 800 by 500 pixels.
height:100%;width:800px;
This value sets the height to 100% of the portlets view area and the width to 800 pixels.
height:500px;width:800px;overflow:scroll;
This value 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.
You can set the preference values by using the WebSphere Portal XML configuration interface.

Procedure

  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 your portal.
    1. Select Administration > Import XML.
    2. Provide the file location.
    3. Click Import.
    For more information about the portal XML configuration interface and how to use it, see the topics about the XML configuration interface, especially Working with the XML configuration interface.