Installation

  1. Install Eclipse Modeling Tools (Luna release)
  2. Install Papyrus UML
    • Eclipse menu: Help -> Install Modeling Components -> Papyrus
  3. Install Epsilon
  4. Install ProPAn tool

Hints for the configuration

  1. Select UML4PF CSS theme for nicer representation of diagrams
    • Eclipse menu: Window -> Preferences -> Papyrus -> CSS Theme
    • Change "Current Theme" to UML4PF
  2. Increase heap space for the installed Eclipse to increase its performance
    • Open eclipse.ini in your Eclipse installation folder
    • Change entry -Xmx512m to -Xmx2048m or -Xmx4096m depending on how much memory you want to provide
    • Restart Eclipse
  3. Make heap status visible to get an impression whether Eclipse needs more memory or not
    • Eclipse menu: Window -> Preferences -> General
    • Activate "Show heap status"

Hints for using ProPAn

  1. Make sure that the UML model has the following Profiles applied:
    • Problem Frames Core Profile
    • Problem Frames Display Profile
    • Problem Frames Domain Knowledge Profile
    • ProPAn Profile
  2. The functionalities for the ProPAn tool can be called by opening the context menu (right mouse button) on an element in the Papyrus diagram under the menu entry "Wizards". Depending on the selected element, different wizards are shown.
  3. To perform a detailed information flow analysis you have to perform the following steps.
    1. Create for the stakeholder at hand a privacy requirement
      • Right-click on the biddable domain, select the wizard "ProPAn: Add a privacy requirement for ...", and follow the instructions.
    2. Generate privacy graphs
      • Right-click anywhere and select the wizard "ProPAn: Generate privacy graphs"
      • In the model explorer, you will find the package "ProPAn". This package contains all ProPAn-related diagrams and graphs. The Papyrus diagrams that visualize the diagrams and graphs are contained in the package of the respective diagram or graph and can be opened via the context menu entry "Open". The elements of the graph or diagram can be arranged automatically by Papyrus by selecting an element of the diagram and then selecting the menu entry Diagram -> Arrange -> All.
    3. Identify personal information of the stakeholder
      • Right-click on the biddable domain and select the wizard "ProPAn: Identify the personal data ..." and follow the instructions.
    4. Initialize the information flow analysis
      • Right-click on the detailed stakeholder information flow graph and select the wizard "ProPAn: Initialize Information Flow Analysis ...".
    5. Perform iteratively a step of the information flow analysis
      • Right-click on the detailed stakeholder information flow graph and select the wizard "ProPAn: Perform a Step in the Information Flow Analysis ..." and follow the instructions.
    6. Generate privacy graphs again
      • Right-click anywhere and select the wizard "ProPAn: Generate privacy graphs".
      • In the package "ProPAn" you'll find the updated stakeholder data flow graph.
  4. If something is not working:
    • Restart Eclipse
    • If this does not solve your problem, contact rene.meis[at]uni-due.de.