Release and Deploy your Plug-in
This document provides step-by-steps instructions to release and deploy a plug-in developed for Semarchy xDM.
The plug-in is released as a Jar file that will be deployed in a Semarchy xDM instance. Once deployed, the plug-in becomes available for design and run-time.
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:
Select the plug-in project, right-click and select Export.
Select Plug-in Development > Deployable plug-ins and fragments.
In the Destination tab, use the Browse button to select a target directory for your plug-in. For example:
Select the Plug-in to deploy. For example:
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.
|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.|
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:
In the plug-in project, double click the
plugin.xmlfile to edit it.
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
Press CTRL+S to save the editor.
You can re-generate the plug-in binary.
|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.|
|To deploy a plug-in in a Semarchy xDM instance, you must connect with a user that has the Platform Administration Read/Write privileges, or with an administrator user (semarchyAdmin role).|
To deploy the plug-in binary:
Connect to the Semarchy Configuration.
Double-click the Plug-ins link.
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.
Click the Browse button and select the plug-in binary file. For example:
Click OK. A Status window shows the number of plug-ins installed or updated.
The plug-in now appears in the list, and can be used in the models and the integration jobs.