Commands for Exceptions 
Definition
Command for a data provider.
Use
'You can change existing (local) exceptions and define new (local) ones with this command.
Exceptions that were defined in the Query Designer cannot be changed.
Structure
CMD |
SET_EXCEPTION |
Parameter |
Description |
EXCEPTION_ID (optional) |
ID of the exception to be changed If there is no exception with this ID, a new one is created. A new exception is also created if this parameter is not filled. For how to determine the Exception_ID, see the notes below. |
ACTIVE 'X' = Yes, ' ' = No |
Exception active |
DESCRIPTION |
Description This text is displayed in the list of exceptions. |
IOBJNM_I |
Context in which a characteristic must be The exception is only evaluated if the data cell for the given characteristic is in the context described by parameters OPERATOR and VALUE. |
STRUCTURE_MEMBER_1 Values: ‘UID’ or ‘ALL’
STRUCTURE_NAME_1
|
Structural component of the first structure If the exception refers to one specific structural component, you have to specify this by entering the unique ID (UID). This is the 25 character string. If the exception refers to all structural elements and you have assigned the value ‘ALL’ to the STRUCTURE_MEMBER parameter, you also have to specify the parameter STRUCTURE_NAME_1 by entering the structure name (25 character string). |
STRUCTURE_MEMBER_2 STRUCTURE_NAME_2 |
Component of the second structure See the remarks on STRUCTURE_MEMBER_1. |
RELATIVE_VALUES (optional) |
Validity area for all characteristics not listed If you assign the value ‘X’ to the parameter, the values for all characteristics that are not listed can be arbitrary. This is to be recommended for relative values such as, for example, percentage deviations. If you assign the value ‘ ’ to the parameter, all characteristics that are not listed have to be aggregated. The exception is only valid fort he aggregated values of the characteristics that are not listed. See Defining Exceptions. |
OPERATOR_I |
Context in which a characteristic must be Valid operators are: 'AL' = No restrictions 'AG' = Aggregated (no filtering) 'EQ' = A certain value 'NA' = Restricted to a value 'HL' = Hierarchy level |
VALUE_I |
Context in which a characteristic must be Key of the characteristic value if operator 'EQ' and hierarchy level if operator 'HL'. |
ALERT_LEVEL_J |
Alert Level The alert level can have the values 1, 2 and 3 for good numbers, 4, 5 and 6 for critical numbers and 7, 8, and 9 for bad numbers. |
OPERATOR_J |
Operator for the data values 'EQ' = Equal to 'NE' = Not equal to 'BT' = Interval 'LE' : Less than or equal to 'LT' = Less than 'GE' : Greater than or equal to 'GT' = Greater than |
VALUE_LOW_J |
Data cell value |
VALUE_HIGH_J |
Data cell value to This parameter is only needed for interval operators. |
To determine the Exception_ID, proceed as follows:
· Create a Web application with the List of Exceptions Web item.
· Call the Web application and deactivate the snippet operations (SNIPPET_OPERATIONS=' ') in the Web application URL.
·
Choose
Activate or Deactivate in the context menu for the List of
Exceptions or
choose 
(Activate/Deactivate).
You can now see the Exception_ID in the URL. Alternatively, you can also see the Exception_ID in the source code for the Web application (View Source).