Requisition Copy To Extension

Canonical	../StructureDefinition/nexus-requisition-copy-to
Status	draft · 1.26.0
Base	Extension (constraint)
Context	ServiceRequest (element)
Source	FSH · JSON

The name of a second clinician the laboratory requisition is copied to, as typed onto the form.

FSH

The authored source of truth: extensions/RequisitionCopyToExtensions.fsh (edit on GitHub). One FSH file may define several related artifacts.

// RequisitionCopyToExtensions.fsh
// The second clinician a laboratory requisition is copied to: their name, and where to send it.
//
// TWO SIMPLE EXTENSIONS, NOT ONE COMPLEX ONE. Each is written independently at the root of the
// requisition `ServiceRequest`, each holds a string, and each appears only when the box it came
// from was filled in. A name with no address and an address with no name are both ordinary, so
// grouping them under a parent extension would describe a shape the data does not have.
//
// WHAT THIS RECORDS. The provincial laboratory requisition prints one "Copy to" block: a tick box,
// a surname box, a given-name box and an address line. What was typed into it is part of the
// requisition -- a reprint has to reproduce the sheet from the resource alone -- and R4 offers no
// element for it. `ServiceRequest.performer` is who does the work, and `requester` is who ordered
// it; neither says who else gets a copy of the result. So the typed text is preserved here.
//
// ONE RECIPIENT, AND THE FORM IS THE REASON. The printed block has one set of boxes, so the data
// has one recipient. That is a limit worth stating rather than an accident to be worked around:
// a repeat, or a reference to a real directory entry, would each be a widening, and a consumer
// written against a single free-text recipient today would still read correctly afterwards.
//
// THE NAME IS ONE STRING, JOINED. The two printed boxes are stored as `"Last, First"` -- the text
// before the first comma is the surname and everything after it is the given name, so that both
// the reprint and the reopened form split it identically. Where only one box was filled the string
// carries that part alone with no separator.
//
// IT IS NOT AN ACTOR. Nothing here is a `Reference`, nothing resolves, and nothing was matched
// against a practitioner directory. It is transcription of what a clinician typed onto a form.
//
// IT IS ON THE ORDER ONLY. The copy-to travels with the requisition. It is not echoed onto the
// `DiagnosticReport` the requisition eventually produces, so a reader asking "who else was to
// receive this result" has to ask the order, and delivery of any copy happens outside FHIR.

Extension: NexusRequisitionCopyTo
Id: nexus-requisition-copy-to
Title: "Requisition Copy To Extension"
Description: """
The name of a second clinician the laboratory requisition is copied to, as typed onto the form.

**Free text, not an actor.** This is a transcription of the surname and given-name boxes on the
printed requisition. It is not a `Reference`, it was not matched against a practitioner directory,
and a consumer must not treat it as a resolvable actor or attempt to resolve it as one.

**Stored as one string, `"Last, First"`.** The text before the first comma is the surname; the text
after it is the given name, including any later comma. Where only one of the two boxes was filled,
the string is that part alone with no separator.

**At most one recipient.** The printed form prints one copy-to block, so the data carries one name.
A reader encountering more than one occurrence should take the first. Carrying several recipients,
or referencing a directory entry instead of naming one, would each be a widening of this element;
neither is available today.

**Present only when the box was filled in.** Its presence is what ticks the form's copy-to check
box on a reprint; there is no separate stored flag.

**It is on the order, and only on the order.** The copy-to is not echoed onto the
`DiagnosticReport` the requisition produces, and nothing in FHIR records that a copy was sent.
"""
* ^url = "../StructureDefinition/nexus-requisition-copy-to"
* ^status = #draft
* ^context[0].type = #element
* ^context[0].expression = "ServiceRequest"
* extension 0..0
* url 1..1
* value[x] 1..1 MS
* value[x] only string
* valueString ^short = "Copy-to clinician's name, as typed -- surname, comma, given name"
* valueString ^definition = "The copy-to clinician's name exactly as typed onto the requisition, with the surname and given name joined as `Last, First`. Free text: not a reference, not directory-matched, and not to be read as a resolvable actor."

Extension: NexusRequisitionCopyToAddress
Id: nexus-requisition-copy-to-address
Title: "Requisition Copy To Address Extension"
Description: """
Where to send the copy of a laboratory requisition's results, as typed onto the form.

**Free text on one line, not an `Address`.** It is the address line of the printed copy-to block,
preserved as a single string. It is not parsed into parts, not validated, and not matched against
any location or organization record.

**Independent of the name.** It appears only when the address box was filled in, so an address
with no accompanying name -- or a name with no address -- is ordinary rather than an error.

**At most one, alongside at most one name.** The printed form prints one copy-to block. A repeat
would be a widening of this element and is not available today.

**It is on the order, and only on the order.** Like the copy-to name, it is not echoed onto the
`DiagnosticReport` the requisition produces, and nothing in FHIR records that a copy was sent.
"""
* ^url = "../StructureDefinition/nexus-requisition-copy-to-address"
* ^status = #draft
* ^context[0].type = #element
* ^context[0].expression = "ServiceRequest"
* extension 0..0
* url 1..1
* value[x] 1..1 MS
* value[x] only string
* valueString ^short = "Where to send the copy, as typed -- one free-text line"
* valueString ^definition = "The copy-to address exactly as typed onto the requisition, as a single unparsed line. Not an `Address` datatype, not validated, and not matched against a location or organization record."