XMDR Model Transformations

1
XMDR Model Transformations Rendering

• Harold Solbrig and John McCarthy
• XMDR Project Quarterly Meeting
• 19 July, 2006
• UC Berkeley Faculty Club

2
Goals of XMDR Model Transformations Rendering

• standard, English-like rendering of 11179 UML
• ala name of Doug Manns old favorite
• machine-readable model specifications
• alternate renderings of 11179 metamodel
• schemas for models output
• hierarchical lists of diagrams, classes, etc.
• etc.
• automated programs procedures for the above
• see page on project wiki (requires
  login/password)
• erdos.lbl.gov/mediawiki/index.php/11179_Diagrams 

3
Transformation Workflows
Poseidon XMI (XMI 1.2)
PoseidonXMIToModels.xsl
PoseidonXMIToDiagrams.xsl
Tool Specific
Generic

Models.xml
Diagrams.xml
Models, Classes, Associations
Diagrams object visibility
4
Diagrams.xml

• ltdiagrams
• xsinoNamespaceSchemaLocation"../schema
  /Diagrams.xsd"gt
• ltcomponent type"UMLClass" id"I4bbc27m1041f4d
  57a4mm31a6" name"Relation_Role"gt
• ltcomponent type"UMLPackage"
  id"I36962dm10bab331102mm5ab7" name"Common_Facili
  ties"/gt
• ltcomponent type"UMLPackage"
  id"I161204m10bab6f20c0mm583e" name"Concept_Syste
  ms"/gt
• ltcomponent type"UMLAttribute"
  id"I4bbc27m1041f4d57a4mm3180"
• name"minCardinality 0..1"gt
• ltcomponent type"UMLDataType"
  id"I6286e3m1014a03848dmm7a83" name"Integer"/gt
• lt/componentgt

5
Models.xml
ltmodels xsinoNamespaceSchemaLocation".
./schema/Models.xsd"gt ltmodel
id"I6286e3m1014a03848dmm7a7e"
name"11179-3 Edition 3 draft metamodel, Kevin D.
Keck, LBNL"gt ltpackage id"I6286e3m1014a03848
dmm7a8f" name"Core Variants"gt ltpackage
id"I2f719am10343fd528amm4ec7" name"Data Element
version 3"gt ltclass id"Ibb5ee1m10345f8
7ba7mm3311" name"Derivation_Rule"
isAbstract"false" assocClass"false"gt
ltassoc id"Ibb5ee1m10345f87ba7mm32e2
name"derivation_rule_application"
className"Derivation_Rule"
sourceRole"applied_to" isNavigable"true"
aggregationType"none"
minCardinality"1"
maxCardinality"1"gt
6
Transformation Workflows
Poseidon XMI (XMI 1.2)
Enterprise Architect XMI (XMI 1.2)
EAXMIToModels.xsl
PoseidonXMIToModels.xsl
EAXMIToDiagrams.xsl
PoseidonXMIToDiagrams.xsl
Tool Specific
Generic

Models.xml
Diagrams.xml
Models, Classes, Associations
Diagrams object visibility
transforms may need to be changed to fit the new
tool output because XMI 1.x standard is
underspecified and every tool does things its own
way.
7
Transformation Workflows
Enterprise Architect XMI (XMI 1.3)
Standard XMI (XMI 2.1)
EAXMIToModels.xsl
XMIToModels.xsl
EAXMIToDiagrams.xsl
XMIToDiagrams.xsl
Tool Specific
Standard(?)
Generic

Models.xml
Diagrams.xml
Models, Classes, Associations
Diagrams object visibility
Once the tools migrate to XML 2.1, there should
be only one tool-independent transform, assuming
that the OMG folks did their job correctly
8
Transformation Workflows
Poseidon XMI (XMI 1.3)
PoseidonXMIToModels.xsl
PoseidonXMIToDiagrams.xsl
Tool Specific
Generic

Models.xml
Diagrams.xml
Other transform processes are generic.
(although currently specific for the 11179 model
and have not been validated or tested
elsewhere).
9
Transformation Workflows
Models.xml
Diagrams.xml
Parameters
DiagramsToText.xsl
_diagrams_text_classes.xml

