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.IINT1ISABUB
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 / OPPIDL / 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_PIDL,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