Setting up a DFC Development Environment in Eclipse

Description

To setup a DFC development environment you will need at a minimum the dfc.jar and dfcbase.jar files. However, we recommend that you reference all the jar files in the folder that contains the dfc.jar file. On Windows, this folder typically is c:\Program Files\Documentum\Shared. In addition, you will need any classfolders and jars of your custom business objects. Another important component is the folder that contains the dfc.properties and the log4j.properties file. This folder needs to be in the classpath too.

Creating a Java project for DFC development in Eclipse 3.1

1. Click on menu item File->New->Project
2. From the 'New Project' window select Java->Java Project and then click on 'Next'
   
   
   
   Fig - New Project Window
   
   
3. Enter a project name (example - 'Simple DFC Project'). For sake of keeping things simple, keep the defaults for other options on this screen. Click on 'Next'.
   
   
   
   Fig - Enter Project Name
   
   
4. Select the 'Libraries' Tab and click on the 'Add External Jars' button.
5. In the 'Jar Selection' dialog navigate to the folder that contains the dfc.jar file. On Windows, this is typically c:\Program Files\Documentum\Shared . Select all (CTRL+A) the jars in this folder and then click on 'Open'.
   
   
   
   Fig - Add DFC Jars
   
   
6. Now, click on the 'Add Class Folder' button and then click on 'Create New Folder'
   
   
   
   Fig - Add Class Folder
   
   
7. In the 'New Folder' dialog give some name (e.g. 'dmConfig') and click on 'Advanced'
8. Select the 'Link to folder in filesystem' checkbox and choose the folder that contains the dfc.properties file. On Windows this is typically C:\Documentum\config
   
   
   
   Fig - Link to the folder containing the dfc.properties file
   
   
9. Click on 'Ok' in both the 'New Folder' and 'Add Class Folder' dialogs
10. Again for the sake of simplicity, keep the default project settings and click on 'Finish'.
11. Eclipse will create a project with the default source and output folders. You can now create Java classes that use DFC in the project. To create a new class right-click on the source folder(or package) and select New->Class. To execute a Java class right-click on the class and select Run As->Java Application. For more details related to the Java development options, please refer to the Eclipse documentation.