Dimension
A dimension is an Entity Type used to define an organizational filter for the Usercube role model.
Examples
The following XML fragment defines the dimension Organization0. The dimension values are of
Directory_Organization type. The ColumnMapping attribute specifies the column (0 to 127) used to
store the dimension value in the assignment rule tables.
**<Dimension Identifier="Organization0" DisplayName_L1="Department" EntityType="Directory_Organization" ColumnMapping="0" />**
Some types of entities can be organized in a hierarchical tree structure. Thus, for example,
organizational units form a tree structure modeled by a Parent navigation property that links the
entity type to itself. It is possible to use the hierarchical aspect of a dimension in an assignment
rule criterion. For example, the assignment must be extended to the whole subunits of a department.
Such a dimension must be declared as a hierarchical dimension by specifying the attribute
IsHierarchical="true".
<Dimension Identifier="Organization0" DisplayName_L1="Department" EntityType="Directory_Organization" ColumnMapping="0" IsHierarchical="true" ParentProperty="Parent" /><EntityType Identifier="Directory_Organization" DisplayName_L1="Department">...
<Property Identifier="Path" DisplayName_L1="Path" Type="String" TargetColumnIndex="6" /> <Property Identifier="Parent" DisplayName_L1="Parent Department" Type="ForeignKey" TargetColumnIndex="128" />...
</EntityType>
The attribute ParentProperty specifies the navigational property defining the hierarchy (Parent
is the navigation property that links the Directory_Organization type to itself).
Properties
| Property | Details |
|---|---|
| ColumnMapping required | Type Int32 Description Specifies the corresponding column in the role model rules. |
| DisplayName_L1 optional | Type String Description Display name of the dimension in language 1 (up to 16). |
| EntityType required | Type Int64 Description References the linked entity type. |
| Identifier required | Type String Description Unique identifier of the dimension. |
| IsExcludedFromRoleMining default value: false | Type Boolean Description true to exclude the dimension from role mining. It means that the dimension is not used as a criteria in the generated rules. |
| IsHierarchical default value: false | Type Boolean Description true to define a hierarchical dimension. Note: Cannot be used without ParentProperty. |
| ParentProperty optional | Type Int64 Description Specifies the navigational property defining the hierarchy. |