Configuring an action to call an invocation channel

The integration framework provides a default action class that you can configure as a system action. By providing this action class, you can configure a user interface control, an escalation, or a workflow to invoke an external service using an invocation channel.

Procedure

  1. Create an invocation channel in the Invocation Channels application.
  2. Create an action in the Actions application.
  3. Specify an object for the action. This object must be the same as the main object of the request object structure of the invocation channel and the main object of the application, workflow, or escalation that invokes the action.
  4. Specify Custom Class in the Type field.
  5. Specify the name of the custom class in the Variable field. You can use the name of the default class provided for this purpose, psdi.iface.action.InvokeCustomClass, or an alternative class name if you created your own custom class to invoke an external system.
  6. Specify values in the Parameters/Attributes field. Specify the values in the following order, and separate each value with a comma:
    1. Required: The name of the invocation channel to use. The value must be precisely the same as the name of the invocation channel.
    2. Optional: The name of the relationship to use if the main object of the response object structure is different from the main object of the request object structure in the invocation channel. If the response object is the same as the request object, no relationship is required.
    3. Optional: If you specified a relationship, specify the action to apply. The default action is Add, which creates records. To update existing records, specify Change as the action. If the request and response object structures are the same, the objects are updated if updated fields are mapped into the response object structure.
  7. Specify whether to apply the action to all applications, to workflows, or applications.
  8. Save the action.

What to do next

Associate an application, workflow, or escalation with the action. The main object is passed to the action class and then to the object structure of the invocation channel to form the request XML.



Feedback