Skip to content

docs(data-integration): add a patients CSV template, scope the columns to USCDI - #59

Merged
akim1995 merged 5 commits into
mainfrom
akim/data-integration-csv-template
Aug 27, 2026
Merged

docs(data-integration): add a patients CSV template, scope the columns to USCDI#59
akim1995 merged 5 commits into
mainfrom
akim/data-integration-csv-template

Conversation

@akim1995

@akim1995 akim1995 commented Aug 27, 2026

Copy link
Copy Markdown
Contributor

A downloadable template for patients, linked from the page.

CSV rather than a spreadsheet format: RFC 4180 is an open standard, every spreadsheet opens it, and it is the delivery format the spec already describes, so the template is the real file with its header filled in rather than a mock-up. Generated from the page's own tables, so the two cannot drift.

Example data is now non-resolving. example.org per RFC 2606 in place of acme.org, and a generic address in place of real streets, towns and counties. Every coded example validated against its bound value set.

Two columns dropped: county and name_prefix. Both are base FHIR fields US Core never mentions: absent from its differential, not must-support, not uscdi-requirement. They appear in the profile's snapshot only because a snapshot inherits every base element.

Left in place, though they have the same status: patient_identifier_type, _use, _assigner_org_npi. Dropping type would make a member number in an identifier_<n>_value slot indistinguishable from any other identifier, which is a data-usefulness call rather than a conformance one.

RFC 4180, so every spreadsheet opens it and it is the delivery format
itself rather than a mock-up. Generated from the page's own tables, so
the columns cannot drift apart.
example.org per RFC 2606, and a generic address in place of real places.
county and name_prefix are base FHIR fields US Core never mentions: not
in its differential, not must-support, not uscdi-requirement.
@akim1995 akim1995 changed the title docs(data-integration): add a CSV template for patients docs(data-integration): add a patients CSV template, scope the columns to USCDI Aug 27, 2026
@akim1995
akim1995 merged commit 8449c97 into main Aug 27, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant