..  _workbench:

Workbench
=======================================

Download and install Workbench
""""""""""""""""""""""""""""""
CMIS Workbench is a Java based desktop client for developers. It's a repository browser for the OpenCMIS client API. It provides a simplistic GUI that can be used to interact with Technology One's ECM implementation of CMIS.

.. image:: /_static/img/workbench.png
	:alt: CMIS Workbench

This tool should be used in conjunction with Fiddler in order to gain an understanding of how CMIS requests are created.

**Download:** https://chemistry.apache.org/java/download.html


..  sidebar:: Note

	This step is only required if you are debugging CMIS Workbench itself. It isn't used to debug ECM's implementation of CMIS.
	
Building chemistry source
""""""""""""""""""""""""""""""
This step is only required if you are debugging CMIS Workbench itself. It isn’t required to debug ECM’s implementation of CMIS. http://chemistry.apache.org/java/developing/guide.html 

Assumptions
^^^^^^^^^^^
The guide assumes you are using the Eclipse IDE for code development, and have Maven and SVN installed.

- Download and install Eclipse: http://www.eclipse.org/downloads/
- Download and install Maven: http://maven.apache.org/download.html
- Download and install SVN: http://subversion.apache.org/packages.html

Getting Started with OpenCMIS
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
This section introduces the most commonly used parts of the OpenCMIS client API. The code snippets are taken from the GettingStarted sample class supplied with Apache chemistry.

Installing the getting started sample
-------------------------------------
On a command line, type the following command:
``svn co https://svn.apache.org/repos/asf/chemistry/opencmis/trunk/chemistry-opencmis-samples/chemistry-opencmis-getting-started``

You can then build the sample and run the org.apache.chemistry.opencmis.doc.GettingStarted sample using maven, by typing the following command:
``mvn clean install``

This will pull in any dependencies for the sample, build it, and run it against a public repository.

The simplest way to work with the getting started sample is to use Maven to create an eclipse project from the code, and import it into your eclipse. To create the eclipse project type the following command:
``mvn eclipse:eclipse``

To import the project into eclipse:

- Click File->Import and choose General->Existing projects into workspace in the Import wizard.
- Click Next and browse to the folder you checked out the project to.
- Click the checkbox next to chemistry-opencmis-gettingstarted project. The project will be imported into your workspace.

You can run the main method in the GettingStarted class as a Java application.