Example Structured Narrative - brianhigh/data-workshop GitHub Wiki
From the Example Goals List, we can make a more formal structured narrative to use when preparing use cases and use case diagrams.
Please note, this document does not provide complete “Use Case Narratives”. Those are much more detailed.
Roles become actors and goals become use cases. We will use the terms “must”, “should”, or “may” in each narrative statement. We use “must”, instead of the more traditional “shall” for a required step, for added clarity.
| Actor | Use Case | Structured Narrative |
|---|---|---|
| Subject | Sign Consent Form | If a human subject is sampled, the subject must sign a consent form. |
| Sampler | Collect Consent Form | The sampler must collect the consent form before sampling the subject. |
| Subject | Complete Subject Data Form | The subject must complete a subject data form by providing personal information. |
| Sampler | Collect Subject Data Form | The sampler must collect the subject data form before sampling the subject. |
| Sampler | Enter Subject Data | The sampler must enter subject information into the system for each human subject sampled. |
| Sampler | Collect Sample | The sampler may collect a sample from a human subject or from a non-human surface. |
| Sampler | Record Geo Location | The sampler must record the geographical sampling location for all samples taken. |
| Sampler | Record Body Location | The sampler must record the human body sampling location for all samples taken from human subjects. |
| Sampler | Record Temperature | The sampler must record a temperature reading for all samples taken. |
| Sampler | Record Humidity | The sampler must record a humidity reading for all samples taken. |
| Sampler | Enter Sample Data | The sampler must enter sample information into the system for each sample collected. |
| Sampler | Deliver Sample | The sampler must deliver the sample to the laboratory. |
| Lab Tech | Receive Sample | The laboratory technician must receive the sample when it is delivered. |
| Lab Tech | Store Sample | The laboratory technician must store the sample in a cooler (refrigerator). |
| Lab Tech | Split Sample | The laboratory technician must split the sample before testing. |
| Lab Tech | Test Sample | The laboratory technician must test the sample before it expires. |
| Lab Tech | Enter Test Result | The laboratory technician must enter the test result into the system. |
| Lab Tech | Dispose Sample | The laboratory technician must dispose of the sample after it is no longer needed. |
| Statistician | Query Results | The statistician may query the system for test results. |
| Statistician | Analyze Results | The statistician may analyze the results using statistical tools. |
In the process of completing the structured narrative, the researcher decided that the the subject merely fills out a (paper) form and then the sampler enters the form data into the data system. This is to help prevent data entry errors and to restrict access to the data system. More specific goals were also identified in the process of making this document, such as recording the sampling location, temperature and humidity.
Such details about what personal information is stored on subjects, how samples are labelled (i.e. how sample IDs are issued), what other sample information is stored, how long before a sample expires, how long samples are stored before disposal, which tests are performed on samples, or when and how sample data are “de-identified” regarding human subject identifiers are still not clear.
Those details will be clarified in later requirements documents.