From eabbd56c95534b41a280db02a22c1ef5e4c5d175 Mon Sep 17 00:00:00 2001 From: "WHQ_NT_DOMAIN\\SP071896" Date: Thu, 14 Oct 2021 06:39:37 -0400 Subject: [PATCH 1/4] Intial cut for careteam resource --- content/soarian/r4/clinical.md | 11 + content/soarian/r4/clinical/care-provision.md | 8 + .../r4/clinical/care-provision/careteam.md | 135 +++++++++ layouts/soarian/r4/clinical.html | 3 + .../soarian/r4/clinical/care-provision.html | 5 + layouts/soarian/r4/sidebar.html | 9 +- .../soarian_r4_examples_careteam.rb | 272 ++++++++++++++++++ lib/resources/r4/soarian_care_team.yaml | 55 ++++ 8 files changed, 497 insertions(+), 1 deletion(-) create mode 100644 content/soarian/r4/clinical.md create mode 100644 content/soarian/r4/clinical/care-provision.md create mode 100644 content/soarian/r4/clinical/care-provision/careteam.md create mode 100644 layouts/soarian/r4/clinical.html create mode 100644 layouts/soarian/r4/clinical/care-provision.html create mode 100644 lib/resources/example_json/soarian_r4_examples_careteam.rb create mode 100644 lib/resources/r4/soarian_care_team.yaml diff --git a/content/soarian/r4/clinical.md b/content/soarian/r4/clinical.md new file mode 100644 index 000000000..dd047ae8e --- /dev/null +++ b/content/soarian/r4/clinical.md @@ -0,0 +1,11 @@ +--- +title: Clinical | R4 API +layout: api +--- + +<%= render '/soarian/r4/clinical.*' %> + +## Care Provision +<%= render '/soarian/r4/clinical/care-provision.*' %> + +* [CareTeam](/soarian/r4/clinical/care-provision/careteam) diff --git a/content/soarian/r4/clinical/care-provision.md b/content/soarian/r4/clinical/care-provision.md new file mode 100644 index 000000000..827864fb1 --- /dev/null +++ b/content/soarian/r4/clinical/care-provision.md @@ -0,0 +1,8 @@ +--- +title: Care Provision | R4 API +layout: api +--- + +<%= render '/soarian/r4/clinical/care-provision.*' %> + +* [CareTeam](../care-provision/careteam) diff --git a/content/soarian/r4/clinical/care-provision/careteam.md b/content/soarian/r4/clinical/care-provision/careteam.md new file mode 100644 index 000000000..ccca47372 --- /dev/null +++ b/content/soarian/r4/clinical/care-provision/careteam.md @@ -0,0 +1,135 @@ +--- +title: CareTeam | R4 API +--- + +# CareTeam + +* TOC +{:toc} + +## Overview + +The CareTeam resource represents a patient’s care team members. Care team members or participants include medical practitioners (physicians, nurses, technicians, and so on), family members, and guardians. The care team can be specific to an encounter or to the patient across all encounters (longitudinal). + +Soarian Clinicals® supports a read-only Application Programming Interface (API). This API accepts `GET` and `POST` based [search] and and `GET` based [read] interactions. The response represents the most current information about the patient that is charted in Soarian Clinicals® at the time of the query. + +The search results include the following fields if they contain values: + +* [Care Team id](https://hl7.org/fhir/resource-definitions.html#Resource.id){:target="_blank"} +* [Status](https://hl7.org/fhir/careteam-definitions.html#CareTeam.status){:target="_blank"} +* [Category (Longitudinal or Encounter)](https://hl7.org/fhir/careteam-definitions.html#CareTeam.category){:target="_blank"} +* [Subject (Patient only](https://hl7.org/fhir/careteam-definitions.html#CareTeam.subject){:target="_blank"} +* [Encounter (Encounter Category only)](https://hl7.org/fhir/careteam-definitions.html#CareTeam.encounter){:target="_blank"} +* [Participant](https://hl7.org/fhir/careteam-definitions.html#CareTeam.participant){:target="_blank"} + * [Role](https://hl7.org/fhir/careteam-definitions.html#CareTeam.participant.role){:target="_blank"} + * [Member](https://hl7.org/fhir/careteam-definitions.html#CareTeam.participant.member){:target="_blank"} (references to RelatedPerson are contained) + * [RelatedPerson patient](https://hl7.org/fhir/R4/relatedperson-definitions.html#RelatedPerson.patient){:target="_blank"} + * [RelatedPerson relationship](https://hl7.org/fhir/R4/relatedperson-definitions.html#RelatedPerson.relationship){:target="_blank"} (text only) + * [RelatedPerson name](https://hl7.org/fhir/R4/relatedperson-definitions.html#RelatedPerson.name){:target="_blank"} + +## Terminology Bindings + +<%= terminology_table(:soarian_care_team, :r4) %> + +## Search + +Search for CareTeam resources that meet the specified query parameters: + + GET /CareTeam?:parameters + + +### Authorization Types + +<%= authorization_types(provider: true, patient: true)%> + +### Parameters + + Name | Required? | Type | Description +---------------|----------------------------------------------|------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------- + `_id` | This, or `patient` | [`token`] | The logical resource ID associated with the resource. + `patient` | This, or `_id` | [`reference`] | The patient who has the care team. + `encounter` | No | [`reference`] | The encounter associated with the care team + `status` | No | [`token`] | The status of the care team. May be a list separated by commas. + `_revinclude` | No | [`_revinclude`] | A request to include any Provenance resource in the bundle that refers to an Immunization resource in the search results. Only supported with Provenance. + + + Notes + +* The `status` parameter only supports the codes `active` and `inactive`. +* The `_revinclude` parameter may be provided once with the value `Provenance:target`. Example: `_revinclude=Provenance:target` +* When `_revinclude` is provided in a request, the OAuth2 token must include the `patient/Provenance.read system/Provenance.read` or `user/Provenance.read` scope as applicable. + + +### Headers + +<%= headers fhir_json: true %> + +### Example Search by Patient + +#### Request + + GET https://fhir-myrecord-sc.sandboxcerner.com/r4/3f2aca24-87f3-4eac-a6d7-1f75247e6b43/CareTeam?patient=A879904FD2FE4B2D90C89FDA84E1285F + +#### Response + +<%= headers status: 200 %> +<%= json(:SOARIAN_R4_CARETEAM_SEARCH_BY_PT) %> + +Note: The examples provided here are non-normative and replaying them in the public sandbox is not guaranteed to yield the results shown on the site + +### Example Search by ID + +#### Request + + GET https://fhir-myrecord-sc.sandboxcerner.com/r4/3f2aca24-87f3-4eac-a6d7-1f75247e6b43/CareTeam?_id=A879904FD2FE4B2D90C89FDA84E1285F.LCC + +#### Response + +<%= headers status: 200 %> +<%= json(:SOARIAN_R4_CARETEAM_SEARCH_BY_ID) %> + +Note: The examples provided here are non-normative and replaying them in the public sandbox is not guaranteed to yield the results shown on the site. + +### Errors + +The common [errors](../../#client-errors) and [OperationOutcomes](https://www.hl7.org/fhir/r4/operationoutcome.html) may be returned. + +## Retrieve by ID + +List an individual CareTeam resource by its ID: + + GET /CareTeam/:id + +## Authorization Types + +<%= authorization_types(provider: true, patient: true)%> + +### Headers + +<%= headers fhir_json: true %> + +### Example + +#### Request + + GET https://fhir-myrecord-sc.sandboxcerner.com/r4/3f2aca24-87f3-4eac-a6d7-1f75247e6b43/CareTeam/A879904FD2FE4B2D90C89FDA84E1285F.LCC + +#### Response + +<%= headers status: 200 %> +<%= json(:SOARIAN_R4_CARETEAM_READ) %> + +Note: The examples provided here are non-normative and replaying them in the public sandbox is not guaranteed to yield the results shown on the site. + +### Errors + +The common [errors] and [OperationOutcomes] may be returned. + + +[search]: https://www.hl7.org/fhir/http.html#search +[read]: https://www.hl7.org/fhir/http.html#read +[`token`]: https://hl7.org/fhir/R4/search.html#token +[`reference`]: https://hl7.org/fhir/r4/search.html#reference +[`_revinclude`]: https://www.hl7.org/fhir/search.html#revinclude +[errors]: ../../#client-errors +[OperationOutcomes]: https://hl7.org/fhir/R4/operationoutcome.html diff --git a/layouts/soarian/r4/clinical.html b/layouts/soarian/r4/clinical.html new file mode 100644 index 000000000..4121833d6 --- /dev/null +++ b/layouts/soarian/r4/clinical.html @@ -0,0 +1,3 @@ +

Clinical

+ +

The Clinical category of HL7® FHIR® resources includes Summary, Diagnostics, Medications, Care Provision and Request & Response.

diff --git a/layouts/soarian/r4/clinical/care-provision.html b/layouts/soarian/r4/clinical/care-provision.html new file mode 100644 index 000000000..003a723e4 --- /dev/null +++ b/layouts/soarian/r4/clinical/care-provision.html @@ -0,0 +1,5 @@ +

Care Provision resources are used to plan and provision care and treatment.

+ +

Click here to see the detailed categorization and full set of resources that fall into this category in the HL7® FHIR® Standard.

+ +

Implemented Resources

diff --git a/layouts/soarian/r4/sidebar.html b/layouts/soarian/r4/sidebar.html index fa276e50e..a949d9de7 100644 --- a/layouts/soarian/r4/sidebar.html +++ b/layouts/soarian/r4/sidebar.html @@ -16,7 +16,14 @@

  • Individuals
  • Patient
  • - + +
  • +

    Clinical

    + +