1 SMWG Service Management Modelling Notes Anthony Crowson Colin Haddow October 2009, ESTEC October 15, 2008

2 SMWG Topics  Modelling Tools – Magicdraw quick review General UML use and issues  Schema Generation Capabilities, limitations  Document Generation Capabilities, limitations

3 SMWG Magicdraw  Tool: only looked at MD already agreed no expectation of finding clearly better solution  Versions 16.5 used so far 16.6 out, looks worth trying  Editions Standard - OK for all PIM (book contents) - Supports report (doc) generation Architect or Enterprise - needed for Schema work

4 SMWG Magicdraw  Model split into modules Good support, checking Allows parallel work Allows inclusion of core in sub-books  Model merge / compare plugin Extra cost Support parallel changes to one module Useful for book captain?  Support for config ctrl (cvs) built in

5 SMWG Magicdraw  Schema generation “Code engineering” Round trip (but… see later) Customisable Not extensible  Document generation “Report generation” Template engine (RTF, HTML, …) Extensible

6 SMWG Modelling  Modelling – general additions stereotypes datatypes modules  Demo in MD

7 SMWG Schema Generation  Two steps from Model to Schema  PIM -> PSM for XSD One-way Updatable  PSM Schema Round trip (change model or schema)

8 SMWG PIM -> XSD PSM  One-way update to add PIM changes  Specifiy Mapping of datatypes Set up appropriate set for SM datatypes Only map by types, not e.g. stereotypes  Doesn't copy documentation would be nice to get in annotations  No obvious way to control all/sequence/choice except as default setting for transform  Constraints copied to PSM but not implemented in Schema  Templates and bindings not preserved

9 SMWG XSD PSM Schema  Round-trip Can import changes in Schema file - Easy way to understand PSM  Supports most Schema capabilities Use stereotype tags to control  Cannot extend / modify built-in capabilities

10 SMWG Schema Generation  (Demonstration in MD)

11 SMWG Book (part) Generation  Velocity template engine  RTF templates supported (almost) all Word formatting & control also HTML, text, OpenOffice OpenOffice is only route to spreadsheets  Access to full UML model  Extension Javascript or Java

12 SMWG Book (part) Generation  Bookmarks / references  Potential limitation Create / reference bookmarks OK Can't put intelligible bookmarks into doc - E.g. to reference from non-generated text - Can work round with extension - Full CCSDS style not yet proven!

13 SMWG Book (part) Generation  Text Entry Support for formatting Not comfortable for large-scale entry MD 16.6 may be better  Less comfortable than editing a “proper” document  Balance against having info in model  Some scripted import is possible

14 SMWG Book (part) Generation  Demonstrate Template Result - Tables - Diagrams - Index, cross-references Text in model