This project provides a Java-based CQL evaluation service and related components.
The front-end of the evaluator is the cql-to-elm translator (which provides translation of CQL to ELM) and the backend is the cql-engine (which provides ELM execution). The evaluator glues those two components together and provides DataProvider and TerminologyProvider implementations that allow execution of CQL against a filesystem, FHIR server, and in-process FHIR resources.
The cql-evaluator project includes a cli tool that allows execution of CQL from the command line. You can build this tool with:
mvn packageThen you can run the cli with:
java -jar ./evaluator.cli/target/evaluator.cli-1.1.0-shaded.jar --helpThat will list the command line options. There is some CQL content available in the Connectathon IG repository. If you have that repository checked out as a sibling repo to this one, you can execute a sample Measure test case by running:
java -jar ./evaluator.cli/target/evaluator.cli-1.1.0-SNAPSHOT-shaded.jar \
--lu ../connectathon/fhir4/input/pagecontent/cql \
--ln EXM104_FHIR4 \
-m FHIR=../connectathon/fhir4/input/tests/EXM104_FHIR4-8.1.000 \
-t ../connectathon/fhir4/input/vocabulary/valueset \
-c Patient=numer-EXM104-FHIR4
-fv R4.
|-- evaluator # core cql-evaluator classes
| |-- src
| | |-- main
| | `-- test
|-- evaluator.builder # factories for constructing a cql-evaluator
| |-- src
| | |-- main
| | `-- test
|-- evaluator.cli # cli tool for running the cql-evaluator
| |-- src
| | |-- main
| | `-- test
|-- evaluator.cql2elm # cql-evaluator specific extensions to the cql-translator
| |-- src
| | |-- main
| | `-- test
|-- evaluator.engine # cql-evaluator specific extensions to the cql-engine
| |-- src
| | |-- main
| | `-- test
|-- evaluator.expression # functionality for evaluating CQL snippets
| |-- src
| | |-- main
| | `-- test
|-- evaluator.fhir # FHIR Resource adapters and operations
| |-- src
| | |-- main
| | `-- test
|-- evaluator.library # functionality for evaluating CQL/FHIR Libraries
| |-- src
| | |-- main
| | `-- test
`-- evaluator.measure # functionality for evaluating FHIR Measures
`-- src
|-- main
`-- testCopyright 2020 Dynamic Content Group
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
https://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.