COPYRIGHT 2019 SPEC INNOVATIONS
How to Perform Model-Based
Reviews
STEVEN H. DAM, PH.D., ESEP
MARCH 28, 2019
COPYRIGHT 2019 SPEC INNOVATIONS
Asks Us Questions
Ask Us Your Questions
• Ask us your questions using
the panel on the left
• This presentation is being
recorded and will be made
available to you.
• Contact us after the webinar
through
o support@Innoslate.com
o Call 571.485.7800
o LinkedIn
o Twitter
HOW TO PERFORM MODEL-BASED REVIEWS 2
COPYRIGHT 2019 SPEC INNOVATIONS
Meet Your Host
• President and Founder of SPEC
Innovations
• Participated in the development of
C4ISR and the DoDAF
• Expert Systems Engineering
Professionals Certificate
• steven.dam@specinnovations.com
• @stevenhdam
3
COPYRIGHT 2019 SPEC INNOVATIONS
Agenda
• What is a Model-Based Review (MBR)?
• Why MBR?
• Capture the Criteria
• Add the Document Content
• Review the Models
• Cross Project Collaboration/Redaction
• Adding Artifact Workflow
• Collaboration
• Live Demo
HOW TO PERFORM MODEL-BASED REVIEWS 4
COPYRIGHT 2019 SPEC INNOVATIONS
What is a Model-Based Review?
• To develop documentation in a human-readable form that enables
linkages directly to the live diagrams and other aspects of the
database
• an interactive medium for reviews as well as development of the
design information
HOW TO PERFORM MODEL-BASED REVIEWS 5
COPYRIGHT 2019 SPEC INNOVATIONS
Why MBR?
• Simplifies the review process significantly
• Enables more of an “in-process review” approach
• Provides traceability through the lifecycle
• Pathway to Digital Engineering
HOW TO PERFORM MODEL-BASED REVIEWS 6
COPYRIGHT 2019 SPEC INNOVATIONS
Capture the Criteria
• identifying the review criteria used by the customer
• copying the document names shown and copying them to a MS
Word document or directly into Innoslate’s Import Analyzer
HOW TO PERFORM MODEL-BASED REVIEWS 7
COPYRIGHT 2019 SPEC INNOVATIONS
Import Analyzer
• Create your digital
document
o Requirements document
o Test plans
o CONOPS
o And more
HOW TO PERFORM MODEL-BASED REVIEWS 8
COPYRIGHT 2019 SPEC INNOVATIONS
Add Additional Documentation
• Add the specific documents that
must be created to meet the
criteria
• Use bolding, italics, underline,
subscripts, and superscripts, as
well as adding tables and other
information
HOW TO PERFORM MODEL-BASED REVIEWS 9
COPYRIGHT 2019 SPEC INNOVATIONS
Use Modeling Functionality
• The OV-1 is an asset diagram
from Innoslate
• establish a hyperlink
between the image and the
diagram by using the URL of
the diagram
HOW TO PERFORM MODEL-BASED REVIEWS 10
COPYRIGHT 2019 SPEC INNOVATIONS
Full Digital Traceability
HOW TO PERFORM MODEL-BASED REVIEWS 11
• The real benefit comes from being able to link between these
Statements and other aspects of the database, including Risk and
Decision entities.
COPYRIGHT 2019 SPEC INNOVATIONS
Baseline Your Documentation
• track any changes between
the original pre-MS-A
document and post
• Note that this action cannot
be undone, as organizations
will use this as part of a legal
process to ensure its
integrity
HOW TO PERFORM MODEL-BASED REVIEWS 12
COPYRIGHT 2019 SPEC INNOVATIONS
Reviewing the Models
HOW TO PERFORM MODEL-BASED REVIEWS 13
COPYRIGHT 2019 SPEC INNOVATIONS
Provide Access to the Reviewers
• We recommend sharing the project as “read only” with reviewers
• Reviewers can navigate the models and post comments in the
diagram views or directly in the individual entity views
• Reviewers can also use the chat functionality
• You can always un-share with people who you don’t want to have
access to the database
HOW TO PERFORM MODEL-BASED REVIEWS 14
COPYRIGHT 2019 SPEC INNOVATIONS
Cross Project Collaboration
• CPC allows for
redacted views
• Hide propriety or even
classified information
HOW TO PERFORM MODEL-BASED REVIEWS 15
COPYRIGHT 2019 SPEC INNOVATIONS
Quick Review Process
• Developers can
receive and respond
instantly
• Develop an
interaction between
the review team
and the developers
HOW TO PERFORM MODEL-BASED REVIEWS 16
COPYRIGHT 2019 SPEC INNOVATIONS
Create a Comment Summary
• Database View > Comment Report.
• The output of that report is a tabbed spreadsheet with all the
entities, their descriptions, and comments
HOW TO PERFORM MODEL-BASED REVIEWS 17
Not only are the comments and answers in one simple place, but it is also accessible directly in the database as well.
COPYRIGHT 2019 SPEC INNOVATIONS
Adding Artifact Workflow
• We want to
control the
approval cycle of
the document at
the Artifact level,
rather than
requirement by
requirement
• Create this model
using the State
Machine Diagram
HOW TO PERFORM MODEL-BASED REVIEWS 18
COPYRIGHT 2019 SPEC INNOVATIONS
Edit the Schema
• Add a Status attribute to the Artifact class
o Schema Editor>Artifact class>Add Property
HOW TO PERFORM MODEL-BASED REVIEWS 19
COPYRIGHT 2019 SPEC INNOVATIONS
Add the Transitions
• Workflow>Add Transitions
• We will identify
o who we want to be able to make the transition from one state to another
(Permissions)
o who is to be notified when such a transition occurs
o if we want to lock the entity after the transition
HOW TO PERFORM MODEL-BASED REVIEWS 20
COPYRIGHT 2019 SPEC INNOVATIONS
Complete Configuration Control
• If you make the changes
to the Status of the
Artifact of interest in
conjunction with
baselining the Artifact in
Document View, then you
can have complete
configuration control
over your review
documentation
HOW TO PERFORM MODEL-BASED REVIEWS 21
COPYRIGHT 2019 SPEC INNOVATIONS HOW TO PERFORM MODEL-BASED REVIEWS 22
Live Demo
COPYRIGHT 2019 SPEC INNOVATIONS
Summary
• Taking this approach to reviews will reduce the time and cost of
reviews and increase the quality of the results of the reviews
• The results of all the previous reviews will be accessible to
everyone who needs access
HOW TO PERFORM MODEL-BASED REVIEWS 23
COPYRIGHT 2019 SPEC INNOVATIONS
Questions and Answers
PLEASE USE THE PANEL ON THE LEFT TO
SUBMIT YOUR QUESTIONS.
HOW TO PERFORM MODEL-BASED REVIEWS 24
COPYRIGHT 2019 SPEC INNOVATIONS
Next Webinar
What?
Innoslate for New Users
When?
Tuesday, June 6th at 11:00 am EDT
Where?
Go To Webinar
HOW TO PERFORM MODEL-BASED REVIEWS 25
COPYRIGHT 2019 SPEC INNOVATIONS
Thank you for Joining Us
Stay Connected!
571.485.7800
blog.Innoslate.com
innoslate.com
SPEC Innovations
Innoslate User Group
@Innoslate
HOW TO PERFORM MODEL-BASED REVIEWS 26

