Global Configuration Object Preferences

Use this topic for information about the default Global Configuration Object (GCO) preferences installed by the Connector for SOLIDWORKS server installation.

This page discusses:

The GCO preferences are attributes that are used for mapping CAD to 3DEXPERIENCE and 3DEXPERIENCE to CAD. They are also used for other administrative information such as mandatory attributes and derived output types.

The administrator installs a sample Global Configuration Object based on user requirements. In Connector for SOLIDWORKS, the sample Global Configuration Object, "SWNewArch" with TEAM is installed. See the X-CAD Design Management Administration Guide for more information about some of the individual GCO preferences. For information about setting GCO preferences, see the X-CAD Design Management User's Guide.

MCADInteg GCO

GCO attributes with the MCADInteg prefix are for mapping the integration of SOLIDWORKS information to ENOVIA.

MCADInteg-TypeFormatMapping

Maps the CAD type to 3DEXPERIENCE type and format.

Syntax
CADType|ENOVIAType,format
Example
drawing|SW Drawing 
assemblyInstance|SW Assembly Instance 
componentInstance|SW Component Instance
assemblyFamily|SW Assembly Family
assemblyFamily|SW Assembly Family Template,asm
componentFamily|SW Component Family
componentFamily|SW Component Family Template,prt
attachment|SW Attachment
image_jpg|ThumbnailViewable
cgr|CgrViewable
png|ThumbnailViewable
All derived output CAD types with a name starting with "userfile_" mapped in the MCADInteg-BusTypeMapping attribute of the GCO have the automatic and background selection disabled. These options are disabled because these derived outputs must be generated explicitly by the user.

MCADInteg-BusTypeMapping

Maps CAD business types to 3DEXPERIENCE object types.

Syntax
CADType|MatrixType
Examples
drawing|SW Drawing 
assemblyInstance|SW Assembly Instance 
componentInstance|SW Component Instance
assemblyFamily|SW Assembly Family
componentFamily|SW Component Family
attachment|SW Attachment
image_jpg|ThumbnailViewable
pdf|Derived Output
cgr|CgrViewable
png|ThumbnailViewable
All derived output CAD types with a name starting with "userfile_" mapped in the MCADInteg-BusTypeMapping attribute of the GCO have the automatic and background selection disabled. These options are disabled because these derived outputs must be generated explicitly by the user.

MCADInteg-RelMapping

Maps the CAD relationship to ENOVIA relationship.

Syntax
CADRelationship|direction,MatrixRelationship
Where:
  • direction is direction to or direction from
  • MatrixRelationship is the symbolic name for the 3DEXPERIENCE relationship.
Examples
CADSubcomponent|to, CAD SubComponent
CADDrawing|from, Associated Drawing
CADInstanceOf|to, Instance Of
swattachment|to, SW Attachment
JoinPart|to, SW Join Part
BasePart|to, SW Base Part
WeldBead|to, SW Weld Part
SplitPart|to, SW Split Part
MirrorPart|to, SW Mirror Part
ExternalReference|to, SW External Reference
DerivedOutputOf|to, Derived Output

MCADInteg-TypePolicyMapping

Defines the policies available for each ENOVIA object type.

Syntax
Type|Policy
You can provide a comma-separated list for Policy
Examples
SW Assembly Instance|Design TEAM Definition
SW Component Instance|Design TEAM Definition
SW Assembly Family|Design TEAM Deinition
SW Component Family|Design TEAM Definition
SW Drawing|Design TEAM Definition
SW Attachment|Derived Output Policy TEAM Policy
Derived Output|Derived Output TEAM Policy
CgrViewable|Viewable TEAM Policy
ThumbnailViewable|Viewable TEAM Policy

MCADInteg-RelationShipClassMapping

This system-level attribute determines if the relationship should be treated as an Assembly, Family, or External Reference.

Syntax
CADrelationship|RelationshipClass
Examples
CADSubcomponent|AssemblyLike
CADDrawing|AssemblyLike
CADInstanceOf|FamilyLike
JoinPart|AssemblyLike,ExternalRefereneLike
BasePart|AssemblyLike,ExternalRefereneLike
WeldBead|AssemblyLike,ExternalRefereneLike
SplitPart|AssemblyLike,ExternalRefereneLike
MirrorPart|AssemblyLike,ExternalRefereneLike
ExternalReference|AssemblyLike,ExternalRefereneLike
swattachment|DerivedOutputLike
DerivedOutputOf|DerivedOutputLike

