Administration Guide

E-mail Notification

E-mail Notifications may appear anywhere in the Programming section of a workflow action. However, Alloy Navigator waits to trigger these notifications until all other statements of the Programming section have been completed. This is necessary to ensure that notifications reflect the most current state of the object in the result of a successfully executed Action.

IMPORTANT: For details, see Inserting Placeholders.

To specify how to generate an E-mail Notification:

  1. In the E-mail Notification dialog box, click Select and choose an E-mail Notification from the list of E-mail Notifications defined for the object class.

    INFO: For details, see Creating E-mail Notifications.

  2. Under Attach, select options for attaching files to the notification:

    • To add all the files that the current action or trigger attaches to the object, select the Files attached to this object check box.

    • To add the files from the a specific Attachment Area on the action's Action Form, select the Files attached using this control check box and choose the area from the drop-down list.

    • To specify a custom SQL expression or script for attaching any files existing in the database, select the Other files check box, then click the Build Expression button and specify a SQL expression or a script. Your SQL expression or script must return IDs of attachments or IDs of objects or activities containing attachments.

      INFO: For details on the Expression Builder, see Using the Expression Builder.

  3. Under Parameters, specify parameter values that are passed to the E-mail Notification:

    Default parameter values display <Default> in red color.

    Parameter values that need to be assigned display <Double-click to assign value> in red color.

    IMPORTANT: You can invoke an E-mail Notification only when it’s parameter values are assigned. If some parameter values are missing, Alloy Navigator does not allow you to generate such E-mail Notification.

    You can assign a value to a parameter as follows:

    • Quickly assign one of predefined values:

      • Right-click a parameter row and choose a value from the pop-up list, which contains the following items:
        • <Empty> — the placeholder for an empty value.

        • When the E-mail Notification is executed from an Action, choose a virtual field from the Action Form. The list displays the virtual fields of the same data type as the target parameter.

          INFO: For details on Forms, see Creating Forms.

        • When the E-mail Notification is executed from a Function, choose a Function parameter. The list contains parameters of the same data type as the target parameter.

          INFO: For details on Functions, see Creating Functions.

    • If the pop-up list does not contain the value that you need, proceed as follows:

      1. Double-click a parameter row to bring up the Assign Parameter dialog box.

      2. Next to the Value field, click the Build Expression button to bring up the Build Expression dialog box.

      3. Then use the Expression Builder to specify a static value or to define a runtime expression.

        INFO: For details, see Using the Expression Builder.

  4. Keep the Enable operation check box selected. Otherwise, this operation will be skipped.

  5. Click OK.