Configure dependent and multiple dependent display items - HxGN SDx - Update 63 - Administration & Configuration

Administration and Configuration of HxGN SDx

Language
English
Product
HxGN SDx
Search by Category
Administration & Configuration
SmartPlant Foundation / SDx Version
10

You can configure display items to be dependent on other display items. For example, you can make a list of users available to be selected dependent on their organization; or you can make a list of available users dependent on their organization and their role.

UserRel is a display item type that behaves similar to a display item type that is created from a relationship definition. The UserRel display item type lets you specifically filter users to a specific plant configuration.

  • If UserRel is configured as an independent display item type, it displays only users with any valid role in the create scope, or plant.

  • If UserRel is configured to be dependent on an organization, then it displays all users in that organization with a valid role in the create scope.

  • If UserRel is configured to be dependent on a role, then it displays all users with the selected role in the create scope. This can be done either by creating a dependency to a role display item or by linking the display item explicitly to a role.

The relationship allows you to define a specific role that the user must have in the create scope. For example, if the list of available users needs to be dependent on the organization, the software traverses the relationship between the two and lists only the users that are in the organization and have any roles assigned to them in the active create scope configuration.

The software supports multiple dependences in which the users listed are dependent on both the organization and a role.

  • SPFDisplayItemDependentItem is the primary relationship definition used to filter a list.

    The software also supports a relationship between SPFDisplayItemDependentItem and display item types created from an edge definition. For example, in the Project Communication feature set, the Organization display item is dependent on the Contract display item. Both displays items are created using the edge definition display item type. When Contract is selected, the To organization and From Organization lists are populated based on the selected contract.

  • SPFDisplayItemSecondaryDependentItem is a new relationship definition that further filters display items available from a list.

Example for creating a multiple dependency relationship

The following example shows how to create the relationship between the organization, role, and user for use on a Project Communication form.

  1. Drag the organization display item to the user display item to create the primary relationship.

  2. Drag the role display item onto the user display item to create the secondary relationship.

The three display items are now related in the following ways.

  • The To organization and To role are parent display items to the To user display item.

  • The To organization display item is related to the To user display item using the SPFDisplayItemDependentItem relationship definition.

  • The To role and the To user display items are related using the SPFDisplayItemSecondaryDependentItem.

When the To organization is selected, the software expands the primary relationship definition and enables the To user dependent list. If only the To role is selected and To organization is not selected, the To user list is not populated because the To role is a secondary display item and the To organization is the primary display item.

Below is the schema for the SPFDisplayItemSecondaryDependentItem.

<RelDef>

<IObject UID="SPFDisplayItemSecondaryDependentItem" Name="SPFDisplayItemSecondaryDependentItem" Description="Secondary Dependency between display items" />

<IRelDef2 Copy12="CopyRelationship" />

<ISPFRelDefExt />

<IRel UID1="ISPFDisplayItem" UID2="ISPFDisplayItem" />

<IRelDef End1Locality="AcrossComponent" Max2="*" Role2="Secondary Dependent Items" Role2DisplayName="Secondary Dependent Display Items" Max1="*" Min1="0" Role1="Dependent Item" LinkInterfaces="ISPFDependentItem" Role1DisplayName="Depends on Secondary Display Item" End2Locality="AcrossComponent" Min2="0" />

<ISchemaObj />

</RelDef>