Select language:
Entering content frame!--a11y-->

Object documentation Commands for Exceptions 

Definition

Command for a data provider.

Use

'You can change existing (local) exceptions and define new (local) ones with this command.

Note

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.

Note

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 This graphic is explained in the accompanying text (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).

 

 

 

 

Leaving content frame