Samples

CHAPTER 1    Director Examples Application

This chapter describes how to configure and run the Novell exteNd Director Examples application. It contains the following sections:

• About the Director Examples application

• Configuring the Director Examples application

• Running the Director Examples application

• Viewing the source code for an example

• Viewing the documentation page for an example

About the Director Examples application

The Director Examples application demonstrates many common coding techniques for Director applications. It includes the following examples:

• Components using Web Services

• Framework examples

• Content Management examples

• Personalization examples

The Director Examples application is packaged as a WAR file called DirectorExamples.war. To use the application, you need to add this WAR file to a Director EAR project by using the samples template.

Configuring the Director Examples application

To configure the Director Examples application to run on the SilverStream^® eXtend Application Server:

1. Start your SilverStream eXtend Application Server with the Autonomy JAR file (autonomyJNI.jar) in the classpath. For example, if you installed Director under c:\Program Files\Novell, you could use this command to start the server:

     silverserver +cp:p c:\Progra~1\Novell\eXtendDirector\autonomy\autonomyJNI.jar
   

2. Add the Autonomy dynamic library (autonomyJNI.dll) to your environment. To do this, you need to add the directory containing the autonomyJNI.dll file to the PATH environment variable. For example, if you installed Director under c:\Program Files\SilverStream, you would add this entry to the PATH environment variable:

     c:\Program Files\Novell\eXtendDirector\autonomy
   

3. Create a new Director database. This database will contain Director application data such as content and user information.

   TIP:   Give the data source a name other than DirectorExamples.

4. In exteNd Workbench, create a Director EAR project. Select the default values on all panels—except as indicated below:

   Panel	What to specify
   Template Location	Specify the following template location: %NOVELL_EXTEND_DIRECTOR_HOME%\templates\Director
   Project Information	Give the project a name other than DirectorExamples. Specify J2EE 1.3 as the J2EE version for your project.
   Setup Type	Select Custom (not Typical).
   Subsystem Selection	Optionally deselect the following subsystems: Debug PMC RSS Rule WebDAV Workflow These are not required to run the application.
   Namespace Application	Uncheck Yes to removing namespacing. NOTE:   This is necessary so that the URL for the Web Service example will be generic.
   Content Management Search Configuration	Make sure that the Enable link to the search service? option is set to Yes.
   Framework Configuration	For Director Framework Datasource, change Director to specify the name of your Director application database: Databases/YourDBName/DataSource For locksmith, specify anonymous (not admin).

5. In exteNd Workbench, select Project>Director Project>Setup. Select the default values on all panels, except as indicated below:

   Panel	What to specify
   Setup Option	Select Add.
   Template Location	Specify the following template location: %NOVELL_EXTEND_DIRECTOR_HOME%\samples
   Subsystem Selection	Select DirectorExamples.

6. Make sure you rebuild the project when you finish using the wizard. If you do not rebuild the project, you need to select Project>Rebuild All and Archive.

7. Create a deployment plan for the project, specifying SilverStream 4.0 as the destination server type.

8. In the Deployment Plan editor, right-click on the Web Module for the DirectorExamples.war to display the Property Inspector.

9. Click Edit Excluded JSPs.

10. Add jsp/navigate1.jsp, jsp/navigate2.jsp, and jsp/doctop.jsp to the list of JSP pages to be excluded.

11. Now right-click on the jdbc/datasource property. Map this property to your Director application database.

    The mapping for this resource reference must be the same as YourDBName, as specified in the Director Framework Datasource field in the Framework Configuration panel of the Director Project Wizard.

12. Save the deployment plan.

13. Create a server profile for deployment. If you're planning to deploy to the SilverStream eXtend Application Server, specify SilverStream 4.0 as the server type. Specify the SilverMaster database (for example, SilverMaster40) as the deployment database.

    TIP:   To create a server profile, select Edit>Profiles.

14. Deploy the EAR.

Running the Director Examples application

To run the Director Examples application:

1. Type the following URL in your browser:

     http://localhost/DirectorExamples
   

   The Director Examples home page appears:

   

2. To test a feature, click the link for that feature.

Viewing the source code for an example

To view the source code for a particular example:

1. Click Source in the upper-right corner of the example page.

   The Director Examples application lists the source files for that example.

2. To see a particular source file, click the link for that file.

Viewing the documentation page for an example

To view the documentation page for a particular example:

• Click Docs in the upper-right corner of the example page.

  The Director Examples application displays a page that provides a description of the coding techniques used to implement the example.

	Samples

Copyright © 2000, 2001, 2002, 2003 SilverStream Software, LLC, a wholly owned subsidiary of Novell, Inc. All rights reserved.