Struct Ifc4x1::IfcChangeActionEnum

Nested Relationships

This struct is a nested type of Struct Ifc4x1.

Struct Documentation

struct Ifc4x1::IfcChangeActionEnum

Public Types

enum Value

IfcChangeActionEnum identifies the type of change that might have occurred to the object during the last session (for example, added, modified, deleted). This information is required in a partial model exchange scenario so that an application or model server will know how an object might have been affected by the previous application. Valid enumerations are:

NOCHANGE: Object has not been modified.

MODIFIED: A modification to the object has been made by the user and application defined by the LastModifyingUser and LastModifyingApplication respectively.

ADDED: The object has been created by the user and application defined by the OwningUser and OwningApplication respectively.

DELETED: The object has been deleted by the user and application defined by the LastModifyingUser and LastModifyingApplication respectively.

NOTDEFINED: The change action is not known or has not been defined.

Consider Application A will create an IFC dataset that it wants to publish to others for modification and have the ability to subsequently merge these changes back into the original model. Before publication, it may want to set the IfcChangeActionEnum to NOCHANGE to establish a baseline so that other application changes can be easily identified. Application B then receives this IFC dataset and adds a new object and sets IfcChangeActionEnum to ADDED with Application B defined as the OwningApplication. Application B then modifies an existing object and (re)defines the LastModifiedDate to the time of the modification, LastModifyingUser to the IfcPersonAndOrganization making the change, and sets the LastModifyingApplication to Application B. When Application A receives this modified dataset, it can determine which objects have been added and modified by Application B and either merge or reject these changes as necessary. Consequently, the intent is that an application only modifies the value of IfcChangeActionEnum when it does something to the object, with the further intent that a model server is responsible for clearing the IfcChangeActionEnum back to NOCHANGE when it is ready to be republished.

HISTORY: New enumeration in IFC R2.0. Modified in IFC2x4.

Values:

enumerator IfcChangeAction_NOCHANGE
enumerator IfcChangeAction_MODIFIED
enumerator IfcChangeAction_ADDED
enumerator IfcChangeAction_DELETED
enumerator IfcChangeAction_NOTDEFINED

Public Static Functions

IFC_PARSE_API const char *ToString(Value v)
IFC_PARSE_API Value FromString(const std::string &s)