IFC 4.3.x development

5.1.3.16 IfcPropertySetTemplate

Change log

IFC4

added

5.1.3.16.1 Semantic definitions at the entity

IfcPropertySetTemplate defines the template for all dynamically extensible property sets represented by IfcPropertySet. The property set template is a container of property templates within a property tree. The individual property templates are interpreted according to their Name attribute and shall have no values assigned.

NOTE  By convention an IfcPropertySetTemplate can also be used as a template for an IfcElementQuantity, being a particular type of a property set definition.

Property set templates can form part of a property library used and declared within a project. Depending on the TemplateType the IfcPropertySetTemplate defines a template for:

The inherited HasContext inverse relation to IfcRelDeclares is used to declare the IfcPropertySetTemplate within a project library. If included in an exchange data set it can then be traversed through the IfcProjectLibrary. The Defines inverse relation to IfcRelDefinesByTemplate is provided to keep the definition relationship between the IfcPropertySetTemplate and the one to many IfcPropertySet's, for which it provides the template. Figure 1 illustrates relationships used for property set templates.

 

"property set template"

Between IfcProperty's within the HasProperties set of IfcPropertySet having the same Name attribute value as the IfcPropertyTemplate's within the HasPropertyTemplates set of IfcPropertySetTemplate an implicit definition relationship is established that assigns the template to the individual properties.

HISTORY  New entity in IFC4.

5.1.3.16.1 Attributes

# Attribute Type Description
IfcRoot
1 GlobalId IfcGloballyUniqueId Assignment of a globally unique identifier within the entire software world.
2 OwnerHistory OPTIONAL IfcOwnerHistory Assignment of the information about the current ownership of that object, including owning actor, application, local identification and information captured about the recent changes of the object,

> NOTE  only the last modification in stored - either as addition, deletion or modification.

> IFC4 CHANGE  The attribute has been changed to be OPTIONAL.
3 Name OPTIONAL IfcLabel Optional name for use by the participating software systems or users. For some subtypes of IfcRoot the insertion of the Name attribute may be required. This would be enforced by a where rule.
4 Description OPTIONAL IfcText Optional description, provided for exchanging informative comments.
IfcPropertyDefinition
HasContext SET [0:1] OF IfcRelDeclares FOR RelatedDefinitions
HasAssociations SET [0:?] OF IfcRelAssociates FOR RelatedObjects Reference to the relationship IfcRelAssociates and thus to those externally defined concepts, like classifications, documents, or library information, which are associated to the property definition.
IfcPropertyTemplateDefinition
IfcPropertySetTemplate
5 TemplateType OPTIONAL IfcPropertySetTemplateTypeEnum Property set type defining whether the property set is applicable to a type (subtypes of IfcTypeObject), to an occurrence (subtypes of IfcObject), or as a special case to a performance history.



The attribute ApplicableEntity may further refine the applicability to a single or multiple entity type(s).
6 ApplicableEntity OPTIONAL IfcIdentifier The attribute optionally defines the data type of the applicable type or occurrence object, to which the assigned property set template can relate. If not present, no instruction is given to which type or occurrence object the property set template is applicable. The following conventions are used:

* The IFC entity name of the applicable entity using the IFC naming convention, CamelCase with IFC prefix

* It can be optionally followed by the predefined type after the separator "/" (forward slash), using upper case

* If a performance history object of a particular distribution object is attributes by the property set template, then the entity name (and potentially amended by the predefined type) is expanded by adding '[PerformanceHistory]'

* If one property set template is applicable to many type and/or occurrence objects, then those object names should be separate by comma "," forming a comma separated string.

> EXAMPLE Refering to a boiler type as applicable entity would be expressed as 'IfcBoilerType', refering to a steam boiler type as applicable entity would be expressed as 'IfcBoilerType/STEAM', refering to a wall and wall standard case and a wall type would be expressed as 'IfcWall, IfcWallStandardCase, IfcWallType'. An applicable IfcPerformanceHistory assigned to an occurrence or type object would be indicated by IfcBoilerType[PerformanceHistory], or respectively IfcBoilerType/STEAM[PerformanceHistory].
7 HasPropertyTemplatesSET [1:?] OF IfcPropertyTemplate Set of IfcPropertyTemplate's that are defined within the scope of the IfcPropertySetTemplate.
Defines SET [0:?] OF IfcRelDefinesByTemplate FOR RelatingTemplateRelation to the property sets, via the objectified relationship IfcRelDefinesByTemplate, that, if given, utilize the definition template.

5.1.3.16.2 Entity inheritance

dot_inheritance IfcPropertySetTemplate IfcPropertySetTemplate IfcPropertyTemplateDefinition IfcPropertyTemplateDefinition IfcPropertySetTemplate->IfcPropertyTemplateDefinition IfcPropertyTemplate IfcPropertyTemplate IfcPropertyTemplate->IfcPropertyTemplateDefinition IfcPropertyDefinition IfcPropertyDefinition IfcPropertyTemplateDefinition->IfcPropertyDefinition IfcPropertySetDefinition IfcPropertySetDefinition IfcPropertySetDefinition->IfcPropertyDefinition IfcRoot IfcRoot IfcPropertyDefinition->IfcRoot IfcObjectDefinition IfcObjectDefinition IfcObjectDefinition->IfcRoot IfcRelationship IfcRelationship IfcRelationship->IfcRoot

5.1.3.16.3 Definitions applying to General Usage

5.1.3.16.3.1 Identity

IfcRoot assigns the globally unique ID. In addition it may provide for a name and a description about the concept.

5.1.3.16.3.2 Revision Control

Ownership, history, and merge state is captured using IfcOwnerHistory.

5.1.3.16.4 Formal representations

ENTITY IfcPropertySetTemplate
 SUBTYPE OF (IfcPropertyTemplateDefinition);
	TemplateType : OPTIONAL IfcPropertySetTemplateTypeEnum;
	ApplicableEntity : OPTIONAL IfcIdentifier;
	HasPropertyTemplates : SET [1:?] OF IfcPropertyTemplate;
 INVERSE
	Defines : SET [0:?] OF IfcRelDefinesByTemplate FOR RelatingTemplate;
 WHERE
	ExistsName : EXISTS(SELF\IfcRoot.Name);
	UniquePropertyNames : IfcUniquePropertyTemplateNames(HasPropertyTemplates);
END_ENTITY;