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.
- Download the attached document file OTV.txt, which describes the general business operations of OTV in advance.
- Start Visual Paradigm for UML.
- Create a new project by selecting File > New Project from the main menu. Name the project as OTV and press Create Blank Project button.
- Right click on Textual Analysis in Diagram Navigator and select New Textual Analysis from the pop-up menu.

- 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.

- The text is imported. Study the problem statement.

- 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.

- 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).

- The second candidate actor general member is found. Again, add it as candidate actor.

- In the last paragraph, we find the candidate actor administrator. Add text administrators as actor.

- 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.

-
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 |
- 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.

- 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.

- 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."

-
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:
- 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.

- Right click on the background of candidate pane and select Tile Layout from the pop-up menu.

- 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.

- Open the Model Explorer (next to Diagram Navigator). Select all the candidate actors and use cases.

- 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:

- Associate actors with use cases. Finally, the diagram should look like the following:

- Save the project. This is the end of the tutorial.
Resources
- OTV.txt
Rate this Article
Click on one of the stars below to rate this article from 1 (lowest) to 5 (highest).
One Moment Please
Thanks for rating 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