You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 5 Next »

Installation

The Open Source UML tool Papyrus is a plug-in for the Open Source integrated development environment (IDE) Eclipse. GenDoc is the associated tool that allows you to output a model in Papyrus into a word document. The artifacts in the output (diagrams, classes, datatypes, etc.) can be copy/pasted directly into a model project's wiki page.

Applied tool versions:

  • Eclipse: version 4.7.2 "Oxygen"
  • Papyrus: version 3.3.0
  • GenDoc: version 0.6.0

Eclipse

  • Eclipse “Oxygen” Modeling Tools package version 4.7.2 can be downloaded from here:
    https://www.eclipse.org/downloads/packages/eclipse-modeling-tools/oxygen2
  • Select the download link that is appropriate for the machine on which you will be making the install, i.e. "Windows 64-bit"
  • This results in the download of a zip file.
  • Note that Eclipse Oxygen requires a 1.8 compatible JVM
  • Extract the contents of the zip file to wherever you would like to install Eclipse. On a PC, "Program Files" is always a good option.
  • The content of the extracted files should look something like this:

  • To launch eclipse, double-click on the "eclipse.exe" file
  • When Eclipse starts coming up, it will prompt you for a "Workspace", providing a default that you can override. 
  • This is where the Eclipse projects, with associated models, will be stored. 
  • When Eclipse fully comes up, you can close the Welcome tab
  • To verify you have the correct installation of the product, go to "Help" → "About Eclipse" 
  • You should see something that looks like this: 

  • You have now successfully installed Eclipse

Papyrus

  • Papyrus version 3.3.0 can be downloaded from here:
    https://www.eclipse.org/papyrus/
  • Scroll down on the right side of the page and select: "Papyrus 3.3.0 Oxygen" Posted March 20th, 2018 and select "Download Page"
  • This takes you to "Papyrus Update Sites". Scroll down and select the "Papyrus Oxygen (3.X.0) Release Update Site
  • Copy the URL of the update site to which it takes you. Should be something like: http://download.eclipse.org/modeling/mdt/papyrus/updates/releases/oxygen/
  • Now you go back into Eclipse and select "Help"→ "Install new software"
  • An "Available Software" screen comes up. Paste  your URL into the "Work with:" box and hit enter
  • There should be multiple "Papyrus" related packages available to install. Select only the box: "Papyrus" and make sure the others are not selected.
  • Then click on "Next" to install the product. The installation will check for dependencies and requirement, and next prompt you to "Accept" the license agreement
  • Once accepted, you can select "Finish" and the installation process continues.
  • When the installation is finished, restart Eclipse to begin to use Papyrus.
  • Go to "Window"→ "Perspective"→"Open Perspective"→ "Other" and select Papyrus.
  • You will now be in the Papyrus Perspective where you can begin to use Papyrus.

GenDoc

The Gendoc plugin is used in conjunction with a document template. The template contains instructions that enable generation of a Microsoft Word document. The document can include extracts from the model such as diagrams, class definitions, attribute definitions along with their stereotypes etc as well as figures and text directly entered into the template. 

  • In Eclipse, go to "Help" → "Install new software"
  • Click "Add" and enter the GenDoc site: http://download.eclipse.org/gendoc/updates/releases/0.6.0/
  • An "Add Repository" screen will come up prompting you for a "Name" for your site. Give it the name "Gendoc"
  • In your "Available Software" page, you can select this site from the scroll box in the "Work with" box and hit enter.
  • The "gendoc" package should show. Select this package and hit "Next".
  • Follow the instructions to complete the installation.



  • No labels