ROLESOF

 
SYNTAX:
 
FUNCTION ROLESOF ( V:GENERIC ENTITY ) : SET OF STRING;
 
The rolesof function returns a set of strings containing the fully qualified names of the roles played by the specified entity instance.
 
Parameters :
V is any instance of an entity data type.
 
Remarks:
 
A ROLE in Express is defined to be a string of the following format: 'EXPRESS_SCHEMA_NAME.ENTITY_NAME.ATTRIBUTE_NAME'. The ENTITY_NAME is the name of the entity that declares the actual attribute (ATTRIBUTE_NAME).
 
Given the following ifcbuildingstorey entity in "flatten entity format"
 
SCHEMA IFC2X3
   ENTITY ifcbuildingstorey;
        ENTITY ifcroot;
            globalid                                 :  IFCGLOBALLYUNIQUEID;
            ownerhistory                         :  ifcownerhistory;
            name                                      :  OPTIONAL IFCLABEL;
            description                             :  OPTIONAL IFCTEXT;
        ENTITY ifcobjectdefinition;
          INVERSE
            hasassignments                      :  SET OF  ifcrelassigns FOR relatedobjects;
            isdecomposedby                      :  SET OF  ifcreldecomposes FOR relatingobject;
            decomposes                              :  SET [0:1] OF ifcreldecomposes FOR relatedobjects;
            hasassociations                        :  SET OF  ifcrelassociates FOR relatedobjects;
        ENTITY ifcobject;
            objecttype                                    : OPTIONAL IFCLABEL;
          INVERSE
            isdefinedby                                 : SET OF ifcreldefines FOR relatedobjects;
        ENTITY ifcproduct;
            objectplacement                         : OPTIONAL ifcobjectplacement;
            representation                             : OPTIONAL ifcproductrepresentation;
          INVERSE
            referencedby                                : SET OF ifcrelassignstoproduct FOR relatingproduct;
        ENTITY ifcspatialstructureelement;
            longname                                     : OPTIONAL IFCLABEL;
            compositiontype                          : IFCELEMENTCOMPOSITIONENUM;
          INVERSE
            referenceselements                     : SET OF ifcrelreferencedinspatialstructure FOR relatingstructure;
            servicedbysystems                       : SET OF ifcrelservicesbuildings FOR relatedbuildings;
            containselements                         : SET OF ifcrelcontainedinspatialstructure FOR relatingstructure;
        ENTITY ifcbuildingstorey;
            elevation                                           : OPTIONAL IFCLENGTHMEASURE;
    END_ENTITY;
END_SCHEMA;
 
Examples of ROLES in ifcbuildingstorey:
 
'IFC2X3.IFCROOT.GLOBALID'                                              Not legal ROLE :  'IFC2X3.IFCBUILDINGSTOREY.GLOBALID'
'IFC2X3.IFCROOT.NAME'                                                       Not legal ROLE :  'IFC2X3.IFCBUILDINGSTOREY.NAME'
'IFC2X3.IFCOBJECTDEFINITION.DECOMPOSES'           Not legal ROLE :  'IFC2X3.IFCBUILDINGSTOREY.DECOMPOSES'
'IFC2X3.IFCBUILDINGSTOREY.ELEVATION'