Environment variables - HxGN SDx - Update 64 - Administration & Configuration

Administration and Configuration of HxGN SDx

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

The following is a list of descriptions for the environment variables found in HxGN SDx. These environment variables can be used when creating conditions, security rules, ENS, and Data Validator import mappings.

Data Validator does not provide an equivalent environment variable when the ConfigLevel1OrBlank environment variable is used as the unique ID definition or unique key definition for a class definition.

Environment Variable

Description

Example

ACCESSGROUPSFORUSERINCREATECONFIG

All valid access groups associated with the current create configuration/user (user's name).

UserAdmin,InstallationAdmin,SuperUserGroup

ACCESSGROUPSFORUSERINQUERYCONFIG

All valid access groups associated with the current query configuration/user (user's name).

VTLDataController,VTLDataMapper

ALLDISCIPLINESFORCREATECONFIG

All disciplines associated with the current create configuration. If no disciplines are found for the current create configuration, the environment variable returns all the disciplines present in the next higher configuration level.

DC_CV, DC_EL, DC_MACH, DC_MECH-N

ALLDISCIPLINESFORQUERYCONFIG

All disciplines associated with the current query configuration. If no disciplines are found for the current query configuration, the environment variable returns all the disciplines present in the next higher configuration level. If no disciplines are found for the current query configuration or any of the higher configuration levels, the environment variable returns a blank value.

MECH-PR, MECH-N

ALLDOMAINSFORUSER

All domains valid for the current user.

InstD,SPFLLADesD,LLAD,SPFREFERENCE,METASCHEMA,SPF,VTL

ALLROLEASSIGNEDACTIVEUSERSINCREATECONFIG

Returns all the users who have any role assignment in the current create configuration. Disabled users are ignored.

HSV_DC, HSV_DE

ALLROLEASSIGNEDUSERSINCREATECONFIG

Returns all the users (including disabled users) who have any role assignment in the current create configuration.

HSV_DC, HSV_DE

CALLEDFROM

Returns the string from the called client. For example, VBClient/WebClient based on a session parameter.

VBClient

CALLEDFROMDIALOG

Returns the string from the called client based on a session parameter. For example, VBClient/WebClient.

VBClient

CLASS

Returns the class definition of an object.

FDWTag

CLASSDEFOBJ

Returns the class definition of an object.

FDWTag

CLOUDURL

Returns the fully-qualified URL path to the Desktop Client site. This is used in email definitions to send notifications about workflow objects to Cloud users. The Cloud users can then access the related workflow object in their To Do List by clicking the URLs in the email notification.

https://opusindiatest.ingrspcloud.net/?App=9aea00beca0c46ea94059e11876acda1

({ENV.CLOUDURL: /CONFIGUID PL_PlantA /API QFindObject /ARG1 ISPFWorkflowItem /CRITERIA ssssss}

COLLABORATIONISSUEPURPOSESBYCREATECONFIG

Returns the UIDs of the issue purposes related to the current create configuration. The issue purposes are returned from the parent configuration if the current create configuration is not related to any issue purpose.

PIP_IFR, PIP_AB, PIP_IFD, PIP_IFC, PIP_Prelim, PIP_Final

COLLABORATIONISSUEPURPOSESBYNAMEINCREATECONFIG

Returns the names of the issue purposes related to the current create configuration. The issue purposes are returned from the parent configuration if the current create configuration is not related to any issue purpose.

IFR, AB, IFD, IFC, Prelim, Final

COLLABORATIONPROJECT

Returns the current collaboration project if the ISCLBCollaborationScope interface is realized on it. If not, returns the parent configuration if the ISCLBCollaborationScope interface is realized on the parent configuration.

PLANTA

CONFIG

Returns the configuration of an object.

PlantA

CONFIG1, CONFIG2, ..5

Name of the create configuration at the specified level

PlantA, Project1...

CONFIGCREATE

Current create configuration string includes parent configurations. So if in project scope will include the plant.

PR_Project_1

CONFIGLEVEL

Current create configuration level. For example, 0, 1, 2, and so on.

2

CONFIGOBID

Returns the object ID of the plant or project in which the requested object exists

000JGNA

CONFIGUID

Returns the UID of the configuration of the object.

PL_PlantA

CREATECONFIGLEVEL1OBJ, CREATECONFIGLEVEL 2, ..5OBJ

Exposes the create configuration object at the specified level to support access to additional properties on this object (1... 5 supported)

ENV.CREATECONFIGLEVEL1OBJ.Property

CREATECONFIGOBJ

Exposes the current create configuration object to support access to additional properties on this object

ENV.CREATECONFIGOBJ.Property

CREATECONFIGPARENTOBJ

Exposes the configuration above the current create configuration object to support access to additional properties on this object. This provides access to the plant properties from the project configuration

ENV.CREATECONFIGPARENTOBJ.Property

CREATECONFIGSTRING

Current create configuration name

PlantA

CREATECONFIGUID

Current create configuration UID.

PL_PlantA

CURRCONFIGLEVELNAME

Current configuration level name.

Project1

CURRENTDATE

Current date.

2022/10/30

CURRENTTIME

Current time.

2022/10/30-10:38:12:991

CURRENTYMD

Current date in the year/month/day format.

2022/10/30

DISCIPLINESFORUSERINCREATECONFIG

Compares the disciplines on role assignments of users with the disciplines on create configuration and:

  • Returns the disciplines that are common to both.

  • If no common disciplines are found, then compares the User-Disciplines with the disciplines on create configuration.

  • If no disciplines are found in the above comparison, returns an empty list.

MECH-PR, MECH-N

DISCIPLINESFORUSERINCREATECONFIG_OR_ALL

Returns the disciplines as per the DISCIPLINESFORUSERINCREATECONFIG variable. If no disciplines are found, it returns all the disciplines in the create configuration.

MECH-PR, MECH-N

DOCCLASSIFICATIONSINCREATECONFIG_OR_ALL

Returns the UIDs of the document classifications related to the current create configuration.

  • If the current create configuration is not related to any document classifications, returns the UIDs from the parent configuration.

  • If there are no parent related document classifications, returns the entire classification tree.

SDC_Engineering, SDC_Documents, SDC_MDR

DOCCLASSIFICATIONNAMESINCREATECONFIG_OR_ALL

Returns the names of the document classifications related to the current create configuration.

  • If the current create configuration is not related to any document classifications, returns the names from the parent configuration.

  • If there are no parent related document classifications, returns the entire classification tree.

Engineering, Documents, MDR

DOCCLASSIFICATIONSINQUERYCONFIG_OR_ALL

Returns the UIDs of the document classifications related to the query configurations.

  • If any of the query configuration is not related to any document classifications, returns the UIDs from the parent configuration.

  • If there are no parent related document classifications, returns the entire classification tree.

SDC_Engineering, SDC_Documents, SDC_MDR

HOSTNAME

Current Data Validator server machine name.

SERVER-PROJECT1

JOBDESCRIPTION

Current Data Validator job description.

EnvironmentVariableExamples

JOBNAME

Current Data Validator job name.

ENVIRON1

LOGINUSERDEFAULTROLES

  • Provides the details about the role with which user logged in.

  • Validates the logged in role with the preparation step recipient role.

Site Engineer PAB

OBJDEFUID

Returns the class definition of an object.

FDWTag

OWNINGGROUPSFORCREATECONFIG

All valid owning groups at the current create configuration level.

ADMIN,OPEN TO ALL, SDVADMIN

OWNINGGROUPSFORQUERYCONFIG

All valid owning groups at the current query configuration level.

ADMIN,OPEN TO ALL, SDVADMIN

OWNINGGROUPSFORUSERINCREATECONFIG

All valid owning groups for the user at the current create configuration level.

ENGINEER,ADMIN,OPEN TO ALL, SDVADMIN

OWNINGGROUPSFORUSERINQUERYCONFIG

All valid owning groups for the user at the current query configuration level.

ENGINEER,ADMIN,OPEN TO ALL, SDVADMIN

QUERYCONFIG1, QUERYCONFIG2,3,4,5

Name of the query configuration at the specified level.

PlantA

QUERYCONFIGLEVEL

Current query configuration level. For example 0,1,2 and so on.

1

QUERYCONFIGSTRINGS

All current query configuration names in a comma separated list.

PlantA, Project1

QUERYCONFIGUIDS

All current query configuration UIDs in a comma separated list..

PL_PlantA, PR_Project1

SDACLIENTURL

Returns the fully-qualified URL path to the Web Client site. This is used in email definitions to send notifications about workflow objects to Web Client users. The users can then access the related workflow object in their To Do List by clicking the URLs in the email notification.

https://<server>/<WCSite>

SECURITYCODESFORUSERINCREATECONFIG

All valid security codes associated with the current create configuration or user.

Proprietary, Unclassified, Restricted

SECURITYCODESFORUSERINQUERYCONFIG

All valid security codes associated with the current query configuration or user.

Proprietary, Unclassified, Restricted

SERVERURL

Current Data Validator server address.

http://localhost/SPFServer

SESSIONID

Current Data Validator session identification.

aa1f956c-d28e-4fb7-83c4-c6e51d109618

SPFOPTIONS

This returns the SystemOptions object, which is used to read system settings when evaluating conditions. Any property on SystemOptions can be used with the applicable condition.

SPFOPTIONS.SPFEnforcePasswordPolicy

TAGCLASSIFICATIONSINCREATECONFIG_OR_ALL

Returns the UIDs of the tag classifications related to the current create configuration.

  • If the current create configuration is not related to any tag classifications, returns the UIDs from the parent configuration.

  • If there are no related parent tag classifications, returns the entire classification tree.

FTC_Equipment, FTC_Instrument

TAGCLASSIFICATIONNAMESINCREATECONFIG_OR_ALL

Returns the names of the tag classifications related to the current create configuration.

  • If the current create configuration is not related to any tag classifications, returns the names from the parent configuration.

  • If there are no related parent tag classifications, returns the entire classification tree.

Equipment, Instrument

TAGCLASSIFICATIONSINQUERYCONFIG_OR_ALL

Returns the UIDs of the tag classifications related to the query configurations.

If any of the query configuration is not related to any tag classifications, returns the UIDs from the parent configuration.

If there are no related parent tag classifications, returns the entire classification tree.

FTC_Equipment, FTC_Instrument

TEMPLATECLASSIFICATIONSINCREATECONFIG_OR_ALL

Returns the UIDs of the template classifications related to the current create configuration.

If the current create configuration is not related to any template classifications, returns the UIDs from the parent configuration.

If there are no related parent template classifications, returns the entire classification tree.

Datasheet Template, XLS Template

TEMPLATECLASSIFICATIONNAMESINCREATECONFIG_OR_ALL

Returns the names of the template classifications related to the current create configuration.

If the current create configuration is not related to any template classifications, returns the names from the parent configuration.

If there are no related parent template classifications, returns the entire classification tree.

Excel Template, XLS Template

TEMPLATECLASSIFICATIONSINQUERYCONFIG_OR_ALL

Returns the UIDs of the template classifications related to the query configurations.

If any of the query configuration is not related to any template classifications, returns the UIDs from the parent configuration.

If there are no related parent template classifications, returns the entire classification tree.

Datasheet Template, XLS Template.

USER

Exposes the currently logged in ISPFLoginUser object to support access to additional properties on this object.

ENV.USER.Property

USERDEFAULTCREATECONFIG

Current user's default create configuration.

PlantA

USERNAME

Current user's login user name.

SDVADMIN

USERORGANIZATIONNAME

Current user's company name.

Hexagon

USERORGANIZATIONNAMEWITHDELIMITER

Returns the user organization name with delimiter appended.

®HSV®

USERSACTUALNAME

Name of the current user

John Smith

USERUID

Returns the UID of the user.

USR_SDxAdmin

USERUSERGROUPS

Current user query access groups.

ENGINEER,ADMIN,OPEN TO ALL, SDVADMIN

USERUSERTYPE

Current user's types.

Full

USERWORKAREANAMES

When a user runs a query in SDx to return shared objects, the system evaluates this environment variable.

  • If the user is an internal user or belongs to an internal organization, the results are returned normally.

  • If the user is an external user or belongs to an external organization or EPC, then a security rule is applied to the results that are returned. Basically, that user will see only objects that are part of the 3D Work Area Definition that the SDx Administrator associated with the PBS for the plant being queried. The administrator determines what each external organization can see.

WorkAreaDefintionUID1

VIRTUALDIRECTORY

Returns the path of a web folder created in IIS that points to a physical folder on the Web server. Virtual directories are used by the software to run applications and services from the application server and to transfer files between file servers and clients.

C:\SDx Server Files\Web_Sites\SDxU38Server