Poseidon for UML: User Guide
Prev |  | Next

# Chapter 15. Plug-Ins

With Poseidon's plug-in interface it is possible to add extended functionality that is well beyond what is implemented in the core product. The Standard Edition of Poseidon for UML comes with this plug-in feature. Development teams from Gentleware AG as well as technology partners are working on plug-ins that meet specific designer and developer needs. The following sections give a brief overview of the most recent plug-ins that are available for shipping (or will be soon). For information on how to install a plug-in, please see the separate documentation available on the Gentleware Web site.

The Professional Edition of Poseidon comes with several options for code generation and one for documentation generation (UMLDoc). Java code generation is the default setting, but you can also choose to generate other types of code. To do this, you have to activate the plug-in that supports the desired language. (Via Plug-Ins | Plug-Ins Panel). When you do this, a set of stereotypes becomes available that can be used to control the result of the code generation. The next sections describe what stereotypes and tagged values you can use to control the output of code generation.

# The Plug-In Manager

The Plug-In Manager is provides an easy interface to install, manage, and uninstall plug-ins. The left side displays all installed plug-ins, while the right side displays details about the selected plug-in.

The plug-in displayed in the figure below is named JarImport. It contains all of the information used by Poseidon to import archived Java files. This plug-in is standard in the Professional Edition.

Details available in the Plug-in Manager:

- Enabled - This dropdown allows you to determine whether or not a plug-in is used by Poseidon.

- File Name - Displays the location where the plug-in is installed. This field is not editable.

- Code Name - Displays the code name of the plug-in.

- Version (Specification) - Displays the version number of the plug-in.

- Version (Implementation) - Displays the internal build number of the plug-in.

- Dependencies - Lists the plug-ins from which it uses functions.

## Installing a New Plug-In

Using Plug-Ins requires three steps. You must first add the license, then install the plug-in, and finally enable the plug-in.

### Add the Plug-In License

1. Download the plug-in from the Gentleware web site. You must additionally purchase a license key from the Gentleware store (except in the case of beta versions).

2. From Poseidon, open the License Manager from the Help menu.

3. Paste the Serial Number into the 'New Key/Serial #' box at the bottom of the License Manager. This number should have arrived via email when you purchased the plug-in.

   Click the 'add' button.

4. The Serial Number now displays a valid status.

   The Serial Number must be registered in order to receive the Final Key. The Final Key allows you to use an unrestricted version of the plug-in. Failure to register the plug-in will cause the plug-in to cease operation after the grace period expires.

5. Click the 'register' button. You can choose to register online (directly from the dialog) or via the website. Once the registration is complete, close the License Manager.

### Install the Plug-In

1. Check the documentation accompanying your plug-in to determine which directory you should use for installation. For most plug-ins, extract these files into the 'lib' directory under the Poseidon installation directory. There are exceptions, however. For example, if you have downloaded the GoVisual autolayout plug-in, extract these files into the 'lib/ext/'directory.

2. Now that the files are in place, it is time to add the Plug-In to Poseidon.

### Enable the Plug-In

1. Open the Plug-In Panel (located in the Plug-Ins menu). Click the 'add' button.

2. Select the .jar file for the Plug-In from the 'lib' directory (or wherever you installed the plug-in, as this is the same file that was unzipped earlier in the process).

   Click the 'install' button.

3. Verify that the Plug-In has been installed and is enabled by highlighting the name of the Plug-In from the list of Installed Plug-Ins.

Prev | Home | Next
Documentation Generation |  | Removing Plug-Ins