Configuring Siebel Open UI > Configuring Siebel Open UI to Interact with Other Applications > Displaying Data from Siebel Open UI in External Applications >
Configuring Communications with Siebel Portlets When Hosted Inside iFrame
This topic outlines the Siebel server parameter configurations to enable communication with Siebel portlets when hosted inside iFrame. These parameters can be modified for the Siebel component with which the functionality is meant to communicate. The instructions in this topic are not required when cross-domain communications are not needed. To configure communications with Siebel portlets when hosted inside iFrame
- Set up the Siebel server parameters:
- Log in to a Siebel client with administrative privileges.
- Navigate to the Administration - Server Configuration screen, and then the Servers view.
- In the Siebel Servers list, choose a Siebel Server.
- In the Components list, select the component that you want to expose as a portlet
- In the Component Parameters list, add the following parameters.
|
|
PortletAPIKey |
This is a required parameter. It is a unique key configured as a server parameter. The source portal program will need to pass this key, in order to be able to invoke a call on the Siebel application exposed as the portlet. The messaging object used to communicate with Siebel Portal will need to contain a parameter msg.Key. The msg.Key must match the key configured in this parameter. If the messaging object does not contain a key, or contains an invalid one, the invocation will result in an error in the Siebel portlet. |
PortletOriginList |
This is a required parameter. It defines the list of valid domains from which the Siebel portlet will accept a communication request. A comma separated list can be provided for this parameter. Any invocations coming from domains that are not listed here will cause an error in the Siebel portlet. |
PortletMaxAllowedAttempts |
This is an optional parameter. Its default value is 3. This parameter specifies the number of unsuccessful communication attempts with the portlet before Siebel Open UI blocks any subsequent calls. An unsuccessful call can occur in the following situations:
- A domain attempts to send a communication request to the portlet, but the PortletOriginList does not specify this domain.
- The portlet_key sent by the communicating domain does not match the parameter specified in the Siebel server.
The Siebel portal will remain blocked up to the time extent as defined by PortletBlockedInterval after which the Siebel Open UI resets the unsuccessful attempts to zero. |
PortletBlockedInterval |
This is an optional parameter. Its default value is 900 seconds. This parameter specifies the time in seconds for which Siebel portlet will remain blocked to any communication attempt from the hosting portal or a neighboring portlet after having exceeded the number of unsuccessful communication attempts (as defined by PortletMaxAllowedAttempts). During this time, the Siebel portlet will still be open to access by the user of the application. However, no programmatic access is permitted. |
- Based on your configuration, the portal, or another portlet in the portal, add the following object to your custom code:
var msg = new Object(); msg.SWEView = view_name; msg.SWEApplet = applet_name; msg.SWECmd =GotoView or GetApplet msg.Key = portlet_key;
NOTE: The SWEView, SWEApplet, and Key arguments are required. All other arguments are optional.
where:
var msg = new Object(); msg.SWEView = Opportunity List View; msg.SWEApplet = Opportunity List Applet; msg.Key = oracle123;
- Add the following code immediately after the code that you added in Step 2.
document.getElementById('siebelframeid').contentWindow.postMessage(msg, '*');
This code invokes a change in the Siebel Portlet window, so that the requested view or applet will get loaded in the content area.
- You can use SWE commands to display a Siebel portlet in Siebel Open UI. For security reasons, you can use only the GotoView and GetApplet method to call a Siebel portlet from an external application. GotoPage and GotoPageTab are not applicable to Siebel Open UI. For more information, see the topic describing SWE commands available in Siebel Open UI in Siebel Portal Framework Guide.
|
Inside Siebel Application |
Called from UI Element Inside Siebel Portlet Container |
Called from Outside Siebel Portlet Container |
CanInvokeMethod |
Yes |
Yes |
No |
ExecuteLogin |
Yes This is not supported for HTTP GET. It is supported through HTTP POST. |
Not applicable for this use case. |
Yes This is not supported for HTTP GET. It is supported through HTTP POST. |
GotoView |
Yes Use only when invoked from the browser address bar by refresh or history navigation. |
Yes |
Yes |
GetApplet |
Yes |
Yes |
Yes |
InvokeMethod |
Yes |
Yes |
No For more information, Allowing Blocked Methods for HTTP GET Access. |
LoadService |
Yes |
Yes |
No |
Login |
Yes |
Not applicable to Siebel Open UI. |
Not applicable to Siebel Open UI (use SSO or similar). |
Logoff |
Yes |
Not applicable to Siebel Open UI. |
No |
ReloadCT |
Yes |
Yes |
No |
|