Creating an EGL Web project

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:
  1. 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.

  2. Expand EGL, then click EGL Web Project. Click Next. The New EGL Web project wizard is displayed.
  3. 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.
  4. 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.
  5. 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.
  6. 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.
  7. 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.

  8. To select a default page template for the Web project, click Next. Select a page template, then click Finish.

Related concepts
Build descriptor part
EGL projects, packages, and files

Related tasks
Specifying database options at project creation
Setting preferences for SQL database connections
Accessing a JSF component from a pageHandler
Configuring a project to run Web transactions

Related reference
sqlJNDIName

Feedback
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.