Tool Mentor: Using Rational Rose® to Find Business Workers and Entities
Purpose
To represent the results of the Activity: Find Business Workers and Entities in in Rational Rose®.
Overview
The following steps are performed to record the results of finding business workers and entities:
- Create the business object model
- Create business workers and business entities (classes in the business object model)
- Create the use-case realization package in the business object model
- Create a business use-case realization
- Create traceability between a business use-case and its realization
- Create a collaboration diagram for the business use-case realization
- Place actors and objects in a collaboration diagram
- Create links between objects in a collaboration diagram
- Create a sequence diagram for the business use-case realization
- Place actors and objects in a sequence diagram
- Describe messages between objects in a sequence diagram
- Describe what an object does when it receives a message in a sequence diagram
- Create class diagrams to document classes in the business object model
1. Create the Business Object Model
A separate business object model can be represented in Rational Rose® using a package within the Logical View Named "Business Object Model". To create a package called "Business Object Model" in the Logical View:
- Right-click to select the Logical View in the browser.
- Select Package from the New option on the short-cut menu. A "NewPackage" browser icon is added to the browser.
- With the new package icon selected, type the name "Business Object Model".
2. Create
Business Workers and Business Entities (Classes in the Business Object Model)
To create a class (a business worker or a business entity) in the business object model:
- Right-click to select the "Business Object Model" package in the browser and make the short-cut menu visible.
- Select Class from the New option on the short-cut menu. A "NewClass" class icon is added to the browser.
- While the new class is still selected, type the name of the class.
- Double-click on the class’ symbol, either in the browser or in the class diagram to open its Class Specification dialog box.
- In the documentation field, enter its brief description.
- In the Stereotype field, enter "Business Worker" or "Business Entity".
- Click OK to accept the descriptions of the class and close the Class Specification dialog box.
3. Create the
Use-Case Realization Package in the Business Object Model
All business use-case realizations are organized initially into a package within the Artifact: Business Object Model, which is in turn represented as a package in the "Logical View" in Rational Rose™.
To create a package within the "Business Object Model" to contain the business use-case realizations :
- Right-click to select the "Business Object Model" in the browser.
- Select Package from the New option on the short-cut menu. A "NewPackage" browser icon is added to the browser.
- With the new package icon selected, type the name "Business Use-Case Realizations".
- Right-click to select the "Business Use-Case Realizations" package in the browser.
- Select Class Diagram from the New option on the short-cut menu. A "NewDiagram" browser icon is added to the browser.
- With the new diagram icon selected, type the name "Traceabilities".
4. Create a Business
Use-Case Realization
To create a business use-case realization:
- Right-click to select the "Use Case View" package in the browser and make the short-cut menu visible.
- Select Use Case from the New option on the short-cut menu. A "NewUseCase" class icon is added to the browser.
- Left-click to select the "NewUseCase" icon. Holding the left-button down, drag-and-drop the "NewUseCase" into the "Business Use-Case Realization" package within the "Business Object Model" package.
- Double-click the "NewUseCase" icon to display the Use Case Specification dialogue for "NewUseCase".
- Replace the name "NewUseCase" with the name of the business use case.
- In the Stereotype field, enter "business use-case realization".
- Click the "OK" button.
- If a dialog appears indicating the business use case now exists in two name spaces, click "OK".
5. Create
Traceability Between a Business Use-Case and its Realization
To create traceability between a business use case and its business use-case realization:
- Expand the "Logical View" in the browser.
- Expand the "Business Object Model" package in the browser
- Expand the "Business Use-Case Realization" package in the browser
- Double-click on the "Traceabilities" in the "Business Use-Case Realization" package diagram to open it.
- From the "Use Case View" left-click to select the business use case. Holding the left-button down, drag-and-drop the business use case onto the canvas of the "Traceabilities" diagram.
- From the "Business Use-Case Realizations" package, left-click the select the business use-case realization you wish to associate with the business use case selected. Holding the left-button down, drag and drop the business use-case realization onto the canvas of the "Traceabilities" diagram, locating it in close proximity to the business use case.
- From the diagram tool bar, select the "association" tool.
- Left-click on the business use-case realization. Holding the left-button down, move the mouse pointer to the business use case and release the left-button. An association will be created.
- Double-click on the association to display the association specification.
- In the stereotype field, enter "realizes".
- Click "OK".
6. Create a
Collaboration Diagram for the Business Use-Case Realization
Business use-case realizations are captured in Rational Rose® using collaboration diagrams. For more complex realizations, you can use sequence diagrams (see Create a Sequence Diagram for the Business Use-Case Realization).
To create a collaboration diagram for the business use-case realization:
- Right-click to select the business use-case realization in the browser and make the short-cut menu visible.
- Select Collaboration Diagram from the New option on the short-cut menu. A "NewDiagram" collaboration diagram icon is added to the browser.
- With the new collaboration diagram selected, type the name of the diagram. Name the diagram "<business use-case name> - <workflow type>". This naming convention simplifies future tracing of objects to the business use-case realization that they participate in.
- Double-click on the new collaboration diagram to bring it up in the diagram window.
7. Place
Actors and Objects in a Collaboration Diagram
To create objects in collaboration diagrams, do the following:
- Double-click on the collaboration diagram in the browser to open it up in the diagram window.
- Click to select a business actor in the browser.
- Drag-and-drop the business actor onto the collaboration diagram.
- Click to select a business worker or a business entity in the browser.
- Drag-and-drop the business worker or business entity onto the collaboration diagram. An object of that class is created in the collaboration diagram.
- Repeat the preceding steps for each object and actor in the business use-case realization.
8. Create
Links between Objects in a Collaboration Diagram
Links provide a way for two objects/actors to exchange messages. To create a link between two objects in a collaboration diagram, do the following:
- Double-click on the collaboration diagram in the browser to open the diagram.
- Click to select the link symbol from the toolbar.
- Click on the business actor or object on one end of the link and drag the message line to the business actor or object at the other end of the link.
- Repeat the preceding steps for each link required between objects or business actors in the business use-case realization.
9. Create a Sequence
Diagram for the Business Use-Case Realization
To create a sequence diagram for a business use-case realization:
- Right-click to select the business use-case realization in the browser and make the short-cut menu visible.
- Select Sequence Diagram from the New option on the short-cut menu. A "NewDiagram" sequence diagram icon is added to the browser.
- With the new sequence diagram selected, type the name of the sequence diagram. It is recommended that you name the diagram "<business use-case name> - <flow type>". This naming convention simplifies future tracing of objects to the business use-case realization that they participate in.
- Double-click on the new sequence diagram to bring it up in the diagram window.
- In the documentation window, enter a brief description of the business use-case realization that the sequence diagram depicts.
10. Place Actors
and Objects in a Sequence Diagram
To place actors objects in sequence diagrams:
- Double-click on the sequence diagram in the browser to open it up in the diagram window.
- Click to select the business actor in the browser.
- Drag-and-drop the business actor onto the sequence diagram.
- Click to select a business worker or a business entity in the browser.
- Drag-and-drop the business worker or business entity onto the sequence diagram. An object of that class is created in the collaboration diagram.
- Repeat the preceding steps for each object and actor in the business use-case realization.
11. Describe
Messages between Objects in a Sequence Diagram
To create a message in a sequence diagram:
- Click to select the Object Message symbol from the toolbar.
- Click on the actor or object sending the message and drag the message line to the actor or object receiving the message.
- Enter the name of the message while the message line is still selected.
- Repeat the preceding steps for each message in the business use-case realization.
To document a message:
- Open the Message Specification dialog box for the message, either by double-clicking on the message, or by right-clicking and selecting the Specification option in the short-cut menu.
- Enter the documentation in the Documentation field.
- Select OK to close the specification.
To rearrange the time order of messages in a sequence diagram, select the message arrow and drag-and-drop messages up and down the time axis to rearrange the order.
12. Describe
What an Object Does When it Receives a Message in a Sequence Diagram
To attach a script to a message:
- Select the Text Box symbol in the sequence diagram toolbar.
- Click on the position where you want to insert the script in the diagram.
- Enter the script in the text box.
- Select both the script and the message arrow by selecting the two symbols while holding down the shift-key.
- Select the Attach Script option from the Edit menu. This attaches the script to the message. Note that the script disappears if the message is removed.
Scripts can be formatted by selecting their text box and dragging the corner markers.
13. Create
Class Diagrams to Document Classes in the Business Object Model
To create a class diagram and insert a class in the diagram, do the following:
- Right-click to select the "Business Object Model" package in the browser and make the short-cut menu visible.
- Select Class Diagram from the New option on the short-cut menu. A "NewDiagram" class diagram is added to the browser.
- While the class diagram is still selected, type the name of the class diagram; name the diagram after the class that it is meant to describe.
- Click to select the class in the browser.
- Drag-and-drop the class onto the class diagram.
Repeat the preceding steps for each class in the "Business Object Model" package.
