1 Copyright © 2013 by Lockheed Martin Corporation 8/1/2013 John Watson Lockheed Martin Document Definition and Generation within a SysML Model

2 Copyright © 2013 by Lockheed Martin Corporation Document Generation from Models Motivation: –Still need to produce Documents –Deliverable Documents were not visible in the model The Modelers couldn’t see the target deliverables It wasn’t clear what content in the model was used to populate the documents Didn’t see what was missing or wrong until the end of the development phase –Issues with existing report writer tools Document Not Organized like the Model Took long time to generate documents

3 Copyright © 2013 by Lockheed Martin Corporation Existing LM DocGen Overview System Elements SysML Model API DocGen Java Program Document Definition External Documents and Figures DocGen Profile Pre-Viewer

4 Copyright © 2013 by Lockheed Martin Corporation DocGen Using Views and Viewpoints System Elements SysML Model API DocGen Java Program External Documents and Figures DocGen Library Pre-Viewer Document Definition

5 Copyright © 2013 by Lockheed Martin Corporation Existing DocGen Diagram Link to “Vehicle Assembly Document”Vehicle Assembly Document Link to “Vehicle Assembly Document”Vehicle Assembly Document

6 Copyright © 2013 by Lockheed Martin Corporation DocGen Diagram with New Views

7 Copyright © 2013 by Lockheed Martin Corporation Doc Gen – Related Viewpoints

8 Copyright © 2013 by Lockheed Martin Corporation DocGen – Complete View

9 Copyright © 2013 by Lockheed Martin Corporation Observations Viewpoints –Added new attributes (and operations?) –Viewpoint Attributes and Tags contained default values Some values are redefined in a specialized View (method stereotype property?) Is there a need to inherit stereotype properties (tags) with «conform» relationship? –add {required} constraint for Viewpoint in metamodel? Views –Some Views didn’t require an «expose» relationship to be complete, e.g. Headings and some paragraphs –Some “paragraph” views were exposed to a model element for the purposes of: Retrieving a property value from the exposed element The value would be inserted in-line with the text of the paragraph

10 Copyright © 2013 by Lockheed Martin Corporation DocGen Library Contains re-usable elements –Viewpoints –Views –Document Templates –other model elements to define Views and Viewpoints

12 Copyright © 2013 by Lockheed Martin Corporation

13 Copyright © 2013 by Lockheed Martin Corporation IEEE Standard 1471 Recommended Practice for Architectural Description of Software-Intensive Systems Adopted also as ANSI Standard ISO/IEC 42010, Systems & Software Engineering — Architecture Description