NRLS-DocumentReference-1-0
DocumentReference | |
Definition |
A reference to an EPaCCS document . |
Control | 0..* |
Type | DocumentReference |
Comments |
Usually, this is used for documents other than those defined by FHIR. |
DocumentReference.masterIdentifier | |
Definition |
Document identifier as assigned by the source of the document. This identifier is specific to this version of the document. This unique identifier may be used elsewhere to identify this version of the document. |
Control | 1..1 |
Type | Identifier |
Requirements |
The structure and format of this Id shall be consistent with the specification corresponding to the formatCode attribute. (e.g. for a DICOM standard document a 64 character numeric UID, for an HL7 CDA format a serialization of the CDA Document Id extension and root in the form "oid^extension", where OID is a 64 digits max, and the Id is a 16 UTF-8 char max. If the OID is coded without the extension then the '^' character shall not be included.). |
Comments |
CDA Document Id extension and root. |
DocumentReference.masterIdentifier.system | |
Definition |
Establishes the namespace in which set of possible id values is unique. |
Control | 0..1 |
Type | Uri |
Requirements |
There are many sequences of identifiers. To perform matching, we need to know what sequence we're dealing with. The system identifies a particular sequence or set of unique identifiers. |
Comments | |
Example | http://www.acme.com/identifiers/patient or urn:ietf:rfc:3986 if the Identifier.value itself is a full uri |
DocumentReference.masterIdentifier.value | |
Definition |
The portion of the identifier typically displayed to the user and which is unique within the context of the system. |
Control | 1..1 |
Type | String |
Comments |
If the value is a full URI, then the system SHALL be urn:ietf:rfc:3986. |
Example | b18f24b7-e72c-44c0-bdf4-7e45d06db1b6 |
DocumentReference.subject | |
Definition |
The document will be about the existance of a patients end of life (EOL) record(s) stored on any EPaCCs. |
Control | 1..1 |
Type | Patient |
Comments | |
DocumentReference.type | |
Definition |
The type of document that is being recorded on the locator service. This will usually be an EPaCCs document. |
Control | 1..1 |
Binding |
Type of document. The codes SHALL be taken from http://fhir.nhs.net/ValueSet/correspondencedocumenttype-1-0 |
Type | CodeableConcept |
Comments |
Key metadata element describing the document, used in searching/filtering. |
DocumentReference.type.coding | |
Definition |
A reference to a code defined by a terminology system. |
Control | 1..1 |
Type | Coding |
Requirements |
Allows for translations and alternate encodings within a code system. Also supports communication of the same instance to systems requiring different encodings. |
Comments |
Codes may be defined very casually in enumerations, or code lists, up to very formal definitions such as SNOMED CT - see the HL7 v3 Core Principles for more information. Ordering of codings is undefined and SHALL NOT be used to infer meaning. Generally, at most only one of the coding values will be labelled as UserSelected = true. |
DocumentReference.type.coding.system | |
Definition |
The identification of the code system that defines the meaning of the symbol in the code. |
Control | 1..1 |
Type | Uri |
Requirements |
Need to be unambiguous about the source of the definition of the symbol. |
Comments |
The URI may be an OID (urn:oid:...) or a UUID (urn:uuid:...). OIDs and UUIDs SHALL be references to the HL7 OID registry. Otherwise, the URI should come from HL7's list of FHIR defined special URIs or it should de-reference to some definition that establish the system clearly and unambiguously. |
Fixed Value | http://snomed.info/sct |
DocumentReference.type.coding.code | |
Definition |
A symbol in syntax defined by the system. The symbol may be a predefined code or an expression in a syntax defined by the coding system (e.g. post-coordination). |
Control | 1..1 |
Type | Code |
Requirements |
Need to refer to a particular code in the system. |
Comments | |
Example | 861421000000109 |
DocumentReference.type.coding.display | |
Definition |
A representation of the meaning of the code in the system, following the rules of the system. |
Control | 1..1 |
Type | String |
Requirements |
Need to be able to carry a human-readable meaning of the code for readers that do not know the system. |
Comments | |
Example | End of Life Care Coordination Summary |
DocumentReference.author | |
Definition |
Identifies who is responsible for adding the information to the document. |
Control | 1..1 |
Type | Practitioner |
Comments |
Not necessarily who did the actual data entry (i.e. typist) it in or who was the source (informant). |
DocumentReference.custodian | |
Definition |
Identifies the organization or group who is responsible for ongoing maintenance of and access to the document. |
Control | 1..1 |
Type | Organization |
Comments |
Identifies the logical organization to go to find the current version, where to report issues, etc. This is different from the physical location of the document, which is the technical location of the document, which host may be delegated to the management of some other organization. |
DocumentReference.custodian.reference | |
Definition |
A reference to a location at which the other resource is found. The reference may be a relative reference, in which case it is relative to the service base URL, or an absolute URL that resolves to the location where the resource is found. The reference may be version specific or not. If the reference is not to a FHIR RESTful server, then it should be assumed to be version specific. Internal fragment references (start with '#') refer to contained resources. |
Control | 1..1 ? |
Type | String |
Comments |
Using absolute URLs provides a stable scalable approach suitable for a cloud/web context, while using relative/logical references provides a flexible approach suitable for use when trading across closed eco-system boundaries. Absolute URLs do not need to point to a FHIR RESTful server, though this is the preferred approach. If the URL conforms to the structure "/[type]/[id]" then it should be assumed that the reference is to a FHIR RESTful server. |
Example | https://sds.proxy.nhs.uk/Organization/A83627 |
DocumentReference.custodian.display | |
Definition |
Plain text narrative that identifies the resource in addition to the resource reference. |
Control | 0..1 |
Type | String |
Comments |
This is generally not the same as the Resource.text of the referenced resource. The purpose is to identify what's being referenced, not to fully describe it. |
DocumentReference.authenticator | |
Definition |
Which person or organization authenticates that this document is valid. |
Control | 0..1 |
Type | Practitioner |
Comments |
Represents a participant within the author institution who has legally authenticated or attested the document. Legal authentication implies that a document has been signed manually or electronically by the legal Authenticator. |
DocumentReference.created | |
Definition |
When the document was created. |
Control | 1..1 |
Type | DateTime |
Comments |
Creation time is used for tracking, organizing versions and searching. This is the creation time of the document, not the source material on which it is based. |
DocumentReference.indexed | |
Definition |
When the document reference was created. |
Control | 1..1 |
Type | Instant |
Comments |
Referencing/indexing time is used for tracking, organizing versions and searching. |
DocumentReference.status | |
Definition |
The status of this document reference. |
Control | 1..1 |
Binding |
The status of the document reference. The codes SHALL be taken from http://hl7.org/fhir/ValueSet/document-reference-status |
Type | Code |
Is Modifier | True |
Comments |
This is the status of the DocumentReference object. If a document exisits then it must be current, since NRLS either has an EPaCCs document or it doesn't. |
Fixed Value | current |
DocumentReference.description | |
Definition |
Human-readable description of the source document. This is sometimes known as the "title". |
Control | 0..1 |
Type | String |
Requirements |
Helps humans to assess whether the document is of interest. |
Comments |
What the document is about, rather than a terse summary of the document. It is commonly the case that records do not have a title and are collectively referred to by the display name of Record code (e.g. a "consultation" or "progress note"). |
DocumentReference.securityLabel | |
Definition |
A set of Security-Tag codes specifying the level of privacy/security of the Document. Note that DocumentReference.meta.security contains the security labels of the "reference" to the document, while DocumentReference.securityLabel contains a snapshot of the security labels on the document the reference refers to. |
Control | 1..1 |
Binding |
Security Labels from the Healthcare Privacy and Security Classification System. The codes SHALL be taken from the following if appropriate, otherwise an alternate coding may be included instead. http://hl7.org/fhir/ValueSet/security-labels |
Type | CodeableConcept |
Requirements |
Use of the Health Care Privacy/Security Classification (HCS) system of security-tag use is recommended. |
Comments |
The confidentiality codes can carry multiple vocabulary items. HL7 has developed an understanding of security and privacy tags that might be desirable in a Document Sharing environment, called HL7 Healthcare Privacy and Security Classification System (HCS). The following specification is recommended but not mandated, as the vocabulary bindings are an administrative domain responsibility. The use of this method is up to the policy domain such as the XDS Affinity Domain or other Trust Domain where all parties including sender and recipients are trusted to appropriately tag and enforce. In the HL7 Healthcare Privacy and Security Classification (HCS) there are code systems specific to Confidentiality, Sensitivity, Integrity, and Handling Caveats. Some values would come from a local vocabulary as they are related to workflow roles and special projects. |
DocumentReference.securityLabel.coding | |
Definition |
A reference to a code defined by a terminology system. |
Control | 1..1 |
Type | Coding |
Requirements |
Allows for translations and alternate encodings within a code system. Also supports communication of the same instance to systems requiring different encodings. |
Comments |
Codes may be defined very casually in enumerations, or code lists, up to very formal definitions such as SNOMED CT - see the HL7 v3 Core Principles for more information. Ordering of codings is undefined and SHALL NOT be used to infer meaning. Generally, at most only one of the coding values will be labelled as UserSelected = true. |
DocumentReference.securityLabel.coding.system | |
Definition |
The identification of the code system that defines the meaning of the symbol in the code. |
Control | 1..1 |
Type | Uri |
Requirements |
Need to be unambiguous about the source of the definition of the symbol. |
Comments |
The URI may be an OID (urn:oid:...) or a UUID (urn:uuid:...). OIDs and UUIDs SHALL be references to the HL7 OID registry. Otherwise, the URI should come from HL7's list of FHIR defined special URIs or it should de-reference to some definition that establish the system clearly and unambiguously. |
Example | http://hl7.org/fhir/ValueSet/security-labels |
DocumentReference.securityLabel.coding.code | |
Definition |
A symbol in syntax defined by the system. The symbol may be a predefined code or an expression in a syntax defined by the coding system (e.g. post-coordination). |
Control | 1..1 |
Type | Code |
Requirements |
Need to refer to a particular code in the system. |
Comments | |
Example | V |
DocumentReference.securityLabel.coding.display | |
Definition |
A representation of the meaning of the code in the system, following the rules of the system. |
Control | 1..1 |
Type | String |
Requirements |
Need to be able to carry a human-readable meaning of the code for readers that do not know the system. |
Comments | |
Example | very restricted |
DocumentReference.securityLabel.text | |
Definition |
A human language representation of the concept as seen/selected/uttered by the user who entered the data and/or which represents the intended meaning of the user. |
Control | 0..1 |
Type | String |
Requirements |
The codes from the terminologies do not always capture the correct meaning with all the nuances of the human using them, or sometimes there is no appropriate code at all. In these cases, the text is used to capture the full meaning of the source. |
Comments |
Very often the text is the same as a displayName of one of the codings. |
DocumentReference.content | |
Definition |
The document and format referenced. There may be multiple content element repetitions, each with a different format. |
Control | 1..1 |
Type | BackboneElement |
Comments |
Document referenced. Can be data or a uri where the data can be found. |
DocumentReference.content.modifierExtension | |
Definition |
May be used to represent additional information that is not part of the basic definition of the element, and that modifies the understanding of the element that contains it. Usually modifier elements provide negation or qualification. In order to make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer is allowed to define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions. |
Control | 0..* |
Type | Extension |
Is Modifier | True |
Aliases | extensions, user content, modifiers |
Comments |
There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone. |
DocumentReference.content.attachment | |
Definition |
The document or url of the document along with critical metadata to prove content has integrity. |
Control | 1..1 |
Type | Attachment |
Comments |
The attachment can be a data (base64 binary) or a uri, but only applicable if the attachment has data. |
DocumentReference.content.attachment.contentType | |
Definition |
Identifies the type of the data in the attachment and allows a method to be chosen to interpret or render the data. Includes mime type parameters such as charset where appropriate. |
Control | 1..1 |
Binding |
The mime type of an attachment. Any valid mime type is allowed. The codes SHALL be taken from http://www.Rfc-Editor.org/bcp/bcp13.txt |
Type | Code |
Requirements |
Processors of the data need to be able to know how to interpret the data. |
Comments | |
Example | application/pdf |
DocumentReference.content.attachment.url | |
Definition |
An alternative location where the data can be accessed. |
Control | 1..1 |
Type | Uri |
Requirements |
The data needs to be transmitted by reference. |
Comments |
If both data and url are provided, the url SHALL point to the same content as the data contains. Urls may be relative references or may reference transient locations such as a wrapping envelope using cid: though this has ramifications for using signatures. Relative URLs are interpreted relative to the service url, like a resource reference, rather than relative to the resource itself. If a URL is provided, it SHALL resolve to actual data. |
Example | https://gpsystem.nhs.uk/epcaccs/9409401122/EOLSummary.pdf |
DocumentReference.content.attachment.size | |
Definition |
The number of bytes of data that make up this attachment. |
Control | 1..1 |
Type | UnsignedInt |
Requirements |
Representing the size allows applications to determine whether they should fetch the content automatically in advance, or refuse to fetch it at all. |
Comments |
The number of bytes is redundant if the data is provided as a base64binary, but is useful if the data is provided as a url reference. |
DocumentReference.content.attachment.title | |
Definition |
A label or set of text to display in place of the data. |
Control | 1..1 |
Type | String |
Requirements |
Applications need a label to display to a human user in place of the actual data if the data cannot be rendered or perceived by the viewer. |
Comments | |
Example | EPaCCs Place chosen to die summary |
DocumentReference.context | |
Definition |
The clinical context in which the document was prepared. |
Control | 1..1 |
Type | BackboneElement |
Comments |
These values are primarily added to help with searching for interesting/relevant documents. |
DocumentReference.context.modifierExtension | |
Definition |
May be used to represent additional information that is not part of the basic definition of the element, and that modifies the understanding of the element that contains it. Usually modifier elements provide negation or qualification. In order to make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer is allowed to define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions. |
Control | 0..* |
Type | Extension |
Is Modifier | True |
Aliases | extensions, user content, modifiers |
Comments |
There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone. |
DocumentReference.context.facilityType | |
Definition |
The kind of facility where the patient was seen. |
Control | 1..1 |
Binding |
XDS Facility Type. For example codes, see http://hl7.org/fhir/ValueSet/c80-facilitycodes ; other codes may be used where these codes are not suitable |
Type | CodeableConcept |
Comments | |
DocumentReference.context.facilityType.coding | |
Definition |
A reference to a code defined by a terminology system. |
Control | 1..1 |
Type | Coding |
Requirements |
Allows for translations and alternate encodings within a code system. Also supports communication of the same instance to systems requiring different encodings. |
Comments |
Codes may be defined very casually in enumerations, or code lists, up to very formal definitions such as SNOMED CT - see the HL7 v3 Core Principles for more information. Ordering of codings is undefined and SHALL NOT be used to infer meaning. Generally, at most only one of the coding values will be labelled as UserSelected = true. |
DocumentReference.context.facilityType.coding.system | |
Definition |
The identification of the code system that defines the meaning of the symbol in the code. |
Control | 1..1 |
Type | Uri |
Requirements |
Need to be unambiguous about the source of the definition of the symbol. |
Comments |
The URI may be an OID (urn:oid:...) or a UUID (urn:uuid:...). OIDs and UUIDs SHALL be references to the HL7 OID registry. Otherwise, the URI should come from HL7's list of FHIR defined special URIs or it should de-reference to some definition that establish the system clearly and unambiguously. |
Example | http://hl7.org/fhir/ValueSet/c80-facilitycodes |
DocumentReference.context.facilityType.coding.code | |
Definition |
A symbol in syntax defined by the system. The symbol may be a predefined code or an expression in a syntax defined by the coding system (e.g. post-coordination). |
Control | 1..1 |
Type | Code |
Requirements |
Need to refer to a particular code in the system. |
Comments | |
Example | 83891005 |
DocumentReference.context.facilityType.coding.display | |
Definition |
A representation of the meaning of the code in the system, following the rules of the system. |
Control | 1..1 |
Type | String |
Requirements |
Need to be able to carry a human-readable meaning of the code for readers that do not know the system. |
Comments | |
Example | Solo practice private office |