How to Manage Requirements Online with UeXceler?

January 13, 2016 Views: 3,977 PDF Link

Being able to browse, edit and manage requirements through your web browser can be very useful, particularly when you are using a machine that does not have Visual Paradigm prior installed, say, machines in your client's site. As a design and management software developed for software developers, Visual Paradigm provides the tools you need to manage requirements online. In this tutorial we will show you how to manage use cases, user stories and sprint on the web. Before we continue, we recommend you watch the video Requirements Gathering with UeXceler 3.0 first so that you will have some basic ideas about the steps and principles suggested in UeXceler.


Overview of this Tutorial

In this tutorial you will learn how to begin managing requirements online with UeXceler. Here is an outline of what will be covered in this tutorial:

  1. Subscribe to VPository (Free)
  2. Create a project in VPository
  3. Create use case, user story and sprint

In order to complete this tutorial, you must have the following software installed:

  • Visual Paradigm 13.0 or higher

Subscribe to VPository

In order to use the requirements management features, you have to subscribe to VPository first. VPository is a cloud service that enables your team and your clients to work hand-in-hand. Your team can work collaboratively and concurrently by using its built-in concurrent versioning system. Your clients can also access it to browse and discuss your software/process design online. It also features a task management tool called Tasifier. Best of all, it is available for FREE (with 1 GB file storage).

To subscribe to VPository:

  1. Open your web browser and visit http://www.vpository.com
  2. Click on Subscribe for Free at the top of the page
    Subscribe to VPository
  3. Assuming that you are the manager of the VPository account to be created. You, the manager, are required to enter your name and email address. You also need to complete the cloud entry point by providing a subdomain, which is usually your organization or company's short name. Now, enter your own name, email address and sub-domain.
    Subscribe VPository
  4. When ready, check I agree to VPository Terms of Service and Privacy Policy.
  5. Click Subscribe to VPository at the bottom.
  6. A confirmation email is sent to the email address stated above. Now, check your inbox. You should see an email like the one below. If not, please see if it is in your junk box, or if you have entered the address correctly.
    Confirm VPository subscription
  7. Click on the link Confirm your VPository Subscription.
  8. You are brought to another web page, where you need to enter the repository name and login credentials. Now, enter your own repository name, which is usually the name of your organization or company.
  9. Enter your password. Make sure it is secure enough.
    Initialize VPository account
  10. Click Start My VPository.
  11. Wait until the preparation of VPository is done. Do not close the browser yet.
  12. When finished, you will see the congratulation message, with the hyperlink of your cloud entry point presented. Click on it and go to the next section.
    VPository subscription ready

Creating your project

In this section you are going to create a project in VPository to try out the requirements management feature.

  1. Assuming that you have clicked on the hyperlink as requested by the final step of the previous section and you are opening your VPository page. Click Login at the top right of the page.
    Login VPository account
  2. Enter your email address and password, which is what you have entered above.
    Enter VPository login details
  3. Click Login.
  4. Click on UeXceler to open it.
    Open UeXceler
  5. This opens UeXceler, where you can browse and management requirements. You are automatically prompted to enter a project name. Now, enter a name. You may name it Test Project, Sample Project, or follow the name we use here. Do not worry too much because you can delete this project later on from the administrator panel of VPository, when you have finished this tutorial.
    Enter project name
  6. In practice you may want to invite your teammates to join this project by clicking Configure Members at the bottom left of the screen. To make this tutorial simple we are not going to cover it now. Click the Create button now to create the project.

Creating your first use case and user story

