Before you start, locate the Web applicaiton. If the Web application is part of a WAR file, unzip the WAR file within the ...\onepage directory structure.
Select Use Web Application.
WAR file - enter the path to the Web application.
Enter the Initial Resource—the initial JSP page to display.
Select from these options:
Web App Qualified URLs – enter an URL with parameters to call a Web application from the JSP application. See “Using a remote URL”.
Enable Grid Rules – select to enable the use of grid rules. See “Using grid rules”.
Grid rules do not apply to forms, or tables/grids
that include form UI. To use grid rules with a form, you need to
use JSP code to return the table after processing the element.
Single Sign-On Required – select if single sign-on is required. See “JSP application single-sign-on”. When you select this option, three more options become available:
JSP Include – use the javax.servlet.RequestDispatcher.include(...) method to enable the target JSP to retrieve the JSP’s contents. This method returns the target JSP’s output to the portal and allows you to manipulate, filter, and integrate that output with other elements in an application with multiple elements—an aggregate application. Aggregate applications use either an <IFRAME> or <DIV> tag style.
The target JSP gets a contextPath in the ServletRequest object that matches the application name under which the JSP is installed.
JSPs using the .include() method have a <BASE HREF=“targetJSP path”> element inserted into the HTML <HEAD> element. This ensures that relative HREFs or IMG links generated from that JSP are loaded correctly.
JSP Forward – use the javax.servlet.RequestDispatcher.forward(...) method to enable the target JSP to retrieve the JSP’s contents. This method does not return the target JSP’s output back to the portal.
This application style must run in an <IFRAME> tag and cannot be included in an aggregate application (application with multiple elements). The forward method ensures that the target JSP receives the contextPath with which it was installed. There is no opportunity for the portal to insert the <BASE HREF=...> element into the returned HTML, so if the <BASE HREF=...> information is not provided by the application, relative HREFs or IMG links may not work.
302 Redirect – this option generates a HTTP Status 302 redirect back to the browser. When the browser receives a 302 redirect status, it executes a get method to the URL contained in that 302 message. This application style must run in an <IFRAME> tag, otherwise the application overlays the entire screen.
One benefit of this application style is that the declarative J2EE security constraints that are part of the target Web application are enforced by the container. The J2EE standard does not require the container to apply declarative security constraints for RequestDispatcher include or forward.
Web applications in J2EE containers can have security descriptors
that are mentioned in web.xml. This section
of the XML puts a constraint on all the resources of the Web application.
Access is granted only to users who are in the manager role. Users
who try to access the Web application from the browser (or other
client program) must be authenticated. If the type of authentication
required is basic authentication, the browser prompts the user for
a user name and password.
If the Web application is added as an application to a page, users need not re authenticate with the application. The portal uses container authentication to authenticate users when they log in to the portal. The same session context authenticates the user with the Web application used to authenticate the user with an application. If the user roles are the same across the Web application, the user is authenticated into the Web application and the contents display in the application.
See the Enterprise Security Administration Guide for details.
Input Parameters – enter the input parameter names as defined by the JSP code.
You must use a name, value pattern like this:
name1=value1&name2=value2&name3=value3
The name must be exactly the same as your JSP code’s input parameter’s name. For example, if the JSP page’s code is:
EPLogin:<input type ="text" name="epuser"> EPPswd:<input type="password" name="eppassword"> HostName:<input type="text" name="hostname"> AssetDN:<input type ="text" name="asset"> PAI URL:<input type="text" name="paiURL">
The input parameters must then be:
epuser=tester&eppassword=test123&hostname=drillbit2k&asset=a1=pubs, dc=sybase,dc=com&paiURL=jdbc:sybase:Tds:sapphire:5000/pubs2
