Appendix G: Upgrade from the Gateway Configuration Tool Project Settings

Save PDF

Last UpdatedMay 12, 2025
9 minute read

Available upgrades for the Gateway:

Gateway for AVEVA P&ID ® Gateway for 2D Data / extractor for AutoCAD 2D with AVEVA P&ID option selected
GCT Gateway for AutoCAD 2D ® Gateway for 2D Data / extractor for AutoCAD 2D
Gateway for DEXPI ® Gateway for 2D Data / extractor for DEXPI
GCT Gateway for MicroStation 2D ® Gateway for 2D Data / extractor for MicroStation 2D
GCT Gateway for SmartPlant P&ID ® Gateway for 2D Data / extractor for Smart P&ID

The following table lists the full upgrade information with respect to MicroStation 2D syntax:

GCT Project - Common Setting	New Gateway Target	Comment
logFolder path	General Settings - Log Path	Copy value
logFolder debug	General Settings - Log Level	If False -> Log Level: Warning If True -> Log Level: Verbose
environmentVariable	Extract	Imported into 'Fonts and Support Folders'
inputOutputFolders	N/A	No action
exampleData	N/A	No action
moveProcessedUnprocessedFiles	N/A	Log Information: "Setting not imported as obsolete"
objectIdFromVnetFile	N/A	Log Warning: In the Gateway for 2D Data, the functionality Object ID From Vnet File used in Gateway Configuration Tool's project is not supported. This feature is replaced by LookupDataSource feature in Base Mapping which can be used to map Object ID and Class ID from an external data source. In order to set it, see LookupDataSource.
restrictProcess	Project Config	Copy value
GCT Project - MS2D Settings	New Gateway Target	Comment
inputs path	Extract	Input Path = copy value, Type = File System
outputs path	Load EIWM	Output Path = copy value, Type = File System
outputs path	Load SVG	Output Path = copy value, Type = File System
outputs path	Load CSV	Output Path = copy value
mappings patterns path	see table: GCT Pattern Mapping Settings	See table: GCT Pattern Mapping Settings
mappings patterns defaultContext	Load EIWM - Project Context	Output Path = copy value, Type = File System
mappings presentation path	see table: GCT Presentation Mapping Settings	See table: GCT Presentation Mapping Settings
mappings attributes path	see table: GCT Attribute Mapping Settings	See table: GCT Attribute Mapping Settings
mappings classes path	see table: GCT Class Mapping Settings	See table: GCT Class Mapping Settings
backgroundColour	Load SVG - Background Color	Copy value
backgroundColour	Load SVG - Override Color	True
regularExpressions	DefaultBaseMapping.xml	Resolved under Pattern Mapping translation
unmappedAttributes	AttributeMapping.xml	Resolved under Attribute Mapping translation
svgScale	Rescale2dUnitsDef.xml - drawingResolution Rescale2dUnitsDef.xml - OLEResolution	Copy value
digitsInFloatValues	N/A	Log Warning: Setting: "Float Point Digits" is obsolete.
Use Pattern Mapping Based on Cell Extents	Patterns2d.xml	Conditions ObjectType=symbol, group, IncludeArea
Exclude blocks from pattern matching with area more than	Patterns2d.xml	Conditions, ObjectType=symbol, Size min, max
Increase Extents	Patterns2d.xml	IncludeArea
Cell	Patterns2d.xml	IncludeArea
Circle	Patterns2d.xml	IncludeArea
Closed Polyline	Patterns2d.xml	IncludeArea
Increase By Width	Patterns2d.xml	IncludeArea, right, left
Increase By Height	Patterns2d.xml	IncludeArea, top, bottom
Match Closed Objects Up To	Patterns2d.xml	Conditions ObjectType=polyline_closed, ovals, Size min, max
Multiline Text Tagging	Patterns2d.xml	Ungroup, ObjectType=mtext
clippingBox	N/A	Log Warning: Setting: Clipping Box - not imported as Segmentation is not supported.
lineWeight	Rescale2dUnitsDef.xml - lineResolution type="lines"	Copy value
rscFonts	ExampleTextMapping.xml	True -> add font map from GCTPresentationFile
zoomToExtent	N/A	If False Log Warning: Setting: "Zoom Extents Before Processing" is not upgraded. 'True' is default in Gateway for 2D Data.
v7Upgrade	N/A	If True Log Warning: Setting: "Run MicroStation Upgrade Utitlity" is not upgraded as not supported in Gateway for 2D Data.
viewPort	N/A	Log Warning: Setting: "viewPort" is obsolete.
hiddenLevels	Extract	Copy value
constructionelements	Extract	Copy value
removelowprioritylines	N/A	If True Log Warning: Setting: "Remove Low Priority Lines" is not upgraded as not supported in Gateway for 2D Data.
timeout	General Settings - Timeout	Output Path = copy value, Type = File System
tagCsvFile	Transform extension "CSVReporting"	See below: CSV Export Conversion Table
GCT Presentation Mapping Settings	New Gateway Target	Comment
removeLevels	DefaultBaseMapping.xml	Resolved by 'Remove' feature for objects with attribute 'layer' set in pattern
colours	ExamplePresentationMapping.xml	Color mapping
cells	DefaultBaseMapping.xml	ObjectId is set to Cell name, ClassId is set to value provided in mapping
levels	DefaultBaseMapping.xml	ObjectId is set to Level name, ClassId is set to value provided in mapping
filenamepatterns	NameMapping.xml	Resolved by adding additional Base Mapping file.
replacecharacters	ExampleTextMapping.xml	Add text mapping
explodeCells	Pattens2d.xml	Ungroup, ObjectType=symbol, numberOfObjects min, max, attribute name=block name
convertCells	N/A	Log Warning: Setting: "Convert Cells" is not upgraded as not supported in Gateway for 2D Data.
excludeCellsFromPatternMapping	DefaultBaseMapping.xml	Resolved by add attributes "#EXCLUDE_FROM_EIWM#", "#EXCLUDE_FROM_SVG#", "#EXCLUDE_FROM_CSV#" for objects with attribute 'block name' set in pattern
defaultfont	ExampleTextMapping.xml	Add map for missing fonts <font from="#missingFonts#" to="[font]" />
fonts	ExampleTextMapping.xml	Add font mapping
GCT Pattern Mapping Settings	New Gateway Target	Comment
all mappings	BaseMapping_[original_GCT_pattern_mapping_file_name].xml	Conversion with respect both GCT and new user guides
Supported keys: from, modifier (untag, ignore), entity (block, text), illegal, block, layer, to, expand, context, ~ (reverse), qualifier, separator, modifiers, replacespace, prefix, suffix	BaseMapping_[original_GCT_pattern_mapping_file_name].xml	Conversion with respect both GCT and new user guides
Not supported keys: prefixqualifierclassification, suffixqualifierclassification	N/A	Log Warning: feature [prefixqualifierclassification, suffixqualifierclassification] not converted.
GCT Attribute Mapping Settings	New Gateway Target	Comment
all mappings	BaseMapping_[original_GCT_attribute_mapping_file_name].xml	Conversion with respect both GCT and new user guides
Supported keys: class, from, to, separator, retag, output	BaseMapping_[original_GCT_attribute_mapping_file_name].xml	Conversion with respect both GCT and new user guides
GCT Class Mapping Settings	New Gateway Target	Comment
all mappings	BaseMapping_[original_GCT_class_mapping_file_name].xml	Conversion with respect both GCT and new user guides
Supported keys: from, to, modifier (untag, ignore)	BaseMapping_[original_GCT_class_mapping_file_name].xml	Conversion with respect both GCT and new user guides
CSV Export Conversion Table GCT Column	New Gateway Target	Comment
TAG	Transformer extension: CSVReporting attribute: 'columns'	ObjectID
REGEXON	N/A	N/A
PMEXPRESSION	Transformer extension: CSVReporting xml node: 'column'	CSVReporting add node 'column' #Tracking: AttributeName BMExpression #Filter: AttributeName: ObjectID " BaseMappings annotation level: "ObjectIdTracking"
CLASS	Transformer extension: CSVReporting attribute: 'columns'	ClassID
ALIAS	Transformer extension: CSVReporting attribute: 'columns'	#Association:is identified by #TargetAttribute:ObjectID
[any characteristic]	Transformer extension: CSVReporting attribute: 'columns'	Copy value

