ActiveVOS Designer User’s Guide

Adding Custom Functions to the ActiveVOS Embedded Engine

You can add Java-based custom functions to the ActiveVOS embedded engine for process execution.

To add the custom functions to the ActiveVOS embedded engine, copy the jar file containing the class files to the following location:

designer\plugins\org.activebpel.enginep_x.x.x\server\shared\lib

where x.x.x is the current version.

You must also add the function context name, namespace, and class information to the engine configuration file as follows:

  1. Open [designer\plugins\org.activebpel.enginep_x.x.x\server\bpr\aeEngineConfig.xml.
  2. where x.x.x is the current version.

  3. Locate the following line:
  4. <entry name="FunctionContexts"/>
  5. Change the line to add the following entries, as shown in the example, and save the file:
  6. <entry name="FunctionContexts">
       <entry name="myFunctionContext">
          <entry name="Namespace" value="urn:active-
               endpoints:custom_functions"/>
          <entry name="Class" value=
               "org.activebpel.samples.custom
              _function.xmlstring.XMLStringFunctionContext"/>
       </entry>
    </entry>

Note: You can also provide an entry for a classpath, using an absolute path or a system property, if you do not wish to add the jar file to the \lib folder.

Restart the server after updating aeEngineConfig.xml.

Note: For details of adding custom functions to ActiveVOS server, see the ActiveVOS Console online help.