ResearchDefinition - FHIR Resource (r4)

This ResearchDefinition Resource uses the FHIR API standard for access and structure.

Validate an ResearchDefinition FHIR Resource (r4)

ResearchDefinition Attributes

AttributeField is listTypeDescription

Description: Canonical identifier for this research definition, represented as a URI (globally unique)

FHIR Version: r4

Attribute Type : uri

Required: N/A

Countability: Singleton

Flags: N/A

Terminology bindings: N/A

Requirements: N/A

Comments: N/A

Example:

"url":

Learn more about the (ResearchDefinition) url FHIR attribute

Description: Additional identifier for the research definition

FHIR Version: r4

Attribute Type : Identifier

Required: N/A

Countability: Array

Flags: N/A

Terminology bindings: N/A

Requirements: N/A

Comments: N/A

Example:

"identifier":

Learn more about the (ResearchDefinition) identifier FHIR attribute

Description: Business version of the research definition

FHIR Version: r4

Attribute Type : string

Required: N/A

Countability: Singleton

Flags: N/A

Terminology bindings: N/A

Requirements: N/A

Comments: N/A

Example:

"version":

Learn more about the (ResearchDefinition) version FHIR attribute

Description: C? Name for this research definition (computer friendly)

FHIR Version: r4

Attribute Type : string

Required: N/A

Countability: Singleton

Flags: N/A

Terminology bindings: N/A

Requirements: N/A

Comments: N/A

Example:

"name":

Learn more about the (ResearchDefinition) name FHIR attribute

Description: Name for this research definition (human friendly)

FHIR Version: r4

Attribute Type : string

Required: N/A

Countability: Singleton

Flags: N/A

Terminology bindings: N/A

Requirements: N/A

Comments: N/A

Example:

"title":

Learn more about the (ResearchDefinition) title FHIR attribute

Description: Title for use in informal contexts

FHIR Version: r4

Attribute Type : string

Required: N/A

Countability: Singleton

Flags: N/A

Terminology bindings: N/A

Requirements: N/A

Comments: N/A

Example:

"shortTitle":

Learn more about the (ResearchDefinition) shortTitle FHIR attribute

Description: Subordinate title of the ResearchDefinition

FHIR Version: r4

Attribute Type : string

Required: N/A

Countability: Singleton

Flags: N/A

Terminology bindings: N/A

Requirements: N/A

Comments: N/A

Example:

"subtitle":

Learn more about the (ResearchDefinition) subtitle FHIR attribute

Description: draft | active | retired | unknown

FHIR Version: r4

Attribute Type : code

Required: N/A

Countability: Singleton

Flags: N/A

Terminology bindings: N/A

Requirements: N/A

Comments: N/A

Example:

"status": "draft"

Learn more about the (ResearchDefinition) status FHIR attribute

Description: For testing purposes, not real usage

FHIR Version: r4

Attribute Type : boolean

Required: N/A

Countability: Singleton

Flags: N/A

Terminology bindings: N/A

Requirements: N/A

Comments: N/A

Example:

"experimental":

Learn more about the (ResearchDefinition) experimental FHIR attribute

Description:

FHIR Version: r4

Attribute Type : Reference

Required: N/A

Countability: Singleton

Flags: N/A

Terminology bindings: N/A

Requirements: N/A

Comments: N/A

Example:

"subject[x]":

Learn more about the (ResearchDefinition) subject[x] FHIR attribute

Description: Date last changed

FHIR Version: r4

Attribute Type : dateTime

Required: N/A

Countability: Singleton

Flags: N/A

Terminology bindings: N/A

Requirements: N/A

Comments: N/A

Example:

"date":

Learn more about the (ResearchDefinition) date FHIR attribute

Description: Name of the publisher (organization or individual)

FHIR Version: r4

Attribute Type : string

Required: N/A

Countability: Singleton

Flags: N/A

Terminology bindings: N/A

Requirements: N/A

