NCPI FHIR Implementation Guide
0.2.0 - ci-build

NCPI FHIR Implementation Guide - Local Development build (v0.2.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Resource Profile: NCPI Research Study

Official URL: https://nih-ncpi.github.io/ncpi-fhir-ig/StructureDefinition/ncpi-research-study Version: 0.2.0
Draft as of 2024-03-04 Computable Name: NcpiResearchStudy

The NCPI Research Study is based upon the core HL7 FHIR ResearchStudy resource (R4) and shall act as the umbrella under which all study resources can ultimately be found.

For the purposes of interoperability, some restrictions have been made to enforce a common mechanism for describing enrollment and provide a simple means for summarizing subject count as well as access control through the main (parent) consent groups. In addition, we are providing some recommended practices for the common data elements required for submission.

Please see the research study documentation for in-depth mappings on the R4 version and the necessary extensions needed to ensure interoperability.

Added Profile Restrictions

To ensure consistency across all NCPI research studies represented in FHIR, there are some additional requirements which must be enforced. These requirements are derived from the Differential Table section of this document.

The following requirements are true for all NCPI Research Studies:

  • enrollment must contain 1 reference of type, Study Group.
  • category must contain the Coding from NCPI StudyCohort.
  • each study should have its accession ID added as an identifier. This is an identifier provided by DbGAP or other organization which represents a common identifier recognized by similar research groups.
  • each study should have its study name as the title.
  • for those studies which exist as part of a larger study, the parent study should be referenced in the study’s partOf property.
  • principalInvestigator must be of type Practitioner if present.
NCPI Common Data Elements HL7 FHIR (R4) Element Notes
Accession # identifier Accession IDs from dbGaP, etc should be added as identifiers with a meaningful system
Study name title  
Substudies partOf Substudies other than consent based organization should reference the parent NCPI Research Study using the partOf reference

To ensure consistency across all NCPI research studies represented in FHIR, there are some additional elements which should be included if applicable to your study. A recommended element is one that is important and will likely have value for those trying to understand the study’s purpose and usefulness but not essential for validation against the profile. Those elements labeled as optional are not central to the fundamental understanding of the study’s content but may play a key role in a study being findable.

Common Data Elements

NCPI COmmon Data Elements HL7 FHIR (R4) Element Recommended or Optional Notes
Study description description Recommended  
Disease/focus condition Recommended Should also have one or more Codings provided, indicating the disease or phenotypes that were interrogated during the study’s execution
Attribution relatedArtifact Recommended This can include, but not limited to; principal investigators, grant numbers, etc.
Study weblinks relatedArfifact Optional These elements fall under the StudyDescription element located in the Added Profile Restrictions section of this document.
Study design studyDesign Optional These elements fall under the StudyDescription element located in the Added Profile Restrictions section of this document.
Study type studyDesign Optional These elements fall under the StudyDescription element located in the Added Profile Restrictions section of this document.
Citation relatedArtifact Optional  
Study documents relatedArtifact Optional  

For a more detailed view of these elements as well as the recommended FHIR mappings please see the research study documentation.

Population Details

Each NCPI Research must have one Study Group which must, at the very least, indicate the total number of patients enrolled at the time the data was loaded into FHIR.

Usage:

Formal Views of Profile Content

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

This structure is derived from ResearchStudy

NameFlagsCard.TypeDescription & Constraintsdoco
.. ResearchStudy 0..*ResearchStudyInvestigation to increase healthcare-related patient-independent knowledge
... Slices for extension 0..*ExtensionExtension
Slice: Unordered, Open by value:url
... studyDesign 0..*CodeableConceptStudy Design and Study Type
URL: https://nih-ncpi.github.io/ncpi-fhir-ig/StructureDefinition/research-study-design
Binding: Study Design (example)
... identifier 1..*IdentifierAccession IDs from dbGaP, etc.
... category
.... coding 0..*CodingIndicate this is an NCPI Research Study
Required Pattern: At least the following
..... system1..1uriIdentity of the terminology system
Fixed Value: https://nih-ncpi.github.io/ncpi-fhir-ig/CodeSystem/ncpi
..... code1..1codeSymbol in syntax defined by the system
Fixed Value: StudyCohort
..... display1..1stringRepresentation defined by the system
Fixed Value: Study Cohort
... condition 0..*CodeableConceptDisease or phenotypes that were interrogated during the study’s execution. MONDO, HPO
... relatedArtifact 0..*RelatedArtifactAttribution, Study Weblinks, Citation, Study Documents, etc.
... description 0..1markdownStudy Description (Recommended)
... enrollment 1..1Reference(NCPI Study Group)Study Participants
... sponsor 0..1Reference(Research Consortium)Consortium or other group the study is a member
... principalInvestigator 0..1Reference(Practitioner)Researcher who oversees multiple aspects of the study

doco Documentation for this format
NameFlagsCard.TypeDescription & Constraintsdoco
.. ResearchStudy 0..*ResearchStudyInvestigation to increase healthcare-related patient-independent knowledge
... implicitRules ?!Σ0..1uriA set of rules under which this content was created
... Slices for extension 0..*ExtensionExtension
Slice: Unordered, Open by value:url
... studyDesign 0..*CodeableConceptStudy Design and Study Type
URL: https://nih-ncpi.github.io/ncpi-fhir-ig/StructureDefinition/research-study-design
Binding: Study Design (example)
... identifier Σ1..*IdentifierAccession IDs from dbGaP, etc.
... title Σ0..1stringStudy Title (Strongly Recommended)
... status ?!Σ1..1codeactive | administratively-completed | approved | closed-to-accrual | closed-to-accrual-and-intervention | completed | disapproved | in-review | temporarily-closed-to-accrual | temporarily-closed-to-accrual-and-intervention | withdrawn
Binding: ResearchStudyStatus (required): Codes that convey the current status of the research study.

... condition Σ0..*CodeableConceptDisease or phenotypes that were interrogated during the study’s execution. MONDO, HPO
Binding: Condition/Problem/DiagnosisCodes (example): Identification of the condition or diagnosis.


... relatedArtifact 0..*RelatedArtifactAttribution, Study Weblinks, Citation, Study Documents, etc.
... description 0..1markdownStudy Description (Recommended)
... enrollment Σ1..1Reference(NCPI Study Group)Study Participants
... sponsor Σ0..1Reference(Research Consortium)Consortium or other group the study is a member
... principalInvestigator Σ0..1Reference(Practitioner)Researcher who oversees multiple aspects of the study

doco Documentation for this format

Terminology Bindings

PathConformanceValueSetURI
ResearchStudy.statusrequiredResearchStudyStatus
http://hl7.org/fhir/ValueSet/research-study-status|4.3.0
from the FHIR Standard
ResearchStudy.conditionexampleCondition/Problem/DiagnosisCodes
http://hl7.org/fhir/ValueSet/condition-code
from the FHIR Standard

Constraints

IdGradePath(s)DetailsRequirements
dom-2errorResearchStudyIf the resource is contained in another resource, it SHALL NOT contain nested Resources
: contained.contained.empty()
dom-3errorResearchStudyIf the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource
: contained.where(((id.exists() and ('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url)))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(uri) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4errorResearchStudyIf a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated
: contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5errorResearchStudyIf a resource is contained in another resource, it SHALL NOT have a security label
: contained.meta.security.empty()
dom-6best practiceResearchStudyA resource should have narrative for robust management
: text.`div`.exists()
ele-1error**ALL** elementsAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1error**ALL** extensionsMust have either extensions or value[x], not both
: extension.exists() != value.exists()
NameFlagsCard.TypeDescription & Constraintsdoco
.. ResearchStudy 0..*ResearchStudyInvestigation to increase healthcare-related patient-independent knowledge
... id Σ0..1idLogical id of this artifact
... meta Σ0..1MetaMetadata about the resource
... implicitRules ?!Σ0..1uriA set of rules under which this content was created
... language 0..1codeLanguage of the resource content
Binding: CommonLanguages (preferred): IETF language tag

Additional BindingsPurpose
AllLanguagesMax Binding
... text 0..1NarrativeText summary of the resource, for human interpretation
... contained 0..*ResourceContained, inline Resources
dom-r4b: Containing new R4B resources within R4 resources may cause interoperability issues if instances are shared with R4 systems
... Slices for extension 0..*ExtensionExtension
Slice: Unordered, Open by value:url
... studyDesign 0..*CodeableConceptStudy Design and Study Type
URL: https://nih-ncpi.github.io/ncpi-fhir-ig/StructureDefinition/research-study-design
Binding: Study Design (example)
... modifierExtension ?!0..*ExtensionExtensions that cannot be ignored
... identifier Σ1..*IdentifierAccession IDs from dbGaP, etc.
... title Σ0..1stringStudy Title (Strongly Recommended)
... protocol Σ0..*Reference(PlanDefinition)Steps followed in executing study
... partOf Σ0..*Reference(ResearchStudy)Part of larger study
... status ?!Σ1..1codeactive | administratively-completed | approved | closed-to-accrual | closed-to-accrual-and-intervention | completed | disapproved | in-review | temporarily-closed-to-accrual | temporarily-closed-to-accrual-and-intervention | withdrawn
Binding: ResearchStudyStatus (required): Codes that convey the current status of the research study.

... primaryPurposeType Σ0..1CodeableConcepttreatment | prevention | diagnostic | supportive-care | screening | health-services-research | basic-science | device-feasibility
Binding: ResearchStudyPrimaryPurposeType (extensible): Codes for the main intent of the study.

... phase Σ0..1CodeableConceptn-a | early-phase-1 | phase-1 | phase-1-phase-2 | phase-2 | phase-2-phase-3 | phase-3 | phase-4
Binding: ResearchStudyPhase (example): Codes for the stage in the progression of a therapy from initial experimental use in humans in clinical trials to post-market evaluation.

... category Σ0..*CodeableConceptClassifications for the study
Binding: (unbound) (example): Codes that describe the type of research study. E.g. Study phase, Interventional/Observational, blinding type, etc.


.... id 0..1idUnique id for inter-element referencing
.... extension 0..*ExtensionAdditional content defined by implementations
Slice: Unordered, Open by value:url
.... coding Σ0..*CodingIndicate this is an NCPI Research Study

Required Pattern: At least the following
..... id0..1stringUnique id for inter-element referencing
..... extension0..*ExtensionAdditional content defined by implementations
..... system1..1uriIdentity of the terminology system
Fixed Value: https://nih-ncpi.github.io/ncpi-fhir-ig/CodeSystem/ncpi
..... version0..1stringVersion of the system - if relevant
..... code1..1codeSymbol in syntax defined by the system
Fixed Value: StudyCohort
..... display1..1stringRepresentation defined by the system
Fixed Value: Study Cohort
..... userSelected0..1booleanIf this coding was chosen directly by the user
.... text Σ0..1stringPlain text representation of the concept
... focus Σ0..*CodeableConceptDrugs, devices, etc. under study
Binding: (unbound) (example): Codes for medications, devices and other interventions.


... condition Σ0..*CodeableConceptDisease or phenotypes that were interrogated during the study’s execution. MONDO, HPO
Binding: Condition/Problem/DiagnosisCodes (example): Identification of the condition or diagnosis.


... contact Σ0..*ContactDetailContact details for the study
... relatedArtifact 0..*RelatedArtifactAttribution, Study Weblinks, Citation, Study Documents, etc.
... keyword Σ0..*CodeableConceptUsed to search for the study
Binding: (unbound) (example): Words associated with the study that may be useful in discovery.


... location Σ0..*CodeableConceptGeographic region(s) for study
Binding: Jurisdiction ValueSet (extensible): Countries and regions within which this artifact is targeted for use.


... description 0..1markdownStudy Description (Recommended)
... enrollment Σ1..1Reference(NCPI Study Group)Study Participants
... period Σ0..1PeriodWhen the study began and ended
... sponsor Σ0..1Reference(Research Consortium)Consortium or other group the study is a member
... principalInvestigator Σ0..1Reference(Practitioner)Researcher who oversees multiple aspects of the study
... site Σ0..*Reference(Location)Facility where study activities are conducted
... reasonStopped Σ0..1CodeableConceptaccrual-goal-met | closed-due-to-toxicity | closed-due-to-lack-of-study-progress | temporarily-closed-per-study-design
Binding: ResearchStudyReasonStopped (example): Codes for why the study ended prematurely.

... note 0..*AnnotationComments made about the study
... arm 0..*BackboneElementDefined path through the study for a subject
.... id 0..1stringUnique id for inter-element referencing
.... extension 0..*ExtensionAdditional content defined by implementations
.... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
.... name 1..1stringLabel for study arm
.... type 0..1CodeableConceptCategorization of study arm
.... description 0..1stringShort explanation of study path
... objective 0..*BackboneElementA goal for the study
.... id 0..1stringUnique id for inter-element referencing
.... extension 0..*ExtensionAdditional content defined by implementations
.... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
.... name 0..1stringLabel for the objective
.... type 0..1CodeableConceptprimary | secondary | exploratory
Binding: ResearchStudyObjectiveType (preferred): Codes for the kind of study objective.


doco Documentation for this format

Terminology Bindings

PathConformanceValueSetURI
ResearchStudy.languagepreferredCommonLanguages
Additional Bindings Purpose
AllLanguages Max Binding
http://hl7.org/fhir/ValueSet/languages
from the FHIR Standard
ResearchStudy.statusrequiredResearchStudyStatus
http://hl7.org/fhir/ValueSet/research-study-status|4.3.0
from the FHIR Standard
ResearchStudy.primaryPurposeTypeextensibleResearchStudyPrimaryPurposeType
http://hl7.org/fhir/ValueSet/research-study-prim-purp-type
from the FHIR Standard
ResearchStudy.phaseexampleResearchStudyPhase
http://hl7.org/fhir/ValueSet/research-study-phase
from the FHIR Standard
ResearchStudy.categoryexample
ResearchStudy.focusexample
ResearchStudy.conditionexampleCondition/Problem/DiagnosisCodes
http://hl7.org/fhir/ValueSet/condition-code
from the FHIR Standard
ResearchStudy.keywordexample
ResearchStudy.locationextensibleJurisdiction ValueSet
http://hl7.org/fhir/ValueSet/jurisdiction
from the FHIR Standard
ResearchStudy.reasonStoppedexampleResearchStudyReasonStopped
http://hl7.org/fhir/ValueSet/research-study-reason-stopped
from the FHIR Standard
ResearchStudy.objective.typepreferredResearchStudyObjectiveType
http://hl7.org/fhir/ValueSet/research-study-objective-type
from the FHIR Standard

Constraints

IdGradePath(s)DetailsRequirements
dom-2errorResearchStudyIf the resource is contained in another resource, it SHALL NOT contain nested Resources
: contained.contained.empty()
dom-3errorResearchStudyIf the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource
: contained.where(((id.exists() and ('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url)))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(uri) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4errorResearchStudyIf a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated
: contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5errorResearchStudyIf a resource is contained in another resource, it SHALL NOT have a security label
: contained.meta.security.empty()
dom-6best practiceResearchStudyA resource should have narrative for robust management
: text.`div`.exists()
dom-r4bwarningResearchStudy.containedContaining new R4B resources within R4 resources may cause interoperability issues if instances are shared with R4 systems
: ($this is Citation or $this is Evidence or $this is EvidenceReport or $this is EvidenceVariable or $this is MedicinalProductDefinition or $this is PackagedProductDefinition or $this is AdministrableProductDefinition or $this is Ingredient or $this is ClinicalUseDefinition or $this is RegulatedAuthorization or $this is SubstanceDefinition or $this is SubscriptionStatus or $this is SubscriptionTopic) implies (%resource is Citation or %resource is Evidence or %resource is EvidenceReport or %resource is EvidenceVariable or %resource is MedicinalProductDefinition or %resource is PackagedProductDefinition or %resource is AdministrableProductDefinition or %resource is Ingredient or %resource is ClinicalUseDefinition or %resource is RegulatedAuthorization or %resource is SubstanceDefinition or %resource is SubscriptionStatus or %resource is SubscriptionTopic)
ele-1error**ALL** elementsAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1error**ALL** extensionsMust have either extensions or value[x], not both
: extension.exists() != value.exists()

Differential View

This structure is derived from ResearchStudy

NameFlagsCard.TypeDescription & Constraintsdoco
.. ResearchStudy 0..*ResearchStudyInvestigation to increase healthcare-related patient-independent knowledge
... Slices for extension 0..*ExtensionExtension
Slice: Unordered, Open by value:url
... studyDesign 0..*CodeableConceptStudy Design and Study Type
URL: https://nih-ncpi.github.io/ncpi-fhir-ig/StructureDefinition/research-study-design
Binding: Study Design (example)
... identifier 1..*IdentifierAccession IDs from dbGaP, etc.
... category
.... coding 0..*CodingIndicate this is an NCPI Research Study
Required Pattern: At least the following
..... system1..1uriIdentity of the terminology system
Fixed Value: https://nih-ncpi.github.io/ncpi-fhir-ig/CodeSystem/ncpi
..... code1..1codeSymbol in syntax defined by the system
Fixed Value: StudyCohort
..... display1..1stringRepresentation defined by the system
Fixed Value: Study Cohort
... condition 0..*CodeableConceptDisease or phenotypes that were interrogated during the study’s execution. MONDO, HPO
... relatedArtifact 0..*RelatedArtifactAttribution, Study Weblinks, Citation, Study Documents, etc.
... description 0..1markdownStudy Description (Recommended)
... enrollment 1..1Reference(NCPI Study Group)Study Participants
... sponsor 0..1Reference(Research Consortium)Consortium or other group the study is a member
... principalInvestigator 0..1Reference(Practitioner)Researcher who oversees multiple aspects of the study

doco Documentation for this format

Key Elements View

NameFlagsCard.TypeDescription & Constraintsdoco
.. ResearchStudy 0..*ResearchStudyInvestigation to increase healthcare-related patient-independent knowledge
... implicitRules ?!Σ0..1uriA set of rules under which this content was created
... Slices for extension 0..*ExtensionExtension
Slice: Unordered, Open by value:url
... studyDesign 0..*CodeableConceptStudy Design and Study Type
URL: https://nih-ncpi.github.io/ncpi-fhir-ig/StructureDefinition/research-study-design
Binding: Study Design (example)
... identifier Σ1..*IdentifierAccession IDs from dbGaP, etc.
... title Σ0..1stringStudy Title (Strongly Recommended)
... status ?!Σ1..1codeactive | administratively-completed | approved | closed-to-accrual | closed-to-accrual-and-intervention | completed | disapproved | in-review | temporarily-closed-to-accrual | temporarily-closed-to-accrual-and-intervention | withdrawn
Binding: ResearchStudyStatus (required): Codes that convey the current status of the research study.

... condition Σ0..*CodeableConceptDisease or phenotypes that were interrogated during the study’s execution. MONDO, HPO
Binding: Condition/Problem/DiagnosisCodes (example): Identification of the condition or diagnosis.


... relatedArtifact 0..*RelatedArtifactAttribution, Study Weblinks, Citation, Study Documents, etc.
... description 0..1markdownStudy Description (Recommended)
... enrollment Σ1..1Reference(NCPI Study Group)Study Participants
... sponsor Σ0..1Reference(Research Consortium)Consortium or other group the study is a member
... principalInvestigator Σ0..1Reference(Practitioner)Researcher who oversees multiple aspects of the study

doco Documentation for this format

Terminology Bindings

PathConformanceValueSetURI
ResearchStudy.statusrequiredResearchStudyStatus
http://hl7.org/fhir/ValueSet/research-study-status|4.3.0
from the FHIR Standard
ResearchStudy.conditionexampleCondition/Problem/DiagnosisCodes
http://hl7.org/fhir/ValueSet/condition-code
from the FHIR Standard

Constraints

IdGradePath(s)DetailsRequirements
dom-2errorResearchStudyIf the resource is contained in another resource, it SHALL NOT contain nested Resources
: contained.contained.empty()
dom-3errorResearchStudyIf the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource
: contained.where(((id.exists() and ('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url)))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(uri) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4errorResearchStudyIf a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated
: contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5errorResearchStudyIf a resource is contained in another resource, it SHALL NOT have a security label
: contained.meta.security.empty()
dom-6best practiceResearchStudyA resource should have narrative for robust management
: text.`div`.exists()
ele-1error**ALL** elementsAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1error**ALL** extensionsMust have either extensions or value[x], not both
: extension.exists() != value.exists()

Snapshot View

NameFlagsCard.TypeDescription & Constraintsdoco
.. ResearchStudy 0..*ResearchStudyInvestigation to increase healthcare-related patient-independent knowledge
... id Σ0..1idLogical id of this artifact
... meta Σ0..1MetaMetadata about the resource
... implicitRules ?!Σ0..1uriA set of rules under which this content was created
... language 0..1codeLanguage of the resource content
Binding: CommonLanguages (preferred): IETF language tag

Additional BindingsPurpose
AllLanguagesMax Binding
... text 0..1NarrativeText summary of the resource, for human interpretation
... contained 0..*ResourceContained, inline Resources
dom-r4b: Containing new R4B resources within R4 resources may cause interoperability issues if instances are shared with R4 systems
... Slices for extension 0..*ExtensionExtension
Slice: Unordered, Open by value:url
... studyDesign 0..*CodeableConceptStudy Design and Study Type
URL: https://nih-ncpi.github.io/ncpi-fhir-ig/StructureDefinition/research-study-design
Binding: Study Design (example)
... modifierExtension ?!0..*ExtensionExtensions that cannot be ignored
... identifier Σ1..*IdentifierAccession IDs from dbGaP, etc.
... title Σ0..1stringStudy Title (Strongly Recommended)
... protocol Σ0..*Reference(PlanDefinition)Steps followed in executing study
... partOf Σ0..*Reference(ResearchStudy)Part of larger study
... status ?!Σ1..1codeactive | administratively-completed | approved | closed-to-accrual | closed-to-accrual-and-intervention | completed | disapproved | in-review | temporarily-closed-to-accrual | temporarily-closed-to-accrual-and-intervention | withdrawn
Binding: ResearchStudyStatus (required): Codes that convey the current status of the research study.

... primaryPurposeType Σ0..1CodeableConcepttreatment | prevention | diagnostic | supportive-care | screening | health-services-research | basic-science | device-feasibility
Binding: ResearchStudyPrimaryPurposeType (extensible): Codes for the main intent of the study.

... phase Σ0..1CodeableConceptn-a | early-phase-1 | phase-1 | phase-1-phase-2 | phase-2 | phase-2-phase-3 | phase-3 | phase-4
Binding: ResearchStudyPhase (example): Codes for the stage in the progression of a therapy from initial experimental use in humans in clinical trials to post-market evaluation.

... category Σ0..*CodeableConceptClassifications for the study
Binding: (unbound) (example): Codes that describe the type of research study. E.g. Study phase, Interventional/Observational, blinding type, etc.


.... id 0..1idUnique id for inter-element referencing
.... extension 0..*ExtensionAdditional content defined by implementations
Slice: Unordered, Open by value:url
.... coding Σ0..*CodingIndicate this is an NCPI Research Study

Required Pattern: At least the following
..... id0..1stringUnique id for inter-element referencing
..... extension0..*ExtensionAdditional content defined by implementations
..... system1..1uriIdentity of the terminology system
Fixed Value: https://nih-ncpi.github.io/ncpi-fhir-ig/CodeSystem/ncpi
..... version0..1stringVersion of the system - if relevant
..... code1..1codeSymbol in syntax defined by the system
Fixed Value: StudyCohort
..... display1..1stringRepresentation defined by the system
Fixed Value: Study Cohort
..... userSelected0..1booleanIf this coding was chosen directly by the user
.... text Σ0..1stringPlain text representation of the concept
... focus Σ0..*CodeableConceptDrugs, devices, etc. under study
Binding: (unbound) (example): Codes for medications, devices and other interventions.


... condition Σ0..*CodeableConceptDisease or phenotypes that were interrogated during the study’s execution. MONDO, HPO
Binding: Condition/Problem/DiagnosisCodes (example): Identification of the condition or diagnosis.


... contact Σ0..*ContactDetailContact details for the study
... relatedArtifact 0..*RelatedArtifactAttribution, Study Weblinks, Citation, Study Documents, etc.
... keyword Σ0..*CodeableConceptUsed to search for the study
Binding: (unbound) (example): Words associated with the study that may be useful in discovery.


... location Σ0..*CodeableConceptGeographic region(s) for study
Binding: Jurisdiction ValueSet (extensible): Countries and regions within which this artifact is targeted for use.


... description 0..1markdownStudy Description (Recommended)
... enrollment Σ1..1Reference(NCPI Study Group)Study Participants
... period Σ0..1PeriodWhen the study began and ended
... sponsor Σ0..1Reference(Research Consortium)Consortium or other group the study is a member
... principalInvestigator Σ0..1Reference(Practitioner)Researcher who oversees multiple aspects of the study
... site Σ0..*Reference(Location)Facility where study activities are conducted
... reasonStopped Σ0..1CodeableConceptaccrual-goal-met | closed-due-to-toxicity | closed-due-to-lack-of-study-progress | temporarily-closed-per-study-design
Binding: ResearchStudyReasonStopped (example): Codes for why the study ended prematurely.

... note 0..*AnnotationComments made about the study
... arm 0..*BackboneElementDefined path through the study for a subject
.... id 0..1stringUnique id for inter-element referencing
.... extension 0..*ExtensionAdditional content defined by implementations
.... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
.... name 1..1stringLabel for study arm
.... type 0..1CodeableConceptCategorization of study arm
.... description 0..1stringShort explanation of study path
... objective 0..*BackboneElementA goal for the study
.... id 0..1stringUnique id for inter-element referencing
.... extension 0..*ExtensionAdditional content defined by implementations
.... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
.... name 0..1stringLabel for the objective
.... type 0..1CodeableConceptprimary | secondary | exploratory
Binding: ResearchStudyObjectiveType (preferred): Codes for the kind of study objective.


doco Documentation for this format

Terminology Bindings

PathConformanceValueSetURI
ResearchStudy.languagepreferredCommonLanguages
Additional Bindings Purpose
AllLanguages Max Binding
http://hl7.org/fhir/ValueSet/languages
from the FHIR Standard
ResearchStudy.statusrequiredResearchStudyStatus
http://hl7.org/fhir/ValueSet/research-study-status|4.3.0
from the FHIR Standard
ResearchStudy.primaryPurposeTypeextensibleResearchStudyPrimaryPurposeType
http://hl7.org/fhir/ValueSet/research-study-prim-purp-type
from the FHIR Standard
ResearchStudy.phaseexampleResearchStudyPhase
http://hl7.org/fhir/ValueSet/research-study-phase
from the FHIR Standard
ResearchStudy.categoryexample
ResearchStudy.focusexample
ResearchStudy.conditionexampleCondition/Problem/DiagnosisCodes
http://hl7.org/fhir/ValueSet/condition-code
from the FHIR Standard
ResearchStudy.keywordexample
ResearchStudy.locationextensibleJurisdiction ValueSet
http://hl7.org/fhir/ValueSet/jurisdiction
from the FHIR Standard
ResearchStudy.reasonStoppedexampleResearchStudyReasonStopped
http://hl7.org/fhir/ValueSet/research-study-reason-stopped
from the FHIR Standard
ResearchStudy.objective.typepreferredResearchStudyObjectiveType
http://hl7.org/fhir/ValueSet/research-study-objective-type
from the FHIR Standard

Constraints

IdGradePath(s)DetailsRequirements
dom-2errorResearchStudyIf the resource is contained in another resource, it SHALL NOT contain nested Resources
: contained.contained.empty()
dom-3errorResearchStudyIf the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource
: contained.where(((id.exists() and ('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url)))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(uri) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4errorResearchStudyIf a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated
: contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5errorResearchStudyIf a resource is contained in another resource, it SHALL NOT have a security label
: contained.meta.security.empty()
dom-6best practiceResearchStudyA resource should have narrative for robust management
: text.`div`.exists()
dom-r4bwarningResearchStudy.containedContaining new R4B resources within R4 resources may cause interoperability issues if instances are shared with R4 systems
: ($this is Citation or $this is Evidence or $this is EvidenceReport or $this is EvidenceVariable or $this is MedicinalProductDefinition or $this is PackagedProductDefinition or $this is AdministrableProductDefinition or $this is Ingredient or $this is ClinicalUseDefinition or $this is RegulatedAuthorization or $this is SubstanceDefinition or $this is SubscriptionStatus or $this is SubscriptionTopic) implies (%resource is Citation or %resource is Evidence or %resource is EvidenceReport or %resource is EvidenceVariable or %resource is MedicinalProductDefinition or %resource is PackagedProductDefinition or %resource is AdministrableProductDefinition or %resource is Ingredient or %resource is ClinicalUseDefinition or %resource is RegulatedAuthorization or %resource is SubstanceDefinition or %resource is SubscriptionStatus or %resource is SubscriptionTopic)
ele-1error**ALL** elementsAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1error**ALL** extensionsMust have either extensions or value[x], not both
: extension.exists() != value.exists()

 

Other representations of profile: CSV, Excel, Schematron

Notes:

As mentioned in the section, “Added Profile Restrictions” above, each NCPI Research must have one NCPI Study Group which must, at the very least, indicate the total number of patients enrolled at the time the data was loaded into FHIR.

Practices for Summary Only Resources

For Studies loaded into Summary Only FHIR servers, the Study’s Study Group resources must have the quantity. This promotes findability by enabling researches without current access to the study’s row-level data to get basic study details including the different subject counts.

For studies that exist alongside row-level data, the Study’s Study Group resources should have each corresponding Patient referenced in the Group’s members array.