Releasing the Plug-in

Generating the Plug-in Binary

The plug-in binary is a Jar file that will be deployed in a Semarchy Convergence for MDM instance. Once deployed, the plug-in becomes available for design and run-time.

Generate the Plug-in Binary

When the plug-in is tested, or when a new version is available, you can generate the plug-in binary.

To generate the Plug-in Binary:

  1. Select the plug-in project, right-click and select Export.
  2. Select Plug-in Development > Deployable plug-ins and fragments.
  3. In the Destination tab, use the Browse button to select a target directory for your plug-in. For example: c:\temp.
  4. Select the Plug-in to deploy. For example: com.acme.phoneStandardizer.
  5. Click Finish.

The jar for the plug-in is created in a plugins folder under the selected destination directory. The generated jar file is named after the plug-in ID and version number.

Warning: When selecting the plug-ins and fragments to deploy, make sure to select only the plug-in, and not the JUnit test case fragments as they are not needed for running the plug-in.

Incrementing the Plug-in Version

If the plug-in was modified or fixed, before generating the new version of the plug-in binary, increment the plug-in version

To increment the Plug-in version:

  1. In the plug-in project, double click the plugin.xml file to edit it.
  2. In the overview tab, increment the Version number. For example, if the original plug-in version is 1.0.0, then the first patch for this plug-in would be 1.0.1.
  3. Press CTRL+S to save the editor.

You can now generate the plug-in binary .

Note: As the generated jar file is named after the plug-in ID and its version number, you can preserve in this directory the successive versions of the plug-in.

Deploying the Plug-in

Important: To deploy a plug-in in a Semarchy instance, you must connect with a user that has the Plug-ins Administration Read/Write privileges, or with a Semarchy administrator user (semarchyAdmin role).

To deploy the plug-in binary:

  1. Connect to the Semarchy Workbench.
  2. Open the Administration Console perspective.
  3. Double-click the Plug-ins node in the Administration view.
  4. Click the Install or Update Plug-in button in the upper right corner of the Plug-ins editor. The Install/Update Plug-ins dialog opens.
  5. Click the Browse button and select the plug-in binary file. For example: com.acme.phoneStandardizer_1.0.0.jar.
  6. Click OK. A Status window shows the number of plug-ins installed or updated.
  7. Your session is closed to take this new plug-in into account. Click the link to restart the session on the Overview perspective.
  8. Open the Administration Console perspective.
  9. Double-click the Plug-ins node from the Administration view.

The plug-in now appears in the list, and can be used in the models and the integration jobs.