Operations

1. $linkToHealthIssue

Introduction

The operation $linkToHealthIssue is an operation performed on the profile QuestionnaireResponseSe, which is based on the QuestionnaireResponse resource. This operation is used to link a ConditionHealthIssueSe to the QuestionnaireResponseSe.

The formal computable definition of the operation is specified by the OperationDefinitionLinkToHealthIssue profile, derived from the OperationDefinition resource in FHIR R4.

To pass information into the operation, the ParametersHealthIssueReferenceSe profile is used, which is based on the Parameters resource in FHIR R4.

Intended Use

The API is designed to link a ConditionHealthIssueSe to a QuestionnaireResponseSe belonging to the same patient. Only one ConditionHealthIssueSe can be linked to a QuestionnaireResponseSe at a time. Additionally, only ConditionHealthIssueSe resources with an active or closed status can be linked.

The literal ID (internal COSMIC ID) of the QuestionnaireResponseSe to be linked must be provided in the API path. This ensures that the QuestionnaireResponseSe referenced exists in COSMIC.

The literal ID (internal COSMIC ID) of the ConditionHealthIssueSe to be linked should be included in the API request body using the ParametersHealthIssueReferenceSe profile.

This API is recommended for use by healthcare professionals.

Specific Rules and Limitations

Type	Description
Rule	Only the ConditionHealthIssueSe in status active or completed may be linked to the QuestionnaireResponseSe.
Limitation	Invalidating a link created in an erroneous situation is not supported.
Limitation	Only one ConditionHealthIssueSe can be linked at a time; linking multiple is not permitted.

Profile Overview

OperationDefinitionLinkToHealthIssue

