About the Global Configuration Object

The Global Configuration Object (GCO) contains attributes that configure the Connector for Altium Designer. This topic describes the attributes to help you decide how to configure the Connector for Altium Designer to meet your business requirements.

You can choose to configure each attribute individually as shown by the link in each section to the procedure for that attribute. Or, you can choose to create a script and update all the required attributes at the same time.

This page discusses:

Flow Levels

You can specify whether the Connector for Altium Designer uses the publishing flow (flow level 1) or the collaboration flow (flow level 3).

Flow level 1, the Publishing Flow, allows a user to manage the entire project, including schematic and layout data, as a single business object. Use this mode if there is a single designer responsible for both the schematic and layout of the design.

Flow level 3, the Collaboration flow, allows users to manage schematic data separately from the layout data. Use this mode would when there are different designers responsible for the schematic design and others for the layouts.

For more information, see Publishing and Collaboration Flows.

For instructions on setting the flow level, see Choosing a Flow Level.

Group ID

You can group different types of objects so that they can always be checked in at the same time, such as a Project and Variant combination.

All cadTypes with the same GroupId are grouped together. Any CadTypes without this Group ID carry an individual GroupId and do not belong to the group.

During the login process, the attribute ECADInteg-GroupId is received from 3DEXPERIENCE and is used during check in. Object selection in the check in dialog box causes the Connector for Altium Designer to evaluate the selection against the GroupId. Objects that belong to the same GroupId are either selected or cleared based on the value of the Select Children Save option:

  • If Select Children is set to false, selecting a Variant object results in the selection of the Project if they belong to the same GroupId.
  • If Select Children is set to true, selecting a Variant object results in the selection of the Project and all the objects under the Project if they belong to the same GroupId.

The standard functionality respects the value of the Select Children Save option.

For instructions on setting the Group ID, see Defining Group IDs for Enforcing Related Object Check-ins.

Check-in Revision Behavior

You can use the ECADInteg-CheckinRevisionBehavior attribute configure the check in process.

You can choose any of these values for this attribute:

ValueDescription
Allow RevisioningWhen checking in an object, users can only select NEXT in the Revision column and cannot create a manual revision level. All available revisions are listed, and the list box cannot be edited.

Default.

Disallow RevisioningWhen checking in an object, users cannot select any value in the Revision column. All available revisions are listed, and the list box cannot be edited.

If the design object does not exist in 3DEXPERIENCE and the user does not have Revisioning access, the user cannot create the object in 3DEXPERIENCE.

Manual RevisioningWhen checking in an object, users can select NEXT or manually enter a revision value. That value is used and the revision level for the checked in object. All available revisions are listed.

For instructions on setting the check-in revision behavior, see Specifying Revision Types Available for Check-in.

Role-Based Access to Commands

You can use the ECADInteg-CSEDisabledCommands attribute to change the baseline behavior to specify which access roles are required for a user to be able to execute a command.

During the login process, the attribute ECADInteg-CSEDisabledCommands is received from 3DEXPERIENCE and is used to enable or disable commands for access roles. If a user does not have the required access role for a command, that command is grayed out.

These are the commands you can configure:

CommandDescription
createworkspaceCreate a workspace
deleteworkspaceDelete a workspace
renameworkspaceRename a workspace
createprojectCreate a project
renameprojectRename a project
deleteprojectDelete a project
createfolderCreate a folder in a workspace or project
renamefolderRename a folder in a workspace or project
deletefolderDelete a folder from a workspace or project
movefolderMove a folder to another parent workspace, project, or folder
deletecadobjectDelete a CAD object
lifecyclePromote or demote a CAD object
assignfolderAdd a CAD object to a folder
removefromfolderRemove a CAD object from a folder

These are the access roles that you can specify.

Access RoleUI Display
VPLMViewerReader
VPLMCreatorAuthor
VPLMExperimenterContributor
VPLMProjectLeaderLeader
VPLMProjectAdministratorOwner
VPLMAdminAdministrator

You can also specify enabled to let all access rules execute that command, or disabled to prevent any access role from executing that command.

For instructions on configuring commands for role-based access, see Controlling Access to Commands Based on Access Roles.

Enforce Folder on Save

You can use the ECADInteg-EnforceFolderOnSave attribute to specify if CAD objects must be assigned to folders before they can be saved in 3DEXPERIENCE.

If you set the value for this attribute to TRUE, users must add all CAD objects to folders before they can be saved. The Save To Browse box lets a user select a folder for the CAD objects being saved.

If you set the value to FALSE, users do not have to select a folder for CAD objects being saved.

For instructions on setting a value for this attribute, see Enforcing That a Folder Is Selected When Saving Objects.

User Settings

During the login process, the Connector for Altium Designer retrieves several preference values used in various dialog boxes.

If a user changes one of the settings, the 3DEXPERIENCE values overwrite their changes. These attributes set preferences: they do not restrict the user. The user can change these values as required. No user changes to preferences are saved to 3DEXPERIENCE. The next time the user logs in, the 3DEXPERIENCE preferences are again set.

Attribute NameSetting Name in the Connector for Altium Designer
IEF-Pref-MCADInteg-CreateIterationOnCheckinCreate Iteration On Checkin
IEF-Pref-MCADInteg-LockObjectOnCheckinRetain Lock After Checkin
IEF-Pref-IEF-DefaultConfigTablesDefault View
IEF-Pref-MCADInteg-SelectChildItemsSelect Children
IEF-Pref-MCADInteg-LockObjectOnCheckoutLock Objects on Checkout
IEF-Pref-MCADInteg-CheckOutDirectoryCheckout Directory
IEF-Pref-IEF-DefaultLateralViewDefault Table View
IEF-Pref-IEF-SelectedManualDerivedOutputsManual
IEF-Pref-MCADInteg-SelectedDerivedOutputsAutomatic

You can update the values for these attributes the same way as the attributes described above.