MCADInteg-CreateDerivedOutputObj

This attribute is not applicable and by default, the connector creates a derived object and saves it as a separate object for the generated CAD file.

Values
TRUE - X-CAD Design Management creates an object for each derived output formats and connects it to its respective parent CAD Model using the Derived Output relationship
FALSE -- The Derived Output file is checked in into its parent CAD Model in a different format.

MCADInteg-TypeDerivedOutputMapping

Maps the business type to derived output types.

Syntax
CADBusinessType|DerivedOutputType
Where, DerivedOutputType can be a comma-separated list of the types that have been defined for the specified object.
Examples
assembly|image_jpg,png,pdf,cgr
component|image_jpg,png,pdf,cgr
drawing|image_jpg,png,pdf
assemblyInstance|image_jpg,png,pdf,cgr
componentInstance|image_jpg,png,pdf,cgr
assemblyFamily|image_jpg,png,pdf,cgr
componentFamily|image_jpg,png,pdf,cgr

MCADInteg-TypeClassMapping

Defines the class for business types.

This is a system level attribute and this attribute is generally not modified.

Syntax
BusinessTypeClass|CADBusinessType
For CADBusinessType, you can use a comma-separated list.
Examples
TYPE_CADMODEL_LIKE|assembly,component,drawing,assemblyFamily,component
Family
TYPE_COMPONENT_LIKE|component,componentInstance
TYPE_ASSEMBLY_LIKE|assembly,assemblyInstance
TYPE_FAMILY_LIKE|assemblyFamily,componentFamily
TYPE_INSTANCE_LIKE|assemblyInstance,componentInstance
TYPE_COMPONENT_FAMILY_LIKE|componentFamily
TYPE_ASSEMBLY_FAMILY_LIKE|assemblyFamily
TYPE_DERIVEDOUTPUT_LIKE|attachment,image_jpg,pdf,cgr,png

MCADInteg-RenameFilesInServer

Enables or disables renaming of files on the server when a user performs a Rename or Save AsSave As command.

This is a system level attribute and should not be altered.

Possible Values
TRUE - The files are renamed on the server side during Rename and Save As. This is the default value.
FALSE - No file renaming operation is done on the server side during Rename and Save As.

MCADInteg-NonSupportedCharacters

Used to define characters that cannot be used in filenames. If any CAD object has any of these characters in its name, the system displays a message and prevents check-in.

Examples
/\\|<>*$?;:@

MCADInteg-TypeChangeMapping

Defines the list of possible type changes entered as a new line-separated list.

Examples
component|componentFamily
componentFamily|component
assembly|assemblyFamily
assemblyFamily|assembly

MCADInteg-NamingStrategy

Maps the file name to the family object name and the configuration name along with the family name to the instance object name.

Possible Values
AlwaysFromFile - Always uses the file name as the family object name and the configuration name (plus family name) as the instance object name. When using this option, set IEF-EnforceInstanceNameUniqueness to FALSE.
AlwaysNumber - Always generates auto-numbers for family and instance object names. This value is the default and requires that IEF-EnforceInstanceNameUniqueness is set to its default value, TRUE.
AlwaysFromFileExceptInstances- The Families and Drawings objects will be named as the name of the file. The configurations will be assigned a unique auto generated number as their name.

MCADInteg-FeatureJPOMapping

Used by Connector for SOLIDWORKS to map the links in to the Connector for SOLIDWORKS protocol handler. The protocol handler opens the relevant X-CAD Design Management clicked links in the appropriate Connector for SOLIDWORKS function.

Value
Select OpenFromWeb|DSCOpenFromWebLink

MCADInteg-VirtualComponentSupport

Determines if Connector for SOLIDWORKS includes or ignores SOLIDWORKS internal components.

Possible Values
TRUE - The system ignores SOLIDWORKS internal components by omitting them at parent assembly check in, in references dialog boxes, and in the SOLIDWORKS add-in task pane tree.
FALSE - The system includes SOLIDWORKS internal components at parent assembly check in, in references dialog boxes, and in the SOLIDWORKS add-in task pane tree. The default is FALSE
To change the default to TRUE, use this MQL command:
modify bus SolidWorksInteg-GlobalConfig SWNewArch TEAM "MCADInteg-VirtualComponentSupport" TRUE;