OperationDefinitionLinkToHealthIssue (OperationDefinition)	I		OperationDefinition	Element id OperationDefinition Short description Definition of the operation '$LinkToConditionHealthIssueSe' Definition A formal computable definition of the operation '$LinkToConditionHealthIssueSe' designed to link a QuestionnaireResponse and a ConditionHealthIssueSe. Data type OperationDefinition Constraints dom-2: If the resource is contained in another resource, it SHALL NOT contain nested Resources `contained.contained.empty()` dom-4: If 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-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 `contained.where((('#'+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(canonical) = '#').exists()).not()).trace('unmatched', id).empty()` dom-6: A resource should have narrative for robust management text.`div`.exists() dom-5: If a resource is contained in another resource, it SHALL NOT have a security label `contained.meta.security.empty()` opd-0: Name should be usable as an identifier for the module by machine processing applications such as code generation `name.matches('[A-Z]([A-Za-z0-9_]){0,254}')` Mappings rim: Entity. Role, or Act workflow: Definition rim: n/a
id	Σ	0..1	string	There are no (further) constraints on this element Element id OperationDefinition.id Short description Logical id of this artifact Definition The logical id of the resource, as used in the URL for the resource. Once assigned, this value never changes. Comments The only time that a resource does not have an id is when it is being submitted to the server using a create operation. Data type string
meta	Σ	0..1	Meta	There are no (further) constraints on this element Element id OperationDefinition.meta Short description Metadata about the resource Definition The metadata about the resource. This is content that is maintained by the infrastructure. Changes to the content might not always be associated with version changes to the resource. Data type Meta Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a rim: N/A
implicitRules	Σ ?!	0..1	uri	There are no (further) constraints on this element Element id OperationDefinition.implicitRules Short description A set of rules under which this content was created Definition A reference to a set of rules that were followed when the resource was constructed, and which must be understood when processing the content. Often, this is a reference to an implementation guide that defines the special rules along with other profiles etc. Comments Asserting this rule set restricts the content to be only understood by a limited set of trading partners. This inherently limits the usefulness of the data in the long term. However, the existing health eco-system is highly fractured, and not yet ready to define, collect, and exchange data in a generally computable sense. Wherever possible, implementers and/or specification writers should avoid using this element. Often, when used, the URL is a reference to an implementation guide that defines these special rules as part of it's narrative along with other profiles, value sets, etc. Data type uri Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a
language		0..1	codeBinding	There are no (further) constraints on this element Element id OperationDefinition.language Short description Language of the resource content Definition The base language in which the resource is written. Comments Language is provided to support indexing and accessibility (typically, services such as text to speech use the language tag). The html language tag in the narrative applies to the narrative. The language tag on the resource may be used to specify the language of other presentations generated from the data in the resource. Not all the content has to be in the base language. The Resource.language should not be assumed to apply to the narrative automatically. If a language is specified, it should it also be specified on the div element in the html (see rules in HTML5 for information about the relationship between xml:lang and the html lang attribute). Data type code Binding A human language. CommonLanguages (preferred) Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a
text		0..1	Narrative	There are no (further) constraints on this element Element id OperationDefinition.text Short description Text summary of the resource, for human interpretation Alternate names narrative, html, xhtml, display Definition A human-readable narrative that contains a summary of the resource and can be used to represent the content of the resource to a human. The narrative need not encode all the structured data, but is required to contain sufficient detail to make it "clinically safe" for a human to just read the narrative. Resource definitions may define what content should be represented in the narrative to ensure clinical safety. Comments Contained resources do not have narrative. Resources that are not contained SHOULD have a narrative. In some cases, a resource may only have text with little or no additional discrete data (as long as all minOccurs=1 elements are satisfied). This may be necessary for data from legacy systems where information is captured as a "text blob" or where text is additionally entered raw or narrated and encoded information is added later. Data type Narrative Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a rim: N/A rim: Act.text?
contained		0..*	Resource	There are no (further) constraints on this element Element id OperationDefinition.contained Short description Contained, inline Resources Alternate names inline resources, anonymous resources, contained resources Definition These resources do not have an independent existence apart from the resource that contains them - they cannot be identified independently, and nor can they have their own independent transaction scope. Comments This should never be done when the content can be identified properly, as once identification is lost, it is extremely difficult (and context dependent) to restore it again. Contained resources may have profiles and tags In their meta elements, but SHALL NOT have security labels. Data type Resource Mappings rim: Entity. Role, or Act rim: N/A
extension	I	0..*	Extension	There are no (further) constraints on this element Element id OperationDefinition.extension Short description Additional content defined by implementations Alternate names extensions, user content Definition May be used to represent additional information that is not part of the basic definition of the resource. 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 can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. 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. Data type Extension Sliced: Unordered, Open, by url(Value) Extensions are always sliced by (at least) url Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` ext-1: Must have either extensions or value[x], not both `extension.exists() != value.exists()` Mappings rim: n/a rim: N/A
modifierExtension	?! I	0..*	Extension	There are no (further) constraints on this element Element id OperationDefinition.modifierExtension Short description Extensions that cannot be ignored Alternate names extensions, user content Definition May be used to represent additional information that is not part of the basic definition of the resource and that modifies the understanding of the element that contains it and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. 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. Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself). Requirements Modifier extensions allow for extensions that cannot be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the definition of modifier extensions. 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. Data type Extension Sliced: Unordered, Open, by url(Value) Extensions are always sliced by (at least) url Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` ext-1: Must have either extensions or value[x], not both `extension.exists() != value.exists()` Mappings rim: n/a rim: N/A
url	Σ	0..0	uri	There are no (further) constraints on this element Element id OperationDefinition.url Short description Canonical identifier for this operation definition, represented as a URI (globally unique) Definition An absolute URI that is used to identify this operation definition when it is referenced in a specification, model, design or an instance; also called its canonical identifier. This SHOULD be globally unique and SHOULD be a literal address at which at which an authoritative instance of this operation definition is (or will be) published. This URL can be the target of a canonical reference. It SHALL remain the same when the operation definition is stored on different servers. Requirements Allows the operation definition to be referenced by a single globally unique identifier. Comments Can be a urn:uuid: or a urn:oid: but real http: addresses are preferred. Multiple instances may share the same URL if they have a distinct version. The determination of when to create a new version of a resource (same url, new version) vs. defining a new artifact is up to the author. Considerations for making this decision are found in Technical and Business Versions. In some cases, the resource can no longer be found at the stated url, but the url itself cannot change. Implementations can use the meta.source element to indicate where the current master source of the resource can be found. Data type uri Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a workflow: Definition.url w5: FiveWs.identifier
version	Σ	0..0	string	There are no (further) constraints on this element Element id OperationDefinition.version Short description Business version of the operation definition Definition The identifier that is used to identify this version of the operation definition when it is referenced in a specification, model, design or instance. This is an arbitrary value managed by the operation definition author and is not expected to be globally unique. For example, it might be a timestamp (e.g. yyyymmdd) if a managed version is not available. There is also no expectation that versions can be placed in a lexicographical sequence. Comments There may be different operation definition instances that have the same identifier but different versions. The version can be appended to the url in a reference to allow a reference to a particular business version of the operation definition with the format [url]\|[version]. Data type string Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a workflow: Definition.version w5: FiveWs.version
name	Σ I	1..1	stringFixed Value	Element id OperationDefinition.name Short description Name for this operation definition (computer friendly) Definition A natural language name identifying the operation definition. This name should be usable as an identifier for the module by machine processing applications such as code generation. Requirements Support human navigation and code generation. Comments The name is not expected to be globally unique. The name should be a simple alphanumeric type name to ensure that it is machine-processing friendly. Data type string Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Fixed value LinkToHealthIssue Mappings rim: n/a workflow: Definition.title
title	Σ	0..0	string	There are no (further) constraints on this element Element id OperationDefinition.title Short description Name for this operation definition (human friendly) Definition A short, descriptive, user-friendly title for the operation definition. Comments This name does not need to be machine-processing friendly and may contain punctuation, white-space, etc. Data type string Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a workflow: Definition.title
status	Σ ?!	1..1	codeBindingFixed Value	Element id OperationDefinition.status Short description draft \| active \| retired \| unknown Definition The status of this operation definition. Enables tracking the life-cycle of the content. Comments Allows filtering of operation definitions that are appropriate for use versus not. Data type code Binding The lifecycle status of an artifact. PublicationStatus (required) Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Fixed value active Mappings rim: n/a workflow: Definition.status {different ValueSet} w5: FiveWs.status
kind	Σ	1..1	codeBindingFixed Value	Element id OperationDefinition.kind Short description operation \| query Definition Whether this is an operation or a named query. Comments Named queries are invoked differently, and have different capabilities. Data type code Binding Whether an operation is a normal operation or a query. OperationKind (required) Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Fixed value operation Mappings rim: n/a w5: FiveWs.class
experimental	Σ	0..0	boolean	There are no (further) constraints on this element Element id OperationDefinition.experimental Short description For testing purposes, not real usage Definition A Boolean value to indicate that this operation definition is authored for testing purposes (or education/evaluation/marketing) and is not intended to be used for genuine usage. Requirements Enables experimental content to be developed following the same lifecycle that would be used for a production-level operation definition. Comments Allows filtering of operation definitions that are appropriate for use versus not. Data type boolean Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a workflow: Definition.experimental w5: FiveWs.class
date	Σ	0..0	dateTime	There are no (further) constraints on this element Element id OperationDefinition.date Short description Date last changed Alternate names Revision Date Definition The date (and optionally time) when the operation definition was published. The date must change when the business version changes and it must change if the status code changes. In addition, it should change when the substantive content of the operation definition changes. Comments Note that this is not the same as the resource last-modified-date, since the resource may be a secondary representation of the operation definition. Additional specific dates may be added as extensions or be found by consulting Provenances associated with past versions of the resource. Data type dateTime Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a workflow: Definition.date w5: FiveWs.recorded
publisher	Σ	0..0	string	There are no (further) constraints on this element Element id OperationDefinition.publisher Short description Name of the publisher (organization or individual) Definition The name of the organization or individual that published the operation definition. Requirements Helps establish the "authority/credibility" of the operation definition. May also allow for contact. Comments Usually an organization but may be an individual. The publisher (or steward) of the operation definition is the organization or individual primarily responsible for the maintenance and upkeep of the operation definition. This is not necessarily the same individual or organization that developed and initially authored the content. The publisher is the primary point of contact for questions or issues with the operation definition. This item SHOULD be populated unless the information is available from context. Data type string Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a workflow: Definition.publisher w5: FiveWs.witness
contact	Σ	0..0	ContactDetail	There are no (further) constraints on this element Element id OperationDefinition.contact Short description Contact details for the publisher Definition Contact details to assist a user in finding and communicating with the publisher. Comments May be a web site, an email address, a telephone number, etc. Data type ContactDetail Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a workflow: Definition.contact
description		0..0	markdown	There are no (further) constraints on this element Element id OperationDefinition.description Short description Natural language description of the operation definition Definition A free text natural language description of the operation definition from a consumer's perspective. Comments This description can be used to capture details such as why the operation definition was built, comments about misuse, instructions for clinical use and interpretation, literature references, examples from the paper world, etc. It is not a rendering of the operation definition as conveyed in the 'text' field of the resource itself. This item SHOULD be populated unless the information is available from context (e.g. the language of the operation definition is presumed to be the predominant language in the place the operation definition was created). Data type markdown Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a workflow: Definition.description
useContext	Σ	0..0	UsageContext	There are no (further) constraints on this element Element id OperationDefinition.useContext Short description The context that the content is intended to support Definition The content was developed with a focus and intent of supporting the contexts that are listed. These contexts may be general categories (gender, age, ...) or may be references to specific programs (insurance plans, studies, ...) and may be used to assist with indexing and searching for appropriate operation definition instances. Requirements Assist in searching for appropriate content. Comments When multiple useContexts are specified, there is no expectation that all or any of the contexts apply. Data type UsageContext Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a workflow: Definition.useContext
jurisdiction	Σ	0..0	CodeableConceptBinding	There are no (further) constraints on this element Element id OperationDefinition.jurisdiction Short description Intended jurisdiction for operation definition (if applicable) Definition A legal or geographic region in which the operation definition is intended to be used. Comments It may be possible for the operation definition to be used in jurisdictions other than those for which it was originally designed or intended. Data type CodeableConcept Binding Countries and regions within which this artifact is targeted for use. Jurisdiction ValueSet (extensible) Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a v2: CE/CNE/CWE rim: CD orim: fhir:CodeableConcept rdfs:subClassOf dt:CD workflow: Definition.jurisdiction
purpose		0..0	markdown	There are no (further) constraints on this element Element id OperationDefinition.purpose Short description Why this operation definition is defined Definition Explanation of why this operation definition is needed and why it has been designed as it has. Comments This element does not describe the usage of the operation definition. Instead, it provides traceability of ''why'' the resource is either needed or ''why'' it is defined as it is. This may be used to point to source materials or specifications that drove the structure of this operation definition. Data type markdown Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a workflow: Definition.purpose w5: FiveWs.why[x] objimpl: no-gen-base
affectsState	Σ	0..0	boolean	There are no (further) constraints on this element Element id OperationDefinition.affectsState Short description Whether content is changed by the operation Definition Whether the operation affects state. Side effects such as producing audit trail entries do not count as 'affecting state'. Comments What http methods can be used for the operation depends on the .affectsState value and whether the input parameters are primitive or complex: Servers SHALL support POST method for all operations. Servers SHALL support GET method if all the parameters for the operation are primitive or there are no parameters and the operation has affectsState = false. Data type boolean Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a
code	Σ	1..1	codeFixed Value	Element id OperationDefinition.code Short description Name used to invoke the operation Definition The name used to invoke the operation. Comments Note that FHIR strings SHALL NOT exceed 1MB in size Data type code Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Fixed value linkToHealthIssue Mappings rim: n/a
comment		0..0	markdown	There are no (further) constraints on this element Element id OperationDefinition.comment Short description Additional information about use Definition Additional information about how to use this operation or named query. Comments Systems are not required to have markdown support, so the text should be readable without markdown processing. The markdown syntax is GFM - see https://github.github.com/gfm/ Data type markdown Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a
base	Σ	0..0	canonical(OperationDefinition)	There are no (further) constraints on this element Element id OperationDefinition.base Short description Marks this as a profile of the base Definition Indicates that this operation definition is a constraining profile on the base. Comments A constrained profile can make optional parameters required or not used and clarify documentation. Data type canonical(OperationDefinition) Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a workflow: Definition.derivedFrom
resource	Σ	0..0	codeBinding	There are no (further) constraints on this element Element id OperationDefinition.resource Short description Types this operation applies to Definition The types on which this operation can be executed. Comments If the type is an abstract resource ("Resource" or "DomainResource") then the operation can be invoked on any concrete specialization. Data type code Binding One of the resource types defined as part of this version of FHIR. ResourceType (required) Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a workflow: Definition.subject[x]
system	Σ	1..1	booleanFixed Value	Element id OperationDefinition.system Short description Invoke at the system level? Definition Indicates whether this operation or named query can be invoked at the system level (e.g. without needing to choose a resource type for the context). Data type boolean Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Fixed value false Mappings rim: n/a
type	Σ	1..1	booleanFixed Value	Element id OperationDefinition.type Short description Invoke at the type level? Definition Indicates whether this operation or named query can be invoked at the resource type level for any given resource type level (e.g. without needing to choose a specific resource id for the context). Data type boolean Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Fixed value false Mappings rim: n/a
instance	Σ	1..1	booleanFixed Value	Element id OperationDefinition.instance Short description Invoke on an instance? Definition Indicates whether this operation can be invoked on a particular instance of one of the given types. Data type boolean Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Fixed value true Mappings rim: n/a
inputProfile		1..1	canonical(https://fhir.cambio.se/StructureDefinition/ParametersHealthIssueReferenceSe)	Element id OperationDefinition.inputProfile Short description Validation information for in parameters Definition Additional validation information for the in parameters - a single profile that covers all the parameters. The profile is a constraint on the parameters resource as a whole. Comments If present the profile shall not conflict with what is specified in the parameters in the operation definition (max/min etc.), though it may provide additional constraints. The constraints expressed in the profile apply whether the operation is invoked by a POST wih parameters or not. Data type canonical(https://fhir.cambio.se/StructureDefinition/ParametersHealthIssueReferenceSe) Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a
outputProfile		0..0	canonical(StructureDefinition)	There are no (further) constraints on this element Element id OperationDefinition.outputProfile Short description Validation information for out parameters Definition Additional validation information for the out parameters - a single profile that covers all the parameters. The profile is a constraint on the parameters resource. Comments If present the profile shall not conflict with what is specified in the parameters in the operation definition (max/min etc.), though it may provide additional constraints. The constraints expressed in the profile apply whether the operation is invoked by a POST wih parameters or not. Data type canonical(StructureDefinition) Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a
parameter	I	1..1	BackboneElement	Element id OperationDefinition.parameter Short description Parameters for the operation Definition The parameters for the operation. Comments Query Definitions only have one output parameter, named "result". This might not be described, but can be to allow a profile to be defined. Data type BackboneElement Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` opd-1: Either a type must be provided, or parts `type.exists() or part.exists()` opd-2: A search type can only be specified for parameters of type string `searchType.exists() implies type = 'string'` opd-3: A targetProfile can only be specified for parameters of type Reference or Canonical `targetProfile.exists() implies (type = 'Reference' or type = 'canonical')` Mappings rim: n/a
id		0..1	string	There are no (further) constraints on this element Element id OperationDefinition.parameter.id Short description Unique id for inter-element referencing Definition Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces. Data type string Mappings rim: n/a
extension	I	0..*	Extension	There are no (further) constraints on this element Element id OperationDefinition.parameter.extension Short description Additional content defined by implementations Alternate names extensions, user content Definition May be used to represent additional information that is not part of the basic definition of the element. 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 can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. 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. Data type Extension Sliced: Unordered, Open, by url(Value) Extensions are always sliced by (at least) url Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` ext-1: Must have either extensions or value[x], not both `extension.exists() != value.exists()` Mappings rim: n/a rim: N/A
modifierExtension	Σ ?! I	0..*	Extension	There are no (further) constraints on this element Element id OperationDefinition.parameter.modifierExtension Short description Extensions that cannot be ignored even if unrecognized Alternate names extensions, user content, modifiers 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 in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. 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 can 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. Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself). Requirements Modifier extensions allow for extensions that cannot be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the definition of modifier extensions. 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. Data type Extension Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` ext-1: Must have either extensions or value[x], not both `extension.exists() != value.exists()` Mappings rim: n/a rim: N/A
name		1..1	codeFixed Value	Element id OperationDefinition.parameter.name Short description Name in Parameters.parameter.name or in URL Definition The name of used to identify the parameter. Comments This name must be a token (start with a letter in a..z, and only contain letters, numerals, and underscore. Note that for search parameters (type = string, with a search type), the name may be altered by the search modifiers. Data type code Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Fixed value healthIssueId Mappings rim: n/a
use		1..1	codeBindingFixed Value	Element id OperationDefinition.parameter.use Short description in \| out Definition Whether this is an input or an output parameter. Comments If a parameter name is used for both an input and an output parameter, the parameter should be defined twice. Data type code Binding Whether an operation parameter is an input or an output parameter. OperationParameterUse (required) Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Fixed value in Mappings rim: n/a
min		1..1	integerFixed Value	Element id OperationDefinition.parameter.min Short description Minimum Cardinality Definition The minimum number of times this parameter SHALL appear in the request. Comments 32 bit number; for values larger than this, use decimal Data type integer Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Fixed value 1 Mappings rim: n/a
max		1..1	stringFixed Value	Element id OperationDefinition.parameter.max Short description Maximum Cardinality (a number or ) Definition* The maximum number of times this element is permitted to appear in the request. Comments Note that FHIR strings SHALL NOT exceed 1MB in size Data type string Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Fixed value 1 Mappings rim: n/a
documentation		0..0	string	There are no (further) constraints on this element Element id OperationDefinition.parameter.documentation Short description Description of meaning/use Definition Describes the meaning or use of this parameter. Comments Note that FHIR strings SHALL NOT exceed 1MB in size Data type string Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a
type	I	0..0	codeBinding	There are no (further) constraints on this element Element id OperationDefinition.parameter.type Short description What type this parameter has Definition The type for this parameter. Comments if there is no stated parameter, then the parameter is a multi-part parameter; type and must have at least one part defined. Data type code Binding A list of all the concrete types defined in this version of the FHIR specification - Abstract Types, Data Types and Resource Types. FHIRAllTypes (required) Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a
targetProfile		0..0	canonical(StructureDefinition)	There are no (further) constraints on this element Element id OperationDefinition.parameter.targetProfile Short description If type is Reference \| canonical, allowed targets Definition Used when the type is "Reference" or "canonical", and identifies a profile structure or implementation Guide that applies to the target of the reference this parameter refers to. If any profiles are specified, then the content must conform to at least one of them. The URL can be a local reference - to a contained StructureDefinition, or a reference to another StructureDefinition or Implementation Guide by a canonical URL. When an implementation guide is specified, the target resource SHALL conform to at least one profile defined in the implementation guide. Comments Often, these profiles are the base definitions from the spec (e.g. http://hl7.org/fhir/StructureDefinition/Patient). Data type canonical(StructureDefinition) Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a
searchType	I	0..0	codeBinding	There are no (further) constraints on this element Element id OperationDefinition.parameter.searchType Short description number \| date \| string \| token \| reference \| composite \| quantity \| uri \| special Definition How the parameter is understood as a search parameter. This is only used if the parameter type is 'string'. Comments Note that FHIR strings SHALL NOT exceed 1MB in size Data type code Binding Data types allowed to be used for search parameters. SearchParamType (required) Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a
binding		0..0	BackboneElement	There are no (further) constraints on this element Element id OperationDefinition.parameter.binding Short description ValueSet details if this is coded Definition Binds to a value set if this parameter is coded (code, Coding, CodeableConcept). Data type BackboneElement Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a
referencedFrom		0..0	BackboneElement	There are no (further) constraints on this element Element id OperationDefinition.parameter.referencedFrom Short description References to this parameter Definition Identifies other resource parameters within the operation invocation that are expected to resolve to this resource. Comments Resolution applies if the referenced parameter exists. Data type BackboneElement Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a
part	I	0..0	see (parameter)	There are no (further) constraints on this element Element id OperationDefinition.parameter.part Short description Parts of a nested Parameter Definition The parts of a nested Parameter. Comments Query Definitions only have one output parameter, named "result". This might not be described, but can be to allow a profile to be defined.
overload		0..0	BackboneElement	There are no (further) constraints on this element Element id OperationDefinition.overload Short description Define overloaded variants for when generating code Definition Defines an appropriate combination of parameters to use when invoking this operation, to help code generators when generating overloaded parameter sets for this operation. Comments The combinations are suggestions as to which sets of parameters to use together, but the combinations are not intended to be authoritative. Data type BackboneElement Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a

ParametersHealthIssueReferenceSe

ParametersHealthIssueReferenceSe (Parameters)			Parameters	Element id Parameters Short description Operation Request Definition This resource is a non-persisted resource used to pass information into the operation '$LinkToHealthIssue'. It has no other use, and there is no RESTful endpoint associated with it. Comments The parameters that may be used are defined by the OperationDefinition resource. Data type Parameters Mappings rim: Entity. Role, or Act v2: n/a rim: n/a
id	Σ	0..1	string	There are no (further) constraints on this element Element id Parameters.id Short description Logical id of this artifact Definition The logical id of the resource, as used in the URL for the resource. Once assigned, this value never changes. Comments The only time that a resource does not have an id is when it is being submitted to the server using a create operation. Data type string
meta	Σ	1..1	Meta	There are no (further) constraints on this element Element id Parameters.meta Short description Metadata about the resource Definition The metadata about the resource. This is content that is maintained by the infrastructure. Changes to the content might not always be associated with version changes to the resource. Data type Meta Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a rim: N/A
id		0..1	string	There are no (further) constraints on this element Element id Parameters.meta.id Short description Unique id for inter-element referencing Definition Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces. Data type string Mappings rim: n/a
extension	I	0..*	Extension	There are no (further) constraints on this element Element id Parameters.meta.extension Short description Additional content defined by implementations Alternate names extensions, user content Definition May be used to represent additional information that is not part of the basic definition of the element. 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 can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. 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. Data type Extension Sliced: Unordered, Open, by url(Value) Extensions are always sliced by (at least) url Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` ext-1: Must have either extensions or value[x], not both `extension.exists() != value.exists()` Mappings rim: n/a rim: N/A
versionId	Σ	0..1	id	There are no (further) constraints on this element Element id Parameters.meta.versionId Short description Version specific identifier Definition The version specific identifier, as it appears in the version portion of the URL. This value changes when the resource is created, updated, or deleted. Comments The server assigns this value, and ignores what the client specifies, except in the case that the server is imposing version integrity on updates/deletes. Data type id Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a
lastUpdated	Σ	0..1	instant	There are no (further) constraints on this element Element id Parameters.meta.lastUpdated Short description When the resource version last changed Definition When the resource last changed - e.g. when the version changed. Comments This value is always populated except when the resource is first being created. The server / resource manager sets this value; what a client provides is irrelevant. This is equivalent to the HTTP Last-Modified and SHOULD have the same value on a read interaction. Data type instant Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a
source	Σ	0..1	uri	There are no (further) constraints on this element Element id Parameters.meta.source Short description Identifies where the resource comes from Definition A uri that identifies the source system of the resource. This provides a minimal amount of Provenance information that can be used to track or differentiate the source of information in the resource. The source may identify another FHIR server, document, message, database, etc. Comments In the provenance resource, this corresponds to Provenance.entity.what[x]. The exact use of the source (and the implied Provenance.entity.role) is left to implementer discretion. Only one nominated source is allowed; for additional provenance details, a full Provenance resource should be used. This element can be used to indicate where the current master source of a resource that has a canonical URL if the resource is no longer hosted at the canonical URL. Data type uri Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a
profile	Σ	1..1	canonical(StructureDefinition)Fixed Value	Element id Parameters.meta.profile Short description Profiles this resource claims to conform to Definition A list of profiles (references to StructureDefinition resources) that this resource claims to conform to. The URL is a reference to StructureDefinition.url. Comments It is up to the server and/or other infrastructure of policy to determine whether/how these claims are verified and/or updated over time. The list of profile URLs is a set. Data type canonical(StructureDefinition) Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Fixed value https://fhir.cambio.se/StructureDefinition/ParametersHealthIssueReferenceSe/v1 Mappings rim: n/a
security	Σ	0..*	CodingBinding	There are no (further) constraints on this element Element id Parameters.meta.security Short description Security Labels applied to this resource Definition Security labels applied to this resource. These tags connect specific resources to the overall security policy and infrastructure. Comments The security labels can be updated without changing the stated version of the resource. The list of security labels is a set. Uniqueness is based the system/code, and version and display are ignored. Data type Coding Binding Security Labels from the Healthcare Privacy and Security Classification System. All Security Labels (extensible) Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a v2: CE/CNE/CWE subset one of the sets of component 1-3 or 4-6 rim: CV orim: fhir:Coding rdfs:subClassOf dt:CDCoding
tag	Σ	0..*	Coding	There are no (further) constraints on this element Element id Parameters.meta.tag Short description Tags applied to this resource Definition Tags applied to this resource. Tags are intended to be used to identify and relate resources to process and workflow, and applications are not required to consider the tags when interpreting the meaning of a resource. Comments The tags can be updated without changing the stated version of the resource. The list of tags is a set. Uniqueness is based the system/code, and version and display are ignored. Data type Coding Binding Codes that represent various types of tags, commonly workflow-related; e.g. "Needs review by Dr. Jones". CommonTags (example) Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a v2: CE/CNE/CWE subset one of the sets of component 1-3 or 4-6 rim: CV orim: fhir:Coding rdfs:subClassOf dt:CDCoding
implicitRules	Σ ?!	0..1	uri	There are no (further) constraints on this element Element id Parameters.implicitRules Short description A set of rules under which this content was created Definition A reference to a set of rules that were followed when the resource was constructed, and which must be understood when processing the content. Often, this is a reference to an implementation guide that defines the special rules along with other profiles etc. Comments Asserting this rule set restricts the content to be only understood by a limited set of trading partners. This inherently limits the usefulness of the data in the long term. However, the existing health eco-system is highly fractured, and not yet ready to define, collect, and exchange data in a generally computable sense. Wherever possible, implementers and/or specification writers should avoid using this element. Often, when used, the URL is a reference to an implementation guide that defines these special rules as part of it's narrative along with other profiles, value sets, etc. Data type uri Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a
language		0..1	codeBinding	There are no (further) constraints on this element Element id Parameters.language Short description Language of the resource content Definition The base language in which the resource is written. Comments Language is provided to support indexing and accessibility (typically, services such as text to speech use the language tag). The html language tag in the narrative applies to the narrative. The language tag on the resource may be used to specify the language of other presentations generated from the data in the resource. Not all the content has to be in the base language. The Resource.language should not be assumed to apply to the narrative automatically. If a language is specified, it should it also be specified on the div element in the html (see rules in HTML5 for information about the relationship between xml:lang and the html lang attribute). Data type code Binding A human language. CommonLanguages (preferred) Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a
parameter	Σ I	1..1	BackboneElement	Element id Parameters.parameter Short description Operation Parameter Definition A parameter passed to the operation. Data type BackboneElement Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` inv-1: A parameter must have one and only one of (value, resource, part) `(part.exists() and value.empty() and resource.empty()) or (part.empty() and (value.exists() xor resource.exists()))` Mappings rim: n/a
id		0..1	string	There are no (further) constraints on this element Element id Parameters.parameter.id Short description Unique id for inter-element referencing Definition Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces. Data type string Mappings rim: n/a
extension	I	0..*	Extension	There are no (further) constraints on this element Element id Parameters.parameter.extension Short description Additional content defined by implementations Alternate names extensions, user content Definition May be used to represent additional information that is not part of the basic definition of the element. 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 can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. 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. Data type Extension Sliced: Unordered, Open, by url(Value) Extensions are always sliced by (at least) url Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` ext-1: Must have either extensions or value[x], not both `extension.exists() != value.exists()` Mappings rim: n/a rim: N/A
modifierExtension	Σ ?! I	0..*	Extension	There are no (further) constraints on this element Element id Parameters.parameter.modifierExtension Short description Extensions that cannot be ignored even if unrecognized Alternate names extensions, user content, modifiers 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 in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. 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 can 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. Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself). Requirements Modifier extensions allow for extensions that cannot be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the definition of modifier extensions. 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. Data type Extension Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` ext-1: Must have either extensions or value[x], not both `extension.exists() != value.exists()` Mappings rim: n/a rim: N/A
name	Σ	1..1	stringFixed Value	Element id Parameters.parameter.name Short description Name from the definition Definition The name of the parameter (reference to the operation definition). Comments Note that FHIR strings SHALL NOT exceed 1MB in size Data type string Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Fixed value HealthIssueReference Mappings rim: n/a
value[x]	Σ I	1..1		There are no (further) constraints on this element Element id Parameters.parameter.value[x] Short description If parameter is a data type Definition If the parameter is a data type. Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a
id		0..1	string	There are no (further) constraints on this element Element id Parameters.parameter.value[x].id Short description Unique id for inter-element referencing Definition Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces. Data type string Mappings rim: n/a
extension	I	0..*	Extension	There are no (further) constraints on this element Element id Parameters.parameter.value[x].extension Short description Additional content defined by implementations Alternate names extensions, user content Definition May be used to represent additional information that is not part of the basic definition of the element. 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 can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. 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. Data type Extension Sliced: Unordered, Open, by url(Value) Extensions are always sliced by (at least) url Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` ext-1: Must have either extensions or value[x], not both `extension.exists() != value.exists()` Mappings rim: n/a rim: N/A
reference	Σ I	1..1	string	Element id Parameters.parameter.value[x].reference Short description Literal reference to the ConditionHealthIssueSe Definition Literal reference to the ConditionHealthIssueSe object that should be linked to the QuestionnaireResponse object in the format 'Condition/hi-{id}'. E.g., Condition/hi-1 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. Data type string Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a rim: N/A
type	Σ	0..0	uriBindingFixed Value	Element id Parameters.parameter.value[x].type Short description Type the reference refers to (e.g. "Patient") Definition The expected type of the target of the reference. If both Reference.type and Reference.reference are populated and Reference.reference is a FHIR URL, both SHALL be consistent. The type is the Canonical URL of Resource Definition that is the type this reference refers to. References are URLs that are relative to http://hl7.org/fhir/StructureDefinition/ e.g. "Patient" is a reference to http://hl7.org/fhir/StructureDefinition/Patient. Absolute URLs are only allowed for logical models (and can only be used in references in logical models, not resources). Comments This element is used to indicate the type of the target of the reference. This may be used which ever of the other elements are populated (or not). In some cases, the type of the target may be determined by inspection of the reference (e.g. a RESTful URL) or by resolving the target of the reference; if both the type and a reference is provided, the reference SHALL resolve to a resource of the same type as that specified. Data type uri Binding Aa resource (or, for logical models, the URI of the logical model). ResourceType (extensible) Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Fixed value Condition Mappings rim: n/a rim: N/A
identifier	Σ	0..0	Identifier	There are no (further) constraints on this element Element id Parameters.parameter.value[x].identifier Short description Logical reference, when literal reference is not known Definition An identifier for the target resource. This is used when there is no way to reference the other resource directly, either because the entity it represents is not available through a FHIR server, or because there is no way for the author of the resource to convert a known identifier to an actual location. There is no requirement that a Reference.identifier point to something that is actually exposed as a FHIR instance, but it SHALL point to a business concept that would be expected to be exposed as a FHIR instance, and that instance would need to be of a FHIR resource type allowed by the reference. Comments When an identifier is provided in place of a reference, any system processing the reference will only be able to resolve the identifier to a reference if it understands the business context in which the identifier is used. Sometimes this is global (e.g. a national identifier) but often it is not. For this reason, none of the useful mechanisms described for working with references (e.g. chaining, includes) are possible, nor should servers be expected to be able resolve the reference. Servers may accept an identifier based reference untouched, resolve it, and/or reject it - see CapabilityStatement.rest.resource.referencePolicy. When both an identifier and a literal reference are provided, the literal reference is preferred. Applications processing the resource are allowed - but not required - to check that the identifier matches the literal reference Applications converting a logical reference to a literal reference may choose to leave the logical reference present, or remove it. Reference is intended to point to a structure that can potentially be expressed as a FHIR resource, though there is no need for it to exist as an actual FHIR resource instance - except in as much as an application wishes to actual find the target of the reference. The content referred to be the identifier must meet the logical constraints implied by any limitations on what resource types are permitted for the reference. For example, it would not be legitimate to send the identifier for a drug prescription if the type were Reference(Observation\|DiagnosticReport). One of the use-cases for Reference.identifier is the situation where no FHIR representation exists (where the type is Reference (Any). Data type Identifier Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a v2: CX / EI (occasionally, more often EI maps to a resource id or a URL) rim: II - The Identifier class is a little looser than the v3 type II because it allows URIs as well as registered OIDs or GUIDs. Also maps to Role[classCode=IDENT] servd: Identifier rim: .identifier
display	Σ	0..0	string	There are no (further) constraints on this element Element id Parameters.parameter.value[x].display Short description Text alternative for the resource Definition Plain text narrative that identifies the resource in addition to the resource reference. 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. Data type string Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a rim: N/A
valueReference			Reference()	Data type Reference()
resource	Σ I	0..0	Resource	There are no (further) constraints on this element Element id Parameters.parameter.resource Short description If parameter is a whole resource Definition If the parameter is a whole resource. Comments When resolving references in resources, the operation definition may specify how references may be resolved between parameters. If a reference cannot be resolved between the parameters, the application should fall back to it's general resource resolution methods. Data type Resource Mappings rim: Entity. Role, or Act
part	Σ	0..0	see (parameter)	There are no (further) constraints on this element Element id Parameters.parameter.part Short description Named part of a multi-part parameter Definition A named part of a multi-part parameter. Comments Only one level of nested parameters is allowed.

Versions

COS version	Profile version	Required COSMIC version	Date	Description
4.5.0	1.0.0	4.0.0	Sep 2024	Initial version, support for POST $linkToHealthIssue.

Supported Operations

HTTP Methods

Method	Description	Scope
POST	Link a QuestionnaireResponseSe to a ConditionHealthIssueSe belonging to the same patient.	system/QuestionnaireResponse.write OR user/QuestionnaireResponse.write OR patient/QuestionnaireResponse.write

Query Operations

Input Parameters

Path parameters: The literal ID of the QuestionnaireResponse
Body parameters: The literal ID of the ConditionHealthIssueSe to be linked via the ParametersHealthIssueReferenceSe profile

Supported Queries

POST [baseURL]/QuestionnaireResponse/{id}/$linkToHealthIssue

Response Codes

Scenario	Response code	Description
API request is a success.	200 OK	-
Path parameter "id": Empty	400 Bad Request	Invalid request: The FHIR endpoint on this server does not know how to handle POST operation[QuestionnaireResponse/$linkToHealthIssue] with parameters [[]]
Path parameter "id": Journal note doesn't exist in Cosmic	404 Not Found	Invalid parameters: QuestionnaireResponseSe not found.
Path parameter "id": Invalid input type	500 Internal Server Error	-
Body parameter "resourceType": Empty, NULL, or not supplied	400 Bad Request	HAPI-0450: Failed to parse request body as JSON resource. Error was: HAPI-1838: Invalid JSON content detected, missing required element: 'resourceType'
Body parameter "resourceType": A different value than 'Parameters'	400 Bad Request	HAPI-0450: Failed to parse request body as JSON resource. Error was: HAPI-1684: Unknown resource name "<supplied value>" (this name is not known in FHIR version "R4")
Body parameter "meta": Empty, NULL, or Not supplied	400 Bad Request	Parameters must contain a valid meta profile
Body parameter "meta.profile": Empty	400 Bad Request	HAPI-0450: Failed to parse request body as JSON resource. Error was: HAPI-1821: [element="profile"] Invalid attribute value "": Attribute value must not be empty ("")
Body parameter "meta.profile": NULL	400 Bad Request	Parameters must contain a valid meta profile
Body parameter "meta.profile": Not supplied	400 Bad Request	Parameters must contain a valid meta profile
Body parameter "meta.profile": Wrong profile url value	422 Unprocessable Entity	Profile reference 'https://fhir.cambio.se/StructureDefinition/ParametersHealthIssueReferenceSee/v1' has not been checked because it is unknown
Body parameter "parameter": Empty, NULL, or Not supplied	422 Unprocessable Entity	Parameters.parameter: minimum required = 1, but only found 0 (from https://fhir.cambio.se/StructureDefinition/ParametersHealthIssueReferenceSe/v1)
Body parameter "parameter.name": Empty	400 Bad Request	HAPI-0450: Failed to parse request body as JSON resource. Error was: HAPI-1821: [element="name"] Invalid attribute value "": Attribute value must not be empty ("")
Body parameter "parameter.name": NULL, or Not supplied	422 Unprocessable Entity	Parameters.parameter.name: minimum required = 1, but only found 0 (from https://fhir.cambio.se/StructureDefinition/ParametersHealthIssueReferenceSe/v1)
Body parameter "parameter.name": A different value other than "HealthIssueReference"	422 Unprocessable Entity	Value is '<supplied value>' but must be 'HealthIssueReference'
Body parameter "parameter.valueReference": Empty, or Not supplied	422 Unprocessable Entity	inv-1: 'A parameter must have one and only one of (value, resource, part)' Rule 'A parameter must have one and only one of (value, resource, part)' Failed
Body parameter "parameter.valueReference.reference": Empty	400 Bad Request	HAPI-0450: Failed to parse request body as JSON resource. Error was: HAPI-1821: [element="reference"] Invalid attribute value "": Attribute value must not be empty ("")
Body parameter "parameter.valueReference.reference": NULL, or Not supplied	422 Unprocessable Entity	inv-1: 'A parameter must have one and only one of (value, resource, part)' Rule 'A parameter must have one and only one of (value, resource, part)' Failed
Body parameter "parameter.valueReference.reference": Not in the format 'Codition/hi-< id >'	400 Bad Request	Invalid request: The supplied condition ID is not supported
Body parameter "parameter.valueReference.reference": Invalid input type	400 Bad Request	HealthIssueReference must contain a valid reference
Body parameter "parameter.valueReference.reference": Health issue doesn't exist in Cosmic	400 Bad Request	Invalid parameters: ConditionHealthIssueSe not found
Body parameter "parameter.valueReference.reference": Health issue status is not Ongoing or Closed.	400 Bad Request	Invalid parameters: The supplied ConditionHealthIssueSe is not in Ongoing or Closed status
If the supplied journal note and the health issue do not belong to the same patient.	400 Bad Request	Invalid parameters: Supplied QuestionnaireResponseSe and ConditionHealthIssueSe do not belong to the same patient
If a link already exist for the supplied health issue and journal note.	409 Conflict	The supplied QuestionnaireResponse & ConditionHealthIssue are already linked
If an unsupported scope is supplied.	403 Forbidden	-

For common codes, refer to Error handling section.