Skip directly to search Skip directly to A to Z list Skip directly to navigation Skip directly to page options Skip directly to site content

NPCR–AERRO Diagram Conventions

The Advancing E-cancer Reporting and Registry Operations (AERRO) model diagrams are based on the Unified Modeling Language (UML). This document outlines additional conventions used specifically for AERRO.

General Conventions

  • Diagrams flow from top to bottom.
  • Diagrams flow from left to right.
  • The version number changes only when major changes are implemented. For minor changes, there is no version change.
  • Notes are represented by rectangles with the top right corner folded down.
  • The work being discussed is shaded purple.
  • General comments or questions are shown in white or purple colors.

Decision Nodes in Activity Diagrams (Workflow and Data Flow Diagrams)

  • Text questions are to the left of the decision node.
  • All activity diagrams (in general) have one start point and one end point.

Use Case Diagrams

  • The first level is represented as a package. A package is a container in the shape of a yellow folder which can contain different model elements such as use cases and other packages.
  • Second-level use cases are represented by light blue ovals.
  • Each use case is assigned to the first or second level according to its hierarchy.

Activity Diagrams (Workflow and Data Flow Diagrams)

  • Decisions are represented by light yellow diamonds.
  • Start and end nodes are represented by black circles with a red outline.
  • State transition specifications are presented as a guard condition for transition from one state to another.
  • Business rules and software requirements are shown in the right swimlane (column) in light blue.
  • Horizontal and vertical solid black lines are synchronization bars.

Technicalities and Concepts to Understand the Diagrams

  • Domain Diagram: The classes connecting to "Internal and External Data Source" classes are actual data sources, not data coming from those classes.
  • Use Case Diagram: The use cases are presented in a hierarchical way. The highest or first-level use case consists of the second-level use case(s) and so on.
  • Workflow Diagram: The details presented in this diagram are limited. It is a simple representation of the normal course of events.
  • Data Flow Diagram: This is a detailed diagram with all conditions covered for a use case or process. It presents exceptions, alternate courses of events, and business rules for the normal course of events in the process.
  • All Diagrams: When reading a diagram, pay attention to the direction of arrows.