Modifying Rules

Choose Create to add a new rule, or Edit to modify the currently selected rule.

• To create a new alert rule, choose  Object  New , enter the name of the new rule, and create it.

  In case no default alert rule is currently available, you can create one by selecting the corresponding option.

• To modify an existing alert rule, select it in the object view, choose  Object  Open , and then in the alert rule view choose  Alert Rule  Display/Edit  to enter editing mode.

  Note that when editing a default alert rule, you cannot add configuration objects, deselect message statuses, or change the name and description of this rule.

• Set the status and severity as necessary.

• Set whether the message payload should be part of the alert.

  You must configure the user-defined search feature for the corresponding runtime components in advance as described in the prerequisites above. Consider that the only payload information that could appear in the alert is the one that matches the search criteria you defined when configuring the user-defined search feature.

The alert rule contains Integration Directory configuration objects referred to here as objects. You can manage the objects for the alert rule as follows:

• To add a new object, select the object type from the Add menu and choose an object from the list.

  Consider the following when adding objects:

  • An alert rule should contain at least one object. The only exception is the default alert rule.

  • When using an Advanced Adapter Engine Extended (AEX) system, you can also add integration flow objects.

  • You can use sender agreement and receiver agreement objects only for AS ABAP-based runtime components.

  • Use the  View  Show Message Header Rules  option. This would allow you to ensure you have added the correct objects to the rule and the system would generate alerts as you need them.

• To exclude an object from the alert rule, select the object and choose Remove .

• Select which runtime components the alert rule applies to in the Components screen area.

• Select which errors in message processing the alert rule applies to in the Message Statuses screen area.

  You can select individual errors as well as groups of errors.

• Add or remove consumers for the alert rule in the Consumers screen area.

  To enable the adding of new consumers, you need to activate the  Edit  Add Consumer  option.

  Recommendation

  You should avoid subscribing consumers using the Add Consumer option described here. This options should be used only when you want to utilize the simple local ALERT-TO-MAIL consumer provided by SAP. For more information, see Alert Consumption .

  In general, alert consumers should subscribe themselves for alert rules using the alerting API on Integration Directory. For more information, see Subscribing Consumers to Alert Rules (RegisterConsumer) .