Setting the active scope - SmartPlant Foundation - IM Update 48 - 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)

Setting the active scope allows you to view, create, modify, and terminate data within the context of a selected configuration. Your role determines which features and commands are available in the selected configuration.

Active scope

Each user works in the context of two active scopes:

  • The query scope is used for all data queries and relationship expansions; it determines what objects you can see. The query scope can consist of more than one configuration.

  • The create scope is used for data creation, modification, and termination. The create scope is always one of the query configurations.

The highest level of the selected create configuration is displayed in the Desktop Client tree view. Only objects that support configurations can be part of the configuration tree. Typically, configuration trees contain plants and projects. In the following example, the create configuration, PlantA, is expanded to show its sub configurations, Projects 1-4.

SPF DTC WIN ConfigTreeView

When you select a create scope, any data you create becomes a part of that scope. For example, if you select PlantA, Project1 as your create scope, any data that you create is part of Project1 in PlantA.

When you select a query scope, you define the scope in which you want to conduct searches. For example, if you select PlantB as your query scope, searches only return data in PlantB.

When projects or sub-configurations exist under a plant and the query scope is set to a project, queries return objects in both the project and the plant. For example, if you set your query scope as Project 3 of PlantB, then your queries return objects that exist in either Project 3 or Plant B. If you want to return results only at the project level, select the Query by selected configurations only option on the Set Active Scope dialog box.

You can change your create or query scope at any time. However, you can only select from plants and projects to which you have access. Data created or modified within a project can be merged into the parent configuration. For more information, see Concurrent Engineering.

  • To see any sub configurations included in the current query scope, right-click the plant, and click Relations > Show Selected Query Sub Configurations.

  • To see any sub configurations available to include in the query scope, right-click the plant, and click Relations > Show Possible Query Sub Configurations.

Roles

Your role determines the features and commands available in the selected configuration. When you log on to the Desktop Client and set your active scope, you must select the appropriate role or roles for the available configurations.

Access to data in SmartPlant Foundation is controlled by a role-based security model that a system administrator defines. Role definitions determine user access to data and to functionality in SmartPlant Foundation. The system administrator assigns individual users to roles within specific plant/project configurations. Users can belong to more than one role per configuration.

For administrative information about defining roles, refer to How to Configure the Security Model.

Set Active Scope dialog box

Allows you to set the active scope for viewing, creating, modifying, and terminating data in SmartPlant Foundation. You can view data in any configuration or configurations selected in this dialog box, but you can select only one configuration to make changes in.

Set the Active Configuration by Query - Filters the list of available roles by first selecting the configurations in which you want to create or query data.

Set the Active Configuration by Roles - Filters the list of available configurations in which you want to create or query data, based on the roles you select.

Query scope - Lists plants and projects in which you can view data. If you select the Set the Active Configuration by Roles option, this list displays only the configurations for which you have been granted the roles selected in the Selected roles list.

Status filter - Defines the lifecycle status of configurations to be displayed in the Query scope list.

Clear Query Scope - Clears the currently selected query configurations.

Select All Top Level Configurations - Selects all the top level configurations or plants in the Query scope list.

Select Sub-Config for Checked Items - Selects all the sub configurations for the selected items in the Query scope list. For example, PlantA contains multiple projects under it. If you select this option, all the projects under that plant will be selected, but PlantA is not selected.

Query by selected configurations only - Restricts queries to only the selected configurations and not higher configurations. For example, if you select Project1 in PlantA with this option selected, your queries return only data from Project1, not from PlantA.

Selected roles - Lists roles available to you. If you select the Set the Active Configuration by Query option, this list is filtered to only those roles available to you for the configurations selected in the Query scope list.

Create scope - Defines the plant or project where you can create and update objects.