Creating connector activities for JMS and MQ connectors
The connector activity is the mechanism that starts the connector. A connector activity puts the request data where the connector rule is programmed to find it, invokes the connector rule, sets response data from the clipboard into work object properties, calls other activities that perform additional processing, and does what is necessary to complete the processing of the data it receives.
To start the connector, the activity uses the appropriate Connect-* method. For example, if the connector is a Java Message Services connector, the activity uses the Connect-JMS method to call the connector rule. If it is an MQ connector, the activity uses the Connect-MQ method.
You use an integrator shape in a flow to call the connector activity. Integrator tasks can call activities that apply to class rules that inherit from the Work- base class rule only. Therefore, typically a connector activity applies to a class rule that inherits from the Work- class so that you can call it directly from an Integrator task in a flow.
Suggested Approach
Complete the following steps to create a connector activity that calls a JMS or MQ connector rule:
- From the Records explorer, click Technical > Activity.
- From the right-click menu, select Create.
- In the Label field, enter the name that you chose for this activity during the planning stage.
- In the Applies to field, enter the name of the class that you determined during the planning stage was correct for this activity.
- Click Create and open.
- On the Pages and Classes tab, configure any pages that the activity uses. For example, it is typical to create a page for the class rule that the connector applies to and for the class rule that the activity applies to.
- On the Parameters tab, configure any parameters required for the activity.
- On the Steps tab, create the steps that implement the purpose of this activity: to set values for a message and call the connector rule. Use the Property-Set method to set property values. Use the Connect-JMS or Connect-MQ method, as appropriate, to call the connector rule.
- On the Security tab, set the to
Connect
. - On the History tab, enter a description in the Full description and the Usage fields.
- Click Save.
- Click Run to test that the activity works.
You can now call this activity from an Integrator task in a flow.