Instrument Bubbles

Contents

Bubble tag type list

Instrument Annotation Bubble class

Instrument Bubble types

Instrument Field location and type

XML

Database

InRun Instrument Bubble Annotation (Control Valve, Flow Element)

Bubble tag type list

This list is needed to test for bubble annotation. Control valves, flow elements are instruments and have bubble annotation. Instruments AT_INST_ do not have to annotation bubbles

<ECClasstypeName="BUBBLE_TAG_TYPES" description="The list of tag types that will use the intelligent OPPID bubble. Control valves and flow elements use an annotation bubble that is not the main tagged component." displayLabel="Bubble tag types" isDomainClass="True">

<BaseClass>SUPPORT_LISTS</BaseClass

<ECCustomAttributes

<String_Collectionxmlns="AutoPLANT_PID_Conversion.01.01">

<Strings>

<string>AT_INST_</string>

<string>AT_TIEIN</string>

<string>AT_SPEC_ITEM</string>

</Strings>

</String_Collection

</ECCustomAttributes

</ECClass

Instrument Annotation Bubble class

This class is the default

<ECClasstypeName="INSTRUMENT_BUBBLE_ANNOTATION_CLASS" description="Default Bubble Annotation class for COntrol valves, Flow elements" displayLabel="Default Bubble Annotation Class" isDomainClass="True">

<ECCustomAttributes

<Bubble_Annotation_Classxmlns="AutoPLANT_PID_Conversion.01.01">

<Bubble_Class>DISCRETE_ANNOTATION</Bubble_Class

</Bubble_Annotation_Class

</ECCustomAttributes

</ECClass

The custom attribute can be added to individual classes to give a unique Bubble annotation

<ECCustomAttributes

<Bubble_Annotation_Classxmlns="AutoPLANT_PID_Conversion.01.01">

<Bubble_Class>DISCRETE_ANNOTATION</Bubble_Class

</Bubble_Annotation_Class

</ECCustomAttributes

Instrument Bubble types

The type of instrument bubble is stored in the INSTR.IINT1 column. There are matching conversion classes for each type. If any user instrument bubbles are added in APPID, the name would be stored in this field after APPID placement.

INSTR.IINT1
ISABUB
ISADCD

Instrument Field location and type

The APPID locations are from the INSTR.ILOC_PID column. The conversion uses the first char from this value: L,HEX. The L would be used in the match, The OPPID numeric value comes from the INSTRUMENT_BUBBLE_LOCATIONS_LIST class in the Supplemental schema

APPID / OPPID
L / 1
C / 2
P / 4
R / 8
B / 16

XML

<Instrument_Location_Mapping_Attributexmlns="AutoPLANT_PID_Conversion.01.01">

<Locations>

<Instrument_Location_Mapping_Structure

APPID_ValueL</APPID_Value

<OPPID_Value1</OPPID_Value

</Instrument_Location_Mapping_Structure

<Instrument_Location_Mapping_Structure

<APPID_ValueC</APPID_Value

OPPID_Value2</OPPID_Value

</Instrument_Location_Mapping_Structure

<Instrument_Location_Mapping_Structure

APPID_ValueP</APPID_Value

OPPID_Value4</OPPID_Value

</Instrument_Location_Mapping_Structure

<Instrument_Location_Mapping_Structure

<APPID_ValueR</APPID_Value

OPPID_Value8</OPPID_Value

</Instrument_Location_Mapping_Structure

<Instrument_Location_Mapping_Structure

APPID_ValueB</APPID_Value

OPPID_Value16</OPPID_Value

</Instrument_Location_Mapping_Structure

</Locations>

</Instrument_Location_Mapping_Attribute

Database

INSTR.ILOC_PID
L,HEX
C,HEX
P,HEX
R,HEX
B,HEX

InRun Instrument Bubble Annotation (Control Valve, Flow Element)

Control valves and flow elements have bubble annotation that is a class on to itself. The Default class that defines which OPPID class to use is called “INSTRUMENT_BUBBLE_ANNOTATION_CLASS”. This class contains the OPPID under the custom attribute “Bubble_Annotation_Class” and the mapping for the alias properties (DEVICE_TYPE_CODE=TEXT1, NUMBER,TEXT2) which are stored in the PROPERTY_MAPPING_ATTRIBUTE custom attribute.

<ECClasstypeName="INSTRUMENT_BUBBLE_ANNOTATION_CLASS" description="Default Bubble Annotation class for Control valves, Flow elements" displayLabel="Default Bubble Annotation Class" isDomainClass="True">

<BaseClass>SUPPORT_LISTS</BaseClass

<ECCustomAttributes

<Bubble_Annotation_Classxmlns="AutoPLANT_PID_Conversion.01.01">

<Bubble_ClassDISCRETE_ANNOTATION</Bubble_Class

</Bubble_Annotation_Class

<PROPERTY_MAPPING_ATTRIBUTE xmlns="AutoPLANT_PID_Conversion.01.01">

<ITEM>

<PROPERTY_MAPPING_STRUCTURE>

<SOURCE_PROPERTY>DEVICE_TYPE_CODE</SOURCE_PROPERTY>

<TARGET_PROPERTY>TEXT1</TARGET_PROPERTY>

</PROPERTY_MAPPING_STRUCTURE>

<PROPERTY_MAPPING_STRUCTURE>

<SOURCE_PROPERTY>NUMBER</SOURCE_PROPERTY>

<TARGET_PROPERTY>TEXT2</TARGET_PROPERTY>

</PROPERTY_MAPPING_STRUCTURE>

</ITEM>

</PROPERTY_MAPPING_ATTRIBUTE>

</ECCustomAttributes

</ECClass

Each Intelligent class can contain a pointer to its own “Instrument bubble annotation class”.

<ECClasstypeName="AP_32100" displayLabel="Angle" isDomainClass="True">

<BaseClass>AT_HVALVE</BaseClass

<ECCustomAttributes

<CLASS_MAPPING_ATTRIBUTE xmlns="AutoPLANT_PID_Conversion.01.01">

<TARGET_CLASSNAME>ANGLE_VALVE</TARGET_CLASSNAME>

<PROPERTY_MAPPING_CLASSNAME>VALVE_MAPPING</PROPERTY_MAPPING_CLASSNAME>

<ALTERNATE_TARGET_CLASS>ANGLE_CONTROL_VALVE</ALTERNATE_TARGET_CLASS>

<ALTERNATE_PROPERTY_MAPPING_CLASSNAME>INSTRUMENT_MAPPING</ALTERNATE_PROPERTY_MAPPING_CLASSNAME>

<IS_INRUN>True</IS_INRUN>

</CLASS_MAPPING_ATTRIBUTE>

Bubble_Annotation_Classxmlns="AutoPLANT_PID_Conversion.01.01">

<Bubble_ClassINSTRUMENT_BUBBLE_ANNOTATION_CLASS</Bubble_Class

</Bubble_Annotation_Class

</ECCustomAttributes

</ECClass