The following table lists the full upgrade information with respect to AutoCAD 2D syntax:

GCT Project - Common Setting	New Gateway Target	Comment
logFolder path	General Settings - Log Path	copy value
logFolder debug	General Settings - Log Level	False -> Log Level: Warning, True -> Log Level: Verbose
environmentVariable	Extract	Imported into 'Fonts and Support Folders'
<inputOutputFolders create="true" />	N/A	no action
<exampleData install="true" />	N/A	no action
<moveProcessedUnprocessedFiles apply="false" />	N/A	Information
objectIdFromVnetFile	N/A	Warning
generateCategorizedLog	General Settings - Categorized Logs	copy value
GCT Project - AC2D Settings	New Gateway Target	Comment
inputs path	Extract	Input Path = copy value, Type = File System
outputs path	Load EIWM	Output Path = copy value, Type = File System
outputs path	Load SVG	Output Path = copy value, Type = File System
outputs path	Load CSV	Output Path = copy value
mappings patterns path	see table: GCT Pattern Mapping Settings	see table: GCT Pattern Mapping Settings
mappings patterns defaultContext	Load EIWM - Project Context	Output Path = copy value, Type = File System
mappings presentation path	see table: GCT Presentation Mapping Settings	see table: GCT Presentation Mapping Settings
mappings attributes path	see table: GCT Attribute Mapping Settings	see table: GCT Attribute Mapping Settings
mappings classes path	see table: GCT Class Mapping Settings	see table: GCT Class Mapping Settings
backgroundColour	Load SVG - Background Color	copy value
backgroundColour	Load SVG - Override Color	true
regularExpressions	DefaultBaseMapping.xml	resolved under Pattern Mapping translation
unmappedAttributes	AttributeMapping.xml	resolved under Attribute Mapping translation
svgScale	Rescale2dUnitsDef.xml - drawingResolution	copy value
visualStyle2dWireFrame	Extract - Visual Styles - Style	False -> mixed, True -> Wireframe
digitsInFloatValues	N/A	Warning
Change Extents	Patterns2d.xml	IncludeArea
Move Nested Blocks To Root	Patterns2d.xml	ungroup, ObjectType=symbol_nested, keepSingle=true
Explode Blocks With Text Only	Patterns2d.xml	ungroup ObjectType=symbol_nested_textonly, symbol_single_textonly, keepSingle=false
Use Pattern Mapping Based on Block Extents	Patterns2d.xml	conditions ObjectType=symbol, group, IncludeArea
Exclude blocks from pattern matching with area more than	Patterns2d.xml	conditions, ObjectType=symbol, Size min, max
Increase Extents	Patterns2d.xml	IncludeArea
Block	Patterns2d.xml	IncludeArea
Circle	Patterns2d.xml	IncludeArea
Closed Polyline	Patterns2d.xml	IncludeArea
Increase By Width	Patterns2d.xml	IncludeArea, right, left
Increase By Height	Patterns2d.xml	IncludeArea, top, bottom
Match Closed Objects Up To	Patterns2d.xml	conditions ObjectType=polyline_closed, ovals, Size min, max
Multiline Text Tagging	Patterns2d.xml	ungroup, ObjectType=mtext
clippingBox	N/A	Log Warning: Setting: Clipping Box - not imported as Segmentation is not supported.
lineWeight	Rescale2dUnitsDef.xml - lineResolution type="lines"	copy value
shxFonts	ExampleTextMapping.xml	True -> add font map from GCTPresentationFile
strokeWidth (Increase Tagged Text Thickness)	N/A	Warning
changeView	Extract - Layouts Selection - Filter	True\|Model Space -> #Model#, True\|Paper Space -> #1stpaper#
processAlternativeViewIfEmpty	Extract - Layouts Selection - Filter	True -> #1stpaper#
hiddenLayers	N/A	True -> Warning
graphicsMode	N/A	Warning
timeout	General Settings - Timeout	Output Path = copy value, Type = File System
tagCsvFile - create	Load CSV	True -> Type = File System, True -> Type = None
exportalllayouts	Extract - Layouts Selection - Filter	True -> #allpaper#
GCT Presentation Mapping Settings	New Gateway Target	Comment
removeLayers	DefaultBaseMapping.xml	Resolved by 'Remove' feature for objects with attribute 'layer' set in pattern
colours	ExamplePresentationMapping.xml	Color mapping
layers	DefaultBaseMapping.xml	ObjectId is set to Layer name, ClassId is set to value provided in mapping
blocks	DefaultBaseMapping.xml	ObjectId is set to Block name, ClassId is set to value provided in mapping
blocks + extractallblockreferencetags (project setting)	DefaultBaseMapping.xml	ObjectId is set to Block name with AutoNumber, ClassId is set to value provided in mapping
filenamepatterns	NameMapping.xml	Resolved by adding additional Base Mapping file.
removeBlocks	DefaultBaseMapping.xml	Resolved by 'Remove' feature for objects with attribute 'block name' set in pattern
explodeBlocks	Pattens2d.xml	ungroup, ObjectType=symbol, numberOfObjects min, max, attribute name=block name
convertBlocks	Extract - Blocks - Block	Replace block with image
excludeBlocksFromPatternMapping	DefaultBaseMapping.xml	Resolved by add attributes "#EXCLUDE_FROM_EIWM#", "#EXCLUDE_FROM_SVG#", "#EXCLUDE_FROM_CSV#" for objects with attribute 'block name' set in pattern
defaultfont	ExampleTextMapping.xml	add map for missing fonts <font from="#missingFonts#" to="[font]" />
fonts	ExampleTextMapping.xml	add font mapping
purge purgeall	N/A
GCT Pattern Mapping Settings	New Gateway Target	Comment
all mappings	BaseMapping_[original_GCT_pattern_mapping_file_name].xml	conversion with respect both GCT and new user guides
Supported keys: from, modifier (untag, ignore), entity (block, text), illegal, block, layer, to, expand, context, ~ (reverse), qualifier, separator, modifiers, replacespace, prefix, suffix	BaseMapping_[original_GCT_pattern_mapping_file_name].xml	conversion with respect both GCT and new user guides
Not supported keys: prefixqualifierclassification, suffixqualifierclassification	N/A	Log Warning: feature [prefixqualifierclassification, suffixqualifierclassification] not converted.
GCT Attribute Mapping Settings	New Gateway Target	Comment
all mappings	BaseMapping_[original_GCT_attribute_mapping_file_name].xml	conversion with respect both GCT and new user guides
Supported keys: class, from, to, separator, retag, output	BaseMapping_[original_GCT_attribute_mapping_file_name].xml	conversion with respect both GCT and new user guides
GCT Class Mapping Settings	New Gateway Target	Comment
all mappings	BaseMapping_[original_GCT_class_mapping_file_name].xml	conversion with respect both GCT and new user guides
Supported keys: from, to, modifier (untag, ignore)	BaseMapping_[original_GCT_class_mapping_file_name].xml	conversion with respect both GCT and new user guides
CSV Export Conversion Table GCT Column	New Gateway Target	Comment
TAG	Transformer extension: CSVReporting attribute: 'columns'	ObjectID
REGEXON	N/A	N/A
PMEXPRESSION	Transformer extension: CSVReporting xml node: 'column'	CSVReporting add node 'column' #Tracking: AttributeName BMExpression #Filter: AttributeName: ObjectID " BaseMappings annotation level: "ObjectIdTracking"
CLASS	Transformer extension: CSVReporting attribute: 'columns'	ClassID
ALIAS	Transformer extension: CSVReporting attribute: 'columns'	#Association:is identified by #TargetAttribute:ObjectID
[any characteristic]	Transformer extension: CSVReporting attribute: 'columns'	copy value

