{
  "description": "Sets the SMART Launch context parameters within the SoFA with support for creating resources if needed.",
  "_filename": "profiles/OperationDefinition-set-context.json",
  "package_name": "ca.infoway.io.halo",
  "date": null,
  "system": true,
  "publisher": null,
  "instance": false,
  "name": "SetContext",
  "type": "false",
  "experimental": "false",
  "outputProfile": "http://fhir.infoway-inforoute.ca/io/HALO/StructureDefinition/set-context-output-parameters",
  "resourceType": "OperationDefinition",
  "title": "Set Context",
  "package_version": "1.0.0-dft-preballot",
  "status": "active",
  "id": "06e007e6-ce78-41ee-a52d-c4457db48557",
  "kind": "operation",
  "url": "http://fhir.infoway-inforoute.ca/io/HALO/OperationDefinition/set-context",
  "code": "set-context",
  "version": "1.0.0",
  "inputProfile": "http://fhir.infoway-inforoute.ca/io/HALO/StructureDefinition/set-context-input-parameters",
  "parameter": [ {
    "max": "1",
    "min": 0,
    "use": "in",
    "name": "appID",
    "type": "string",
    "documentation": "The ID of the SMART App for which the context is being set. This SHALL be the app's ID as listed within the jurisdictional App Catalog. This parameter is optional for the current release of HALO; however, jurisdictions may choose to require its presence. In such cases, the requirement of this parameter will be communicated to PoC vendors out of band."
  }, {
    "max": "1",
    "min": 0,
    "use": "in",
    "name": "patient",
    "type": "Reference",
    "documentation": "A reference to the current Patient in context. This SHALL be a reference to a resource contained within the `resources` Bundle parameter, or a resource that already exists within the SoFA (depending on the Jurisdictional implementation)."
  }, {
    "max": "1",
    "min": 0,
    "use": "in",
    "name": "encounter",
    "type": "Reference",
    "documentation": "A reference to the current Encounter in context. This SHALL be a reference to a resource contained within the `resources` Bundle parameter, or a resource that already exists within the SoFA (depending on the Jurisdictional implementation)."
  }, {
    "max": "*",
    "min": 0,
    "use": "in",
    "name": "fhirContext",
    "type": "Reference",
    "documentation": "References to other resources that are related to the current context. These SHALL be references to resources contained within the `resources` Bundle parameter, or resources that already exists within the SoFA (depending on the Jurisdictional implementation)."
  }, {
    "max": "1",
    "min": 0,
    "use": "in",
    "name": "fhirUser",
    "type": "Reference",
    "documentation": "A reference to the user (i.e., PractitionerRole) who is initiating the launch. This will be communicated to the SMART App via the fhirUser claim within the ID Token when the `openid` or `fhirUser` scope is requested. This SHALL be a reference to a resource contained within the `resources` Bundle parameter, or a resource that already exists within the SoFA (depending on the Jurisdictional implementation)."
  }, {
    "max": "1",
    "min": 0,
    "use": "in",
    "name": "need_patient_banner",
    "type": "boolean",
    "documentation": "The SMART on FHIR need_patient_banner launch context parameter."
  }, {
    "max": "1",
    "min": 0,
    "use": "in",
    "name": "intent",
    "type": "string",
    "documentation": "The SMART on FHIR intent launch context parameter."
  }, {
    "max": "1",
    "min": 0,
    "use": "in",
    "name": "smart_style_url",
    "type": "string",
    "documentation": "The SMART on FHIR smart_style_url launch context parameter."
  }, {
    "max": "1",
    "min": 0,
    "use": "in",
    "name": "tenant",
    "type": "string",
    "documentation": "The SMART on FHIR tenant launch context parameter."
  }, {
    "max": "1",
    "min": 0,
    "use": "in",
    "name": "resources",
    "type": "Bundle",
    "documentation": "A [SetContextTransactionBundle](https://simplifier.net/halo/setcontexttransactionbundle) capturing the resources to be populated within the SoFA as a result of the $set-context operation. The bundle type is `transaction` and SHALL only contain resources which are covered by and conform to the profiles defined in [CA Core+](https://simplifier.net/ca-core)."
  }, {
    "max": "1",
    "min": 0,
    "use": "out",
    "name": "launchID",
    "type": "string",
    "documentation": "An opaque identifier generated for this operation, representing the context set, such as patient or user session information. The launchID SHALL always be populated for a successful $set-context operation."
  }, {
    "max": "1",
    "min": 0,
    "use": "out",
    "name": "resourcesResponse",
    "type": "Bundle",
    "documentation": "A [SetContextTransactionResponseBundle](https://simplifier.net/halo/setcontexttransactionresponsebundle) which communicates the outcome of the create interaction on the SoFA for each resource included in the input transaction Bundle of the $set-context operation. The bundle type is `transaction-response` and SHALL be present if there was a corresponding Bundle provided in the input and the resulting transaction was successful. If present, the output Bundle SHALL contain one entry per entry in the corresponding input `transaction` Bundle. This parameter is required if the `resources` parameter was provided in the input."
  }, {
    "max": "*",
    "min": 1,
    "use": "out",
    "name": "outcome",
    "type": "OperationOutcome",
    "documentation": "An OperationOutcome resource detailing the outcome (e.g., success, failure) of the operation."
  } ]
}