1

SMWG

Service Management Modelling Notes

Anthony Crowson

Colin Haddow

October 2009, ESTEC

October 15, 2008

2

SMWGTopics

Modelling• Tools – Magicdraw quick review

• General UML use and issues

Schema Generation• Capabilities, limitations

Document Generation• Capabilities, limitations

3

SMWGMagicdraw

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

SMWGMagicdraw

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

SMWGMagicdraw

Schema generation• “Code engineering”

• Round trip (but… see later)

• Customisable

• Not extensible

Document generation• “Report generation”

• Template engine (RTF, HTML, …)

• Extensible

6

SMWGModelling

Modelling – general additions• stereotypes

• datatypes

• modules

Demo in MD

7

SMWGSchema Generation

Two steps from Model to Schema

PIM -> PSM for XSD• One-way

• Updatable

PSM <-> Schema• Round trip (change model or schema)

8

SMWGPIM -> 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

SMWGXSD 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

SMWGSchema Generation

(Demonstration in MD)

11

SMWGBook (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

SMWGBook (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

SMWGBook (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

SMWGBook (part) Generation

Demonstrate• Template

• Result- Tables

- Diagrams

- Index, cross-references

• Text in model