Comments: N/A

Example:

"publisher":

Learn more about the (ResearchDefinition) publisher FHIR attribute

Description: Contact details for the publisher

FHIR Version: r4

Attribute Type : ContactDetail

Required: N/A

Countability: Array

Flags: N/A

Terminology bindings: N/A

Requirements: N/A

Comments: N/A

Example:

"contact":

Learn more about the (ResearchDefinition) contact FHIR attribute

Description: Natural language description of the research definition

FHIR Version: r4

Attribute Type : markdown

Required: N/A

Countability: Singleton

Flags: N/A

Terminology bindings: N/A

Requirements: N/A

Comments: N/A

Example:

"description":

Learn more about the (ResearchDefinition) description FHIR attribute

Description: Used for footnotes or explanatory notes

FHIR Version: r4

Attribute Type : string

Required: N/A

Countability: Array

Flags: N/A

Terminology bindings: N/A

Requirements: N/A

Comments: N/A

Example:

"comment":

Learn more about the (ResearchDefinition) comment FHIR attribute

Description: The context that the content is intended to support

FHIR Version: r4

Attribute Type : UsageContext

Required: N/A

Countability: Array

Flags: N/A

Terminology bindings: N/A

Requirements: N/A

Comments: N/A

Example:

"useContext":

Learn more about the (ResearchDefinition) useContext FHIR attribute

Description: Intended jurisdiction for research definition (if applicable)

FHIR Version: r4

Attribute Type : CodeableConcept

Required: N/A

Countability: Array

Flags: N/A

Terminology bindings: N/A

Requirements: N/A

Comments: N/A

Example:

"jurisdiction":

Learn more about the (ResearchDefinition) jurisdiction FHIR attribute

Description: Why this research definition is defined

FHIR Version: r4

Attribute Type : markdown

Required: N/A

Countability: Singleton

Flags: N/A

Terminology bindings: N/A

Requirements: N/A

Comments: N/A

Example:

"purpose":

Learn more about the (ResearchDefinition) purpose FHIR attribute

Description: Describes the clinical usage of the ResearchDefinition

FHIR Version: r4

Attribute Type : string

Required: N/A

Countability: Singleton

Flags: N/A

Terminology bindings: N/A

Requirements: N/A

Comments: N/A

Example:

"usage":

Learn more about the (ResearchDefinition) usage FHIR attribute

Description: Use and/or publishing restrictions

FHIR Version: r4

Attribute Type : markdown

Required: N/A

Countability: Singleton

Flags: N/A

Terminology bindings: N/A

Requirements: N/A

Comments: N/A

Example:

"copyright":

Learn more about the (ResearchDefinition) copyright FHIR attribute

Description: When the research definition was approved by publisher

FHIR Version: r4

Attribute Type : date

Required: N/A

Countability: Singleton

Flags: N/A

Terminology bindings: N/A

Requirements: N/A

Comments: N/A

Example:

"approvalDate":

Learn more about the (ResearchDefinition) approvalDate FHIR attribute

Description: When the research definition was last reviewed

FHIR Version: r4

Attribute Type : date

Required: N/A

Countability: Singleton

Flags: N/A

Terminology bindings: N/A

Requirements: N/A

Comments: N/A

Example:

"lastReviewDate":

Learn more about the (ResearchDefinition) lastReviewDate FHIR attribute

Description: When the research definition is expected to be used

FHIR Version: r4

Attribute Type : Period

Required: N/A

Countability: Singleton

Flags: N/A

Terminology bindings: N/A

Requirements: N/A

Comments: N/A

Example:

"effectivePeriod":

Learn more about the (ResearchDefinition) effectivePeriod FHIR attribute

Description: The category of the ResearchDefinition, such as Education, Treatment, Assessment, etc.

FHIR Version: r4

Attribute Type : CodeableConcept

Required: N/A

Countability: Array

Flags: N/A

Terminology bindings: N/A

