SpecimenDefinition
Introduction
Scope and Usage
SpecimenDefinition will define a kind of specimen, which can be associated with in vitro diagnostic procedures described in a catalog of orderable services. SpecimenDefinition describes the kind of specimen to be collected from the subject of these procedures as well as the requirements applying to the collection activity, the preparation of the subject for this collection. This resource also describes the associated type(s) of specimen conditioned for testing, which are the output of the specimen collection activity. A specimen conditioned for testing is described with the type(s) of container and possible additive to be used, the minimal and normal volumes of collection, the conditions of storage, transportation and handling for the specimen once collected and conditioned. This resource is a necessary building block of a sharable catalog of orderable in vitro diagnostic services. The subjects of these orderable services may be human patients, non-human living subjects or non-living materials such as water, surfaces, medical devices, etc. All sub-specialties of clinical and anatomic pathology laboratories are concerned, as well as all care services prone to order in vitro diagnostic services to those laboratories. A catalog of orderable services generally belongs to a specific laboratory or facility. Nonetheless, the data items used to build this catalog are of universal meaning and interest.
Boundaries and Relationships
This resource relates to these other resources:
- The SpecimenDefinition resource is referenced by the Catalog resource, which represents a whole catalog, to enable the creation and maintenance of kinds of specimens within a catalog of orderable diagnostic services.
- The SpecimenDefinition resource references the SubstanceDefinition resource, in order to describe the type of substance (body fluid, other material) concerned by a kind of specimen. It also references the SubstanceDefinition resource to describe additives to be used in the production of specimens of some kind.
Background and Context
Provides additional detail on exactly how the resource is to be used
StructureDefinition
Elements (Simplified)
- SpecimenDefinition [0..*]: - Kind of specimen
- SpecimenDefinition.url [0..1]: uri Logical canonical URL to reference this SpecimenDefinition (globally unique)
- SpecimenDefinition.identifier [0..1]: Identifier Business identifier
- SpecimenDefinition.version [0..1]: string Business version of the SpecimenDefinition
- SpecimenDefinition.versionAlgorithm[x] [0..1]: string, Coding extensible:version-algorithm How to compare versions
- SpecimenDefinition.name [0..1]: string Name for this {{title}} (computer friendly)
- SpecimenDefinition.title [0..1]: string Name for this SpecimenDefinition (Human friendly)
- SpecimenDefinition.derivedFromCanonical [0..*]: canonical Based on FHIR definition of another SpecimenDefinition
- SpecimenDefinition.derivedFromUri [0..*]: uri Based on external definition
- SpecimenDefinition.status [1..1]: code required:publication-status draft | active | retired | unknown
- SpecimenDefinition.experimental [0..1]: boolean If this SpecimenDefinition is not for real usage
- SpecimenDefinition.subject[x] [0..1]: CodeableConcept, Reference(Group) Type of subject for specimen collection
- SpecimenDefinition.date [0..1]: dateTime Date status first applied
- SpecimenDefinition.publisher [0..1]: string The name of the individual or organization that published the SpecimenDefinition
- SpecimenDefinition.contact [0..*]: ContactDetail Contact details for the publisher
- SpecimenDefinition.description [0..1]: markdown Natural language description of the SpecimenDefinition
- SpecimenDefinition.useContext [0..*]: UsageContext Content intends to support these contexts
- SpecimenDefinition.jurisdiction [0..*]: CodeableConcept extensible:jurisdiction Jurisdiction of the authority that maintains the this SpecimenDefinition (if applicable)
- SpecimenDefinition.purpose [0..1]: markdown Why this SpecimenDefinition is defined
- SpecimenDefinition.copyright [0..1]: markdown Notice about intellectual property ownership, can include restrictions on use
- SpecimenDefinition.copyrightLabel [0..1]: string Copyright holder and year(s)
- SpecimenDefinition.approvalDate [0..1]: date When SpecimenDefinition was approved by publisher
- SpecimenDefinition.lastReviewDate [0..1]: date The date on which the asset content was last reviewed by the publisher
- SpecimenDefinition.effectivePeriod [0..1]: Period The effective date range for the SpecimenDefinition
- SpecimenDefinition.typeCollected [0..1]: CodeableConcept example:v2-0487 Kind of material to collect
- SpecimenDefinition.patientPreparation [0..*]: CodeableConcept example:prepare-patient-prior-specimen-collection Patient preparation for collection
- SpecimenDefinition.timeAspect [0..1]: string Time aspect for collection
- SpecimenDefinition.collection [0..*]: CodeableConcept example:specimen-collection Specimen collection procedure
- SpecimenDefinition.typeTested [0..*]: BackboneElement Specimen in container intended for testing by lab
- SpecimenDefinition.typeTested.isDerived [0..1]: boolean Primary or secondary specimen
- SpecimenDefinition.typeTested.type [0..1]: CodeableConcept example:v2-0487 Type of intended specimen
- SpecimenDefinition.typeTested.preference [1..1]: code required:specimen-contained-preference preferred | alternate
- SpecimenDefinition.typeTested.container [0..1]: BackboneElement The specimen's container
- SpecimenDefinition.typeTested.container.material [0..1]: CodeableConcept example:container-material The material type used for the container
- SpecimenDefinition.typeTested.container.type [0..1]: CodeableConcept example:specimen-container-type Kind of container associated with the kind of specimen
- SpecimenDefinition.typeTested.container.cap [0..1]: CodeableConcept example:container-cap Color of container cap
- SpecimenDefinition.typeTested.container.description [0..1]: markdown The description of the kind of container
- SpecimenDefinition.typeTested.container.capacity [0..1]: Quantity(SimpleQuantity) The capacity of this kind of container
- SpecimenDefinition.typeTested.container.minimumVolume[x] [0..1]: Quantity(SimpleQuantity), string Minimum volume
- SpecimenDefinition.typeTested.container.additive [0..*]: BackboneElement Additive associated with container
- SpecimenDefinition.typeTested.container.additive.additive[x] [1..1]: CodeableConcept, Reference(SubstanceDefinition) example:v2-0371 Additive associated with container
- SpecimenDefinition.typeTested.container.preparation [0..1]: markdown Special processing applied to the container for this specimen type
- SpecimenDefinition.typeTested.requirement [0..1]: markdown Requirements for specimen delivery and special handling
- SpecimenDefinition.typeTested.retentionTime [0..1]: Duration The usual time for retaining this kind of specimen
- SpecimenDefinition.typeTested.singleUse [0..1]: boolean Specimen for single use only
- SpecimenDefinition.typeTested.rejectionCriterion [0..*]: CodeableConcept example:rejection-criteria Criterion specified for specimen rejection
- SpecimenDefinition.typeTested.handling [0..*]: BackboneElement Specimen handling before testing
- SpecimenDefinition.typeTested.handling.temperatureQualifier [0..1]: CodeableConcept example:handling-condition Qualifies the interval of temperature
- SpecimenDefinition.typeTested.handling.temperatureRange [0..1]: Range Temperature range for these handling instructions
- SpecimenDefinition.typeTested.handling.maxDuration [0..1]: Duration Maximum preservation time
- SpecimenDefinition.typeTested.handling.instruction [0..1]: markdown Preservation instruction
- SpecimenDefinition.typeTested.testingDestination [0..*]: CodeableConcept example:diagnostic-service-sections Where the specimen will be tested
Mappings
- SpecimenDefinition Mappings — 19 mapping entries
Operations
- apply — Apply — The apply operation applies a SpecimenDefinition in a given context to create a Specimen resource instance
Resource Packs
list-SpecimenDefinition-packs.xml
<?xml version="1.0" encoding="UTF-8"?>
<List xmlns="http://hl7.org/fhir">
<id value="SpecimenDefinition-packs"/>
<status value="current"/>
<mode value="working"/>
</List>
Search Parameters
- container — token — The type of specimen conditioned in container expected by the lab —
SpecimenDefinition.typeTested.container.type - experimental — token — Not for genuine usage (true) —
SpecimenDefinition.experimental - identifier — token — The unique identifier associated with the SpecimenDefinition —
SpecimenDefinition.identifier - is-derived — token — Primary specimen (false) or derived specimen (true) —
SpecimenDefinition.typeTested.isDerived - status — token — Publication status of the SpecimenDefinition: draft, active, retired, unknown —
SpecimenDefinition.status - title — string — Human-friendly name of the SpecimenDefinition —
SpecimenDefinition.title - type — token — The type of collected specimen —
SpecimenDefinition.typeCollected - type-tested — token — The type of specimen conditioned for testing —
SpecimenDefinition.typeTested.type - url — uri — The uri that identifies the specimen definition —
SpecimenDefinition.url
Examples
- 2364 — specimendefinition-example-serum-plasma — Example definition of serum or plasma specimen.
- 7 — specimendefinition-example — Example definition of venous blood specimen.
- specimendefinition-example — specimendefinition-example
- specimendefinition-example-serum-plasma — specimendefinition-example-serum-plasma
- specimendefinition-examples-header — specimendefinition-examples-header
Mapping Exceptions
specimendefinition-fivews-mapping-exceptions.xml
Unmapped Elements
- FiveWs.recorded — Unknown
- FiveWs.author — Unknown
- FiveWs.actor — Unknown
- FiveWs.cause — Unknown
- FiveWs.version — Unknown
- FiveWs.witness — Unknown
- FiveWs.class — Unknown
- FiveWs.where — Unknown
- FiveWs.context — Unknown
- FiveWs.init — Unknown
- FiveWs.why — Unknown
- FiveWs.identifier — Unknown
- FiveWs.source — Unknown
- FiveWs.who — Unknown
- FiveWs.grade — Unknown
- FiveWs.status — Unknown
- FiveWs.planned — Unknown
- FiveWs.done — Unknown
- FiveWs.subject — Unknown