In a Structured Narrative Dataset (SND) system, events are the primary objects used to tie together data recorded for a participant. To add data to a participant's record, a project is selected, and a super-package is chosen from its list. The user fills in the data for the attributes defined in the XML narrative, and these values are then stored.

Events are linked to the project table to provide a reference to a restricted super-package list. They are also linked to an external query source to validate the participant’s membership in the project.

Data Entry Workflow

1. Select a participant ID.
2. Select the appropriate project. The project contains an approved list of procedures (packages) that can be performed and ties those packages to billing and protocol information.
3. Select the package for which to enter data.
4. Enter the appropriate data on the given page.

Procedure Attributes

The data entry panel lists procedure attributes to be provided, such as treatment amounts and route of treatment.

Procedure Narrative

The procedure narrative records step by step what has happened and connects the description with the package IDs where the entered data has been recorded. Using a narrative template and entered data filtered to a specific participant and event, the narrative can be generated using the API.

Narrative Generation

Each package definition includes a narrative template including curly brace delimited {tokens} marking where data will be inserted.

• Package Narrative Template: Defined with each package to provide a template for putting the data into test format. Tokens mark where to put actual data in the template
• Example:

  Heart rate = {HR} bpm, temperature = {temp} F, respiration rate = {RR} bpm

• Super Package Narrative Template: A text representation, in hierarchical format, of all the Package Narrative Templates.
• Example:

  - Weight and vitals
  	- Heart rate = {HR} bpm, temperature = {temp} F, respiration rate = {RR} bpm
  	- Weight = {weight} kg

The tokens become attribute columns, populated as part of data entry. Using the templates, event narratives can be generated by populating the templates with the entered data for the specific event and participant ID.

• Super Package Narrative For Event: Super Package Narrative Template with the saved values for a particular SND Event on a particular participant Id filled in.
• Example:

  5/5/2017 12:12:29
  Admit/Charge ID: 1111
  **  Weight and vitals
  	- Heart rate = 131 bpm, temperature = 100.70 F, respiration rate = 35 bpm 
  	- Weight = 7.10 kg

• Full Event Narrative: All the Super Package Narratives for an Event for a given participant Id.
• Example:

  5/5/2017 12:12:29
  Admit/Charge ID: 1111
  ** TB test right eye. Result: negative 
  ** Weight and vitals 
  	- Heart rate = 131bpm, temperature = 100.70 F, respiration rate = 35 bpm 
  	- Weight = 7.10 kg

• Full Narrative: Full Event Narratives over a given period of time.
• Example:

  5/5/2017 10:12:29
  Admit/Charge ID: 1111
  ** TB test right eye. Result: negative 
  ** Weight and vitals 
  	- Heart rate = 131bpm, temperature = 100.70 F, respiration rate = 35 bpm 
  	- Weight = 7.10 kg 		
  5/23/2017 15:05:00
  Admit/Charge ID: 1111
  	**  Cumulative blood draw of 1.000 mL for 200XY

Procedure Notes

The notes section allows the entry of additional notes which will be stored with the event.

When data is entered, fields are filtered to the packages and subpackages associated with the event.

Related Topics

• Structured Narrative Datasets
• SND: APIs