PACIO Sample Data Depot
0.1.0 - draft

PACIO Sample Data Depot, published by MITRE. This guide is not an authorized publication; it is the continuous build for version 0.1.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/paciowg/sample-data-fsh/ and changes regularly. See the Directory of published versions

Examples Style Guide

Conventions

This page reviews naming conventions for the use case persona and examples.

Persona

Personas will have a unique profile to start. This is similar to a "scene 0" that was shown in different Connectathons.

The conventions are designed to be persona-centric.

Persona identifiers

The id convention will be as such: <resource type>-<concatenated first and last name and ordinal number>

Example 1: a patient name of "Jenny Mosley" will have an id: patient-jennymosley01.

Example 2: a provider of "Anita M. Chu" will have an id: practitioner-AnitaChu-01.

It is recommended that any change to demographics for a person should have a different name entirely. However, if we want to keep the same person name, then ensure there is a unique number at the end. Include in the FSH Description field a short description of what makes this patient unique from the other initial persona.

For example, if patient-jennymosley01 was born on Feb 1, 1965 and we wanted the patient in a different scenario to be older in a different world with a new birthdate of March 15, 1950 then create a new patient identifier patient-jennymosley02. Then put in the description field: Description: "Patient Jenny Mosley has a different birth date."

Locations

The convention for locations will mirror the convention fo persona: <resource type>-<concatenated location "name" and ordinal number>

The name of a location can be pulled from the name data element (renaissancepharmacy), be composed of some portion of the address (111MapleCt) or be a more general description like Jenny Mosley's home (jennymosley_home).

Example 1: a location known as "Renaissance Pharmacy" can have an id: Location-RenaissancePharmacy01.

Other resource identifiers

A storyboard may assume that a given set of clinical information may undergo a change over time. For example, a medication of metropolol 50 mg twice daily that prescribed to a patient on 2024-05-07 may be adjusted 6 months later to metropolol 25 mg twice daily.

We recommend the following convention make the details of the change over time more flexible:

<concatenated first and last name and ordinal number>-<resource type>-<resource name>-<ordinal number>

Then add a brief summary in description field if there is a change.

Example 1:

patient Jenny Mosley prescribed the medication metoprolol for the first time, will have the following representation in FSH:

id: "jennymosley01-MedicationRequest-Metoprolol-01"
Description: "Patient Jenny Mosley with initial medication metoprolol prescribed."

Assume that the medication has changed in prescription. Workflow-wise, this is a discontinuation of the first medication request and a new prescription of metropolol with the adjusted dose. This results in 2 more example resources:

id: "jennymosley01-medicationrequest_metoprolol-02"
Description: "Patient Jenny Mosley with initial medication metoprolol discontinued."
id: "jennymosley01-medicationrequest_metoprolol-03"
Description: "Patient Jenny Mosley containing new prescription of metoprolol with adjusted dose."