Guideline: Find and Outline Actors and Use Cases
This guideline describes how to find and outline Actors and use cases.
Relationships
Main Description

Finding Actors

Find the external entities with which the system under development must interact. Candidates include groups of users who will require help from the system to perform their tasks and to execute the system's primary or secondary functions, as well as external hardware, software, and other systems.

Define each candidate Actor by naming it and writing a brief description. Include the Actor's area of responsibility and the goals that the Actor will attempt to accomplish when using the system. Eliminate Actor candidates who do not have any goals. For more information on Actors and their properties, see Concept: Actor.

These questions are useful for identifying Actors:

  • Who will supply, use, or remove information from the system?
  • Who will use the system?
  • Who is interested in a certain feature or service provided by the system?
  • Who will support and maintain the system?
  • What are the system's external resources?
  • What other systems will need to interact with the system under development?

Review the list of stakeholders that you captured in the Vision Statement. Not all stakeholders will be Actors (meaning, they will not all interact directly with the system under development), but this list of stakeholders is useful for identifying candidates for Actors.

Finding likely use cases

The best way to find use cases is to consider what each Actor requires of the system. For each Actor, human or not, ask:

  • What are the goals that the Actor will attempt to achieve with the system?
  • What are the primary tasks that the Actor wants the system to perform?
  • Will the Actor create, store, change, remove, or read data in the system?
  • Will the Actor need to inform the system about sudden external changes?
  • Does the Actor need to be informed about certain occurrences in the system, such as unavailability of a network?
  • Will the Actor perform a system startup or shutdown?

Understanding how the target organization works and how this information system might be incorporated into existing operations gives an idea of system's surroundings. That information may reveal other use case candidates.

Give a unique name and brief description that clearly describes the goals for each use case. If the candidate use case does not have goals, ask yourself why it exists, and then either identify a purpose for it or eliminate the use case. For more information on use cases and their properties, see Concept: Use Case.

Outlining use cases

Without going into details, write a first draft of the flow of events of the use cases identified as high-priority. Initially, write a simple step-by-step description of the basic flow of the use case. The step-by-step description is a simple ordered list of interactions between the Actor and the system. For example, the description of the basic flow of the Withdraw Cash use case of an automated teller machine (ATM) would be something like this:

  1. The customer inserts a bank card.
  2. The system validates the card and prompts the person to enter a personal identification number (PIN).
  3. The customer enters a PIN.
  4. The system validates the PIN and prompts the customer to select an action.
  5. The customer selects Withdraw Cash.
  6. The system prompts the customer to choose which account.
  7. The customer selects the checking account.
  8. The system prompts for an amount.
  9. The customer enters the amount to withdraw.
  10. The system validates the amount (assuming sufficient funds), and then issues cash and a receipt.
  11. The customer takes the cash and receipt, and then retrieves the bank card.
  12. The use case ends.

As you create this step-by-step description of the basic flow of events, you may discover alternative and exceptional flows. For example, what happens if the customer enters an invalid PIN? Capture each alternative flow that you identified so that you don't forget them. You can fill in the details later. See Example: Evolution of the Use-Case Model for more information on how the use cases evolve.

Relationships between Actors and use cases

The relationship between Actors and use cases should be captured, or documented  There are several ways to do this. If you are using a use-case model on the project, you can create use-case diagrams to show how Actors and use cases relate to each other. See Guideline: Use-Case Model for more information.

If you are not using a use-case model for the project, make sure that each use case identifies the associated primary and secondary Actors.

More Information