Jump to Menu

How to View and Revert Software Design Changes with Visual History?

Knowing the past is the key for making right decisions in the future, and this is particularly true in software design. Knowing a software's previous designs can help you understand how the software behaved before and why was certain design idea being changed or abandoned. All these provide you with insightful ideas in producing new design that can not only work, but work in the best possible way.

Visual History was designed to help you trace and see the changes of your software design. By sliding along its timeline, you are presented with your design in old revisions. You can glance over the evolution of design to determine the best solution for your software. Visual History also allows you to revert changes from old design, which saves your precious time on reworking the same old things.

Compatible edition(s): Enterprise, Professional, Standard, Modeler

  • August 13, 2013
  • Views: 31,517
  • PDF

What is this Tutorial about?

The purpose of this tutorial is to let you know how to make use of Visual History to see the history along with the evolution of a use case diagram. At the beginning of this tutorial, you will be asked to create a simple use case diagram for ATM, make some changes and perform several rounds of committing. After that, you will run Visual History to see the changes you have made, and to revert some of the changes.

Preparation

In order perform the steps in this tutorial, make sure you have Visual Paradigm downloaded and installed. You may click here to download Visual Paradigm if you do not have it installed.
To avoid disrupting your production environment during the tutorial, please import a new project in Teamwork Server/Visual Paradigm Online to walk through the steps in this tutorial.

Part I - Building a Sample Project with Use Case Diagram

In this section, you will be drawing a simple use case diagram for ATM. Several rounds of committing will be performed as well.

  1. Open the new project you just imported into Teamwork Server/Visual Paradigm Online.
  2. Create a use case diagram ATM. Draw a simple use case diagram with an actor User and several use cases Withdraw Cash, Check Balance, Edit Account and Donate to Charity.
    Simple ATM use case diagram
    If you are not familiar with use case diagram or use case modeling, please read the user's guide page about use case diagram. For advanced users, you may want to know about the 10 tips to create a professional use case diagram by reading our Know-How article.
  3. Commit the changes to server (by selecting Team > Commit... from the toolbar).
  4. Contain the use cases with a system. Name the system ATM.
    System shape created
  5. Commit the changes to server.
  6. Let's say the use case Donate to Charity was found to be redundant in the ATM system. Delete it.
    Use case deleted
  7. Commit the changes to server.
  8. The Edit Account use case was found a bit unclear. Let's rename it to Edit Pin.
    Use case renamed
  9. Commit the changes to server.

Part II - Using Visual History

In this part, you will make use of the Visual History feature to review previous designs. You will also revert some of the changes.

  1. Open Visual History by selecting Team > Visual History... from the toolbar.
  2. Visual History is mainly divided into two sides. The left hand side shows you the diagram image of the currently opening revision, while the right hand side shows the diagram image of the revision as selected in the timeline under it.
    Visual history
    Now, press on the revision pointer in the timeline and drag rightwards for one revision.
    drag visual history timeline
  3. When you arrive at a revision, the preview of diagram in that revision would appear. Release the mouse button.
    revision preview
  4. Once you have released the mouse button, you can see the use case diagram in previous revision appears on the right hand side. Besides, there is a yellow pointer that appear above the Edit Pin use case on the left hand side. It indicates the place where modification took place.
    previous revision opened
  5. Click on the yellow pointer. This popup a summary of modification made to the Edit Pin use case, between the revision as selected on the right hand side and the current revision. In this case, the summary tells you that the use case was renamed from Edit Account to Edit Pin.
    visual history modification summary
  6. Let's say we want to re-apply the old use case name. Click Revert in the Modification Summary popup.
    revision preview
  7. The use case (in the current revision) is instantly renamed to Edit Account, following that in the previous revision.
    use case name reverted
  8. Now, move one more revision backward by adjusting the revision pointer in timeline.
    move one revision backward
  9. This time, you should see two red pointers, with minus sign in them, appear on the right hand side. This means that the Donate to Charity use case along with its connector were existing in the chosen old revision, but are no longer existing in the current revision.
    visual history shows shape deletion
  10. Let's restore the Donate to Charity use case. Click on the red pointer above the Donate to Charity use case. In the popup, click Restore.
    restore deleted shape
  11. You should see the Donate to Charity use case re-appear in the current revision. Let's also restore the association that connects between the User actor and Donate to Charity use case.
    restore deleted association
  12. You've done. Click Done at the bottom of Visual History to go back to the diagram.
    use case diagram restored
  13. Finally, don't forget to commit the changes to server.


Turn every software project into a successful one.

We use cookies to offer you a better experience. By visiting our website, you agree to the use of cookies as described in our Cookie Policy.

OK