minimal Common Oncology Data Elements (mCODE) Implementation Guide
4.0.0 - STU4 United States of America flag

minimal Common Oncology Data Elements (mCODE) Implementation Guide, published by HL7 International / Clinical Interoperability Council. This guide is not an authorized publication; it is the continuous build for version 4.0.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/fhir-mCODE-ig/ and changes regularly. See the Directory of published versions

Resource Profile: Tumor Profile

Official URL: http://hl7.org/fhir/us/mcode/StructureDefinition/mcode-tumor Version: 4.0.0
Active as of 2025-01-07 Maturity Level: 3 Computable Name: Tumor
Other Identifiers: OID:2.16.840.1.113883.4.642.40.15.42.64

Identifies a tumor that has not been removed from the body. Whenever possible, a single resource conforming to this profile will be used to track a tumor over time (as opposed to creating new Tumor-conforming BodyStructure resources each time that tumor is measured). Use HumanSpecimen to represent the tumor after removal from the body. Note that the required code for morphology used in STU2 is now inactive. A new code has been specified and SHOULD be used, but the old code remains conformant.

Usage

Used to represent a tumor that has not been removed from the body, and track that specific tumor across encounters and procedures.

Conformance

BodyStructure resources associated with an in-scope patient with morphology of SCT 367651003 SHALL conform to this profile. Beyond this requirement, a producer of resources SHOULD ensure that any resource instance associated with an in-scope patient used to represent a tumor that has not been removed from the body SHALL be published in this form.

A single instance of BodyStructure conforming to this profile SHOULD be used to track a specific tumor over time.

Usage:

