To develop using JavaServer Faces Components for BusinessObjects Enterprise, your web application must be properly configured. Configuring your web application involves several steps:
web.xml
configuration file.
faces-c onfig.xml
application configuration resource file.
crystalreportviewers11
folder into your web application.
Note: This step is only required if you are using the ReportPageViewer
component in your web application.
The following procedure assumes that you are creating a web application from the beginning. However, you can also use the directions below to modify an existing web application.
web_application_name
WEB
web.xml
faces
lib/
classes/
crystalreportviewers11/
Your web application will be stored in the web_application_name directory. This is the root directory for the web application and contains all of the files that the web application needs. Your web application directory (web_application_name) should be located in the main web applications directory for your web application server (for Tomcat, this directory is typically called webapps
).
The WEB
directory contains all of the support files required for your web application. The web.xml
and faces
files are created in this folder.
The WEB
directory contains all of the JAR files required by your web application, including any JAR files that contain custom backing beans (see How do I use backing beans?). Alternatively, custom .class
files such as backing beans you create can be stored in the WEB
directory.
The crystalreportviewers11
directory contains all of the support files required by the ReportPageViewer
component.
web.xml
file and save it in the WEB-I NF
directory. The web.xml
file must be constructed as follows:<
<!DOCTYPE web
"-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
"http://java.sun.com/dtd/web
<web
<display
<listener>
<listener
</listener>
<servlet>
<servlet
<servlet
<load
</servlet>
<servlet
<servlet
<url
</servlet
<context
<param
<param
</context
<context
<param
<param
</context
</web
The servlet mapping defined in the <servlethttp://localhost:8080/
web_application_name/faces/logon.jsp
will activate the faces servlet which then loads logon.jsp.
Note: The <contextcrystalreportviewers11
folder reference is only necessary if you are using the ReportPageViewer
component in your application.
faces-c onfig.xml
file and save it in the WEB-I NF
directory. The faces-c onfig.xml
file must be constructed as follows:<
<!DOCTYPE faces
"-//Sun Microsystems, Inc.//DTD JavaServer Faces Config 1.0//EN"
"http://java.sun.com/dtd/web
<faces
<navigation
...
</navigation
<managed
...
</managed
</faces
faces
is used to define the navigation rules for your application (see How do I define the navigation flow of my application?) and to initialize and configure managed beans (see How do I configure the default values of Java beans?).
WEB-I NF\lib
directory:On Windows, jsfplatform.war is in C:\Program Files\Business Objects\BusinessObjects Enterprise 11\java\applications.
On Unix systems, this file is in businessobjects_root/java/applications where businessobjects_root is $HOME/enterprise11
On Windows, these JAR files are in C:\Program Files\Common Files\Business Objects\3.0\java\lib
. On Unix systems, the JAR files are in businessobjects_root/java/lib
, where businessobjects_root is $HOME/crystalreports
.
Also ensure that the jar files located in C:\Program Files\Common Files\Business Objects\3.0\java\lib\external
for Windows or businessobjects_root/java/lib/external
for UNIX, are included.
crystalreportviewers11
(C:\Program Files\Common Files\Business Objects\3.0
on Windows) into your web application's crystalreportviewers11
directory.Note: This step is only required if you are using the ReportPageViewer
component in your web application.
Business Objects http://www.businessobjects.com/ Support services http://www.businessobjects.com/services/support/ |