Requirements: N/A

Comments: N/A

Example:

"topic":

Learn more about the (ResearchDefinition) topic FHIR attribute

Description: Who authored the content

FHIR Version: r4

Attribute Type : ContactDetail

Required: N/A

Countability: Array

Flags: N/A

Terminology bindings: N/A

Requirements: N/A

Comments: N/A

Example:

"author":

Learn more about the (ResearchDefinition) author FHIR attribute

Description: Who edited the content

FHIR Version: r4

Attribute Type : ContactDetail

Required: N/A

Countability: Array

Flags: N/A

Terminology bindings: N/A

Requirements: N/A

Comments: N/A

Example:

"editor":

Learn more about the (ResearchDefinition) editor FHIR attribute

Description: Who reviewed the content

FHIR Version: r4

Attribute Type : ContactDetail

Required: N/A

Countability: Array

Flags: N/A

Terminology bindings: N/A

Requirements: N/A

Comments: N/A

Example:

"reviewer":

Learn more about the (ResearchDefinition) reviewer FHIR attribute

Description: Who endorsed the content

FHIR Version: r4

Attribute Type : ContactDetail

Required: N/A

Countability: Array

Flags: N/A

Terminology bindings: N/A

Requirements: N/A

Comments: N/A

Example:

"endorser":

Learn more about the (ResearchDefinition) endorser FHIR attribute

Description: Additional documentation, citations, etc.

FHIR Version: r4

Attribute Type : RelatedArtifact

Required: N/A

Countability: Array

Flags: N/A

Terminology bindings: N/A

Requirements: N/A

Comments: N/A

Example:

"relatedArtifact":

Learn more about the (ResearchDefinition) relatedArtifact FHIR attribute

Description: Logic used by the ResearchDefinition

FHIR Version: r4

Attribute Type : canonical(Library)

Required: N/A

Countability: Array

Flags: N/A

Terminology bindings: N/A

Requirements: N/A

Comments: N/A

Example:

"library":

Learn more about the (ResearchDefinition) library FHIR attribute

Description: What population?

FHIR Version: r4

Attribute Type : Reference

Required: N/A

Countability: Singleton

Flags: N/A

Terminology bindings: N/A

Requirements: N/A

Comments: N/A

Example:

"population": {
  "reference": "ResearchElementDefinition/example"
}

Learn more about the (ResearchDefinition) population FHIR attribute

Description: What exposure?

FHIR Version: r4

Attribute Type : Reference

Required: N/A

Countability: Singleton

Flags: N/A

Terminology bindings: N/A

Requirements: N/A

Comments: N/A

Example:

"exposure":

Learn more about the (ResearchDefinition) exposure FHIR attribute

Description: What alternative exposure state?

FHIR Version: r4

Attribute Type : Reference

Required: N/A

Countability: Singleton

Flags: N/A

Terminology bindings: N/A

Requirements: N/A

Comments: N/A

Example:

"exposureAlternative":

Learn more about the (ResearchDefinition) exposureAlternative FHIR attribute

Description: What outcome?

FHIR Version: r4

Attribute Type : Reference

Required: N/A

Countability: Singleton

Flags: N/A

Terminology bindings: N/A

Requirements: N/A

Comments: N/A

Example:

"outcome":

Learn more about the (ResearchDefinition) outcome FHIR attribute

ResearchDefinition Example

{
  "resourceType": "ResearchDefinition",
  "id": "example",
  "text": {
    "status": "generated",
    "div": "<div xmlns=\"http://www.w3.org/1999/xhtml\">[Put rendering here]</div>"
  },
  "status": "draft",
  "population": {
    "reference": "ResearchElementDefinition/example"
  }
}

ResearchDefinition Structure

