Visual Paradigm Quick Start: Last Update: June 05, 2017
Visual Paradigm Quick Start: Last Update: June 05, 2017
Quick Start
Getting Started
Installing Visual Paradigm
1. Execute the Visual Paradigm installer.
Depending on whether you own a purchased copy or an evaluation copy of Visual Paradigm, you can proceed by
following the steps below respectively:
For Customers
You should receive a notification Email with an activation code. The same activation code can also be found from
the license key listed in your customer account. Copy the activation code first, click on Perpetual License, paste the
copied activation code and then click Activate to continue.
For Evaluation
If you want to evaluate Visual Paradigm, click 30 Days FREE Evaluation. Then, select the edition to evaluate and
click Evaluate to start your 30 days evaluation.
The Environment
To open an existing project, select Project > Open from the toolbar and select the project to open.
This section will go through the steps of creating diagrams, creating shapes and connecting them. You will also
learn how to document model elements and make diagrams more readable by coloring shapes.
Creating Diagram
Lets take use case diagram as an example. To create a use case diagram:
1. Select Diagram > New from the toolbar.
2. At the top of the New Diagram window, enter the
diagram type (or a part of it).
3. Select the type of diagram to create.
4. Click Next.
5. Enter the diagram name, its location and description.
6. Click OK.
Resource Catalog allows you to create a new shape that connects with an existing one. You can also use it to create
connector between two shapes. Lets create a use case from actor.
In addition to textual description, voice recording is also available. If your machine supports microphone usage,
click the Record button at the top right of the Description Pane. In the Record Voice window, click the red circle
button to start recording. To stop, click the button with a square inside. To save your recording, click OK.
Make sure your recording device is available when applying this feature.
1. Right click on the use case shape and select Styles and
Formatting > Formats from the popup menu.
2. Open the Background tab in the Formats window. Select
Green for color. Click OK to confirm the change.
UML Modeling
Compatible editions: All
Sequence Diagram
A sequence diagram is primarily used to show the interaction between objects that are represented as lifelines in a
sequential order. More importantly, lifelines show all of their interaction points with other objects in events.
As always, you can create a new diagram via the toolbar, same for sequence diagram. To create sequence diagram,
choose Diagram > New from the toolbar. Then, select UML diagrams > Sequence Diagram in the New Diagram
window. Here, lets create a sequence diagram with an alternative approach - create as a sub-diagram of use case.
The reason of creating a sequence diagram as a sub-diagram of use case is to visualize the interaction between
user and system in accomplishing the use case. Lets see how it works. We will carry on with the use case diagram
created in the previous section.
1. Move your mouse pointer over the use case Cancel Order. 2
2. Click on the tiny Sub Diagrams button at the bottom right of the shape
and select New Diagram from the popup menu.
3. This shows the New Diagram window. Select Sequence Diagram and
then click Next.
4. Click OK.
5. This creates a blank sequence diagram. Create an actor Customer in
the diagram. You can find Actor from the diagram toolbar.
6. Lets model the interaction of how customer can cancel an order.
Move the mouse pointer over the actor. Press on the Resource
Catalog button and drag it out. 6
7. Release the mouse button and select Message -> LifeLine from the
Resource Catalog.
8. Name the lifeline System, and the message login.
9. Complete the interaction by adding other messages and the Order
lifeline.
To go back to the parent use case, you can click on the shortcut on top of the diagram:
Activity Diagram
An activity diagram is essentially a flowchart, showing the flow of control from one activity to another. Unlike a
traditional flowchart, it can model the dynamic aspects of a system because it involves modeling the sequential
steps in a computational process. Lets make use of an activity diagram to model the registration process.
1. Create an empty activity diagram named Registration. You can create an activity diagram by selecting
Diagram > New from the toolbar. Then, select Activity Diagram in the New Diagram window. Click Next
and then click OK.
2. Create a swimlane for grouping actions based on the participants. Select Horizontal Swimlane from the
diagram toolbar and click on the diagram to create one.
3. Double click on the headers and rename them to User and System, respectively.
4. Create initial nodes, actions, decision node and activity final node inside the swimlane. Do remember to
resize the swimlane to accommodate the shapes.
The decision node represents the moment where a decision has to be made. Multiple flows will be
produced based on different results of decision making.
The Control Flow -> Action resource helps you create action shapes rapidly.
Class Diagram
A class diagram models the blueprints of objects required by a system and the relationships between them. Lets
make use of class diagram to model the domain classes of the order processing system.
Class Diagram and Package Header
When you create a class diagram, you are prompted to enter the package header (see the image below). Package
header is a quick way to create new class diagram in a package. The diagram and the shapes created in the
diagram will all be grouped by the package specified. Lets say if you want the class diagram to be grouped by a
package mypackage, enter mypackage in package header.
By doing so, a new package will be created, with the new class diagram put inside. You
can inspect the structuring in the Model Structure view, opening by clicking at the
top right of any diagram.
If the package you specified exists, the new class diagram will be put in
that existing package. If the specified package does not exist, a new
package will be created.
1. Right click on a class and select Add > Attribute from the popup menu.
2. Type the name and type of attribute inline - for example, name : String.
3. Press Enter to confirm.
4. You can now create the next attribute by repeating step 2. To stop, press Esc.
1. Right click on a class and select Add > Operation from the popup menu.
2. Type the name and optionally the method signature (i.e. parameters and return
type) - for example, printCustomerDetails(delimiter : String).
3. Press Enter to confirm.
4. You can now create the next operation by repeating step 2. To stop, press Esc.
To edit an association end, double-click on the end to open the Association Editor. Enter a name for the role of the
association in the middle text box and adjust properties like multiplicity and navigability as needed.
Sub-process Non-atomic, complex work that can be elaborated into smaller works
1. Create an empty BPD named Parcel Collection. You can create a BPD by selecting Diagram > New from the
toolbar. Then, select Business Process Diagram in the New Diagram window. Click Next and then click
OK.
2. Create a pool for the post office officer, the person who execute the process. Select Horizontal Pool from
the diagram toolbar and click on the diagram to create one. Name the pool Post Office Officer.
3. Create start event, tasks, gateway and end event inside the pool.
Drilling-Down Sub-Process
A sub-process can be expanded to show a lower-level process. To expand a sub-process, click on
the + symbol at the bottom of the sub-process shape. By doing this, a new BPD will be opened.
You can then model the internal details using activities, gateways, events, etc. When you go back to the parent
level BPD, you will see the sub-level details appear in the sub-process shape.
To collapse an expanded sub-process shape, click - at its bottom. To expand it, click + again.
When you present your business process design to someone, like your clients or manager, having a way to
visualize the workflow dynamically can help you expressing the design more effectively. Moreover, thats what the
animation feature can help. The animation feature allows you to animate your design from the very first element,
which is typically the start event until the final element. To animate a BPD:
1. Right click on the background of BPD and select Show Animation Panel from the popup menu.
2. Click + at the top of the Animation Panel.
3. Enter the name of the path to animate for example, Collect parcel (success).
4. If your process design contains gateway (or any other kinds of element for decision making), you may
need to construct the path manually.
5. Click to play the path. Shapes have been passed by are highlighted in purple by default. And whenever
the animation is progressing through a sequence or message flow, a dark ball would appear and move
along the line to guide your line of vision.
Code Engineering
Compatible editions: Standard
Java Round-Trip
Round-trip engineering enables you to produce source code from UML model (and the other
way round) and keep the source code and UML model synchronized. With Java round-trip,
you can generate Java source code from class model, or the reverse a Java code-base to class
diagram.
1. Select Tools > Code > Generate Java Code from the toolbar.
2. Edit the output folder in the Generate Code window.
3. Click OK to generate code.
1. Select Tools > Code > Reverse Java Code from the toolbar.
2. Edit the source folder in the Reverse Code window.
3. Click OK to reverse code.
4. You can then create class diagram with the reversed classes. Simply open the Model Explorer to find the
classes and then drag them to class diagram to visualize them.
C++ Round-Trip
Round-trip engineering enables you to produce source code from UML model (and the other
way round) and keep the source code and UML model synchronized. With C++ round-trip,
you can generate C++ source code from class model or the reverse, a C++ code-base to class
diagram.
1. Select Tools > Code > Generate C++ Code from the toolbar.
2. Edit the source and Cpp folder in the Generate Code window.
3. Click OK to generate code.
1. Select Tools > Code Engineering > Reverse C++ Code from the toolbar.
2. Edit the source and Cpp folder in the Reverse Code window.
3. Click OK to reverse code.
4. You can then create class diagram with the reversed classes. Simply open the Model Explorer to find the
classes and then drag them to class diagram to visualize them.
Instant Reverse
Instant Reverse allows you to reverse different types of source into UML class models, such as Java, C++, CORBA,
Ada, PHP, Python, Objective-C, etc. To reverse, select Tools > Code > Instant Reverse. from the toolbar, then
select the kind of programming language to reverse. Select the source files and proceed.
Instant Generator
Instant generator produces source code from your model at a particular instant. Unlike the code generation
support in round-trip engineering, instant generator is a one-off. To generate code, select Tools > Code > Instant
Generator from the toolbar, then select the programming language in which to generate.
Reverse Engineer Sequence Diagram from Java
Sequence diagram can help represent interactions between objects in runtime. Visual Paradigm enables you to
reverse your Java source code to sequence diagram. You can gain a better understanding of a piece of Java source
code by reading its corresponding diagram, instead of looking at possibly a thousand lines of code. To reverse Java
code to sequence diagram:
1. Create a new document via the toolbar (Tools 4. The Template Pane is updated to list out the
> Doc. Composer). available templates based on your selection.
2. Select Build Doc from Scratch. Choose the appropriate template and drag it to
3. Select in Diagram Navigator, Model Explorer the document editor.
or Class Repository the model
element/diagram that you want to show in
your document.
To export document as HTML/PDF/MS Word file, click on at the top right corner of Doc.
Composer.
Doc. Composer Fill-in Doc
Fill-in Doc is a mode of Doc. Composer that helps you integrate design details into your project documentation. To
use Fill-in Doc:
1. Create a new document via the toolbar (Tools > Doc. Composer).
2. Select Fill-in Doc.
3. To make things simple, lets try with a sample provided. Click on Software-Requirements-Specification.
4. Click OK. You should be prompted for saving a Doc Base. A Doc Base is a semi-completed version of your
project documentation or report. It contains only background information, possibly filled by you or your
colleague. The design details are leave empty and be filled by Doc. Composer. Save it to somewhere in
your machine first.
5. Doc. Composer analyzes your Doc Base and presents the Doc Fields that exist in your document. Your
screen should look like this:
7. You will see many variable-like fields throughout the document, like this:
Those fields are known as Doc Fields. A Doc Field is a special piece of text within a Doc Base. Doc Fields
will be replaced by your actual project content when being read by Doc. Composer during document
exporting.
8. Exit Microsoft Word and go back to Visual Paradigm.
9. Now, click Preview to take a look at the end result. A temp. document will be produced, like this:
If you want to know more about Doc. Composer, click here to download the Doc. Composer
Writers Guide.
Project Publisher
Project Publisher helps produce Web contents from your project file.
If you work as a team and need to work together on the same design, or to share your design with your
teammates, you need to make use of VPository.
VPository is the cloud-based repository where designs can be stored. You can upload your project to VPository and
allow your teammates to open and edit it.
Subscribing to VPository
In order to use VPository, you have to subscribe to it first. Subscription of VPository is made inside Visual
Paradigm. To subscribe to VPository for your team:
1. Select Team > Utilities > Open Teamwork Client from the toolbar of Visual Paradigm.
2. In the Teamwork Client window, select Project > Import Project to Repository from its menu.
3. Specify the project source in the Import from field, edit the project name, author and description.
4. Invite your teammate(s) by clicking Add Project Member at the bottom of the window.
5. Click Import.
Committing
Commit is the process of uploading changes made in the working copy back to server. When you, one of the team
members, make changes in a project, you can share your works by committing those changes to the VPository and
let others to update the changes from VPository.
To commit changes:
3. Click Commit.
When finish committing, the changes you made will be uploaded to server and at the same time,
latest changes in server are updated to your local project copy.
Updating
Update is the process of refreshing the working copy by merging changes that others have made and committed to
server.
PostMania is a tool built into VPository. It allows you to share your design with someone. It also allows the reader
known as a viewer in PostMania to share his comments with you.
Sharing Diagram
To share your design with PostMania:
4. Click on the Share button at the top of the PostMania Topic Pane.
5. In the Share Diagram window, enter the name and Email address of the people to share with.
6. Click Send Invitation Email. In order for these people to view the shared diagram, they have to join
PostMania. Here we are going to send them invitation Emails.
Invitation Emails will be sent out in three minutes. Invitees can then accept the invitation to join PostMania. After
that, they can view the diagram you shared in web browser. They can also post comments to diagrams, to shapes
or to properties like description, flow of events (for use case), etc.
Reacting to Comments
When a viewer has posted a comment, as a member, you will see a notification in status bar, like this:
Click on it to open PostMania. Notifications are listed on the left hand side. Click on a notification to view its detail.
By clicking on a notification you can see the unread conversation listed on screen. You can give a quick reply at the
bottom of the screen, or click Open at the top right corner to open the related diagram.
If you click Open, the related diagram will be opened, with highlight to the discussed area. You can then refine the
design based on clients request, commit the change and add a reply in the PostMania Topic Pane to ask the
viewer to verify the change.
Advanced Modeling
Compatible editions: Standard
Nickname
If you are working in or working for multinational corporations, you may need to maintain your model in multiple
languages. The Nickname feature helps you achieve that. It allows you to maintain multiple languages in one single
project without the need to keep multiple project files for same content.
1. Select Modeling > Nickname > Configure Nicknames from the toolbar.
2. In the Configure Nickname window, click Add User Language.
3. In the Add User Language window, select the language to add.
4. The newly added language is selected in the Configure Nicknames window. Keep it selected and click OK.
5. Now, you can rename the shapes and diagrams to translate the model to the language added. To switch
the model back to the original language, select Modeling > Nickname > Original from the toolbar.
Project Reference
To avoid creating the same things (e.g. a class) over and over again, it would be useful to have a generic library to
keep components for reuse. When you make any changes to the components in the library, those changes will
ripple down to where the components are actually used. In Visual Paradigm, we call this generic library a
Reference Project. To add project reference and re-use the data in referenced project:
7. You can connect referenced project data with the data of the current editing project.
Impact Analysis
Compatible editions: Professional
If you want to make a change to some model elements, it would be important to know which other elements will
get affected because of it. Impact Analysis can help you with that.
Matrix Diagram
Matrix Diagram helps you to identify the relationship between model elements of specific type(s), so as to study
the consequence of making certain changes. To create a matrix:
1. Create a matrix by selecting Modeling > Impact Analysis > Matrix from the toolbar.
2. Lets say if you want to inspect the relationship among all the classes in the project. Add class to both
Models on Row and Models on Column by first selecting class on the left hand side and clicking > to add
it into row and column list respectively.
3. Select Relationship for By. By here means to compare row and column items by the selected criterion.
4. Click OK. This produces a matrix which lists the classes in rows and columns, showing their relationships in
cells.
Lets say you are thinking about deleting the Payment class. By reading the matrix, you realize that the
Payment class is a super class of CreditCardPayment and ChequePayment. Deleting the super class
Payment may risk losing data. So youd probably need to consider withdrawing the deletion or to move
the data from super class to sub class, etc.