Creating an ActiveMatrix Composite Wrapper for a Custom Action

Procedure

  1. Create an SOA project using Business Studio.
  2. Ensure all the options are selected and click Next.

  3. Create an empty SOA Project and click Finish. This creates an empty composite. Add a Java component to the composite.

  4. Open the composite file in a text editor and add the given tags after substituting the customA action name in to the tags: 
    <scaext:extension xmi:id="_wefwedADASDsada"
				name="com.tibco.governance.custom.action.customAction.amxcomponent.CustomActionComponent"
				requiredVersion="1.0.0"
				extensionPoint="com.tibco.governance.agent.amxcomponent.extensionpoint.actionconfigurationprocessor"/>
    Also edit the sca:composite tab to define the scaext namespace. For example: xmlns:scaext=http://xsd.tns.tibco.com/amf/models/sca/extensions
  5. Right-click the Java component and generate the Implementation. Enter the name of the project and click Finish. This generates two classes: AbstractCustomActionComponent and CustomActionComponent.

  6. Navigate to MANIFEST.MF of the generated implementation and ensure the packages are added. If not, manually add the packages.

  7. Once the setup is complete, in the CustomActionComponent class, import the class com.tibco.amf.platform.runtime.extension.Extension and add the @Extension notation at the top of the class declaration.
  8. Import ActionConfigurationProcessor, CustomActionConfigurationProcessor, and ActionConfigurationProcessorExtensionPoint (com.tibco.governance.agent.action.ActionConfigurationProcessor). This component class must implement the ActionConfigurationProcessorExtensionPoint (com.tibco.governance.agent.amxcomponent.extensionpoint.ActionConfigurationProcessorExtensionPoint) interface. From the init() method of the component class, call initialize of the CustomActionConfigurationProcessor.
  9. Navigate to the customfeature file under the com.tibco.governance.custom.action.customaction/DeploymentArtifacts and ensure that both amxcomponent plug-in and the custom action plug-in are included in the Included Plug-ins tab.
  10. Generate the DAA. The DAA containing the action can now be deployed on ActiveMatrix.
    For a completely implemented ActiveMatrix component, see Request Counter in Sample Action Source Code.