{
  "resourceType" : "ResearchDefinition",
  // from Resource: id, meta, implicitRules, and language
  // from DomainResource: text, contained, extension, and modifierExtension
  "url" : "<uri>", // Canonical identifier for this research definition, represented as a URI (globally unique)
  "identifier" : [{ Identifier }], // Additional identifier for the research definition
  "version" : "<string>", // Business version of the research definition
  "name" : "<string>", // C? Name for this research definition (computer friendly)
  "title" : "<string>", // Name for this research definition (human friendly)
  "shortTitle" : "<string>", // Title for use in informal contexts
  "subtitle" : "<string>", // Subordinate title of the ResearchDefinition
  "status" : "<code>", // R!  draft | active | retired | unknown
  "experimental" : <boolean>, // For testing purposes, not real usage
  // subject[x]: E.g. Patient, Practitioner, RelatedPerson, Organization, Location, Device. One of these 2:
  "subjectCodeableConcept" : { CodeableConcept },
  "subjectReference" : { Reference(Group) },
  "date" : "<dateTime>", // Date last changed
  "publisher" : "<string>", // Name of the publisher (organization or individual)
  "contact" : [{ ContactDetail }], // Contact details for the publisher
  "description" : "<markdown>", // Natural language description of the research definition
  "comment" : ["<string>"], // Used for footnotes or explanatory notes
  "useContext" : [{ UsageContext }], // The context that the content is intended to support
  "jurisdiction" : [{ CodeableConcept }], // Intended jurisdiction for research definition (if applicable)
  "purpose" : "<markdown>", // Why this research definition is defined
  "usage" : "<string>", // Describes the clinical usage of the ResearchDefinition
  "copyright" : "<markdown>", // Use and/or publishing restrictions
  "approvalDate" : "<date>", // When the research definition was approved by publisher
  "lastReviewDate" : "<date>", // When the research definition was last reviewed
  "effectivePeriod" : { Period }, // When the research definition is expected to be used
  "topic" : [{ CodeableConcept }], // The category of the ResearchDefinition, such as Education, Treatment, Assessment, etc.
  "author" : [{ ContactDetail }], // Who authored the content
  "editor" : [{ ContactDetail }], // Who edited the content
  "reviewer" : [{ ContactDetail }], // Who reviewed the content
  "endorser" : [{ ContactDetail }], // Who endorsed the content
  "relatedArtifact" : [{ RelatedArtifact }], // Additional documentation, citations, etc.
  "library" : [{ canonical(Library) }], // Logic used by the ResearchDefinition
  "population" : { Reference(ResearchElementDefinition) }, // R!  What population?
  "exposure" : { Reference(ResearchElementDefinition) }, // What exposure?
  "exposureAlternative" : { Reference(ResearchElementDefinition) }, // What alternative exposure state?
  "outcome" : { Reference(ResearchElementDefinition) } // What outcome?
}

ResearchDefinition Search Parameters

The following search parameters can be used to query ResearchDefinition resources. Just submit them like so:

https://api.1up.health/fhir/r4/ResearchDefinition?query-param=queryvalue

Search Parameter	Field Type	Resource Fields Searched
`composed-of`	`reference`	`relatedArtifact.where`
`context`	`text`	`useContext.value`
`context-quantity`	`quantity`	`useContext.value`
`context-type`	`text`	`useContext.code`
`context-type-quantity`	`composite`	`useContext`
`context-type-value`	`composite`	`useContext`
`date`	`date`	`date`
`depends-on`	`reference`	`relatedArtifact.where`
`derived-from`	`reference`	`relatedArtifact.where`
`description`	`text`	`description`
`effective`	`date`	`effectivePeriod`
`identifier`	`text`	`identifier`
`jurisdiction`	`text`	`jurisdiction`
`name`	`text`	`name`
`predecessor`	`reference`	`relatedArtifact.where`
`publisher`	`text`	`publisher`
`status`	`text`	`status`
`successor`	`reference`	`relatedArtifact.where`
`title`	`text`	`title`
`topic`	`text`	`topic`
`url`	`uri`	`url`
`version`	`text`	`version`