Perform Textual Analysis

OTV is a company which delivers online TV broadcasting services. It is going to improve its services by re-developing the online broadcasting system. In this tutorial, we will make use of textual analysis to identify main use cases of OTV's online broadcasting services, and form a use case diagram for further studies.

December 8, 2010
User Rating: / 11
Views: 6,791
PDF Link Add comments
Edition: Community or above (Edition comparison)

  1. Download the attached document file OTV.txt, which describes the general business operations of OTV in advance.
  2. Start Visual Paradigm for UML.
  3. Create a new project by selecting File > New Project from the main menu. Name the project as OTV and press Create Blank Project button.
  4. Right click on Textual Analysis in Diagram Navigator and select New Textual Analysis from the pop-up menu.
    new textual analysis
  5. You can enter the problem statement in problem statement editor. Choose either type directly there, or import a text file. Let's try to import the downloaded text file. Click on the button Import File, select OTV.txt and click Open button.
    import file
  6. The text is imported. Study the problem statement.
    imported text
  7. Now, identify all candidate actors that involve in the system. By reading the problem statement, we find the first candidate actor, premium member in the second paragraph. Highlight and then right click on it, and select Add text as Actor from the pop-up menu.
    add first actor
  8. Check out the grid at the bottom. It lists the properties of extracted candidate object: Candidate Class (candidate object's name), Extracted Text (the word/ phrase it extracted from), Type (candidate type), Description, Occurrence (the number of times the word/ phrase appears in the problem statement) and Highlight (the highlight color of candidate object).
    actor created
  9. The second candidate actor general member is found. Again, add it as candidate actor.
    add second actor
  10. In the last paragraph, we find the candidate actor administrator. Add text administrators as actor.
    add last actor
  11. Now, identify candidate use cases. Candidate use cases usually name as a verb or verb+noun phrase. For instance, "watch any archived TV programs" in the second paragraph. Highlight and right click on "watch any archived TV programs", and select Add text as Use Case from the pop-up menu.
    add usecase
  12. Search the text below and identify them as candidate use cases:
    Register as a general member
    Register as a premium member
    Watch both archived and live programs
    Upgrade himself to a premium member
    Remove his/her account
    Posting their opinion
    Receive monthly newsletter
    Update the program schedule
    Update the program
    Archive programs
    Monitor the delivery of newsletter
  13. In order to distinguish the candidate objects in problem statement, we can change their highlight color. Let's select orange as the highlight color for candidate actors. Click Highlight cell of premium member and press the inverted triangle. Select orange from the combo box.
    change color
  14. You may notice that some of the candidate actors and use cases can be renamed to make them shorter and more informative. Take candidate actor premium member as example, to rename a candidate actor, in the grid at the bottom, double click on premium member cell under Candidate Class and change it to Premium Member.
    rename
  15. On the other hand, you can enter description for Premium Member. The text you typed in Description cell will become the documentation of Premium Member actor. For example, enter "A premium member can watch both archived and live TV programs for US $30 per month."
    enter description
  16. Rename the other candidates and their description as shown below:
    Candidate Class Extracted Text Description
    General Member general member A general member can only watch archived TV programs. In order to watch live programs, s/he should upgrade his/her membership to be premium member.
    Administrator administrators Administrator has the rights to update the TV program schedule, update and archive TV programs. S/He is responsible for mentoring the deliver of newsletter to premium members.
    Watch Archived Program watch any archived TV programs Members can watch the scheduled archived TV programs anytime.
    Register as General Member register as a general member It is free of charge to register as a general member.
    Register as Premium Member register as a premium member No application fee is applied for registering as premium member.
    Watch Live Program watch both archived and live programs Only premium members are allowed to watch live TV programs.
    Upgrade Membership upgrade himself to a premium member A general member can upgrade his/her membership to a premium member.
    Remove Account remove his/her account US$50 of administrative fee is applied when premium members remove their account.
    Post Opinion posting their opinion Premium members can post their opinion regarding TV programs on OTV's official website.
    Receive Newsletter receive monthly newsletter Premium members can subscribe monthly newsletter for US$300 per annum.
    Update Program Schedule update the program schedule Administrator keeps updating TV program schedule fortnightly.
    Update Program update the program Administrator keeps updating TV programs weekly.
    Archive Program archive programs Administrator keeps archiving TV programs weekly.
    Monitor Delivery of Newsletter monitor the delivery of newsletter Administrator is responsible for monitoring the delivery of newsletter.

    Up to now, the textual analysis should look like this:
    completed
  17. Let's switch to candidate pane by clicking Candidate Pane View button. Candidate pane view is where you can visualize candidate objects for easy arrangement.
    candidate pane
  18. Right click on the background of candidate pane and select Tile Layout from the pop-up menu.
    set tile layout
  19. We are going to form a use case diagram with those candidate objects. Create a use case diagram through Diagram Navigator. Right click on Use Case Diagram and select New Use Case Diagram from the pop-up menu.
    create usecase diagram
  20. Open the Model Explorer (next to Diagram Navigator). Select all the candidate actors and use cases.
    select candidate actors and use cases
  21. Drag them from Model Explorer and drop them all on the use case diagram. Rearrange the shapes to make the diagram alike the below image:
    basic use case diagram
  22. Associate actors with use cases. Finally, the diagram should look like the following:
    final ucd
  23. Save the project. This is the end of the tutorial.

Resources

  1. OTV.txt

Rate this Article

Click on one of the stars below to rate this article from 1 (lowest) to 5 (highest).

You may be interested in

  1. Writing Effective Use Case
  2. UML Package Diagram
    Tagged:
  3. Draw Entity Relationship Diagram (ERD)
    Tagged:
  4. Produce UML Use Cases from Business Process Diagram (BPD)
  5. Draw UML Sequence Diagram with Keyboard
Tags of this article:

Comments (10)

written by Indra on April 24, 2010

I request permit to share in fb
Thanks

written by ? on April 24, 2010

You can use the Share link in top of the page to share this tutorial to face book.

written by Sachin Deshpande on December 10, 2010

Hi,
This is really a good feature and seems unique in VP amongst the UML tools. I have used Rose, RSA, EA, VP, Jude, etc and found this feature here. But wouldn't it be great if nouns can be shown automatically as Candidate classes, verbs as actions/use cases/ flows, etc on just a click. User can later select the items needed by him out of the suggestions given by the tool.
This can be done by a tool. :)
Thanks,
Sachin.