The following table lists the AVEVA NET Gateway Configuration Tool project settings (for AutoCAD 2D), which are upgraded in the new AVEVA™ Gateway for 2D Data settings:

AVEVA Gateway Configuration Tool General Settings	AVEVA Gateway for 2D Data Target	Comment
inputs path	Extractor Config
outputs path	SVG, EIWM, CSV Loaders Configs
type	SVG Loader Config	Setting to set output type SVG
defaultContext	EIWM Loader Config
backgroundColour	SVG Loader Config
processXrefs	Base Mapping	Resolved by 'Remove' feature for objects with attribute 'saved path' (specific for Xrefs)
tagCsvFile	CSV Loader Config	See 'CSV Export Conversion Table'
logFolder	Project Config
debug	Project Config	Resolved by setting Log level to 'Verbose'
environmentVariable	Extractor Config	Imported into 'Fonts and Support Folders
moveProcessedUnprocessedFiles	N/A	Log Information: "Setting not imported as obsolete"
processed path	N/A
unprocessed path	N/A
restrictProcess	N/A	Log Information: Setting not imported as obsolete
objectIdFromVnetFile	N/A	Log Warning: In the Gateway for 2D Data, the Object ID From Vnet File functionality used in Gateway Configuration Tool's project is not supported. This feature is replaced by LookupDataSource feature in Base Mapping which can be used to map Object ID and Class ID from an external data source. In order to set it, see LookupDataSource.
inputOutputFolders	N/A
exampleData	N/A
lineWeight	N/A	Log Warning: All 2D entities will be exported with default line thickness (in case user selects value different than 1).

The following table lists the GCT configuration parameters which are no longer relevant:

GCT Project - Smart P&ID Setting	New Gateway Target	Comment
digitsInFloatValues	N/A	SVG coordinates have maximum float precision
objectIdFromVnetFile	N/A	Use the LookupDataSource feature in Base Mapping which to map Object ID and Class ID from an external data source
association type	N/A	Associations are created by default, and can be removed if needed in Base Mapping Associations configuration
generateIsAPartOf	N/A	Associations are created by default, and can be removed if needed in Base Mapping Associations configuration

The filenamepatterns setting in the AVEVA Gateway Configuration Tool is replaced by the Base Mapping in the new AVEVA Gateway for 2D Data, with the following configurations in the NameMapping.xml. This .xml modifies the filename whose value is stored in the #MODEL_NAME# attribute:

AVEVA™ Gateway for 2D Data

Appendix G: Upgrade from the Gateway Configuration Tool Project Settings

Table of Contents

Appendix G: Upgrade from the Gateway Configuration Tool Project Settings

Related Links