MCADInteg-KeepLocalReferencesOnCheckout

Determines if checkout overwrites existing local copies with the latest version.

Possible Values
TRUE - The system does not overwrite on checkout local copies with the latest version.
FALSE - The system overwrites on checkout local copies with the latest version. The default is FALSE
To change the default to TRUE, use this MQL command:
-	modify bus SolidWorksInteg-GlobalConfig SWNewArch TEAM "MCADInteg-KeepLocalReferencesOnCheckout" TRUE;

MCADInteg-TraverseDrwOnBothSides

Control if client includes all drawing's references on check-in operation.

Possible Values
TRUE - Entire Structure referenced by a Related Drawing / Drawings is used for Checkin Operation.
FALSE - Structure referenced by a Related Drawing is not used for Checkin Operation. The default is FALSE
Note: For this attribute to work Related Documents should be set to Related Drawing.

MCADInteg-MxToCADAttribMapping

Map 3DEXPERIENCE-to-CAD attributes for attribute synchronization during checkout (attributes must exist). The user can choose whether or not to perform the attribute sync.

Important: Mapping for these attributes is only supported from ENOVIA to the CAD file, not from the CAD file to ENOVIA.

Syntax
ENOVIA-Type,$$revision$$|CAD-Type,CAD-Attribute
ENOVIA-Type,$$major_revision$$|CAD-Type,CAD-Attribute
$$revision$$, maps the value of iteration from the ENOVIA object to the CAD file.
$$major_revision$$, maps the value of revision from the ENOVIA object to the CAD file.
For more information, see Installation and Setup | Administrate | Social and Collaborative | Global Design Management | X-CAD Design Management - Installation and Administration | Configuring and Setting Preferences | Entering GCO Attribute Values
Examples
SW Drawing,$$revision$$|drawing,MyIteration
SW Drawing,$$major_revision$$|drawing,MyRevision

IEF GCO

GCO attributes with the IEF prefix map CAD to 3DEXPERIENCE and define 3DEXPERIENCE mapping among 3DEXPERIENCE attributes.

IEF-TypeTemplateMapping

Maps CAD types to the template types for the Start Design function.

Syntax
CADType|TEMPLATE_TYPE
Examples
componentFamily|SW Component Family Template
assemblyFamily|SW Assembly Family Template
drawing|SW Drawing Template

IEF-EnforceInstanceNameUniqueness

Determines whether or not the family names are appended with parentheses. Use the function when using the attribute MCADInteg-NamingStrategy.

Possible Values
FALSE - Family name is appended with parentheses.
TRUE - Family name is not appended. Use this attribute with auto-numbering. TRUE is the default.

IEF-AutoNameSeries

Maps the CAD type to the series name for auto-naming. Auto-naming is a feature that users can select from the Options dialog box. The feature has the auto-generator create names when users save new files or when they create files with new names using SOLIDWORKS' Save As. The Options dialog box is available to users from the 3DEXPERIENCE tab in the SOLIDWORKS view.

By default, instance auto-naming uses the generator for type_CADModel, as shown below:

Syntax
CAD_Type|SeriesName
Examples for type_CADModel
type_CADModel|A Size
type_CADDRAWING|B Size

To auto-name component and assembly instances uniquely, you can specify an additional auto-number generator for each type of instance.

Examples for SOLIDWORKS Component and Assembly Instances
type_SWComponentInstance|X Size
type_SWAssemblyInstance|Y Size
Note: If you specify an additional auto-number generator only for assembly instances, component instances will use the generator specified for type_CADModel.

IEF-Pref-MCADInteg-DefaultTypePolicySettings

Defines the mapping between the Component Type and the Design Policy. This mapping shows default values for new objects in the policy columns for the selected Component Type in the Check-in page.

See Behavior Changes - ReadOnly Attribute for details of the impact of this attribute.

