erwin 9.x and 2019 R1 Data Modeler - Export - 7.1

Talend Data Catalog Bridges

author
Talend Documentation Team
EnrichVersion
7.1
EnrichProdName
Talend Big Data Platform
Talend Data Fabric
Talend Data Management Platform
Talend Data Services Platform
Talend MDM Platform
Talend Real-Time Big Data Platform
EnrichPlatform
Talend Data Catalog

Bridge Specifications

Vendor erwin, Inc.
Tool Name erwin Data Modeler
Tool Version 9.x, 2019 R1
Tool Web Site https://erwin.com/products/erwin-data-modeler/
Supported Methodology [Data Modeling] Data Store (Physical Data Model, Logical Data Model, Stored Procedure Expression Parsing), Graphical Layout via COM API on Native (.erwin) or Export (.XML) File

BRIDGE INFORMATION
Export tool: erwin, Inc. erwin Data Modeler 9.x, 2019 R1 (https://erwin.com/products/erwin-data-modeler/)
Export interface: [Data Modeling] Data Store (Physical Data Model, Logical Data Model, Stored Procedure Expression Parsing), Graphical Layout via COM API on Native (.erwin) or Export (.XML) File to erwin 9.x and 2019 R1 Data Modeler
Export bridge: 'CaErwin9Xml' 10.1.0

BRIDGE DOCUMENTATION
The bridge generates an erwin XML file.

ERWIN NATIVE FORMAT (.erwin):
The bridge requires the erwin Data Modeler COM/OLE API to export erwin metadata files.
Erwin Data Modeler must be properly installed with a valid license on the machine executing this bridge.
Starting with Erwin Data Modeler 9.8 / 2018 R1, Erwin requires the user to re-confirm the license in the UI if the tool has not been used for more than 72 hours.
In order to avoid this inconvenience, Erwin Data Modeler should be installed through the 'Offline Activation' email process which is available only on a node locked license.

ERWIN WINDOWS USER:
The bridge must run on behalf of the Windows user that can run the erwin software.
If the bridge is running as part of a Windows desktop application, then you must log on windows with that user.
If the bridge is running as part of a Windows service, then go to the Windows services and click on the 'Properties' menu of such service, go to the 'Log On' tab, select 'This account' and specify the same user name and password used as Windows session when using erwin, and restart the Windows service.

ERWIN WINDOWS COM API:
The bridge uses the Erwin Windows COM API via simple scripts (ErwinApi.js and ErwinXml.js).
If these scripts are not working properly, contact Erwin support to debug the issue (which may require re-installing erwin).
The scripts can be tested as follows:
cscript.exe //E:jscript //Nologo .\conf\MIRModelBridgeTemplate\ERwin\ERwinApi.js -version 9 -GetVersion
cscript.exe //E:jscript //Nologo .\conf\MIRModelBridgeTemplate\ERwin\ERwinXml.js -version 9 -from eMovies.xml -to eMovies.erwin -log eMoviesLog.txt


Bridge Parameters

Parameter Name Description Type Values Default Scope
File This bridge generates either an .XML or .erwin (native erwin) file.
The bridge determines which format based upon the extension of the file name in this bridge parameter.

In order to load the converted .XML model in erwin:

1. Choose 'Open' from the File menu.
2. In the 'List files of type' list box select XML Files (*.xml).
3. Locate the drive and the folder that contains the file you want to open.
- Double-click on the folders in the Folders list to switch to a different
- folder. If necessary, switch to a different drive by selecting a drive from the Drives list.
4. Locate the file you want to open. Type the name of the file in the 'File Name' text box or select it from the File Name list.
5. Click 'Open'.
FILE
*.xml
*.erwin
  Mandatory
Version Specify here the version of erwin to generate the data model for.

When generating an erwin 9 binary file (*.erwin), this version of the software must be installed locally.

When generating an erwin 9 xml file (*.xml), any version can be generated for use on the local or a remote computer.
ENUMERATED
Auto Detect
2019
2018
9.8
9.7
9.6
9.5.2
9.5
9.2
9.1
9.0
Auto Detect  
Design level Specify here the design level of the data model to generate.

'Logical only' : will generate a logical data model

'Physical only' : will generate a physical data model

'Logical & physical' : will generate a logical and physical data model

The default value for this option is 'Logical & physical'
ENUMERATED
Logical & physical
Logical only
Physical only
Logical & physical  
Target database Specify the target database. 'Auto Detect' means that the bridge will try to auto-detect the target database from the originating model. ENUMERATED
Auto Detect
DB2 for i 5.x/6.x/7.x
DB2 for LUW 9.1
DB2 for LUW 9.5
DB2 for LUW 9.7
DB2 for z/OS 8.1
DB2 for z/OS 9.1
DB2 for z/OS 12
Hive 2.1.x
Informix 9.x
MySQL 5.x
Netezza 7.2
ODBC/Generic 2.0
ODBC/Generic 3.0
Oracle 10.x
Oracle 11.x
PostgreSQL 9.6
Progress 9.x
SAS
SQL Server 2000
SQL Server 2005
SQL Server 2008
SQL Server 2012
SQL Server 2014
SQL Server 2016
SQL Azure
Sybase 12.5
Sybase 15
Sybase IQ 12.x
Sybase IQ 15.x
Teradata 2.6
Teradata 12
Teradata 13
Teradata 14.10
Teradata 15
Auto Detect  
Export dimensional properties This option enables the dimensional modeling features of erwin for this model and exports the dimensional role (Fact, Dimension, Outrigger) and dimensional type (fixed vs slowly changing) of the tables. BOOLEAN
False
True
False  
XML Indentation (pretty printing) This option controls the pretty printing of the XML, for the purpose of opening the generated file in a text editor.

For example, specify here a tabulation character, or some space characters.

By default, there is no indentation which leads to a more compact file.
STRING      
Validate XML Specify here if the generated xml file should be validated against the erwin XML Schema before it is converted to the *.erwin binary format.
This parameter is only used when generating a *.erwin binary file.
When generating an erwin xml file only, no validation is performed.
This parameter should be set to 'True' for most common usages.
BOOLEAN
False
True
True  
Connection Allows selecting a connection by name, if the source model contains multiple database connections.
If the source model contains multiple connections and this parameter value is left empty, the connection with the most objects is selected.
STRING      

 

Bridge Mapping

Meta Integration Repository (MIR)
Metamodel
(based on the OMG CWM standard)
"erwin 9.x and 2019 R1 Data Modeler"
Metamodel
CaErwin9Xml
Mapping Comments
     
Association Relationship / Foreign Key  
Aggregation Identifying/ Non Identifying  
Comment Comment  
Description Definition  
DesignLevel Logical_Only, Physical_Only  
Name Name Computed if not set
PhysicalName Physical_Name Foreign Key Constraint Name
AssociationRole Relationship / Foreign Key Two roles are created for each Relationship
Multiplicity Cardinality or Relationship_Nulls_Not_Allowed  
Name Parent To Child Phrase or Child-To-Parent Phrase  
OnDelete RI Actions: Delete Rule  
OnInsert RI Actions: Insert Rule  
OnUpdate RI Actions: Update Rule  
Source   Based on the multiplicity of each role and the Identifying/Non Identifying property
AssociationRoleNameMap Attribute/Index Used to connect the attributes involved in a Relationship
Attribute Attribute/Column  
Comment Comment  
Description Definition  
DesignLevel Logical Only, Physical Only  
ExtraConstraint Validation_Rule_Ref if the validation rule cannot be set on the type
Name Name  
Optional Null Option  
PhysicalName Physical Name  
Position Order, Physical_Order  
BaseType Domain, Attribute Data Type No equivalent, We create the 5 base types Erwin requires
BusinessRule Default Values, Validation Rules  
Comment Comment  
Description Definition  
DesignLevel Logical_Only, Physical_Only  
LowerBound Validation_Rule_Min_Value  
Name Name  
PhysicalName Physical_Name  
UpperBound Validation_Rule_Max_Value  
CandidateKey Key Group/Index (non Foreign Key)  
Comment Comment  
Description Definition  
DesignLevel Logical_Only, Physical_Only  
Name Name  
PhysicalName Physical Name if set by the user
UniqueKey   Create an Inversion Entry if uniqueKey is false
Class Entity/Table  
Comment Comment  
Description Definition  
DesignLevel Logical_Only, Physical_Only  
DimensionalRole Dimensional Notation Role Type  
DimensionalType Dimensional Notation Update Type  
Name Name  
PhysicalName Physical Name  
ClassDiagram ER Diagram  
Description Definition  
Name Name  
DatabaseSchema Owner Table, View Stored Procedure, Sequence or Index owner
DesignLevel Logical_Only, Physical_Only  
Name Name  
DerivedType Domain, Attribute Data Type  
Comment Domain_Comment  
DataType Datatype See datatype conversion arrays
Description Domain_Definition  
InitialValue Default and Default_Value imported from the Not Mapped value tag associated to this type
Length Datatype  
Name Name  
PhysicalName Physical_Domain_Name Mapped only if the Model is generated as Physical Only
Scale Datatype  
UserDefined   Mapped as a Domain only if it is user defined
DesignPackage Subject Area  
Description Definition  
Name Name  
ForeignKey Key Group/Index (Foreign Key)  
Comment Comment  
Description Definition  
DesignLevel Logical_Only, Physical_Only  
Name Name  
PhysicalName Physical_Name if set by the user
Generalization Supertype/Subtype  
DesignLevel Logical_Only, Physical_Only set to Logical Only if a transformation is created
Name Name Computed.
GeneralizationRole Supertype/Subtype Relationship  
Comment Comment  
Description Definition  
Name Name  
PhysicalName Physical_Name Foreign Key Constraint Name
Identity Sequence, Identity properties  
Cycle Cycle  
IncrementValue Increment By  
MaximumValue Maximum Value  
MinimumValue Minimum Value  
StartValue Starting Value  
Index Key Group/Index  
Clustered Index Clustered  
Description Definition  
DesignLevel Logical_Only, Physical_Only  
Name Name  
PhysicalName Physical_Name  
IndexMember Key Group Member/Index Member  
DesignLevel Logical_Only, Physical_Only  
Name Name  
Position Key Group Member Position  
SortOrder Key_Group_Sort_Order  
Note Note  
Value Comment  
Projection Drawing Object Graphical Information
BackgroundColor Fill Starting Color  
Bold Font Bold  
FontColor Font Color  
FontName Font Name  
FontSize Font Size  
Height Height The height is not available if the box is in AutoSize mode
Italic Font Italic  
LineColor Outline ?olor  
Strike Font Strikethrough  
Underline Font Underline  
Width Width The width is not available if the box is in AutoSize mode
X x  
Y y  
PropertyElementTypeScope User Defined Property  
Scope UDP Class  
PropertyType User Defined Property  
DataType Type  
Description Description  
DesignLevel   UDP design level: Logical and/or Physical
InitialValue Default value  
Name Name  
NativeId   Object id
PhysicalName   Not used
Position position  
Usage   set to User
PropertyValue User Defined Property  
Value Value value set on an object
RelationshipProjection Drawing Object Graphical Information
Bold Font Bold  
FontColor Font Color  
FontName Font Name  
FontSize Font Size  
Italic Font Italic  
LineColor Line ?olor  
LinePoints relationship path  
Strike Font Strikethrough  
Underline Font Underline  
X x relationship mid point
Y y relationship mid point
SQLViewAssociation View Relationship  
Comment Comment  
Description Definition  
DesignLevel Logical_Only, Physical_Only  
Name Name Computed if needed
PhysicalName Physical_Name  
SQLTableSequence Relationship Sequence  
SQLViewAttribute View Column  
Comment Comment  
Description Definition  
DesignLevel Logical_Only, Physical_Only  
Name Name  
PhysicalName Physical_Name  
Position Order  
SQLViewEntity View Table View Entity
Comment Comment No equivalent, (Erwin fails to import)
Description Definition  
DesignLevel Logical_Only, Physical_Only  
Name Name  
PhysicalName Physical_Name  
WhereClause View SQL or Where clause  
Sequence Sequence  
DataType Datatype  
Description Comment  
Length Datatype  
Name name  
NativeDataType Datatype  
Scale Datatype  
Shape Shape, Text Box  
BackgroundColor Fill Color  
Bold Font Bold  
FontColor Font Color  
FontName Font  
FontSize Font Size  
Height   Used to provide placement information
Italic Font Italic  
LineColor Line Color Object outline color
Name Name Object name as stored in MIR model
ShapeType   Type of the drawing object correspopnding to the Drawing Objects palette
Strike Font Strikeout  
Underline Font Underline  
X   Used to provide placement information
Y   Used to provide placement information
Z   Z-order of the object
StoreModel Model/Diagram The model is built using the elements contained in the ERwin file
Description Definition  
DesignLevel Logical_Only, Physical_Only  
Name Name Model Name
SystemType Target Server  
SystemTypeOld Target Server  
StoredProcedure Stored Procedure  
Description Comment  
DesignLevel Logical_Only, Physical_Only  
Name Name  
Semantics Template_Code  
Synonym Synonym  
Name Name  
Trigger Trigger Table Trigger
Description Comment  
Name Name  
Semantics Trigger_Body  
TriggerType Trigger_Fire  
TypeValue Validation Rule  
Name Name  
Position Order  
Value Definition