Start of Content Area

Procedure documentation Editing Follow Up Actions: Alert Monitor Entry Locate the document in its SAP Library structure

Use

From the Parameter tab page, choose Alert Monitor to inform one or more interested parties that an exception, whose threshold values have been exceeded or fallen short of, has been logged in the exception log. 

You can also change the alert texts for the query views under investigation as well as the level of each exception cell. You can also parameterize them with text variables.

If you want to make the most of the option of jumping from the Alert Monitor to a resource, assign the URL of the resource in question to the corresponding Alert Monitor entry. 

Prerequisites

You have already selected an exception and assigned it to the follow-up action Alert Monitor Entry.

You can find additional information under Defining Exceptions Settings and Tab Page: Parameter.

Procedure

When you double-click on the assigned follow-up action in the Selected Objects tree structure, the Properties of the Follow Up Action screen area appears.

Select alert type

You have the option of generating BW Alerts or SAP Alerts.

Generate BW Alerts

Depending on the recipient type, you can select the recipient of the BW alert:

Type of recipient

Procedure

Result

All SAP users

Set the indicator for All SAP Users

The Alert Monitor entry is displayed for all SAP users.

Assigned users of a role

       1.      Choose This graphic is explained in the accompanying text Roles. You get to the Select Roles dialog box.

       2.      Select and transfer the roles that you want to use into the left-hand area of the screen.

       3.      Choose This graphic is explained in the accompanying text Continue.

The Alert Monitor entry is displayed for everyone assigned to the role that you specified.

Individual SAP users

...

       1.      Choose This graphic is explained in the accompanying text Recipient List. You get to the Select Recipient dialog box.

       2.      Select and transfer the required SAP users into the left-hand area of the screen.

       3.      Choose This graphic is explained in the accompanying text Continue.

The Alert Monitor entry is displayed for the selected recipient.

Generate SAP Alerts

SAP Alerts are alerts that are generated with SAP Alert Management. In order to be able to generate SAP Alerts from within the Reporting Agent you have to make the following settings in SAP Alert Management:

...

       1.      Define alert categories in the transaction ALRTCATDEF. See Structure linkAlert Category and Structure linkDefining Alert Categories.

Note

You also get to transaction ALRTCATDEF in Customizing (transaction code SPRO) under SAP Customizing Implementation Guide ® SAP NetWeaver ® SAP Business Information Warehouse ® Reporting-Relevant Settings ® General Reporting Settings in Business Explorer® Reporting Agent: Settings for SAP Alerts.

       2.      Select the recipient of the SAP Alert. See Structure linkRecipient Determination.

       3.      As needed, maintain the Alert Container. The Alert Container ensures the exchange between the BW variables and the variables in the central alert server. See Structure linkAlert Container.

If you have made these settings in SAP Alert Management, you can generate SAP Alerts from the Reporting Agent. Make the following settings:

Settings

Procedure

Result

Alert category

...

       1.      Using input help, choose your desired alert category for the Alert Cat field.

       2.      Choose This graphic is explained in the accompanying text Install.

With the selection of the alert category you have decided upon specific settings such as priority, for example.

Container parameter

...

       1.      Choose This graphic is explained in the accompanying text Container Parameter. The Change Parameter for Alert Container dialog box appears.

       2.      Using the input help for the Text Variable field, choose your desired variables.

       3.      Choose This graphic is explained in the accompanying text Install.

By determining the variables for the Alert Container, you ensure the exchange between the BW variables and the variables in the central alert server.

If you choose the container parameter BW_ALERT_TEXT, the alert text generated by BW Exception Reporting is transferred.

Note that the types of container parameters go with the types of assigned BW variables.

You can find more information in the components of the SAP Web application server under Structure linkAlert Management (BC-SRV-GBT-ALM).

 

You can edit alert texts for a specific alert monitor entry on an exception cell level and on a query view level.

Editing texts for an alert monitor entry on the level of individual alerts (exception cells)

...

       1.      In the tree structure Selected Objects, select the Alert Monitor entry for which you want to edit a text.  

If an alert text already exists, this is displayed in the Properties of Follow Up Action screen area, under the text group header. 

       2.      Choose This graphic is explained in the accompanying text Edit to change an alert text or to create a text. The Change Text for Alert Monitor dialog box appears.

       3.      Enter the text you want.

You can find and replace words with the This graphic is explained in the accompanying text Find/Replace  function.

You can insert the contents of a file with the This graphic is explained in the accompanying text Load Local File function.

