About the Global Configuration Object

The Global Configuration Object (GCO) contains attributes that configure the Connector for Zuken CR-5000. This topic describes the attributes to help you decide how to configure the Connector for Zuken CR-5000 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:

Group ID

This feature provides the functionality to group different kinds of object types, so that they could be checked in always at the same time. This is especially necessary for the Project/Variant combination. All cadTypes which have the same GroupId will be grouped together. All objects whose CadTypes are not referenced in this attribute will carry an individual GroupId and therefore do not belong to a group.

During Login process, the attribute ECADInteg-GroupId is received from 3DEXPERIENCE and is honored in the checkin dialog. An object selection in checkin dialog, evaluates the GroupId received and all Objects which belong to the same GroupId are either selected or deselected in top down or bottom up direction. Considering the above GCO setting and if “Select Children” is set to false, selecting a Variant object results in the selection of the Project as they belong to the same GroupId. This is a bottom up functionality.

In the same case, if the Select Children is set to true, selecting a Variant object results in the selection of the Project. This results in the selection of all the objects under the Project since the select children is set to true. This is top down functionality.

Derived Output Parameter File

The Connector supports the download and the execution of so called Derived Output Parameter Files prior to Derived Output Creation. Derived Output Parameter Files allow the Administrator to provide customized scripts to the end user. Parameter object could be used to provide additional information to create Derived Outputs while checkin operation. Once the user has selected a Parameter Object for a specific Derived Output, the Connector downloads the java script and executes it.

There are specific conventions which need to be obeyed. The content of the parameter object can consist of the following files:

- Mandatory control script

- Additional and optional support scripts

  • The mandatory script needs to have the following Naming convention <sampleParameterName>-<mappedDerivedOutputName>.js.

    Example: myParameter-mill.js

  • There can be multiple other files in this object which do not need to follow this naming convention. These other files can then i.e. be used inside the java script file.
  • The java script needs to be checked into the corresponding Derived Output Format of the Parameter Object.

In order to setup the parameter file for its corresponding derived output, the following setting in the GCO should be set by the user.

The attribute IEF-DerivedOutputParameterObjTypeMapping defines which type of Derived Output Parameter types are available for which specific mapped type of the Derived Output.

Attribute Name Attribute Values
IEF-DerivedOutputParameterObjTypeMapping

<DerivedOutput MappedType1>|<ParameterObjecttype1>

<DerivedOutput MappedType2>|<ParameterObjecttype2>

For Example: mill|Derived Output Parameter
The attribute IEF-DerivedOutputParameterObjTypeMapping defines which type of Derived Output Parameter types are available for which specific mapped type of the Derived Output.
Attribute Name Attribute Values
IEF- DerivedOutputTypeDefaultParameterObjectMapping

<DerivedOutput MappedType1>,<Default Parameter Object1>

<DerivedOutput MappedType2>,<Default Parameter Object1>

For Example: mill|Derived Output Parameter,DOP-1,A

Checkin Revision Behavior

The Revision behavior in the checkin is now configurable through GCO setting. Three different ways are supported for controlling the revisioning. Based on the selected setting, the user can create any revision, select NEXT revision or can be disallowed to create a new revision in the Connector.

GCO Attribute

Specify which of the behaviors you want to configure.

  • Attribute
    • Name: ECADInteg-CheckRevisionBehaviour
    • Type: String
    • Ranges
  • References
    • Referenced in Type: ECADInteg-GlobalConfig
  • ECADInteg-CheckinRevisionBehavior = [AllowRevisioning|DisallowRevisioning|ManualRevisioning]
    • Defines the Checkin revision behavior in CSE.
Range Description
Allow Revisioning This allows the user to create only NEXT revision. The menu for creating NEXT revision will be available from the context menu of the design object in the checkin dialog. The user will not be able to create a manual revision. All the available revisions will be listed. The Revision list box is non-editable.
Disallow revisioning This denies revisioning for the user. The user will not be able to create any manual revision nor a NEXT revision but all the available revisions will be listed. The Revision list box is non-editable.
Note: If the design object does not exist in 3DEXPERIENCE and user does not have the access for Revisioning, then the user will not be able to create the design object in 3DEXPERIENCE.
Manual Revisioning This allows the user to create NEXT revision as well specify an own revision. All the available revisions will be listed. The Revision list box is editable and the user can specify any revision. This user specified input will be used as a new revision.

Role based commands

The administrator can control the access to Connector commands for any specific role/roles or even disable them completely using this GCO setting.

The GCO attribute which controls this is ECADInteg-CSEDisabledCommands. During the Login to 3DEXPERIENCE from connector, the value specified in this GCO attribute is received from 3DEXPERIENCE. The execution of the Connector commands will be based on the configured setting. Following is an overview of the available commands.

Command Meaning
createworkspace Create a workspace
deleteworkspace Delete a workspace
renameworkspace Rename a workspace
createproject Create a project
renameproject Rename a project
deleteproject Delete a project
createfolder Create a folder in a workspace or project
renamefolder Rename a folder in a workspace or project
deletefolder Delete a folder from a workspace or project
movefolder Move a folder to another parent workspace, project, or folder
deletecadobject Delete a CAD object
lifecycle Promote or demote a CAD object
assignfolder Add a CAD object to a folder
removefromfolder Remove a CAD object from a folder
All commands which are disabled will be greyed out and disabled in the Connector. A tooltip text shows that the command is disabled for the current role.

Enforce Folder on Save

The administrator can enforce if a CAD object needs to be assigned to a workspace folder during Save to 3DEXPERIENCE.

The GCO attribute which controls this is ECADInteg-EnforceFolderOnSave. The default value is set to FALSE. Allowed Values: TRUE|FALSE. If the GCO is configured to TRUE, the user needs to choose the workspace folder before performing a Save using the browse button under Save To field.

GCO Attributes used for User Settings

The user settings are read during the login to 3DEXPERIENCE. CSE reads the DEC login response and updates the setting. The existing CSE settings are overwritten by the 3DEXPERIENCE settings.

Note: The Settings will not be saved to 3DEXPERIENCE when the user commits the modifications done in Options dialog under Checkin dialog and also from the context menu for Derived output selection in Checkin dialog.

The following user settings from the 3DEXPERIENCE Options could be saved back to 3DEXPERIENCE

Attribute Name Corresponding Setting Name in Connector
IEF-Pref-MCADInteg-CreateIterationOnCheckin Create Iteration On Checkin
IEF-Pref-MCADInteg-LockObjectOnCheckin Retain Lock After Checkin
IEF-Pref-IEF-DefaultConfigTables Default View
IEF-Pref-MCADInteg-SelectChildItems Select Children
IEF-Pref-MCADInteg-LockObjectOnCheckout Lock Objects on Checkout
IEF-Pref-MCADInteg-CheckOutDirectory Checkout Directory
IEF-Pref-IEF-DefaultLateralView Default Table View
IEF-Pref-IEF-SelectedManualDerivedOutputs Manual
IEF-Pref-MCADInteg-SelectedDerivedOutputs Automatic