Changes since version true:

  • New Content

    • Formal Views of Profile Content

    Description of Profiles, Differentials, Snapshots and how the different presentations work.

    NameFlagsCard.TypeDescription & Constraintsdoco
    .. BodyStructure 0..* BodyStructure Specific and identified anatomical structure
    dom-2: If the resource is contained in another resource, it SHALL NOT contain nested Resources
    dom-3: If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource
    dom-4: If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated
    dom-5: If a resource is contained in another resource, it SHALL NOT have a security label
    dom-6: A resource should have narrative for robust management
    ... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
    ele-1: All FHIR elements must have a @value or children
    ... Slices for extension S 0..* Extension Extension
    Slice: Unordered, Open by value:url
    ele-1: All FHIR elements must have a @value or children
    ext-1: Must have either extensions or value[x], not both
    .... relatedCondition S 0..1 (Complex) Reference to cancer condition associated with this tumor
    URL: http://hl7.org/fhir/us/mcode/StructureDefinition/mcode-related-condition
    ele-1: All FHIR elements must have a @value or children
    ext-1: Must have either extensions or value[x], not both
    ..... extension 0..0
    ..... url 1..1 uri "http://hl7.org/fhir/us/mcode/StructureDefinition/mcode-related-condition"
    ..... value[x] S 1..1 Reference(US Core Condition Problems and Health Concerns Profile) Value of extension
    ele-1: All FHIR elements must have a @value or children
    ... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
    ele-1: All FHIR elements must have a @value or children
    ext-1: Must have either extensions or value[x], not both
    .... identifier:bodyStructureIdentifier Σ 1..* BodyStructureIdentifier A persistent identifier of this tumor.
    ele-1: All FHIR elements must have a @value or children
    ... active ?!Σ 0..1 boolean Whether this record is in active use
    ele-1: All FHIR elements must have a @value or children
    ... morphology SΣ 0..1 CodeableConcept Kind of Structure
    Binding: Tumor Morphology Code Value Set (extensible)
    Additional BindingsPurpose
    Tumor Morphology Code Max Value Set Max Binding

    ele-1: All FHIR elements must have a @value or children
    ... location SΣ 1..1 CodeableConcept Body site
    Binding: Cancer Body Location Value Set (extensible)
    ele-1: All FHIR elements must have a @value or children
    ... locationQualifier S 0..* CodeableConcept Body site modifier
    Binding: Body Location and Laterality Qualifier Value Set (required)
    ele-1: All FHIR elements must have a @value or children
    ... patient SΣ 1..1 Reference(Cancer Patient Profile) Who this is about
    ele-1: All FHIR elements must have a @value or children

    doco Documentation for this format

    Terminology Bindings

    PathConformanceValueSetURI
    BodyStructure.morphologyextensibleTumorMorphologyCodeVS
    http://hl7.org/fhir/us/mcode/ValueSet/mcode-tumor-morphology-code-vs
    from this IG
    Additional Bindings Purpose
    Tumor Morphology Code Max Value Set Max Binding
    BodyStructure.locationextensibleCancerBodyLocationVS
    http://hl7.org/fhir/us/mcode/ValueSet/mcode-cancer-body-location-vs
    from this IG
    BodyStructure.locationQualifierrequiredBodyLocationAndLateralityQualifierVS
    http://hl7.org/fhir/us/mcode/ValueSet/mcode-body-location-and-laterality-qualifier-vs
    from this IG

    This structure is derived from BodyStructure

    NameFlagsCard.TypeDescription & Constraintsdoco
    .. BodyStructure BodyStructure
    ... Slices for extension S 0..* Extension Extension
    Slice: Unordered, Open by value:url
    .... relatedCondition S 0..1 (Complex) Reference to cancer condition associated with this tumor
    URL: http://hl7.org/fhir/us/mcode/StructureDefinition/mcode-related-condition
    ..... value[x] S 1..1 Reference(US Core Condition Problems and Health Concerns Profile) Value of extension
    ... Slices for identifier S 1..* Identifier Stable identifier(s) for this tumor
    Slice: Unordered, Open by value:type
    .... identifier:bodyStructureIdentifier 1..* BodyStructureIdentifier A persistent identifier of this tumor.
    ... morphology S 0..1 CodeableConcept Kind of Structure
    Binding: Tumor Morphology Code Value Set (extensible)
    Additional BindingsPurpose
    Tumor Morphology Code Max Value Set Max Binding
    ... locationQualifier S 0..* CodeableConcept Body site modifier
    Binding: Body Location and Laterality Qualifier Value Set (required)
    ... patient S 1..1 Reference(Cancer Patient Profile) Who this is about

    doco Documentation for this format

    Terminology Bindings (Differential)

    PathConformanceValueSetURI
    BodyStructure.morphologyextensibleTumorMorphologyCodeVS
    http://hl7.org/fhir/us/mcode/ValueSet/mcode-tumor-morphology-code-vs
    from this IG
    Additional Bindings Purpose
    Tumor Morphology Code Max Value Set Max Binding
    BodyStructure.locationextensibleCancerBodyLocationVS
    http://hl7.org/fhir/us/mcode/ValueSet/mcode-cancer-body-location-vs
    from this IG
    BodyStructure.locationQualifierrequiredBodyLocationAndLateralityQualifierVS
    http://hl7.org/fhir/us/mcode/ValueSet/mcode-body-location-and-laterality-qualifier-vs
    from this IG
    NameFlagsCard.TypeDescription & Constraintsdoco
    .. BodyStructure 0..* BodyStructure Specific and identified anatomical structure
    ... id Σ 0..1 id Logical id of this artifact
    ... meta Σ 0..1 Meta Metadata about the resource
    ... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
    ... text 0..1 Narrative Text summary of the resource, for human interpretation
    ... contained 0..* Resource Contained, inline Resources
    ... Slices for extension S 0..* Extension Extension
    Slice: Unordered, Open by value:url
    .... relatedCondition S 0..1 (Complex) Reference to cancer condition associated with this tumor
    URL: http://hl7.org/fhir/us/mcode/StructureDefinition/mcode-related-condition
    ..... id 0..1 string Unique id for inter-element referencing
    ..... extension 0..0
    ..... url 1..1 uri "http://hl7.org/fhir/us/mcode/StructureDefinition/mcode-related-condition"
    ..... value[x] S 1..1 Reference(US Core Condition Problems and Health Concerns Profile) Value of extension
    ... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
    ... Slices for identifier SΣ 1..* Identifier Stable identifier(s) for this tumor
    Slice: Unordered, Open by value:type
    .... identifier:bodyStructureIdentifier Σ 1..* BodyStructureIdentifier A persistent identifier of this tumor.
    ... active ?!Σ 0..1 boolean Whether this record is in active use
    ... morphology SΣ 0..1 CodeableConcept Kind of Structure
    Binding: Tumor Morphology Code Value Set (extensible)
    Additional BindingsPurpose
    Tumor Morphology Code Max Value Set Max Binding
    ... location SΣ 1..1 CodeableConcept Body site
    Binding: Cancer Body Location Value Set (extensible)
    ... locationQualifier S 0..* CodeableConcept Body site modifier
    Binding: Body Location and Laterality Qualifier Value Set (required)
    ... description Σ 0..1 string Text description
    ... image 0..* Attachment Attached images
    ... patient SΣ 1..1 Reference(Cancer Patient Profile) Who this is about

    doco Documentation for this format

    Terminology Bindings

    PathConformanceValueSetURI
    BodyStructure.languagepreferredCommonLanguages
    http://hl7.org/fhir/ValueSet/languages
    from the FHIR Standard
    Additional Bindings Purpose
    AllLanguages Max Binding
    BodyStructure.morphologyextensibleTumorMorphologyCodeVS
    http://hl7.org/fhir/us/mcode/ValueSet/mcode-tumor-morphology-code-vs
    from this IG
    Additional Bindings Purpose
    Tumor Morphology Code Max Value Set Max Binding
    BodyStructure.locationextensibleCancerBodyLocationVS
    http://hl7.org/fhir/us/mcode/ValueSet/mcode-cancer-body-location-vs
    from this IG
    BodyStructure.locationQualifierrequiredBodyLocationAndLateralityQualifierVS
    http://hl7.org/fhir/us/mcode/ValueSet/mcode-body-location-and-laterality-qualifier-vs
    from this IG

    This structure is derived from BodyStructure

    Key Elements View

    NameFlagsCard.TypeDescription & Constraintsdoco
    .. BodyStructure 0..* BodyStructure Specific and identified anatomical structure
    dom-2: If the resource is contained in another resource, it SHALL NOT contain nested Resources
    dom-3: If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource
    dom-4: If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated
    dom-5: If a resource is contained in another resource, it SHALL NOT have a security label
    dom-6: A resource should have narrative for robust management
    ... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
    ele-1: All FHIR elements must have a @value or children
    ... Slices for extension S 0..* Extension Extension
    Slice: Unordered, Open by value:url
    ele-1: All FHIR elements must have a @value or children
    ext-1: Must have either extensions or value[x], not both
    .... relatedCondition S 0..1 (Complex) Reference to cancer condition associated with this tumor
    URL: http://hl7.org/fhir/us/mcode/StructureDefinition/mcode-related-condition
    ele-1: All FHIR elements must have a @value or children
    ext-1: Must have either extensions or value[x], not both
    ..... extension 0..0
    ..... url 1..1 uri "http://hl7.org/fhir/us/mcode/StructureDefinition/mcode-related-condition"
    ..... value[x] S 1..1 Reference(US Core Condition Problems and Health Concerns Profile) Value of extension
    ele-1: All FHIR elements must have a @value or children
    ... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
    ele-1: All FHIR elements must have a @value or children
    ext-1: Must have either extensions or value[x], not both
    .... identifier:bodyStructureIdentifier Σ 1..* BodyStructureIdentifier A persistent identifier of this tumor.
    ele-1: All FHIR elements must have a @value or children
    ... active ?!Σ 0..1 boolean Whether this record is in active use
    ele-1: All FHIR elements must have a @value or children
    ... morphology SΣ 0..1 CodeableConcept Kind of Structure
    Binding: Tumor Morphology Code Value Set (extensible)
    Additional BindingsPurpose
    Tumor Morphology Code Max Value Set Max Binding

    ele-1: All FHIR elements must have a @value or children
    ... location SΣ 1..1 CodeableConcept Body site
    Binding: Cancer Body Location Value Set (extensible)
    ele-1: All FHIR elements must have a @value or children
    ... locationQualifier S 0..* CodeableConcept Body site modifier
    Binding: Body Location and Laterality Qualifier Value Set (required)
    ele-1: All FHIR elements must have a @value or children
    ... patient SΣ 1..1 Reference(Cancer Patient Profile) Who this is about
    ele-1: All FHIR elements must have a @value or children

    doco Documentation for this format

    Terminology Bindings

    PathConformanceValueSetURI
    BodyStructure.morphologyextensibleTumorMorphologyCodeVS
    http://hl7.org/fhir/us/mcode/ValueSet/mcode-tumor-morphology-code-vs
    from this IG
    Additional Bindings Purpose
    Tumor Morphology Code Max Value Set Max Binding
    BodyStructure.locationextensibleCancerBodyLocationVS
    http://hl7.org/fhir/us/mcode/ValueSet/mcode-cancer-body-location-vs
    from this IG
    BodyStructure.locationQualifierrequiredBodyLocationAndLateralityQualifierVS
    http://hl7.org/fhir/us/mcode/ValueSet/mcode-body-location-and-laterality-qualifier-vs
    from this IG

    Differential View

    This structure is derived from BodyStructure

    NameFlagsCard.TypeDescription & Constraintsdoco
    .. BodyStructure BodyStructure
    ... Slices for extension S 0..* Extension Extension
    Slice: Unordered, Open by value:url
    .... relatedCondition S 0..1 (Complex) Reference to cancer condition associated with this tumor
    URL: http://hl7.org/fhir/us/mcode/StructureDefinition/mcode-related-condition
    ..... value[x] S 1..1 Reference(US Core Condition Problems and Health Concerns Profile) Value of extension
    ... Slices for identifier S 1..* Identifier Stable identifier(s) for this tumor
    Slice: Unordered, Open by value:type
    .... identifier:bodyStructureIdentifier 1..* BodyStructureIdentifier A persistent identifier of this tumor.
    ... morphology S 0..1 CodeableConcept Kind of Structure
    Binding: Tumor Morphology Code Value Set (extensible)
    Additional BindingsPurpose
    Tumor Morphology Code Max Value Set Max Binding
    ... locationQualifier S 0..* CodeableConcept Body site modifier
    Binding: Body Location and Laterality Qualifier Value Set (required)
    ... patient S 1..1 Reference(Cancer Patient Profile) Who this is about

    doco Documentation for this format

    Terminology Bindings (Differential)

    PathConformanceValueSetURI
    BodyStructure.morphologyextensibleTumorMorphologyCodeVS
    http://hl7.org/fhir/us/mcode/ValueSet/mcode-tumor-morphology-code-vs
    from this IG
    Additional Bindings Purpose
    Tumor Morphology Code Max Value Set Max Binding
    BodyStructure.locationextensibleCancerBodyLocationVS
    http://hl7.org/fhir/us/mcode/ValueSet/mcode-cancer-body-location-vs
    from this IG
    BodyStructure.locationQualifierrequiredBodyLocationAndLateralityQualifierVS
    http://hl7.org/fhir/us/mcode/ValueSet/mcode-body-location-and-laterality-qualifier-vs
    from this IG

    Snapshot View

    NameFlagsCard.TypeDescription & Constraintsdoco
    .. BodyStructure 0..* BodyStructure Specific and identified anatomical structure
    ... id Σ 0..1 id Logical id of this artifact
    ... meta Σ 0..1 Meta Metadata about the resource
    ... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
    ... text 0..1 Narrative Text summary of the resource, for human interpretation
    ... contained 0..* Resource Contained, inline Resources
    ... Slices for extension S 0..* Extension Extension
    Slice: Unordered, Open by value:url
    .... relatedCondition S 0..1 (Complex) Reference to cancer condition associated with this tumor
    URL: http://hl7.org/fhir/us/mcode/StructureDefinition/mcode-related-condition
    ..... id 0..1 string Unique id for inter-element referencing
    ..... extension 0..0
    ..... url 1..1 uri "http://hl7.org/fhir/us/mcode/StructureDefinition/mcode-related-condition"
    ..... value[x] S 1..1 Reference(US Core Condition Problems and Health Concerns Profile) Value of extension
    ... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
    ... Slices for identifier SΣ 1..* Identifier Stable identifier(s) for this tumor
    Slice: Unordered, Open by value:type
    .... identifier:bodyStructureIdentifier Σ 1..* BodyStructureIdentifier A persistent identifier of this tumor.
    ... active ?!Σ 0..1 boolean Whether this record is in active use
    ... morphology SΣ 0..1 CodeableConcept Kind of Structure
    Binding: Tumor Morphology Code Value Set (extensible)
    Additional BindingsPurpose
    Tumor Morphology Code Max Value Set Max Binding
    ... location SΣ 1..1 CodeableConcept Body site
    Binding: Cancer Body Location Value Set (extensible)
    ... locationQualifier S 0..* CodeableConcept Body site modifier
    Binding: Body Location and Laterality Qualifier Value Set (required)
    ... description Σ 0..1 string Text description
    ... image 0..* Attachment Attached images
    ... patient SΣ 1..1 Reference(Cancer Patient Profile) Who this is about

    doco Documentation for this format

    Terminology Bindings

    PathConformanceValueSetURI
    BodyStructure.languagepreferredCommonLanguages
    http://hl7.org/fhir/ValueSet/languages
    from the FHIR Standard
    Additional Bindings Purpose
    AllLanguages Max Binding
    BodyStructure.morphologyextensibleTumorMorphologyCodeVS
    http://hl7.org/fhir/us/mcode/ValueSet/mcode-tumor-morphology-code-vs
    from this IG
    Additional Bindings Purpose
    Tumor Morphology Code Max Value Set Max Binding
    BodyStructure.locationextensibleCancerBodyLocationVS
    http://hl7.org/fhir/us/mcode/ValueSet/mcode-cancer-body-location-vs
    from this IG
    BodyStructure.locationQualifierrequiredBodyLocationAndLateralityQualifierVS
    http://hl7.org/fhir/us/mcode/ValueSet/mcode-body-location-and-laterality-qualifier-vs
    from this IG

    This structure is derived from BodyStructure

     

    Other representations of profile: CSV, Excel, Schematron