Domain Definition Window (System Administration) - Intergraph Smart Instrumentation - 13.1 - Administration & Configuration - Hexagon

Intergraph Smart Instrumentation Administration

English (United States)
Intergraph Smart Instrumentation
Search by Category
Administration & Configuration
Smart Instrumentation Version

Enables the System Administrator to define a new domain or modify the definitions for an existing domain. To access this window, with the System Administration window open, click File > Domain.  The options in the window become accessible after you select an existing domain and click Edit icon 16bit.

Domain — Select a domain from this list or type a new domain name as needed.

Number — Type a number for the domain if required.

Description — Type a short description of the domain, if needed.

Administrator — Select a user who will be the Domain Administrator.

Domain schema name — Displays the Domain schema logon name.  You cannot change the logon name. It is created during domain initialization.

Plant hierarchy separator — Type a character for use as the separator that appears where all or part of a plant hierarchy is displayed as a string.  For example, if the separator character is &, and you have plant hierarchy items My Plant, My Area, and My Unit, in the Properties dialog box for the My Unit item, the software displays the parent hierarchy as My Plant&My Area.

If working in an integrated environment, you cannot use a forward slash (/) as a plant hierarchy separator.

Domain type

Select the domain type depending on the activities you want to perform in your engineering plants.

Engineering company — Such a domain is usually contracted to design and build plants based on process information.  These are 'grass-roots' projects that usually involve one set of data which may be revised extensively during the life-cycle of the plant.  In this case, the data for each project is maintained within a single database schema.  Once a plant is operational, the domain type can be changed to Owner operator if needed, and the owner can perform the necessary maintenance and modernization.

Owner operator — In such a domain, an operational plant exists and most of the activities are concerned with routine maintenance or plant modernization (revamps).  To facilitate plant modernization, a number of projects can be defined within the domain.  Each project is defined for one plant only, and a plant can have several projects associated with it.  The main body of data in the domain that includes existing data together with any data that was integrated on completion of projects is called As-Built.  In this case, the database is partitioned into several schemas: a single schema for As-Built and separate schemas for each project.

  • Exclusive claim mode — Allows a Project Administrator to claim a particular As-Built item only for one project. It is possible, however, to claim this item for another project after removing the item from the project for which it was claimed first using the Release Claim merge action, or after merging the item with As-Built.  If you clear the check box, a Project Administrator can claim the same item for more than one project created in an owner operator domain, either from one project to another, or from As-Built.

     After creating a project, these settings become fixed in the Owner operator domain.

  • Domain usage — Indicates the usage of an Owner operator domain, which can be one of the following:

    • None — This is the default value for domain usage after an upgrade. Starting with this value, you can select any of the options.

    • Sub-contractor — Indicates that the domain is defined as a sub-contractor under a particular satellite domain. Once you have defined the domain usage as a sub-contractor, it is no longer possible to redefine its usage.

Domain features

Activity tracking — Enables the use of activity tracking.

Audit trail options — Enables the use of audit trail options.

The Audit trail options will not retrieve Change Log data for updates in Index and Wiring supporting tables as these are not recorded to the database.

Cable type dependency — Enables cable type dependency.

You can only select this option if all reference cables comply with the dependency requirements.  You can generate a Cable Type Dependency Validation report to display a list of all reference cables that do not comply with the dependency requirements.  Also, make sure that in the current domain, the properties of plant cables in the Domain Explorer match the properties of the reference cables in the Reference Explorer.

Single mode (on Oracle Server only) — Improves the software performance and switches to single mode. Switching to single mode unlocks all the database objects. Therefore, more than one user can have access to the same item simultaneously. There is no mechanism that prevents the occurrence of sharing violation problems. Using the same database resource by more than one user can cause database problems.

If you want only one user at a time to work with the same item, you must clear this check box. This way, when a user starts working with a specific item, the software locks the item for other users.

Default plant use — Allows you to enable or disable the use of the default plant in the current domain. If you clear this check box, the plant DEFAULT and all its hierarchy levels do not appear in the Plant Hierarchy Explorer. You can switch the use of the default plant on or off when making or modifying domain definitions.

  • If the Domain Administrator defines a plant hierarchy with more than three levels in a particular domain, it is no longer possible to use of the default plant in that domain. In this case, the software automatically clears the Default plant use check box.

  • If you intend to use Smart Instrumentation in an integrated environment, you must clear this check box. This is because in the OBJECT_REGISTRY table, all plant group ID numbers must be unique. The software uses this table to work with the Smart schema. In the plant DEFAULT, the plant group ID numbers are not unique: the ID number is 1 in all of the plant groups, that is Plant, Area, and Unit.

KKS mode — Activates propagation of KKS names when KKS naming conventions are used in the project.

Rule Manager — Allows consistency and GUI rules created by Rule Manager to be used in the project. For more information, see Smart Instrumentation Rule Manager in the Smart Instrumentation User's Guide, under Using Rule Manager, Smart Instrumentation Rule Manager.