written by Jick on December 29, 2010

Hi Sachin,

Thank you for your suggestion. Do you want us to check through the passage, identify and extract those nouns and verbs to become candidate class and actions/usecase/flows respectively? This sounds good. But I am afraid the program is unable to identify whether a word is a noun or a verb... (Or did I misunderstood your need?)

Best regards,
Jick Yeung

written by Filip on January 5, 2011

Hi,
I have comunity edition of VP-UML. I`d like format text in Textual Analysis, but I have not display Format toolbar. Is it restriction for comuunity edition or is it only hide? How can I display Format toolbar?
Thanks for answer
Filip

written by Jick Yeung on January 6, 2011

Hi Filip,

The Format toolbar is available in ALL editions of VP-UML (including the Community Edition). Since the feature was recently added to the latest version of VP-UML (8.1), please check the About dialog box (Help > About), to make sure you are running the latest version. If you are running a previous version, please download the latest one at:
http://www.visual-paradigm.com/download/vpuml.jsp

Best regards,
Jick Yeung

written by Diego on June 8, 2011

Hi,
i have added a system border to the use case diagram to indicate the delimitated borders of the system..
When i try to delete it, the application deletes also all the associations between actors elements and use case elements. Is there a wat to delete only the system borders.

Sorry but it's the first time i use the application.

written by ? on June 8, 2011

Since all Use Case are contained by the system, delete system will delete all child - use case. If you need to do that, please move out all use case before delete the system.

written by Lacks on September 15, 2011

Hello

I was just wondering for the exported excel format which is not much user friendly. It comes up with a lot of columns which is not necessarily required.
In case if I have to import or export requirements then how easy it is to do it with the system.
Also do I need to export a file from tool first to know the format and then accordingly putting requirements into the same and importing into document?

written by Jick Yeung on September 15, 2011

Hi Lacks,

Thank you for your post. Actually you may ignore most of the columns when you want to create new requirements and import them back to VP-UML. I recommend you walk through the steps below to enter the new requirements in Excel for importing back to VP-UML.

1. Export Excel from VP-UML.
1.1 Select "Raw" for Export Style
1.2 Select the requirement diagram where you want the requirements be created in
1.3 Click Export

2. In the exported excel, copy the last row, paste as a new row.

3. In the new row, clear the cell of the ID column

4. Fill in whatever column you need. (e.g. Text, ID, source, etc)

5. Repeat 2 to 4 until all requirements are created.

6. Import the Excel back to VP-UML.

Hope this help. Please feel free to post again if you have any questions.

Best regards,
Jick Yeung

Write comment

Rating

Comment

Enter the calculation result

security code