You can use the This graphic is explained in the accompanying text Save as Local File function to save your alert text locally. 

       4.      Choose This graphic is explained in the accompanying text Select Variable if you want to insert a text variable into your text. The Variable Selection dialog box appears. The system displays the variables that can be selected along side their technical names and description.

Included here are not only the general variables of a query but also the context-sensitive variables of a specially selected query view. The variables serve as placeholders for dynamically generated text and are not filled until query runtime.

You can use This graphic is explained in the accompanying text Find and This graphic is explained in the accompanying text Find Again to search within the selection list.

If you want to restrict the selection list, open the Restrictions area. Enter the technical name or description of the text variable you are looking for, or use  This graphic is explained in the accompanying text Multiple Selection to select more than one text variable. Then choose  This graphic is explained in the accompanying text Start Search.

       5.      In the selection list, choose the required text variable, and choose This graphic is explained in the accompanying text Transfer. The system inserts the text variable into your text in the position of your cursor.

       6.      After you have edited the alert text, choose This graphic is explained in the accompanying text Continue.

Note

This text is displayed as the default text for the alert entry on the individual alert level.

       7.      If a BW exception appears for different query views in different contexts, you can edit alert texts in relation to the respective drilldown.

You can find additional information under Structure linkDefining and Changing Exceptions and Structure linkAlert Monitor.

Caution 

Note: The Reporting Agent checks a series of query views during the background run: These views are taken from the sequence of selected characteristics. The system does this by filtering by characteristic values 1 to n-1 in sequence and drilling down the last characteristic. 

In the Properties of Follow Up Action screen area, under the Text group header, choose the expert mode This graphic is explained in the accompanying text Enhanced. The Change Text for Alert Monitor dialog box appears.

       8.      In the Selection of Query View screen area, double-click on the required characteristic to choose the special query view. The selected characteristic is shown as “specified’ in the lower Alert Text screen area.

Caution

Note: Even though it is not mentioned here, another characteristic can be specified here as well as the one denoted as “specified”.

       9.      Edit the alert text. The same text editing functions are available as in the simple editor describe above.

   10.      Choose This graphic is explained in the accompanying text Continue.

Editing texts for an alert monitor entry on the level of a query view

...

       1.      In the Selected Objects tree structure, choose This graphic is explained in the accompanying text Drilldown Characteristics. To the right, the Name of Query View screen area is displayed with This graphic is explained in the accompanying text No Characteristic specified.

       2.      In the Name of Query View screen area, under the Text group header, choose This graphic is explained in the accompanying text Edit. The Change Text for Alert Monitor dialog box appears.

       3.      Edit the alert text.

       4.      Choose This graphic is explained in the accompanying text Continue.

       5.      To edit a text for a query view with a specified characteristic, select this specified characteristic in the Selected Objects tree structure, under This graphic is explained in the accompanying text Drilldown Characteristics. (A characteristic is specified when it is in the filter). To the right, the Name of Query View and This graphic is explained in the accompanying text specified characteristic is displayed.

       6.      In the Name of Query View screen area, under the Text group header, choose This graphic is explained in the accompanying text Edit. The Change Text for Alert Monitor dialog box appears.

       7.      Edit the alert text.

       8.      Choose This graphic is explained in the accompanying text Continue.

Changing a URL for the alert monitor

Alert monitor entries can also be given an URL of your choice. This function allows you to jump from the Alert Monitor not only into the current query view but also to any other resource you have chosen.

As a prerequisite for this function, you have to make an entry in the Action column (ACTION) of the Alert Monitor Web item at the List of Columns with Labels (COLUMN_LIST) attribute.

Note

If the current Alert Monitor entry was already given a URL, this is displayed in the Follow Up Action Properties or Name of Query View screen area, in the field under the URL group header.

...

       1.      In the Name of Query View or Follow Up Action Properties screen area, under the URL group header, choose This graphic is explained in the accompanying text Edit. The Change URL for Alert Monitor dialog box appears.

       2.      Enter the URL in the upper screen area. You can use This graphic is explained in the accompanying text to parameterize the URL with text variables.

Example

If you decide to specify a BW query as a resource, you use text variables to add filter values to the URL.

       3.      In the Short Text screen area, you can enter a text to appear as a quick info in the Alert Monitor.

Example

URL: www.sap.com

Short text: SAP Homepage

       4.      Choose This graphic is explained in the accompanying text Continue.

 

See also:

Example for Alert Texts

Structure linkAlert Monitor

 

End of Content Area