The Monitor action type must specify one or more monitor definition blocks in the configuration XML. Each monitor block is contained within the <Monitors> element. Each <Monitors> element contains one or more <Monitor> blocks, each containing one or more <Conditions> and <Actions>. And each of these elements may contain one or more <Condition> and/or <Action> to perform.
To learn about how these elements relate to other elements in a well test configuration XML structure, see Well Test Hierarchy.
Example
|
<Action type="Monitor" timeout="0" sleeptime="5000"> <Monitors> <Monitor> <Conditions> <Condition operator="=" value1="1" value1relativeFacilityLink="" value1type="Self" value2="PONEWTST" value2relativeFacilityLink="Separator" value2type="UDC" /> </Conditions> <Actions> <Action type="SetPoint" udc="MSG" relativeFacilityLink="Separator" valueType="Text" attribute="" value="Monitor 1" /> </Actions> </Monitor> <Monitor> <Conditions> <Condition operator="CHANGED" value1="PONEWTST" value1relativeFacilityLink="Separator" value1type="UDC" value2="" value2relativeFacilityLink="" value2type="" /> </Conditions> <Actions> <Action type="SetPoint" udc="MSG" relativeFacilityLink="Separator" valueType="Text" attribute="" value="Monitor 2" /> </Actions> </Monitor> </Monitors> </Action> |
The <Conditions> element has one type of child element, <Condition>, and has no attributes.
The <Conditions> element has the following properties:
| Property | Description |
|---|---|
|
Case Sensitive |
Yes |
|
Required |
Yes |
|
Number of Instances Allowed |
Unlimited |
|
Parent Element |
<Monitor> |
|
Child Elements |
<Condition> |
|
Attributes |
None |
A Condition is used to compare two values or to monitor for a change on point value, and if true, perform an action.
The <Condition> element has the following properties:
| Property | Description |
|---|---|
|
Case Sensitive |
Yes |
|
Required |
Yes |
|
Number of Instances Allowed |
Unlimited |
|
Parent Element |
<Conditions> |
|
Child Elements |
None |
|
Attributes |
operator value1 value1Type value1RelativeFacilityLink value2 value2Type value2RelativeFacilityLink |
The <Condition> element has the following attributes:
| Attribute | Required | Description |
|---|---|---|
|
operator |
No |
Specifies the operation used for the comparison. Acceptable values include:
|
|
value1 |
Yes |
Specifies the first value to use when comparing the point value in the expression:
|
|
value1Type |
Yes |
Specifies the first value Type (value1Type) property. Options include Self or UDC. |
|
value1RelativeFacilityLink |
No |
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. |
|
value2 |
Yes |
Specifies the second value to use when comparing the point value in the expression:
|
|
value2Type |
Yes |
Specifies the second value Type (value2Type) property. Options include Self or UDC. |
|
value2RelativeFacilityLink |
No |
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. |