R4 Ballot #1 (Mixed Normative/Trial use)

This page is part of the FHIR Specification (v3.3.0: R4 Ballot 2). The current version which supercedes this version is 5.0.0. For a full list of available versions, see the Directory of published versions . Page versions: R5 R4B R4 R3 R2

FHIR Infrastructure Work GroupMaturity Level: 5 Normative Compartments: Not linked to any defined compartments

Detailed Descriptions for the elements in the OperationOutcome resource.

OperationOutcome
Element IdOperationOutcome
Definition

A collection of error, warning or information messages that result from a system action.

Control1..1
Summarytrue
Comments

Can result from the failure of a REST call or be part of the response message returned from a request message. If sent with extensions overriding particular issues, might even appear as part of a request message.

OperationOutcome.issue
Element IdOperationOutcome.issue
Definition

An error, warning or information message that results from a system action.

Control1..*
Summarytrue
OperationOutcome.issue.severity
Element IdOperationOutcome.issue.severity
Definition

Indicates whether the issue indicates a variation from successful processing.

Control1..1
Terminology BindingIssueSeverity (Required)
Typecode
Is Modifiertrue (Reason: Indicates whether the OperationOutcome indicates a failure or a success)
Requirements

Indicates how relevant the issue is to the overall success of the action.

Summarytrue
Comments

This is labeled as "Is Modifier" because applications should not confuse hints and warnings with errors.

OperationOutcome.issue.code
Element IdOperationOutcome.issue.code
Definition

Describes the type of the issue. The system that creates an OperationOutcome SHALL choose the most applicable code from the IssueType value set, and may additional provide its own code for the error in the details element.

Control1..1
Terminology BindingIssueType (Required)
Typecode
Requirements

Expresses the issue in a human and computer-friendly way, allowing the requesting system to behave differently based on the type of issue.

Summarytrue
OperationOutcome.issue.details
Element IdOperationOutcome.issue.details
Definition

Additional details about the error. This may be a text description of the error, or a system code that identifies the error.

Control0..1
Terminology BindingOperation Outcome Codes (Example)
TypeCodeableConcept
Summarytrue
Comments

A human readable description of the error issue SHOULD be placed in details.text.

OperationOutcome.issue.diagnostics
Element IdOperationOutcome.issue.diagnostics
Definition

Additional diagnostic information about the issue. Typically, this may be a description of how a value is erroneous, or a stack dump to help trace the issue.

Control0..1
Typestring
Summarytrue
Comments

Typically, this field is used to provide troubleshooting information about the error.

OperationOutcome.issue.location
Element IdOperationOutcome.issue.location
Definition

For resource issues, this will be a simple XPath limited to element names, repetition indicators and the default child access that identifies one of the elements in the resource that caused this issue to be raised. For HTTP errors, will be "http." + the parameter name.

Control0..*
Typestring
Requirements

Allows systems to highlight or otherwise guide users to elements implicated in issues to allow them to be fixed more easily.

Summarytrue
Comments

The root of the XPath is the resource or bundle that generated OperationOutcome. Each XPath SHALL resolve to a single node. The XPath syntax is used whether the referenced instance is expressed in XML or JSON. Note that expression is being trialed as an alternative to XPath.

OperationOutcome.issue.expression
Element IdOperationOutcome.issue.expression
Definition

A simple subset of FHIRPath limited to element names, repetition indicators and the default child access that identifies one of the elements in the resource that caused this issue to be raised.

Control0..*
Typestring
Requirements

Allows systems to highlight or otherwise guide users to elements implicated in issues to allow them to be fixed more easily.

Summarytrue
Comments

The root of the FHIRPath is the resource or bundle that generated OperationOutcome. Each FHIRPath SHALL resolve to a single node.