HIV Screening Clinical Guidelines Implementation Guide
0.1.0 - CI Build Unknown region code '840'

HIV Screening Clinical Guidelines Implementation Guide, published by National Association of Community Health Centers, Inc. (NACHC). This guide is not an authorized publication; it is the continuous build for version 0.1.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/cqframework/hiv-cds/ and changes regularly. See the Directory of published versions

Sample Recommendation

Functional Description

A simple example utilizing a FHIR Plan Definition, Library, ValueSet, and CQL to express an example HIV Screening recommendation for end-to-end testing purposes.

Content

The following artifacts formalize the description of the logic and behavior defined by this recommendation.

ResourceTypeDescription
Hello HIV World, Sample Recommendation - Plan DefinitionPlan DefinitionClinical Decision Support Document that defines and exposes actions utilized for a CDS-Hooks request.
Hello HIV World, Sample Recommendation - LibraryLibraryCQL Library that provides the logic needed for the Sample Recommendation.

Common Libraries

ResourceTypeDescription
FHIR HelpersLibraryCQL Library that provides common logic for modeling FHIR R4.
FHIR CommonLibraryA Shared library encapsulating valuable common terminologies and functions used in FHIR-based CQL artifacts.

Example Data / Requests
DescriptionBundleCDS Hooks RequestExpected Response
Patient that has been diagnosed with HIV. Test Bundle 
{
    "hookInstance": "test",
    "fhirServer": "http://localhost:8080/cqf-ruler-r4/fhir",
    "hook": "patient-view",
    "context": {
        "userId": "Practitioner/example",
        "patientId": "Patient/HIVPatient"
    },
    "prefetch": {
        "item2": {
            "response": {
                "status": "200 OK"
            },
            "resource": {
                "resourceType" : "Patient",
                "id" : "HIVPatient",
                "gender" : "male",
                "birthDate" : "1974-12-25"
            }
        },
        "item3": {
            "response": {
                "status": "200 OK"
            },
            "resource": {
                "resourceType": "Condition",
                "id": "HIVPatient-condition-1-hiv",
                "clinicalStatus": {
                    "coding": [
                    {
                        "system": "http://hl7.org/fhir/ValueSet/condition-clinical",
                        "version": "4.0.1",
                        "code": "active",
                        "display": "Active"
                    }
                    ]
                },
                "verificationStatus": {
                    "coding": [
                    {
                        "system": "http://hl7.org/fhir/ValueSet/condition-ver-status",
                        "version": "4.0.1",
                        "code": "confirmed",
                        "display": "Confirmed"
                    }
                    ]
                },
                "category": [
                    {
                    "coding": [
                        {
                        "system": "http://hl7.org/fhir/ValueSet/condition-category",
                        "version": "4.0.1",
                        "code": "problem-list-item",
                        "display": "Problem List Item"
                        }
                    ]
                    }
                ],
                "code": {
                    "coding": [
                    {
                        "system": "http://hl7.org/fhir/sid/icd-10-cm",
                        "version": "2021",
                        "code": "B20",
                        "display": "Human immunodeficiency virus [HIV] disease"
                    }
                    ]
                },
                "subject": {
                    "reference": "Patient/HIVPatient"
                },
                "onsetDateTime": "2018-02-10T10:00:00-07:00",
                "recordedDate": "2021-05-10T12:00:00-07:00"
            }
        }
    }
}
 
{
    "cards": [
        {
            "summary": "Hello HIV World!",
            "indicator": "info",
            "detail": "This is a test.",
            "source": {
                "label": "Info for those with HIV",
                "url": "https://www.cdc.gov/hiv/guidelines/testing.html"
            }
        }
    ]
}