ForceNullConfig - SmartPlant Foundation - IM Update 46 - Help - Hexagon

SmartPlant Foundation Help

Language
English
Product
SmartPlant Foundation
Search by Category
Help
SmartPlant Foundation / SDx Version
10
SmartPlant Markup Plus Version
10.0 (2019)
Smart Review Version
2020 (15.0)

When a relationship is created between two objects, the following rule applies:

  • If either of the two objects being related have a configuration, the relationship is stamped with the current create configuration.

    For example, when working in a project and relating a label (configuration independent) to a document (configuration controlled), the relationship is stamped with the project configuration.

When a relationship is expanded, the following rules apply:

  • If the object being expanded has a query context, the query for the related objects is performed in the context of that configuration.

  • If the object being expanded has no query context, the query for the related objects is performed in the context of the selected query scope.

The following situations describe when relationships are created differently:

Relationship creation

When creating relationships between objects with a configuration and those without, the relationship is stamped with the current create configuration forcing relationship expansion to be in this context. In some cases, this results in not finding the related objects.

  • By setting the ForceNullConfig flag on the relationship, the relationship is created with no configuration, which ensures the relationship is expanded in the context of the current query scope.

  • SPFRoleAssignmentConfigItem is configured with ForceNullConfig=True so that when expanding up the role assignment, the system can retrieve the configuration items.

Relationship expansion

When you expand the relationships between administration objects and you have multiple query scopes set, the results will appear in separate windows for each configuration set. For example, query for a Client API with multiple query configurations. A flag on the query method ensures that only one list view is displayed but Show Methods results in multiple list views of methods, one for each query configuration set.

To get around this:

  • When expanding relationships between configuration independent items like administration objects, to avoid seeing multiple list views, set the ForceNullConfig flag on the Relationship Definition.

Most administration relationships such as SPFClientAPIMethods are configured in this way.