erwin 7.x Data Modeler (File) - Import - 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 Requirements

This bridge:
  • is only supported on Microsoft Windows.

Bridge Specifications

Vendor erwin, Inc.
Tool Name erwin Data Modeler
Tool Version 7.x
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
Incremental Harvesting
Multi-Model Harvesting
Remote Repository Browsing for Model Selection
Data Profiling

Import tool: erwin, Inc. erwin Data Modeler 7.x (https://erwin.com/products/erwin-data-modeler/)
Import 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 from erwin 7.x Data Modeler (File) Import bridge: 'CaErwin7Xml' 10.1.0

This bridge will import both .erwin format files and .XML format files saved using erwin Data Modeler versions 7.x.

The bridge parses the .XML format files natively.

WARNING ONE:
The bridge requires the erwin Data Modeler COM/OLE API to be installed in order to parse .erwin format files. Therefore, erwin 7 Data Modeler must be properly installed and the specific .erwin file must be able to be opened on the machine executing this bridge.

WARNING TWO:
When creating the .xml version of a file (Save As... in erwin), select the 'XML Repository Format' option for the type of XML file that erwin creates. Here are the steps to create this type of Repository .XML file:
1. Open the .erwin file in erwin.
2. Select File, then Save As...
3. Select 'XML Repository Format File (*.xml)' for the 'Save as type' pulldown.
4. Specify a path and name for the exported file.
5. Click OK

Note that you may need a valid erwin license to save .XML files in the 'XML Repository Format'.

FREQUENTLY ASKED QUESTIONS

Q: What erwin version does this bridge support?
A: This import bridge supports the XML file version generated by erwin 7.0 build 1679 and later versions.

Q: How does the bridge import the ordering of attributes ?
A: The bridge imports the physical order preferably, if the information is present in the XML file, otherwise the logical order is used.
To view the physical column ordering in erwin 7:
- Switch to the model Physical View,
- In the 'Format' menu, select 'Stored Display Settings...',
- Click on the 'Physical' tab, and select the 'Physical Order' radio button.
This is the order erwin uses when generating SQL DDL, and MIMB will import this order, if it is available in the file.
If you wish to import the logical order, please derive a logical only model in erwin and import it.

WARNING ON POTENTIAL MISSING PHYSICAL NAMES

This issue is particularly relevant when you convert from erwin to ETL or BI (business intelligence) tools, or to the OMG CWM XMI standard. When you save a logical and physical model, the physical names of tables, columns, and keys might not always be saved into the XML file. When you use erwin to manage the automatic generation of physical names from logical names, only the generation rules are saved. This is not an issue for physical-only erwin models, which are often used to re-engineer existing databases.

The main workaround for this issue is to select the 'AllFusion Repository Format' radio button (as described above) when saving the .XML file. Just import the produced XML file in the erwin 7 import bridge as usual.

Another solution is to make sure all physical names are explicitly set, therefore not relying on any generation rules from the logical names.

Alternatively, you can derive a new physical model (to be saved as XML) from your existing logical and physical model. Select 'Derive New Model...' from the 'Tools' menu, and select 'New Model Type' as 'Physical'.
The next step of the wizard will then invoke all the generation rules to produce all the physical names.
The new physical model can then be saved as XML. Note that the logical names of the tables are also available in this new XML file, but unfortunately the logical names of attributes might still be missing.

Note that the bridge automatically parses the .ERWIN files using the correct XML generation function in erwin, so that the problem of missing physical names does not occur.

WARNING ON POTENTIAL MISSING DIMENSIONAL MODELING ROLES

This issue is particularly relevant when erwin is used for dimensional modeling to BI tools, or to the OMG CWM XMI standard. As for the physical name issue explained above, the dimensional modeling roles (Fact, Dimensional, or Outrigger) may not be available in the XML file if they are automatically calculated by erwin.

One solution, is to make sure all dimensional modeling roles are explicitly set (use the 'Table Editor', tab 'Dimensional'), therefore not relying on automatic calculations by erwin based on usage.


Bridge Parameters

Parameter Name Description Type Values Default Scope
File When creating the .xml version of a file (Save As... in erwin), it is recommended that one select the 'XML Repository Format' option for the type of XML file that erwin creates. Please see warnings in the overall bridge tool tip about using the standard XML format that erwin also provides.
Here are the steps to create this type of Repository .XML file:

1. Open the .erwin file in erwin.
2. Select File, then Save As...
3. Select 'XML Repository Format File (*.xml)' for the 'Save as type' pulldown.
4. Specify a path and name for the exported file.
5. Click OK

The bridge will use the generated XML or ERWIN file as input. Remember that erwin must be installed on the same machine that the bridge runs on in order for the ERWIN format to be parsed.
FILE
*.xml
*.erwin
*.erwin_tmpl
  Mandatory
Import UDPs A User Defined Property (UDP) is usually defined with a property definition object that has a default value. The objects the property applies to may also specify an explicit value for this property, or no value at all in which case the default value of the property definition applies.

This option allows you to control how property definitions and values are imported:

- By default, the bridge imports the property definition as a Property Type.

- 'As metadata' - Import an explicit value as Property Value, implicit values are not imported, the default value is kept on the Property Type only. This is the default behavior.

- 'As metadata, migrate default values' - Import explicit and implicit values as Property Value objects.

- 'In description, migrate default values' - Append the property name and value, even if implicit, to the object's description and/or comment (depending upon the design level). This allows you to export the UDP values to another tool which does not support the notion of UDP.

- 'Both, migrate default values' - Import the UDP value, even if implicit, both as metadata and in the object's description and/or comment (depending upon the design level).
ENUMERATED
As metadata
As metadata, migrate default values
In description, migrate default values
Both, migrate default values
As metadata  
Import relationship name Specifies how to import the relationship names from erwin

'From relationship name' - from the name property. This is the default.

'From relationship description' - from the description property.

'From derived name' - from the verb phrase derived name.

This option may be useful to some database modelers who decided to use the description property to document the relationships name instead of the regular name property.
ENUMERATED
From relationship name
From relationship description
From derived name
From relationship name  
Import column order from Specifies how to import the position of columns in tables
'Column order' - Order of the columns displayed in the erwin physical view.
'Physical order' - Order of the columns in the database, as generated in SQL DDL. This is the default value.

To view the columns physical order in erwin, edit the current subject area 'Stored Display Settings', then click on tab 'Physical', group 'Display Level', then on the 'Physical Order' radio button.
ENUMERATED
Column order
Physical order
Physical order  
Import owner schemas Specifies if owner schemas should be imported.

'True' - The owner schema for Tables, Views and other database objects is imported. This is the default value.

'False' - The owner schema for Tables, Views and other database objects is ignored. This option may be useful for models where physical names are not unique, to indicate the model should be treated as a logical model (not ready for SQL DDL generation) while physical information is still maintained the model.
BOOLEAN   True  
Import diagrams Specifies if diagrams should be imported.

'None' - Diagrams are not imported.

'Current view' - Only the current view of the diagrams are imported. This is the default value.

'All' - Diagrams are imported twice: once for the logical view and once for the physical view.
ENUMERATED
None
Current view
All
Current view  
Move entities to subject areas erwin entities belong under the model and may be assigned to one or more subject areas. This parameter is useful if the erwin modeler wished to use subject areas as conventional (UML) design packages with their own namespace where any entity may belong to ONLY one subject area.
Specifically, if entities belong to only one subject area, they will be placed in the corresponding package. Other entities are placed under the model. Additionally, this option assumes that all entities are defined within a user defined subject area.
BOOLEAN   False  

 

Bridge Mapping

Meta Integration Repository (MIR)
Metamodel
(based on the OMG CWM standard)
"erwin 7.x Data Modeler (File)"
Metamodel
CA ERwin Data Modeler (Model)
Mapping Comments
     
Argument Argument  
Comment Comment  
DefaultValue Default Value  
Description Definition  
DesignLevel Design Level  
Kind Kind  
Name Name  
NativeId Native Id  
PhysicalName Physical Name  
Position Position  
Association Relationship  
Aggregation Identifying True if identifying
Comment Comment  
Description Definition  
DesignLevel Design Level  
ExtraConstraint Constraint  
Name Name  
NativeId Native Id  
AssociationRole Unnamed RelationshipEnd, Named RelationshipEnd  
Multiplicity Cardinality  
Name Name  
OnDelete On Delete  
OnInsert On Insert  
OnUpdate On Update  
Source Source Based on the multiplicity of each role and the Identifying/Non Identifying property
Attribute Attribute, Column, Primary Key Column - Attribute, Primary Key Attribute, Column - Attribute, Primary Key Column  
Comment Comment  
Description Definition  
DesignLevel Design Level  
ExtraConstraint Constraint if the validation rule cannot be set on the type
Generate Generate  
InitialValue Default Value imported from the default value tag associated to this type
Name Physical Name, Name  
NativeId Native Id  
Optional Nullable  
PhysicalName Physical Name  
Position Position  
BusinessRule Min - Max, Valid Values List, Default Value, User-Defined  
Comment Comment  
Description Definition  
DesignLevel Design Level  
LowerBound Min  
Name Name  
NativeId Native Id  
PhysicalName Physical Name  
UpperBound Max  
Value Default Value, Text  
CandidateKey Candidate Key Group  
Comment Comment  
Description Definition  
DesignLevel Design Level  
Name Name  
NativeId Native Id  
PhysicalName Physical Name if set by the user
UniqueKey Unique Key True for Primary Key/Alternate Key, False for Inversion Entries
Class Entity, Table, Table - Entity, Data Source Table  
Comment Comment  
Description Definition  
DesignLevel Design Level  
DimensionalRole Dimensional Role  
DimensionalType Dimensional Type  
Generate Generate  
Name Physical Name, Name  
NativeId Native Id  
PhysicalName Physical Name  
ClassDiagram ER Diagram  
Comment Comment  
Description Definition  
DesignLevel Design Level  
MaxDefinitionLength Max Definition Length  
Name Name  
NativeId Native Id  
Notation Notation  
PhysicalName Physical Name  
Condition Condition  
Name Name  
ConnectionNamespace Folder  
Comment Comment  
Description Definition  
DesignLevel Design Level  
Name Name  
NativeId Native Id  
PhysicalName Physical Name  
ConnectionPackage Data Source Schema, Directory  
Comment Comment  
Description Definition  
DesignLevel Design Level  
Name Name  
NativeId Native Id  
PhysicalName Physical Name  
DatabaseSchema Database Schema  
Comment Comment  
Description Definition  
DesignLevel Design Level  
Name Name  
NativeId Native Id  
PhysicalName Physical Name  
DerivedType Domain The MIR UserDefined property is set to True for User Defined Domains
Comment Comment  
DataType Data Type See datatype conversion arrays
Description Definition  
DesignLevel Design Level  
InitialValue Initial Value imported from the default value tag associated to this type
Length Length extracted from the datatype
LowerBound Lower Bound imported from the validation rule associated to this type
Name Name  
NativeDataType Native Data Type  
NativeId Native Id  
NativeLogicalDataType Native Logical Data Type  
PhysicalName Physical Name computed from the datatype, length and precision
Scale Scale extracted from the datatype
UpperBound Upper Bound imported from the validation rule associated to this type
UserDataType User Data Type  
DesignPackage Subject Area  
Comment Comment  
Description Definition  
DesignLevel Design Level  
Name Name  
NativeId Native Id  
FlatTextFile Data Source File, File  
Comment Comment  
Description Definition  
DesignLevel Design Level  
Name Physical Name, Name  
NativeId Native Id  
PhysicalName Physical Name  
ForeignKey Foreign Key Group  
Comment Comment  
Description Definition  
DesignLevel Design Level  
Generate Generate  
Name Name  
NativeId Native Id  
PhysicalName Physical Name if set by the user
Generalization Subtype Relationship  
Complete Complete  
Description Definition  
DesignLevel Design Level set to Logical Only if involved in a transformation
Exclusive Exclusive  
Name Name  
NativeId Native Id  
GeneralizationRole Subtype Relationship Role  
Description Definition  
DesignLevel Design Level  
Name Name  
NativeId Native Id  
OnDelete On Delete  
OnInsert On Insert  
OnUpdate On Update  
Identity Identity  
Cache Cache  
Cycle Cycle  
IncrementValue Increment Value  
MaximumValue Maximum Value  
MinimumValue Minimum Value  
Name Name  
StartValue Start Value  
Index Index  
Clustered Clustered  
Comment Comment  
Description Definition  
DesignLevel Design Level  
Generate Generate  
Name Name  
NativeId Native Id  
PhysicalName Physical Name  
Unique Unique  
IndexMember Index Member  
Comment Comment  
Description Definition  
DesignLevel Design Level  
NativeId Native Id  
Position Position  
SortOrder Sort Order  
Note Note  
Author Author  
Importance Importance  
ModificationTime Modification Time  
Name Name  
NativeId Native Id  
Status Status  
Value Note  
PropertyElementTypeScope UDPs used for UDP values and column physical information specific to Teradata: COMPRESS, CASE and FORMAT
Name Name  
Scope Scope  
PropertyType UDP UDP design level: Logical and/or Physical
DataType Data Type  
Description Definition  
DesignLevel Design Level  
Group Group  
InitialValue Initial Value  
Name Name  
NativeId Native Id  
Position Position  
Usage Usage set to User
SQLViewAssociation View Relationship  
AliasName Alias Name  
Comment Comment  
Description Definition  
DesignLevel Design Level  
Name Name  
NativeId Native Id  
PhysicalName Physical Name  
SQLTableSequence Sequence  
SQLViewAttribute View Column  
Comment Comment  
Description Definition  
DesignLevel Design Level  
Expression Expression  
InitialValue Default Value  
Name Name  
NativeId Native Id  
Optional Nullable  
Position Position  
SQLViewEntity View  
Comment Comment  
Description Definition  
DesignLevel Design Level  
DimensionalRole Dimensional Role  
Generate Generate  
GroupByClause Group By Clause  
HavingClause Having Clause  
Name Name  
NativeId Native Id  
OrderByClause Order By Clause  
SelectType Select Type  
ViewStatement View Statement  
ViewStatementType View Statement Type  
ViewType View Type  
WhereClause Where Clause The View SQL if user defined or else the Where clause
Sequence Sequence  
Comment Comment  
DataType Data Type  
Description Definition  
DesignLevel Design Level  
Generate Generate  
Length Length  
Name Name  
NativeDataType Native Data Type  
NativeId Native Id  
Scale Scale  
StoreConnection Model Source, Data Source  
Comment Comment  
Connection Connection  
Description Definition  
DesignLevel Design Level  
Name Name  
NativeId Native Id  
PhysicalName Physical Name  
StoreType Store Type  
SystemMajorVersion System Major Version  
SystemMinorVersion System Minor Version  
SystemReleaseVersion System Release Version  
SystemType System Type  
SystemTypeOld System Type Old  
StoreModel Model  
Author Author  
Comment Comment  
CreationTime Creation Time  
Description Definition  
DesignLevel Design Level  
ModificationTime Modification Time  
Modifier Modifier  
Name Name  
NativeId Native Id  
PhysicalName Physical Name  
StoreType Store Type  
SystemMajorVersion System Major Version  
SystemMinorVersion System Minor Version  
SystemReleaseVersion System Release Version  
SystemType System Type  
SystemTypeOld System Type Old  
StoredProcedure Stored Procedure  
Comment Comment  
Description Definition  
DesignLevel Design Level  
Generate Generate  
Name Name  
NativeId Native Id  
Postcondition Postcondition  
Precondition Precondition  
Semantics Code  
Synonym Synonym  
Comment Comment  
Description Definition  
DesignLevel Design Level  
Generate Generate  
Name Name  
NativeId Native Id  
Trigger Trigger  
Comment Comment  
Description Definition  
DesignLevel Design Level  
FireOnDelete Fire On Delete  
FireOnInsert Fire On Insert  
FireOnUpdate Fire On Update  
Generate Generate  
Name Name  
NativeId Native Id  
Semantics Code  
TriggerType Trigger Type  
TypeValue Type Value  
Comment Comment  
Description Definition  
DesignLevel Design Level  
Name Name  
NativeId Native Id  
PhysicalName Physical Name  
Position Position  
Value Value