Values
(DEFAULTVALUE)SW Assembly|Design TEAM Definition,Design TEAM Definition
(DEFAULTVALUE)SW Component|Design TEAM Definition,Design TEAM Definition
(DEFAULTVALUE)SW Drawing|Design TEAM Definition,Design TEAM Definition
(DEFAULTVALUE)SW Assembly Instance|Design TEAM Definition,Design TEAM Definition
(DEFAULTVALUE)SW Component Instance|Design TEAM Definition,Design TEAM Definition
(DEFAULTVALUE)SW Assembly Family|Design TEAM Definition,Design TEAM Definition
(DEFAULTVALUE)SW Component Family|Design TEAM Definition,Design TEAM Definition
(DEFAULTVALUE)IEF Document|Design TEAM Definition,Design TEAM Definition
(DEFAULTVALUE)SW Card|Design TEAM Resource,Design TEAM Resource

IEF-SetDefaultFamilyObjectRevisionMode

Determines whether X-CAD Design Management supports together or individual mode of Family Towers revisioning.

Ensure that the attribute IEF-SetDefaultFamilyObjectRevisionMode is present in the GCO and set to together.

Values
individual - Not supported in Connector for SOLIDWORKS.
together - Ensures that whenever a family structure is revised, all items of the family are structured and revised at the same time.
Important: Connector for SOLIDWORKS only supports together.

IEF-CreateVersionObjects

Defines whether or not new version objects can be created for a Revision.

Values
TRUE - More than one iteration object can be created in any revision stream.
FALSE - Not supported in Connector for SOLIDWORKS.
Important: Connector for SOLIDWORKS only supports TRUE.

SLW GCO

The SLW GCO are generic GCO for enabling and disabling specific Connector for SOLIDWORKS functionality.

SLW-CheckInPermitIncomplete

Permits or denies check-in of an assembly without check-in of the assemblies' sub-components.

Values
TRUE - Users can choose whether or not to include a referenced component when checking in assemblies and subassemblies. TRUE is the default.
FALSE- Users are required to check in the referenced parts and subassemblies when checking in an assembly or subassembly.

This setting controls whether or not users will be allowed to de-select children for check-in when the parent is being checked-in. This setting has no effect on initial check-in. When an assembly is checked in for the first time, users cannot deselect children selected for check-in.

SLW-CheckInBlockRemoteReferences

Permits or denies check-in of assemblies that reference files outside of the Connector for SOLIDWORKS view.

Values
TRUE - When checking-in an assembly with a reference outside the Connector for SOLIDWORKS view, users are prevented from completing the check-in by error on the referenced file. TRUE is the default.
FALSE - When checking in an assembly with a reference outside the Connector for SOLIDWORKS view, users see a warning that the file is outside the view. However, they can check-in the assembly.

SLW-CheckoutPermitPartialGet

Permits or prevents users from getting a file locally with the Check-out or Get commands when referenced components exist in the local view in a different version than would be retrieved by the system.

Values
TRUE - Users can choose whether or not to retrieve a reference file when the file exists locally. Retrieving the reference file replaces the local file with the retrieved file. TRUE is the default.
FALSE - Users must replace each referenced files with the correct version when retrieving the file's assembly or subassembly.

SLW-ConfigurationFilter

Identifies the configurations for which Connector for SOLIDWORKS should create instance objects during check-in.

Syntax
extension|exclude pattern|include pattern
Values
The value is a multi-line string, where you can identify exclude and include patterns for one file extension on each line.

The include pattern overrides the exclude pattern.

You can:

  • Use a wildcard pattern for the file extension.
  • Add multiple exclude and include patterns for an extension by separating the values with commas.
  • Leave include pattern empty to include all configurations except the excluded pattern.
Notes:
  • You cannot exclude all configurations. If you specify a pattern that excludes all configurations, Connector for SOLIDWORKS disregards the pattern and includes all configurations. If an exclude pattern is specified and include pattern is specified as * then, the exclude pattern is overridden and all configurations are included.
  • You can access the configuration instances, that were saved before the SLW-ConfigurationFilter change and that are excluded during the SLW-ConfigurationFilter modifications.
Examples
Example Description
SLDPRT|*|Standard*
In this example, for parts, all configurations except those that start with "Standard" are excluded.
SLDASM|Default|*
In this example, for assemblies, all configurations except the Default configuration are included.
SLDASM|Default,Test*|*
In this example, for assemblies, all configurations except the Default configuration and those that start with "Test" are included.
*|*|Main*
In this example, for all file types, all configurations except those that start with "Main" are excluded.