Download

Source Code

Building

• Extract the repointDev.zip to a convenient location.
• This will create a folder called repointDev, which contains the following folders -
  • com.documentum.dfc
  • com.documentum.devprog
  • com.documentum.devprog.libraryFunctions
  All of these are Eclipse Plugin Project folders.
• From Eclipse, import these projects into the workspace - File -> Import -> Existing Projects into Workspace. Select repointDev as the the root folder. Eclipse will detect the four projects mentioned above. Click on 'Select All' and then 'Finish'. This will create Eclipse projects with the above names within your workspace.
• Copy all the DFC related jars from the folder that contains the dfc.jar (e.g. c:\Program Files\Documentum\Shared ) to com.documentum.dfc\lib.
• Create a config.jar by creating a jar of all the properties files such as dfc.properties. These files are typically located in DOCUMENTUM\config (e.g. c:\Documentum\config). The command to create a jar is as follows, assuming that the JAVA_HOME\bin folder is in your system PATH.

  c:\Documentum\config>jar cvf config.jar *.properties

• Place this config.jar in com.documentum.dfc\config.
• Right-click on com.documentum.dfc and go to Properties->Java Build Path.
• Select the 'Libraries' tab and click on 'Add Jars'.
• Select all the jars within com.documentum.dfc/lib and the jar com.documentum.dfc/config/config.jar.
• Now, from the same place, switch to the 'Order/Export' tab. Select(check) all the jars that you see in the list. This list is same as the jars that you added in the previous step.
• Click on 'Ok'
• Open the com.documentum.dfc\plugin.xml file. It should open in the Eclipse plugin manifest editor.
• Switch to the 'Runtime' tab on the plugin manifest editor. Click on 'Add' in the Classpath list and select all the jars within the lib folder and also com.documentum.dfc/config/config.jar. Note that if these jars are already there in the Classpath list, you do not need to do this step.
• Save all files and refresh the com.documentum.dfc project by right-clicking on it and selecting 'Refresh'.
• The rest of the projects should build automatically if you have this setting enabled otherwise you can request an explicit build of the remaining projects.

Running Repoint From the IDE

Standalone

• Open the file com.documentum.devprog\repointProd.product.
• From the 'Overview' tab click on 'Launch the product'. This should launch the Repository Interrogation Utility standalone version.

Plugin

• Click on the menu item Run->Run from Eclipse.
• From the left column, select 'Eclipse Application' and click on the 'New' button towards the bottom. This should create a new Runtime Workspace configuration. Leave the defaults for simplicity.
• Select this new configuration and click on the 'Run' button.
• A new Eclipse instance will be launched. From this instance, open the Documentum perspective by clicking on Window->Open Perspective->Documentum Perspective.

Understanding the Structure

com.documentum.dfc

This is the base plugin and is primarily meant for wrapping the DFC jars and the configuration files such as dfc.properties. This is needed because Eclipse needs all jars in its standard plugin format. This plugin does not contain any source.

com.documentum.devprog

This plugin depends on the com.documentum.dfc plugin and is the core repoint plugin. It contains code for the repository navigation tree, the repository type tree, dql query editor, the api editor and the properties view. This plugin exposes three extension points in the repository tree, type tree and the properties view. These extension points allow an extending plugin to add actions (menu items) to the context menus of the corresponding views. The library functions plugin uses these extension points to add library functions to the tree view. In addition, the plugin also adds a TBO descriptor dialog by hooking into the type view extension point.

com.documentum.devprog.typeSupport

This plugin hooks into the extension points on the repoint base plugin and adds library functions like checkout, checkin, view, export, XSL transform, .... Basically, anything after the horizontal line in the repository trees context menu is added by this plugin.