How to Perform Model-Based Reviews

  • 1.
    COPYRIGHT 2019 SPECINNOVATIONS How to Perform Model-Based Reviews STEVEN H. DAM, PH.D., ESEP MARCH 28, 2019
  • 2.
    COPYRIGHT 2019 SPECINNOVATIONS Asks Us Questions Ask Us Your Questions • Ask us your questions using the panel on the left • This presentation is being recorded and will be made available to you. • Contact us after the webinar through o support@Innoslate.com o Call 571.485.7800 o LinkedIn o Twitter HOW TO PERFORM MODEL-BASED REVIEWS 2
  • 3.
    COPYRIGHT 2019 SPECINNOVATIONS Meet Your Host • President and Founder of SPEC Innovations • Participated in the development of C4ISR and the DoDAF • Expert Systems Engineering Professionals Certificate • steven.dam@specinnovations.com • @stevenhdam 3
  • 4.
    COPYRIGHT 2019 SPECINNOVATIONS Agenda • What is a Model-Based Review (MBR)? • Why MBR? • Capture the Criteria • Add the Document Content • Review the Models • Cross Project Collaboration/Redaction • Adding Artifact Workflow • Collaboration • Live Demo HOW TO PERFORM MODEL-BASED REVIEWS 4
  • 5.
    COPYRIGHT 2019 SPECINNOVATIONS What is a Model-Based Review? • To develop documentation in a human-readable form that enables linkages directly to the live diagrams and other aspects of the database • an interactive medium for reviews as well as development of the design information HOW TO PERFORM MODEL-BASED REVIEWS 5
  • 6.
    COPYRIGHT 2019 SPECINNOVATIONS Why MBR? • Simplifies the review process significantly • Enables more of an “in-process review” approach • Provides traceability through the lifecycle • Pathway to Digital Engineering HOW TO PERFORM MODEL-BASED REVIEWS 6
  • 7.
    COPYRIGHT 2019 SPECINNOVATIONS Capture the Criteria • identifying the review criteria used by the customer • copying the document names shown and copying them to a MS Word document or directly into Innoslate’s Import Analyzer HOW TO PERFORM MODEL-BASED REVIEWS 7
  • 8.
    COPYRIGHT 2019 SPECINNOVATIONS Import Analyzer • Create your digital document o Requirements document o Test plans o CONOPS o And more HOW TO PERFORM MODEL-BASED REVIEWS 8
  • 9.
    COPYRIGHT 2019 SPECINNOVATIONS Add Additional Documentation • Add the specific documents that must be created to meet the criteria • Use bolding, italics, underline, subscripts, and superscripts, as well as adding tables and other information HOW TO PERFORM MODEL-BASED REVIEWS 9
  • 10.
    COPYRIGHT 2019 SPECINNOVATIONS Use Modeling Functionality • The OV-1 is an asset diagram from Innoslate • establish a hyperlink between the image and the diagram by using the URL of the diagram HOW TO PERFORM MODEL-BASED REVIEWS 10
  • 11.
    COPYRIGHT 2019 SPECINNOVATIONS Full Digital Traceability HOW TO PERFORM MODEL-BASED REVIEWS 11 • The real benefit comes from being able to link between these Statements and other aspects of the database, including Risk and Decision entities.
  • 12.
    COPYRIGHT 2019 SPECINNOVATIONS Baseline Your Documentation • track any changes between the original pre-MS-A document and post • Note that this action cannot be undone, as organizations will use this as part of a legal process to ensure its integrity HOW TO PERFORM MODEL-BASED REVIEWS 12
  • 13.
    COPYRIGHT 2019 SPECINNOVATIONS Reviewing the Models HOW TO PERFORM MODEL-BASED REVIEWS 13
  • 14.
    COPYRIGHT 2019 SPECINNOVATIONS Provide Access to the Reviewers • We recommend sharing the project as “read only” with reviewers • Reviewers can navigate the models and post comments in the diagram views or directly in the individual entity views • Reviewers can also use the chat functionality • You can always un-share with people who you don’t want to have access to the database HOW TO PERFORM MODEL-BASED REVIEWS 14
  • 15.
    COPYRIGHT 2019 SPECINNOVATIONS Cross Project Collaboration • CPC allows for redacted views • Hide propriety or even classified information HOW TO PERFORM MODEL-BASED REVIEWS 15
  • 16.
    COPYRIGHT 2019 SPECINNOVATIONS Quick Review Process • Developers can receive and respond instantly • Develop an interaction between the review team and the developers HOW TO PERFORM MODEL-BASED REVIEWS 16
  • 17.
    COPYRIGHT 2019 SPECINNOVATIONS Create a Comment Summary • Database View > Comment Report. • The output of that report is a tabbed spreadsheet with all the entities, their descriptions, and comments HOW TO PERFORM MODEL-BASED REVIEWS 17 Not only are the comments and answers in one simple place, but it is also accessible directly in the database as well.
  • 18.
    COPYRIGHT 2019 SPECINNOVATIONS Adding Artifact Workflow • We want to control the approval cycle of the document at the Artifact level, rather than requirement by requirement • Create this model using the State Machine Diagram HOW TO PERFORM MODEL-BASED REVIEWS 18
  • 19.
    COPYRIGHT 2019 SPECINNOVATIONS Edit the Schema • Add a Status attribute to the Artifact class o Schema Editor>Artifact class>Add Property HOW TO PERFORM MODEL-BASED REVIEWS 19
  • 20.
    COPYRIGHT 2019 SPECINNOVATIONS Add the Transitions • Workflow>Add Transitions • We will identify o who we want to be able to make the transition from one state to another (Permissions) o who is to be notified when such a transition occurs o if we want to lock the entity after the transition HOW TO PERFORM MODEL-BASED REVIEWS 20
  • 21.
    COPYRIGHT 2019 SPECINNOVATIONS Complete Configuration Control • If you make the changes to the Status of the Artifact of interest in conjunction with baselining the Artifact in Document View, then you can have complete configuration control over your review documentation HOW TO PERFORM MODEL-BASED REVIEWS 21
  • 22.
    COPYRIGHT 2019 SPECINNOVATIONS HOW TO PERFORM MODEL-BASED REVIEWS 22 Live Demo
  • 23.
    COPYRIGHT 2019 SPECINNOVATIONS Summary • Taking this approach to reviews will reduce the time and cost of reviews and increase the quality of the results of the reviews • The results of all the previous reviews will be accessible to everyone who needs access HOW TO PERFORM MODEL-BASED REVIEWS 23
  • 24.
    COPYRIGHT 2019 SPECINNOVATIONS Questions and Answers PLEASE USE THE PANEL ON THE LEFT TO SUBMIT YOUR QUESTIONS. HOW TO PERFORM MODEL-BASED REVIEWS 24
  • 25.
    COPYRIGHT 2019 SPECINNOVATIONS Next Webinar What? Innoslate for New Users When? Tuesday, June 6th at 11:00 am EDT Where? Go To Webinar HOW TO PERFORM MODEL-BASED REVIEWS 25
  • 26.
    COPYRIGHT 2019 SPECINNOVATIONS Thank you for Joining Us Stay Connected! 571.485.7800 blog.Innoslate.com innoslate.com SPEC Innovations Innoslate User Group @Innoslate HOW TO PERFORM MODEL-BASED REVIEWS 26