Showing application event action contexts

When creating event handlers that send system messages to recipients, you might want to make the record for which the application event is generated available to the message recipients, in context on its form.

For example, suppose you are setting up an event handler that generates a request for approval to a purchasing manager every time a purchase order is created. To make it easier for the purchasing manager to view the actual purchase order being requested, you can set up the message so that the manager can simply click the Show Context button in the Inbox form. When you click this button, the new purchase order record automatically displays in the Purchase Orders form.

Note:  This procedure can be performed only for Notify or Prompt actions, on the Event Action Notify or Event Action Prompt forms.
  1. In the Event Actions form, create an application event action for a Notify or Prompt action type.
  2. WIth that action selected, click Edit Parameters.
  3. In the Event Action Notify or Event Action Prompt form, designate the name of a form in the Filter Form field.

    This argument designates the form that you want to open when the recipient clicks the Show Context button.

    This parameter enables the Show Context button when the recipient views the message.

  4. Click Filter Form.
  5. Use the Event Action Expression Editor to designate an expression that resolves to a string that involves the property on which you want that form to filter when it opens.
    Example: This expression might be something like this:

    SUBSTITUTE("propertyName = {0}", FP("propertyName"))

    This particular example allows the system to pass the specific record that triggered the event handler.

  6. Set up the rest of the Notify or Prompt action as desired.
  7. Click OK.
  8. Back in the Event Actions form, save your work.
    We recommend that you check the syntax and view the expression details before saving.
  9. Close the Event Actions form.
The application returns you to the Event Handlers form, where you can see the results of any changes in the Event Actions grid.
Related topics