This plugin is deprecated
With the sunsetting of Atom the CQL plugin is no longer being supported. Please migrate to using the VS Code plugin instead.
Adds syntax highlighting, semantic (error) highlighting, and local execution to CQL files in Atom, a free and open source editor.
The cql-language package has been published to the Atom package repository, so installation is simple:
- If you don't have Atom, download and install it.
- Install the cql-language package by follow the instructions for installing packages a. The cql-language package requires both a Java v1.8 runtime and a correct Java Path. If the installation fails to detect either, you will be prompted to download and install Java and/or set a correct Java Path.
After you've installed the cql-language package, open any .cql file in Atom. As long as the file has the .cql extension, syntax and error highlighting will be automatically applied.
To execute CQL right-click in the CQL Editor Windows and select CQL -> Execute or press F5
The translation and execution capabilities in the plugin expect CQL files to be in the following directories, by convention:
input/cql
input/tests
input/tests/<cql-library-name>
input/tests/<cql-library-name>/<patient-id>
input/tests/<cql-library-name>/<patient-id>/<resource-type-name>/<resource files> // flexible structure
input/vocabulary/codesystem
input/vocabulary/valuesetWithin the tests folder, there is a folder for each CQL library, by name (note that the name of the file must match the name of the library in order for the evaluator to properly execute the CQL). Note also that the evaluator is a separate subsystem from the translator, so it will read whatever is current of off disk, so be sure to save before executing.
Within the library folder, there is a folder for each "test case", in the form of a Patient (the execution only supports patient context execution at this point). The folder must have the same id as the patient (that's how the evaluator knows what the patient id is).
Within each test case folder are the resources for that specific test case. The resource files can be provided either directly in this folder, or they can be organized into folders by resource type name. Whether they are in the test folder or in subfolders, resources can be provided as bundles (included nested bundles), or as separate files, and in either XML or JSON format. If a Patient is provided, the id element of the Patient resource must match the name of the test case folder.
The Clinical Quality Language (CQL) is a domain specific language for expressing electronic clinical quality measures (eCQM) and clinical decision support rules (CDS) in an author-friendly computable format. Find out more about CQL:
- CQL Specification
- CQL Stream on FHIR Zulip Chat
- clinical_quality_language on GitHub
- Clinical Quality Expression Language at HL7
- Clinical Quality Framework (CQF)
- uninstall the language-cql package from Atom if you have it installed
- run
npm install -g yarn - run
yarn installin the root directory to install dependencies - run
apm linkto create a symbolic link from the git directories to the working directory- working directory can be found at
<user dir>\.atom\packages\language-cql
- working directory can be found at
- reload workspace to get updates (ctr-shift-f5)
Copyright 2014 - 2015 The MITRE Corporation
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
http://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.
![dependabot[bot] avatar](https://avatars.githubusercontent.com/in/29110?v=4 "dependabot[bot]")
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent