Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.
Difference between revisions of "Papyrus/Papyrus Developer Guide/Model your development"
(→Generate the documentation) |
(→Package org.eclipse.papyrus.uml.developer.mde) |
||
Line 149: | Line 149: | ||
===<span id="_-HwUkfXCEeWzTLgJvBjJCA">Package org.eclipse.papyrus.uml.developer.mde</span>=== | ===<span id="_-HwUkfXCEeWzTLgJvBjJCA">Package org.eclipse.papyrus.uml.developer.mde</span>=== | ||
====<span id="_-Hw7ofXCEeWzTLgJvBjJCA">Class Activator</span>==== | ====<span id="_-Hw7ofXCEeWzTLgJvBjJCA">Class Activator</span>==== | ||
− | + | ||
<span id="_-HxisfXCEeWzTLgJvBjJCA"> - specializes [[#_-vApM_W_EeWzTLgJvBjJCA|AbstractUIPlugin]]</span><br> | <span id="_-HxisfXCEeWzTLgJvBjJCA"> - specializes [[#_-vApM_W_EeWzTLgJvBjJCA|AbstractUIPlugin]]</span><br> | ||
− | <span id="_-HyJwfXCEeWzTLgJvBjJCA">The activator class controls the plug-in life cycle | + | <span id="_-HyJwfXCEeWzTLgJvBjJCA">The activator class controls the plug-in life cycle</span><br> |
− | + | ||
====<span id="_-Hyw0fXCEeWzTLgJvBjJCA">Interface I_DeveloperIDMStereotype</span>==== | ====<span id="_-Hyw0fXCEeWzTLgJvBjJCA">Interface I_DeveloperIDMStereotype</span>==== | ||
− | |||
− | |||
− | + | <span id="_-HzX4fXCEeWzTLgJvBjJCA">constant included in the MDE process profile</span><br> | |
====<span id="_-Hz-8fXCEeWzTLgJvBjJCA">Interface I_DocumentStereotype</span>==== | ====<span id="_-Hz-8fXCEeWzTLgJvBjJCA">Interface I_DocumentStereotype</span>==== | ||
− | |||
− | |||
− | + | <span id="_-H0mAfXCEeWzTLgJvBjJCA">list of constant contained in the document profile </span><br> | |
====<span id="_-H1NEfXCEeWzTLgJvBjJCA">Package command</span>==== | ====<span id="_-H1NEfXCEeWzTLgJvBjJCA">Package command</span>==== | ||
− | |||
<br> | <br> | ||
[[Image:Command_ClassDiagram.png|Command ClassDiagram]] | [[Image:Command_ClassDiagram.png|Command ClassDiagram]] | ||
Line 171: | Line 165: | ||
=====<span id="_-MUEcfXCEeWzTLgJvBjJCA">Class CreateDocumentModelCommand</span>===== | =====<span id="_-MUEcfXCEeWzTLgJvBjJCA">Class CreateDocumentModelCommand</span>===== | ||
<span id="_-MUrgfXCEeWzTLgJvBjJCA"> - specializes [[#_-2i0lfW_EeWzTLgJvBjJCA|RecordingCommand]]</span><br> | <span id="_-MUrgfXCEeWzTLgJvBjJCA"> - specializes [[#_-2i0lfW_EeWzTLgJvBjJCA|RecordingCommand]]</span><br> | ||
− | <span id="_-MVSkfXCEeWzTLgJvBjJCA"> this command transform a model to document model | + | <span id="_-MVSkfXCEeWzTLgJvBjJCA"> this command transform a model to document model</span><br> |
− | + | ||
− | + | ||
====<span id="_-MV5ofXCEeWzTLgJvBjJCA">Package handler</span>==== | ====<span id="_-MV5ofXCEeWzTLgJvBjJCA">Package handler</span>==== | ||
− | |||
<br> | <br> | ||
[[Image:Handler_ClassDiagram.png|Handler ClassDiagram]] | [[Image:Handler_ClassDiagram.png|Handler ClassDiagram]] | ||
Line 182: | Line 173: | ||
=====<span id="_-N0gUfXCEeWzTLgJvBjJCA">Class GetHTMLTextHandler</span>===== | =====<span id="_-N0gUfXCEeWzTLgJvBjJCA">Class GetHTMLTextHandler</span>===== | ||
<span id="_-N1HYfXCEeWzTLgJvBjJCA"> - specializes [[#_-N2VgfXCEeWzTLgJvBjJCA|IDMAbstractHandler]]</span><br> | <span id="_-N1HYfXCEeWzTLgJvBjJCA"> - specializes [[#_-N2VgfXCEeWzTLgJvBjJCA|IDMAbstractHandler]]</span><br> | ||
− | <span id="_-N1ucfXCEeWzTLgJvBjJCA">This class is used to create and html developper doc file. | + | <span id="_-N1ucfXCEeWzTLgJvBjJCA">This class is used to create and html developper doc file.</span><br> |
− | + | ||
=====<span id="_-N2VgfXCEeWzTLgJvBjJCA">Class IDMAbstractHandler</span>===== | =====<span id="_-N2VgfXCEeWzTLgJvBjJCA">Class IDMAbstractHandler</span>===== | ||
<span id="_-N28kfXCEeWzTLgJvBjJCA"> - specializes [[#_-44W4fW_EeWzTLgJvBjJCA|AbstractHandler]]</span><br> | <span id="_-N28kfXCEeWzTLgJvBjJCA"> - specializes [[#_-44W4fW_EeWzTLgJvBjJCA|AbstractHandler]]</span><br> | ||
− | <span id="_-N3jofXCEeWzTLgJvBjJCA">Abstract handler in order to connect to papyrus | + | <span id="_-N3jofXCEeWzTLgJvBjJCA">Abstract handler in order to connect to papyrus</span><br> |
− | + | ||
=====<span id="_-N4KsfXCEeWzTLgJvBjJCA">Class GetWikiTextHandler</span>===== | =====<span id="_-N4KsfXCEeWzTLgJvBjJCA">Class GetWikiTextHandler</span>===== | ||
<span id="_-N4xwfXCEeWzTLgJvBjJCA"> - specializes [[#_-N2VgfXCEeWzTLgJvBjJCA|IDMAbstractHandler]]</span><br> | <span id="_-N4xwfXCEeWzTLgJvBjJCA"> - specializes [[#_-N2VgfXCEeWzTLgJvBjJCA|IDMAbstractHandler]]</span><br> | ||
− | <span id="_-N5Y0fXCEeWzTLgJvBjJCA"> This class is used to create and wiki developper doc file. | + | <span id="_-N5Y0fXCEeWzTLgJvBjJCA"> This class is used to create and wiki developper doc file.</span><br> |
− | + | ||
− | + | ||
====<span id="_-N5_4fXCEeWzTLgJvBjJCA">Package transcription</span>==== | ====<span id="_-N5_4fXCEeWzTLgJvBjJCA">Package transcription</span>==== | ||
− | |||
<br> | <br> | ||
[[Image:Transcription_ClassDiagram.png|Transcription ClassDiagram]] | [[Image:Transcription_ClassDiagram.png|Transcription ClassDiagram]] | ||
Line 201: | Line 187: | ||
=====<span id="_-RgGcPXCEeWzTLgJvBjJCA">Class HTMLTranscription</span>===== | =====<span id="_-RgGcPXCEeWzTLgJvBjJCA">Class HTMLTranscription</span>===== | ||
<span id="_-RgtgfXCEeWzTLgJvBjJCA"> - realizes [[#_-Rh7ofXCEeWzTLgJvBjJCA|ITranscription]]</span><br> | <span id="_-RgtgfXCEeWzTLgJvBjJCA"> - realizes [[#_-Rh7ofXCEeWzTLgJvBjJCA|ITranscription]]</span><br> | ||
− | <span id="_-RhUkfXCEeWzTLgJvBjJCA">This class is a specialization to generate html files. | + | <span id="_-RhUkfXCEeWzTLgJvBjJCA">This class is a specialization to generate html files. </span><br> |
− | + | ||
− | + | ||
=====<span id="_-Rh7ofXCEeWzTLgJvBjJCA">Interface ITranscription</span>===== | =====<span id="_-Rh7ofXCEeWzTLgJvBjJCA">Interface ITranscription</span>===== | ||
− | <span id="_-RiisfXCEeWzTLgJvBjJCA">This class is used to generated very swiftly a document from the document model | + | <span id="_-RiisfXCEeWzTLgJvBjJCA">This class is used to generated very swiftly a document from the document model</span><br> |
− | + | ||
− | + | ||
=====<span id="_-RjJwfXCEeWzTLgJvBjJCA">Class TranscriptionEngine</span>===== | =====<span id="_-RjJwfXCEeWzTLgJvBjJCA">Class TranscriptionEngine</span>===== | ||
− | <span id="_-Rjw0fXCEeWzTLgJvBjJCA"> This class is an engine to traduce a document model into files | + | <span id="_-Rjw0fXCEeWzTLgJvBjJCA"> This class is an engine to traduce a document model into files</span><br> |
− | + | ||
=====<span id="_-RkX4PXCEeWzTLgJvBjJCA">Class WikiTranscription</span>===== | =====<span id="_-RkX4PXCEeWzTLgJvBjJCA">Class WikiTranscription</span>===== | ||
− | <span id="_-Rk-8PXCEeWzTLgJvBjJCA">This class is a specialization to generate mediawiki files. | + | <span id="_-Rk-8PXCEeWzTLgJvBjJCA">This class is a specialization to generate mediawiki files.</span><br> |
− | + |
Revision as of 11:40, 29 March 2016
Contents
- 1 How to use MDE to develop Papyrus
How to use MDE to develop Papyrus
Table of Contents
Requirements
- REQ_001 (id=REQ_001):
The tool must help to model papyrus development
- REQ_0011 (id=REQ_0011):
The tool must help to model requirements.
- REQ_0012 (id=REQ_0012):
The tool must help to make the design
- REQ_0013 (id=REQ_0013):
The tool must help to model test
- REQ_0014 (id=REQ_0014):
The model of development must contain traceability
- REQ_0015 (id=REQ_0015):
The tool must help to model use cases.
- REQ_002 (id=REQ_002):
From the model, it must be able to generate documentation
- REQ_0021 (id=REQ_0021):
From the model, it must be able to generate HTML documentation
- REQ_0022 (id=REQ_0022):
From the model, it must be able to generate WKIMEDIA documentation
Use Cases
UseCases
In order to model your development and generate your documentation.
You must install a version of SysML and the plugin org.eclipse.papyrus.uml.developer.mde that can been found in the git org.eclipse.papyrus\plugins\developer
PapyrusMDE
Model Requirements
- traces to REQ_0011
The Designer has to create a use case inside the "requirements" model.
The requirement may be functional or non functional.
Requirements has to be refined or decompose until it can be tested.
How to
In order to create requirement, the Designer can use the module "Papyrus Requirement" that help to create requirements
Create a requirement
Model Use Cases
- traces to REQ_0015, REQ_0014
The "Designer" has to develop Use cases that are refinement of the functional requirements.
In each use case, a comment has to be added in order to explain the use case.
In each use case, the designer has to add a set of comment stereotyped "userDoc" in order to write the how to.
Each Use case must have a link "satisfy" with the refined requirement
How to
In order to create a use case, the designer has to create a use case in the component inside the UseCase model.
Create a Use Case
In each Use case, the designer has to add a nested comment in order to explain the goal of the use case, (it can be also an activity diagram or sequence diagram)
Create a comment
The designer has also to explain how a user can execute this function. This is the "how to" section, the purpose is to explain step by step how the user can do in order to run the functionality.
To do that, create a comment stereotyped "UserDoc" write you text inside or associate a screenshot of your execution by adding a hyperlink on this comment.
Add a comment for the user doc
Reference an image by using hyperlinks
Model the design
- traces to REQ_0012, REQ_0014
The designer must model its development in order to be able to explain its architecture, the behavior, choices of its tool.
How to
To do that, the designer can design the model or make a retro-engineering of the code. To that papyrus provides in papyrus designer a generator and retro tool for the java or C++code.
Model Tests
- traces to REQ_0013, REQ_0014
The Designer must add a least one test case for each use case.
A test case is a use case stereotyped "UseCaseTest". The Use case must contain an activity that represents the java class that represents the code of you test.
How to
To do that, go to the "Test" model, create use case and stereotype it "Use case Test". This is the scenario to test a use case.
In the use case add a comment and explain the scenario.
In the code you must have a JUnit or a java class that corresponds tho this test. Copy qualified name of your test and add it as an activity.
Then add a verify link from the test the use case to the requirement. Use papyrus requirement in order to simplify creation of links.
Use Case Test
Generate the documentation
- traces to REQ_002, REQ_0021, REQ_0022
From the model, it possible to generate the developer Document.
This generation is done in two steps: first the tool generate a document model and from the document model it generates a document.
The document model contains only package stereotyped "section" and comment stereotyped "content" or "imageRef".
Transformation to the document model: Each package requirements, UseCases, Design and Test become a section. Each requirement becomes a paragraph. Each Use Case becomes a section with its comments a paragraph of the section. The comment stereotyped user doc becomes a sub-section "How to". Each diagram will be serialized and become an image inside the container section. Each image hyperlink associated to a comment becomes an image after the paragraph.
The transformation from the model of document to the document is bijective.
How to
In order to generate the code: Ensure that the following profile are applied.
Applied Profiles
Fill properties of stereotype "Project " for the root model.
Project stereotype properties
Ensure that the model are in directory doc, all images are in the directory doc/imgDOC
PluginStructure.png
Select the root model in the model explorer and click right to generate html or media wiki
HTML generation
Open the html document, use a css file, called default css, and you can obtain the following document.
Note that this doc has been obtained by using the tool on itself. You can notice that a new model element with the stereotype Document is also generated. You can remove it. I let it in order to demonstrate that is possible to make all in model.
Generated HTML page
Design
Package org.eclipse.papyrus.uml.developer.mde
Class Activator
- specializes AbstractUIPlugin
The activator class controls the plug-in life cycle
Interface I_DeveloperIDMStereotype
constant included in the MDE process profile
Interface I_DocumentStereotype
list of constant contained in the document profile
Package command
Class CreateDocumentModelCommand
- specializes RecordingCommand
this command transform a model to document model
Package handler
Class GetHTMLTextHandler
- specializes IDMAbstractHandler
This class is used to create and html developper doc file.
Class IDMAbstractHandler
- specializes AbstractHandler
Abstract handler in order to connect to papyrus
Class GetWikiTextHandler
- specializes IDMAbstractHandler
This class is used to create and wiki developper doc file.
Package transcription
Class HTMLTranscription
- realizes ITranscription
This class is a specialization to generate html files.
Interface ITranscription
This class is used to generated very swiftly a document from the document model
Class TranscriptionEngine
This class is an engine to traduce a document model into files
Class WikiTranscription
This class is a specialization to generate mediawiki files.