Obtain Revision from SmartPlant Foundation — Select this check box to allow Smart Instrumentation to use SmartPlant Foundation to create a new revision for publishable documents. On publishing a report, the software first checks whether the report has a SmartPlant Foundation revision and then assigns the appropriate revision scheme automatically. If a user added a Smart Instrumentation revision previously, but did not obtain a new revision from SmartPlant Foundation, the software uses the Smart Instrumentation Revision schema to publish reports. Note that with this option selected, you can still use internal Smart Instrumentation revision options for those items not registered to SmartPlant Foundation.

Clear the check box to allow Smart Instrumentation users to add revisions to publishable reports using only internal Smart Instrumentation revision settings. SmartPlant Foundation revision options become inaccessible. If a user obtained a revision from SmartPlant Foundation previously, but did not make a new Smart Instrumentation revision, the software ignores the previous revision and does not allow publishing of the report until the user creates a revision in Smart Instrumentation.

  • Regardless of whether the check box is selected or cleared, to publish a report, a Smart Instrumentation user must assign a revision to a report before publishing. If no revision exists, the software displays an appropriate message and does not allow publishing of the report.

  • When using revisions from SmartPlant Foundation, Smart Instrumentation can be configured to support minor as well as major revisions. For details, see Configure Smart Instrumentation to Use Minor Revisions

  • SmartPlant Foundation supports this option from versions SPF 2009 Service Pack 3 and above.

  • When registering items for use in an integrated environment, the Obtain revision from SmartPlant Foundation check box, in the Administration Module > Domain Definition > Domain features, is selected automatically even if it was not selected before registering. After the register items process is complete you must clear the Obtain revision from SmartPlant Foundation check box to continue to use Smart Instrumentation revision numbering. To use revision numbering from SmartPlant Foundation, leave the check box selected.


Instrumentation and process data — Only applies where the selected domain type is Engineering company. For the domain type Owner operator, the workflow is defined at the level of the projects in the domain. The available workflow options are:

  • Full — Activates all workflow options, including marking instrument tags for release as a formal issue in a binder package. The Release to Spec option becomes available in the Document Binder module and in the Spec Change Notification Options dialog box.

  • Without Document Binder — Activates all workflow options, except for the option to release instrument tags as a formal issue in a binder package.

  • None — No workflow options are activated.

Specification title block

Custom title block assignment method — Applies only to title blocks displayed in specifications. You can change this setting at any stage of your domain life-cycle. The methods are:

  • Standard (used in all modules) — Allows the Domain Administrator to select one specific custom title block to be assigned to all specifications. After selecting this option, the software hides all the title block assignment options that are available in the Specifications module.

  • Special (used in Specifications module only) — Allows users to assign individual title blocks to any specification, using the title block assignment options available in the Specifications module.

Plant hierarchy separator — Allows you to set a single-character separator for all or part of a plant hierarchy is displayed as a string. For example, if the separator character is &, and you have plant hierarchy items My Plant, My Area, and My Unit, in the Properties dialog box for the My Unit item, the software displays the parent hierarchy as follows:
My Plant&My Area

Global path

Global path — Displays the global path that you set for all users. If you change the existing global path, all user-defined paths remain linked to the previous global path. For example, if you change the global path from \\APP_SERVER\Smart Instrumentation to \\APP_SERVER_1\Smart Instrumentation, and a user has already specified a path to the PSR folder, in the appropriate box, the user-defined path is displayed as a full path \\APP_SERVER\Smart Instrumentation\PSR. The global path you specify in this field determines the global path location across all of Smart Instrumentation's modules. Any path you define (in any module) becomes a sub-folder of the Global Path. It can be viewed in Smart Instrumentation's Preferences, where the Global path location is indicated.

A global path does not apply to individual temporary folder settings.

Browse — Allows you to navigate to the folder that you want to specify as the global path folder. We recommend that you specify a path that complies with universal naming conventions (that is, it starts with \\). If you want to use mapped drives, make sure that all Smart Instrumentation users have the same drive mapping.

Allow to overwrite the global path — Allows users to set user-defined paths in addition to the specified global path. When the check box is selected, users are not restricted to setting new paths in Smart Instrumentation within the global path folder.

Path for SmartPlant XML files — Allows you to specify the location of the Smart Instrumentation map files: ContextMap.xml and IntoolsMap.xml, needed for working in an integrated environment. These files are also needed when you are working with interfaces to other tools. Click Browse to select the folder where the Smart Instrumentation map files are located.

Intergraph Smart Instrumentation Web Services URL Enter the link to the location of your SI Web API server. Use the following format: https://<SI Web API Server Name.Domain>/api/si/<Version>.

For example:

If you typed an incorrect URL link and a connection to the server cannot be established, an error message is generated when clicking Save. Verify that the URL is correct, or leave this field empty in order to save and close the Domain Definition window.

Miscellaneous Options

Notes — Type notes or comments if you need.