Review and Corrections for Condition (#996)

* example corrections and link fixes for condition * added security field
cerner · Oct 20, 2023 · b1d03f7 · b1d03f7
1 parent 5db83a3
commit b1d03f7
Show file tree

Hide file tree

Showing 5 changed files with 153 additions and 131 deletions.
diff --git a/content/millennium/dstu2/general-clinical/condition.md b/content/millennium/dstu2/general-clinical/condition.md
@@ -137,8 +137,8 @@ _Implementation Notes_
     * If `Condition.dateRecorded` is set on the request body, its value will currently be ignored.
   * Creating Conditions with a category code of [health-concern](https://argonautwiki.hl7.org/Argonaut_Condition_Category_Codes) is not currently supported.
 * The code.coding field can have at most 2 codings.
-  * One of the codings must have userSelected: true
-  * The other coding must have userSelected: false
+  * One of the codings must have `userSelected: true`
+  * The other coding must have `userSelected: false`
 * A Condition with a category code of diagnosis will be automatically prioritized to the least significant priority by the Cerner Millennium EHR.
 
 ### Authorization Types
@@ -235,7 +235,7 @@ _Implementation Notes_
 
 * Any field which is missing will be interpreted as nulling out or removing data from the resource. See [FHIR<sup>®</sup> Update] for additional details about update operations.
 * Currently, `health-concern` category code is not supported for updating conditions.
-* The code.coding field can have at most 2 codings, one of which must be set as userSelected true and the other one must be set as userSelected false.
+* The code.coding field can have at most 2 codings, one of which must be set as `userSelected: true` and the other one must be set as `userSelected: false`.
 
 ### Authorization Types
 

diff --git a/content/millennium/r4/clinical/summary/condition.md b/content/millennium/r4/clinical/summary/condition.md
@@ -69,19 +69,16 @@ _Implementation Notes_
  `subject`         | This or `_id` or `patient`     | [`reference`] | Who the condition is for. Example: `Patient/12345`
  `clinical-status` | No                             | [`token`]     | The clinical status of the condition. Example: `active`, `inactive`, `resolved`
  `category`        | No                             | [`token`]     | The category of the condition. Categories problem-list-item, encounter-diagnosis and health-concern are supported as of now. Example: `problem-list-item`, `encounter-diagnosis`, `health-concern`
- `_revinclude`     | No                             | [`token`]     | Provenance resource entries to be returned as part of the bundle. Example:_revinclude=Provenance:target
+ `_revinclude`     | No                             | [`token`]     | Provenance resource entries to be returned as part of the bundle. Example:`_revinclude=Provenance:target`
  `encounter`       | No                             | [`reference`] | The encounter ID/s for the patient. Encounter-diagnosis conditions that match the encounter ID/s and all problem-list-item conditions of the patient are returned. Example: `encounter=97733489`
 
 Notes:
 
 * If `_id` is provided, no other parameters may be provided.
-
-* The `_revinclude` parameter may be provided once with the value `Provenance:target`. Example: `_revinclude=Provenance:target`
-
-* The `_revinclude` parameter may be provided with the `_id/patient` parameter. Example: `_id=82c1c95c-83bb-47d2-86d7-7961aa996082&_revinclude=Provenance:target`
-
+* The `_revinclude` parameter may
+  * be provided once with the value `Provenance:target`. Example: `_revinclude=Provenance:target`
+  * be provided with the `_id/patient` parameter. Example: `_id=82c1c95c-83bb-47d2-86d7-7961aa996082&_revinclude=Provenance:target`
 * When `_revinclude` is provided in a request to the closed endpoint, the OAuth2 token must include the `user/Provenance.read` scope. Currently `patient/Provenance.read` is not supported and hence `_revinclude` cannot be utilised for patient persona.
-
 * When `encounter` is provided, encounter-diagnosis for the matched encounter/s and all problem-list-item conditions of the patient will be returned. No HealthConcerns are returned.
 
 ### Headers
@@ -162,7 +159,7 @@ List an individual Condition by its id:
 
 #### Patient Authorization Request For Resolved Status
 
-    GET https://fhir-ehr.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Condition/p109117485
+    GET https://fhir-ehr.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Condition/p73875571
 
 #### Response
 
@@ -184,7 +181,7 @@ List an individual Condition by its id:
 
 #### Patient Authorization Request For Entered in Error Status
 
-    GET https://fhir-ehr.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Condition/d2266495305
+    GET https://fhir-ehr.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Condition/p73703587
 
 #### Response
 
@@ -208,8 +205,8 @@ _Implementation Notes_
 * The Condition Create API supports only the API fields mentioned below. Unsupported fields will be ignored.
 * Modifier fields should not be provided, and will cause the transaction to fail.
 * The code.coding field can have at most 2 codings.
-  * One of the codings must have userSelected: true
-  * The other coding must have userSelected: false
+  * One of the codings must have `userSelected: true`
+  * The other coding must have `userSelected: false`
 * The Condition Create API currently supports only Conditions with a category of `problem-list-item` or `encounter-diagnosis`.
 * An `encounter-diagnosis` Condition will be automatically prioritized to the least significant priority by the Cerner Millennium EHR.
 * On FHIR write of an encounter-diagnosis, the diagnosis will automatically receive the next available diagnosis priority within the problem list component.
@@ -269,7 +266,7 @@ _Implementation Notes_
 
 * Currently `problem-list-item` and `encounter-diagnosis` are supported.
 * Any field which is missing will be interpreted as nulling out or removing data from the resource. See [FHIR<sup>®</sup> Update] for additional details about update operations.
-* The code.coding field can have at most 2 codings, one of which must be set as userSelected true and the other one must be set as userSelected false.
+* The code.coding field can have at most 2 codings, one of which must be set as `userSelected: true` and the other one must be set as `userSelected: false`.
 
 ### Authorization Types
 

diff --git a/lib/resources/dstu2/condition.yaml b/lib/resources/dstu2/condition.yaml
@@ -85,10 +85,10 @@ fields:
       info_link: http://hl7.org/fhir/dstu2/snomedct.html
     - display: ICD-9-CM
       system: http://hl7.org/fhir/sid/icd-9-cm
-      info_link: http://hl7.org/fhir/icd.html
+      info_link: https://terminology.hl7.org/ICD.html#icd-9-variants
     - display: ICD-10-CM
       system: http://hl7.org/fhir/sid/icd-10-cm
-      info_link: http://hl7.org/fhir/icd.html
+      info_link: https://terminology.hl7.org/CodeSystem-icd10CM.html
 
 - name: category
   required: 'No'

diff --git a/lib/resources/example_json/r4_examples_condition.rb b/lib/resources/example_json/r4_examples_condition.rb
@@ -102,11 +102,11 @@ module Resources
     }.freeze
 
     R4_PATIENT_CONDITION_ENTRY ||= {
-      'resourceType': 'Condition',
-      'id': 'p109117485',
-      'meta': {
-        'versionId': '109117485',
-        'lastUpdated': '2020-06-11T04:05:04.000Z',
+      "resourceType": 'Condition',
+      "id": 'p73875571',
+      "meta": {
+        "versionId": '73936721',
+        "lastUpdated": '2023-08-01T16: 09: 08.000Z',
         'security': [
           {
             'system': 'http://terminology.hl7.org/CodeSystem/v3-ActCode',
@@ -122,151 +122,176 @@ module Resources
           }
         ]
       },
-      'text': {
-        'status': 'generated',
-        'div': '<div xmlns="http://www.w3.org/1999/xhtml"><p><b>Condition</b></p><p><b>Patient</b>: SMART, NANCY'\
-               '</p><p><b>Problem</b>: Pregnant, Patient currently pregnant (finding)</p>'\
-               '<p><b>Category Classification</b>: Medical</p><p><b>Clinical Status</b>: Resolved</p>'\
-               '<p><b>Verification Status</b>: Confirmed</p><p><b>Onset</b>: Jun 12, 2019</p>'\
-               '<p><b>Resolved</b>: Apr  4, 2020  5:00 P.M. UTC</p></div>'
+      "text": {
+        "status": 'generated',
+        # rubocop:disable Layout/LineLength
+        "div": '<div xmlns=\"http://www.w3.org/1999/xhtml\"><p><b>Condition</b></p><p><b>Patient</b>: Smart II, Nancy</p><p><b>Problem</b>: Opioid abuse, Opioid abuse</p><p><b>Category Classification</b>: Medical</p><p><b>Clinical Status</b>: Resolved</p><p><b>Verification Status</b>: Confirmed</p></div>'
+        # rubocop:enable Layout/LineLength
       },
-      'clinicalStatus': {
-        'coding': [
+      "clinicalStatus": {
+        "coding": [
           {
-            'system': 'http://terminology.hl7.org/CodeSystem/condition-clinical',
-            'code': 'resolved',
-            'display': 'Resolved',
-            'userSelected': false
+            "system": 'http: //terminology.hl7.org/CodeSystem/condition-clinical',
+            "code": 'resolved',
+            "display": 'Resolved',
+            "userSelected": false
           }
         ],
-        'text': 'Resolved'
+        "text": 'Resolved'
       },
-      'verificationStatus': {
-        'coding': [
+      "verificationStatus": {
+        "coding": [
           {
-            'system': 'http://terminology.hl7.org/CodeSystem/condition-ver-status',
-            'code': 'confirmed',
-            'display': 'Confirmed',
-            'userSelected': false
+            "system": 'http: //terminology.hl7.org/CodeSystem/condition-ver-status',
+            "code": 'confirmed',
+            "display": 'Confirmed',
+            "userSelected": false
           }
         ],
-        'text': 'Confirmed'
+        "text": 'Confirmed'
       },
-      'category': [
+      "category": [
         {
-          'coding': [
+          "coding": [
             {
-              'system': 'http://terminology.hl7.org/CodeSystem/condition-category',
-              'code': 'problem-list-item',
-              'display': 'Problem List Item'
+              "system": 'http: //terminology.hl7.org/CodeSystem/condition-category',
+              "code": 'problem-list-item',
+              "display": 'Problem List Item'
             }
           ],
-          'text': 'Problem List Item'
+          "text": 'Problem List Item'
         },
         {
-          'coding': [
+          "coding": [
             {
-              'system': 'http://snomed.info/sct',
-              'code': '74188005',
-              'display': 'Medical (qualifier value)',
-              'userSelected': false
+              "system": 'http: //snomed.info/sct',
+              "code": '74188005',
+              "display": 'Medical (qualifier value)',
+              "userSelected": false
             }
           ],
-          'text': 'Medical'
+          "text": 'Medical'
         }
       ],
-      'code': {
-        'coding': [
+      "code": {
+        "coding": [
           {
-            'system': 'http://snomed.info/sct',
-            'code': '77386006',
-            'display': 'Patient currently pregnant (finding)',
-            'userSelected': true
+            "system": 'http: //e-imo.com/products/problem-it',
+            "code": '87295',
+            "display": 'Opioid abuse',
+            "userSelected": false
+          },
+          {
+            "system": 'http: //snomed.info/sct',
+            "code": '5602001',
+            "display": 'Opioid abuse (disorder)',
+            "userSelected": false
           }
         ],
-        'text': 'Pregnant'
+        "text": 'Opioid abuse'
       },
-      'subject': {
-        'reference': 'Patient/12742400',
-        'display': 'SMART, NANCY'
+      "subject": {
+        "reference": 'Patient/12724066',
+        "display": 'Smart II, Nancy'
       },
-      'onsetDateTime': '2019-06-12',
-      'abatementDateTime': '2020-04-04T17:00:00.000Z',
-      'recordedDate': '2020-03-05T16:54:50.000Z'
+      "recordedDate": '2023-05-21T02: 19: 13.000Z',
+      "recorder": {
+        "reference": 'Practitioner/12742069',
+        "display": 'Portal, Portal'
+      }
     }.freeze
 
     R4_PATIENT_ENTERED_IN_ERROR_ENTRY ||= {
-      'resourceType': 'Condition',
-      'id': 'd2266495305',
-      'meta': {
-        'versionId': '2266495305',
-        'lastUpdated': '2020-06-11T04:05:04.000Z',
-        'security': [
+      "resource": {
+        "resourceType": 'Condition',
+        "id": 'p73703587',
+        "meta": {
+          "versionId": '73875225',
+          "lastUpdated": '2023-05-20T19:17:15.000Z',
+          'security': [
+            {
+              'system': 'http://terminology.hl7.org/CodeSystem/v3-ActCode',
+              'code': 'PHY',
+              'display': 'physician requested information sensitivity',
+              'userSelected': false
+            },
+            {
+              'system': 'http://terminology.hl7.org/CodeSystem/v3-ActCode',
+              'code': 'PRS',
+              'display': 'patient requested information sensitivity',
+              'userSelected': false
+            }
+          ]
+        },
+        "text": {
+          "status": 'generated',
+          # rubocop:disable Layout/LineLength
+          "div": '<div xmlns=\"http://www.w3.org/1999/xhtml\"><p><b>Condition</b></p><p><b>Patient</b>: Smart II, Nancy</p><p><b>Problem</b>: Therapeutic drug monitoring, Patient encounter status (finding)</p><p><b>Category Classification</b>: Medical</p><p><b>Verification Status</b>: Entered in Error</p><p><b>Onset</b>: Aug 19, 2003</p></div>'
+          # rubocop:enable Layout/LineLength
+        },
+        "verificationStatus": {
+          "coding": [
+            {
+              "system": 'http://terminology.hl7.org/CodeSystem/condition-ver-status',
+              "code": 'entered-in-error',
+              "display": 'Entered in Error'
+            }
+          ],
+          "text": 'Entered in Error'
+        },
+        "category": [
           {
-            'system': 'http://terminology.hl7.org/CodeSystem/v3-ActCode',
-            'code': 'PHY',
-            'display': 'physician requested information sensitivity',
-            'userSelected': false
+            "coding": [
+              {
+                "system": 'http://terminology.hl7.org/CodeSystem/condition-category',
+                "code": 'problem-list-item',
+                "display": 'Problem List Item'
+              }
+            ],
+            "text": 'Problem List Item'
           },
           {
-            'system': 'http://terminology.hl7.org/CodeSystem/v3-ActCode',
-            'code': 'PRS',
-            'display': 'patient requested information sensitivity',
-            'userSelected': false
-          }
-        ]
-      },
-      'text': {
-        'status': 'generated',
-        'div': '<div xmlns="http://www.w3.org/1999/xhtml"><p><b>Condition</b></p><p><b>Diagnosis</b>:'\
-            ' Error, Error</p><p><b>Category Classification</b>: Medical</p><p><b>Verification Status</b>:'\
-            ' Entered in Error</p></div>'
-      },
-      'verificationStatus': {
-        'coding': [
-          {
-            'system': 'http://terminology.hl7.org/CodeSystem/condition-clinical',
-            'code': 'entered-in-error',
-            'display': 'Entered in Error'
+            "coding": [
+              {
+                "system": 'http://snomed.info/sct',
+                "code": '74188005',
+                "display": 'Medical (qualifier value)',
+                "userSelected": false
+              }
+            ],
+            "text": 'Medical'
           }
         ],
-        'text': 'Entered in Error'
-      },
-      'category': [
-        {
-          'coding': [
+        "code": {
+          "coding": [
             {
-              'system': 'http://terminology.hl7.org/CodeSystem/condition-category',
-              'code': 'encounter-diagnosis',
-              'display': 'Encounter Diagnosis'
-            }
-          ],
-          'text': 'Encounter Diagnosis'
-        },
-        {
-          'coding': [
+              "system": 'http://snomed.info/sct',
+              "code": '305058001',
+              "display": 'Patient encounter status (finding)',
+              "userSelected": false
+            },
             {
-              'system': 'http://snomed.info/sct',
-              'code': '74188005',
-              'display': 'Medical (qualifier value)',
-              'userSelected': false
+              "system": 'http://e-imo.com/products/problem-it',
+              "code": '818990',
+              "display": 'Therapeutic drug monitoring',
+              "userSelected": false
             }
           ],
-          'text': 'Medical'
+          "text": 'Therapeutic drug monitoring'
+        },
+        "subject": {
+          "reference": 'Patient/12724066',
+          "display": 'Smart II, Nancy'
+        },
+        "onsetDateTime": '2003-08-19',
+        "recordedDate": '2022-08-24T20:22:15.000Z',
+        "recorder": {
+          "reference": 'Practitioner/12742069',
+          "display": 'Portal, Portal'
         }
-      ],
-      'code': {
-        'coding': [
-          {
-            'system': 'http://terminology.hl7.org/CodeSystem/data-absent-reason',
-            'code': 'error',
-            'display': 'Error'
-          }
-        ],
-        'text': 'Error'
       },
-      'subject': {
-        'reference': 'Patient/12742400'
+      "search": {
+        "mode": 'match'
       }
     }.freeze