_diagrams_text_all.xml
Classes / Associations in English
_diagrams_text.xml
Diagram / Visible Objects in English
Diagram / All Objects in English
10
English text .xml

• ltdiagrams gt
• ltdiagram name"Administered_Items"
• caption"Figure 2 - Types of
  Administered Items (modified - Keck,
  2006-06-06)"gt
• ltclassDescription name"Administered_Item"gt
• ltsentencegt
• ltclassgtAdministered Itemlt/classgt is a
  subclass of ltclassgtClassifiable Itemlt/classgt.
  Every instance of ltclassgtAdministered
  Itemlt/classgt is also an instance of
  ltclassgtClassifiable Itemlt/classgt. lt/sentencegt
• ltsentencegt
• ltclassgtAdministered Itemlt/classgt is a
  subclass of ltclassgtDocumentable Itemlt/classgt.
  Every instance of ltclassgtAdministered
  Itemlt/classgt is also an instance of
  ltclassgtDocumentable Itemlt/classgt. lt/sentencegt
• ltsentencegt

11
Transformation Workflows
Models.xml
Diagrams.xml
Parameters
DiagramsToText.xsl
_diagrams_text_classes.xml

_diagrams_text_all.xml
converts output into a series of html files, one
per diagram
_diagrams_text.xml
TextoHTML.xsl
ltDiagramgt.html
12
Fig2.html

• ltheadgt
• ltmeta http-equiv"Content-Type"
  content"text/html charsetUTF-8" /gt
• lttitlegtFigure 2 - Types of Administered
  Items (modified - Keck, 2006-06-06)lt/titlegt
• lt/headgt
• ltbodygt
• ltdiv class"diagram"gt
• lth1gtDiagram Administered_Itemslt/h1gt
• ltspan class"classDescription"gt
• ltpgtltugtltbgtAdministered_Itemlt/bgtlt/ugt
• ltspan class"sentence"gtltbr /gt
• ltspan class"class"gtltbgtAdministe
  red Itemlt/bgtlt/spangt is a subclass of ltspan
  class"class"gtltbgtClassifiable Itemlt/bgtlt/spangt.
  Every instance of ltspan class"class"gtltbgtAdministe
  red Itemlt/bgtlt/spangt is also an instance of ltspan
  class"class"gtltbgtClassifiable Itemlt/bgtlt/spangt.
  .lt/spangt

Note classes on everything for easy .css styling
13
Fig2.html
14
Transformation programs

• DiagramsToText.xsl
• Transform to convert a _diagrams/_models XML into
  various collections marked up English text
• PoseidonXMIToDiagrams.xsl
• Transform a Poseidon XMI Schema into a
  hierarchical list of diagrams and their visible
  contents
• PoseidonXMIToModels.xsl
• transform a Poseidon XMI Schema into a 'standard'
  set of models, classes and the like
• TextToHtml.xsl
• render output of DiagramsToText in HTML.
• Utils.xsl
• utility methods used by PoseidonXMI... transforms

15
Schemas (per Frank requests)

• ClassText.xsd
• schema for flat list of classes
• Diagrams.xsd
• schema for hierarchical list of diagrams
• DiagramText.xsd
• schema for the marked up English text
• Models.xsd
• schema for the models output

16
Text, Models, and HTML Files

• text and models files
• iso11179-3e3draft_diagrams.xml
• iso11179-3e3draft_models.xml
• iso11179-3e3draft_diagrams_text.xml
• iso11179-3e3draft_diagrams_text_all.xml
• iso11179-3e3draft_diagrams_text_classes.xml
• html files
• allClasses.html
• from 3e3draft_diagrams_text_classes.xml
• Figltngt.html
• from iso11179-3e3draft_diagrams_text.xml
• Figltngt_all.html
• from iso11179-3e3draft_diagrams_text_all.xml

17
Online demo of diagrams text

• erdos.lbl.gov/mediawiki/index.php/11179_Diagrams