Well Test Config - Point Value Compare Action Type

Point Value Compare Action Type

The Point Value Compare (PointValueCompare) action type is used to compare two values and perform an action, if true. The values used in the comparison can be either from a point or a hard-coded value.

The PointValueCompare action type supports the configuration of true and false actions, these will be executed if the comparative expression is evaluated as true and/or false. If the expression evaluated is true, the action defined in the True Action property will be executed. Similarly, if the expression evaluated is false, the action defined in the False Action property will be executed. In the XML configuration these conditional actions are specified in the <TrueAction> and <FalseAction> elements.

Note: It is possible (and probable) to have nested Point Value Compare actions. There is no limit to the number of nested levels.

Click the following image for more information:

Sample Point Value Compare Action Configuration

To configure a Point Value Compare action

A Point Value Compare action type can be configured from several different places within the well test configuration control. However, the base configuration is always the same. Perform the following steps to configure this type of action, referring to the property definitions below:

Click to Add action from the drop-down menu.

Select the Point Value Compare action type from the Action type list. The action's properties will appear on the right.

Configure the properties for the first value in the comparison:

Select the Type for the value: Self or UDC.

Specify the Value to be used when comparing the points.

If the Type is Self, enter an alphanumeric value.

If the Type is UDC, click the browse button to open the Select UDC dialog box and select an appropriate UDC.

Optional. Select a relative facility tag from the Relative facility link drop-down menu. Note: If the Type is set to Self, the Relative facility link property is hidden from view.

Select the desired Operator from the drop-down menu.

Configure the properties for the second value in the comparison, as described in steps 3 and 4 above.

Indicate the True action to execute, if the expression evaluated in the Point Value Compare action is true.

Indicate the False action to execute, if the expression evaluated in the Point Value Compare action is false.

Click OK to accept the configuration.

Action Properties

The properties for the Point Value Compare action type are described below.

Property	Description	XML
Type	Specifies the action type for the action.	type
Value 1
Value	Specifies the first value to use when comparing the point value in the expression: if the Value 1 Type (value1Type) is Self, then the value of this property will be used in the comparison. if the Value 1 Type (value1Type) is UDC, then the value from the point will be used in the comparison. Click the browse button to open the Select UDC dialog box and select an appropriate UDC.	value1
Type	Specifies the first value Type (value1Type) property. Options include Self or UDC.	value1Type
Relative facility link	Specifies the first relative facility tag to use for the action. Note: The facility tag used as the starting point for the relative resolution depends on where this action type is configured. If the action is defined at a position level, then the base facility tag will be the well facility. If defined at the header level, the base facility will be the header facility. Note: If the Type is set to Self, the Relative facility link property is hidden from view.	value1RelativeFacilityLink
Operator	Specifies the operation used for the comparison. Acceptable values include: Equal — = (operator="=") Greater than — > (operator=">") Greater than or equal — >= (operator=">=") Less than — < (operator="<") Less than or equal — <= (operator="<=") Not equal — <> (operator="<>")	operator
Value 2
Value	Specifies the second value to use when comparing the point value in the expression: if the Value 2 Type (value2Type) is Self, then the value of this property will be used in the comparison. if the Value 2 Type (value2Type) is UDC, then the value from the point will be used in the comparison. Click the browse button to open the Select UDC dialog box and select an appropriate UDC.	value2
Type	Specifies the second value Type (value2Type) property. Options include Self or UDC.	value2Type
Relative facility link	Specifies the second relative facility tag to use for the action. Note: The facility tag used as the starting point for the relative resolution depends on where this action type is configured. If the action is defined at a position level, then the base facility tag will be the well facility. If defined at the header level, the base facility will be the header facility. Note: If the Type is set to Self, the Relative facility link property is hidden from view.	value2RelativeFacilityLink
True action	A True action can be configured for a Point Value Compare action type. If the expression evaluated in the Point Value Compare action is true, the specified action type will be executed. To add a true action Click to add an action if the evaluated expression is true. Select the appropriate action from the drop-down menu. Options include: Exit Action Type Header Command Action Type Monitor Action Type Point Value Compare Action Type Script Action Type Set Point Action Type Test Action Type UIS Command Action Type Click or the action type name to edit the action. Click to delete the action type, as necessary. Repeat to add as many actions as required. See each action type listed above for user assistance.	<TrueAction>
False action	A False action can be configured for a Point Value Compare action type. If the expression evaluated in the Point Value Compare action is false, the specified action type will be executed. To add a false action Click to add an action if the evaluated expression is false. Select the appropriate action from the drop-down menu. Options include: Exit Action Type Header Command Action Type Monitor Action Type Point Value Compare Action Type Script Action Type Set Point Action Type Test Action Type UIS Command Action Type Click or the action type name to edit the action. Click to delete the action type, as necessary. Repeat to add as many actions as required. See each action type listed above for user assistance.	<FalseAction>

Property

Description

XML

Type

Specifies the action type for the action.

type

Value 1

Value

Specifies the first value to use when comparing the point value in the expression:

if the Value 1 Type (value1Type) is Self, then the value of this property will be used in the comparison.
if the Value 1 Type (value1Type) is UDC, then the value from the point will be used in the comparison. Click the browse button to open the Select UDC dialog box and select an appropriate UDC.

value1

Type

Specifies the first value Type (value1Type) property. Options include Self or UDC.

value1Type

Relative facility link

Specifies the first relative facility tag to use for the action.

Note: The facility tag used as the starting point for the relative resolution depends on where this action type is configured. If the action is defined at a position level, then the base facility tag will be the well facility. If defined at the header level, the base facility will be the header facility.

Note: If the Type is set to Self, the Relative facility link property is hidden from view.

value1RelativeFacilityLink

Operator

Specifies the operation used for the comparison. Acceptable values include:

Equal — = (operator="=")
Greater than — > (operator=">")
Greater than or equal — >= (operator=">=")
Less than — < (operator="<")
Less than or equal — <= (operator="<=")
Not equal — <> (operator="<>")

operator

Value 2

Value

Specifies the second value to use when comparing the point value in the expression:

if the Value 2 Type (value2Type) is Self, then the value of this property will be used in the comparison.
if the Value 2 Type (value2Type) is UDC, then the value from the point will be used in the comparison. Click the browse button to open the Select UDC dialog box and select an appropriate UDC.

value2

Type

Specifies the second value Type (value2Type) property. Options include Self or UDC.

value2Type

Relative facility link

Specifies the second relative facility tag to use for the action.

Note: If the Type is set to Self, the Relative facility link property is hidden from view.

value2RelativeFacilityLink

True action

A True action can be configured for a Point Value Compare action type. If the expression evaluated in the Point Value Compare action is true, the specified action type will be executed.

To add a true action

Click to add an action if the evaluated expression is true.

Select the appropriate action from the drop-down menu. Options include:

Click or the action type name to edit the action.
Click to delete the action type, as necessary.
Repeat to add as many actions as required.
See each action type listed above for user assistance.

False action

A False action can be configured for a Point Value Compare action type. If the expression evaluated in the Point Value Compare action is false, the specified action type will be executed.

To add a false action

Click to add an action if the evaluated expression is false.

Select the appropriate action from the drop-down menu. Options include:

Click or the action type name to edit the action.
Click to delete the action type, as necessary.
Repeat to add as many actions as required.
See each action type listed above for user assistance.