For an overview of how to organize your work, see EGL projects, packages,
and files.
To set up a new EGL Web project, do as follows:
- In the Workbench, do either of the following steps:
- Click File > New > Project; or
- Right-click, then click New > Project.
The New Project wizard opens.
- Expand EGL, then click EGL Web Project.
Click Next. The New EGL Web project wizard
is displayed.
- In the Project name field, type a name for the
project. By default, the project is placed in your workspace; but you can
click Browse and choose a different location.
- Select how to specify a build descriptor, which is the part that directs
processing at generation time:
- Create new project build descriptor(s) automatically means
that EGL provides build descriptors and writes them to a build file (extension
.eglbld) that has the same name as the project.
To specify some of the
values in those build descriptors, click Options.
To change those values later, change the build file that is created for you.
For
further details, see Specifying database options at project creation.
- Use build descriptor specified in EGL preference means
that EGL points to a build descriptor that you created and identified as an
EGL preference.
- Select existing build descriptor allows you
to specify a build descriptor from those that are available in your workspace.
- If you requested that a build descriptor be created automatically, you
can place a value in the JNDI Name for SQL Connection field.
The effect is to assign the name to which the default data source is bound
in the JNDI registry at debug or generation time. (An example value is java:comp/env/jdbc/MyDB.)
Your selection assigns a value to the build descriptor option sqlJNDIName.
If the JNDI Name for SQL Connection field is already
populated, the value was obtained from a Workbench preference, as described
in Setting preferences for SQL database connections.
- In most cases, click Finish. To do additional
customization (as is possible for any Web project), configure the J2EE settings
at the bottom of the dialog. Optionally, you can click Hide Advanced to
conceal the J2EE settings.
- To configure the Web project features, click Next.
The following EGL-related features are available on the Features page:
- EGL support with JSF is selected by default.
This feature lets the EGL Web project use JavaServer Faces components to display
information on Web pages and receive input from Web pages.
- EGL support with JSF Component Interfaces allows
you to call Java™ functions recognized by the JavaServer Faces components,
giving you more direct control over their appearance and behavior. See Accessing
a JSF component from a pageHandler.
- EGL support with Legacy Web Transaction adds
support for Web Transactions to the project.
The other features in this list do not affect EGL directly. You can
add any of these features later by right-clicking the project in the Project
Explorer view and clicking Properties. Then click Web
Project Features and use the check boxes to add features. You
can not remove features from a project.
- To select a default page template for the Web project, click Next.
Select a page template, then click Finish.