UeXceler provides you with plenty of tools for managing requirements and we are not going to try them all here. Let's try creating a use case, and then a user story in it.

  1. Open the Use Case page.
    Open Use Case page
  2. Use cases define high level business goals of the system to be developed. Usually they are defined by discussing with the business stakeholders. Now, create a use case by clicking New Use Case at the top right of the page
    Create use case
  3. Enter the name of the use case and press Enter.

    Use case is created. You may be aware of the properties that can be specified for a use case. You may notice that some properties are editable, while some are read-only (e.g. Diagrams). Supposedly, the project you are working on right now will be edited by Visual Paradigm clients for detailing the requirements and software design. Those read-only properties are to be provided by Visual Paradigm client.
    Use case created
  4. Let's create a user story. You can create a user story under a use case, or create it as a general user story. We recommend grouping user stories based on the use cases they belong to. Doing so will give you a clear picture on the concerns to address and the requirements to be implemented for particular use cases. Open the User Stories page under the use case.
    Open user story page
  5. Click on Add a feature that can be finished in 10 days to create a user story.
    Create user story
  6. Enter the name of the user story and press Enter. Note that user stories are simple notes that record front-line stakeholders' concerns or the problems that they are now facing now, hoping to be addressed by the system to be built. The intent of creating user story is to provide a way to note down things that issues that need to be discussed later on and identifying requirements. Therefore, a user story need not to be a requirement. Sometimes, one user story may lead to the creation of multiple requirements, or even be discarded if it is found out of system scope.
    Enter user story name
  7. You have created a use case and a user story. Let's have an overview of them. Open the User Story page of UeXceler. You will see the use cases as well as the user stories of this project. When your project grows, you can use the filter function (at the top left of the page) to control the stories to be shown on the page.
    User story page

Creating sprint

A sprint is a time boxed iteration within a software project. It contains the user stories needed to be addressed within a period of time agreed by project team and stakeholders, usually around two weeks to one month. Supposedly, system functions that can address the concerns described under the user stories in sprint will be available by the end of a sprint. Let's create a sprint.

  1. Open the Sprint page by clicking Sprint at the top of the screen.
    The Sprint page
  2. Click Add New Sprint.
  3. Give the sprint a name and press Enter to confirm. The name can be one that describe the target to be achieved, or it can be a version number.
    Entering sprint name
  4. You are prompted to add user stories into the sprint. Usually, the user stories to add were decided after the discussion between project team, business stakeholders and front-line stakeholders. Now, add the user story we created into the sprint. Check it and click ADD CHECKED USER STORIES TO SPRINT at the bottom of page.
    Add user story to sprint
  5. Click DONE.
    Click done
  6. You are brought to the main sprint page. Here you can see the working sprint we just created and possibly the planning sprints that are yet to be started after the finishing of working sprint.
    Sprint page

Assigning user stories to team members

Once a sprint is setup, you can move on to assigning stories to individual team members. An assignment implies that the member is responsible for handling the user story. He/she be the one who design and implement system functions in solving the problem described under the story, or be the one who manage the other members in supporting the functions.

  1. Click on the working sprint to open it.
    Opening sprint
  2. Click on the button for member configuration.
    Configure members
  3. Click on Config. Members and select the team members that involve in this sprint. In our example we just have one member. If you have invited someone else when creating project, you should see more people here.
    Select members
  4. To assign a user story, press on it and drag to the responsible team member.
    Assign user story to member
  5. Release the mouse button.
    Story assigned
    That's all for this tutorial. If you have any questions about UeXceler, feel free to contact us.

Related Links

  1. YouTube video – Requirements Gathering with UeXceler 3.0

You may be interested in

  1. Data Flow Diagram (DFD) Tutorial
  2. Writing Effective Use Case
  3. Drawing Entity Relationship Diagram (ERD)
    Tagged:
  4. Data Flow Diagram with Examples - Food Ordering System
  5. Perform UML Modeling in NetBeans
Tags of this article:

Comments (3)

written by Alexander Fernandes Praxedes on January 16, 2016

Excelente ferramenta!
Tutorial muito bem descritivo e de fácil compreensão!

written by Mubarak Bose on January 20, 2016

I Cannot see the use-case and the sprint that I created. why?

written by Jick Yeung (VP) on March 10, 2016

Hi Mubarak,

Thank you for your reply. Could you submit a ticket with regard to the problem that you've encountered?
https://www.visual-paradigm.com/support/

Our support team will get back to you as soon as we can.

Write comment

Rating

Comment

Enter the calculation result

security code