The AF Attribute Excluded Property

Blog Post created by dfsoll on Nov 1, 2017

Each AF attribute has a set of properties associated with it.  Beginning with PI-AF version 2015 (, there is an "Excluded" property.  This property allows the exclusion of a property from the AF database.


Why would you want to exclude a property rather than just removing it?  The primary purpose of having the Excluded property is to allow attributes that were defined in an AF Element Template be excluded from a particular instance of an element that is derived from a template.


Here's an example: Suppose that you wanted to create a template of a computer and you were defining attributes for the disk drives, let's say, the size of the disk.  You could create an attribute in the template named "Drive C: Size", which will work fine, but many computers also have a D: drive.  Previous to AF 2015, you would either create an additional attribute in the element that is not inherited from the template, or create a "Drive D: Size" in the template and set the value to 0 for those computers that don't have a D: drive.  In AF 2015 or greater, you can create the "Drive D: Size" in the template and simply mark it as "Excluded" in the elements for computers without a D: drive.


Attributes in a template can be marked as "Excluded", then the exclusion can be turned off once instantiated in an element or the attribute in the template is not excluded but in the inherited element you can exclude it.


Note that the PI System Explorer, by default, show excluded attributes.  This can be disabled (or enabled) by clicking on the "Tools - Options" menu option and clicking on the "Show Excluded Attributes" check box.