SMART Base, published by WHO. This guide is not an authorized publication; it is the continuous build for version 0.2.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/WorldHealthOrganization/smart-base/tree/main and changes regularly. See the Directory of published versions
Built from commit d97caff5.

• Narrative Content
• XML
• JSON
• TTL

: Can author CQL - JSON Representation

Draft as of 2026-03-20

Raw json | Download

{
  "resourceType" : "Requirements",
  "id" : "SGAuthoring.Skills.AuthorCQL",
  "meta" : {
    "profile" : [
      🔗 "http://smart.who.int/base/StructureDefinition/SGRequirements"
    ]
  },
  "text" : {
    "status" : "generated",
    "div" : "<div xmlns=\"http://www.w3.org/1999/xhtml\"><div xml:lang=\"en\" lang=\"en\"><hr/><p><b>English</b></p><hr/><p class=\"res-header-id\"><b>Generated Narrative: Requirements SGAuthoring.Skills.AuthorCQL</b></p><a name=\"SGAuthoring.Skills.AuthorCQL\"> </a><a name=\"hcSGAuthoring.Skills.AuthorCQL\"> </a><div style=\"display: inline-block; background-color: #d9e0e7; padding: 6px; margin: 4px; border: 1px solid #8da1b4; border-radius: 5px; line-height: 60%\"><p style=\"margin-bottom: 0px\"/><p style=\"margin-bottom: 0px\">Profile: <a href=\"StructureDefinition-SGRequirements.html\">SMART Guidelines Requirements</a></p></div><p>These requirements apply to the actor <a href=\"ActorDefinition-SGAuthoring.Persona.FHIRModeller.html\">FHIR Modeller</a></p><table class=\"grid\"><tr><td><b><a name=\"CQL-01\"> </a></b>Write CQL decision logic</td><td>SHALL</td><td><div><p>Can write CQL libraries implementing L2 decision-support logic tables.</p>\n</div></td></tr><tr><td><b><a name=\"CQL-02\"> </a></b>Write CQL scheduling logic</td><td>SHALL</td><td><div><p>Can write CQL libraries implementing L2 scheduling logic tables.</p>\n</div></td></tr><tr><td><b><a name=\"CQL-03\"> </a></b>Write CQL indicator logic</td><td>SHALL</td><td><div><p>Can write CQL libraries implementing indicator calculations with numerator/denominator definitions.</p>\n</div></td></tr><tr><td><b><a name=\"CQL-04\"> </a></b>Create CQL concept definitions</td><td>SHALL</td><td><div><p>Can create CQL concept and data element definitions for use across libraries.</p>\n</div></td></tr><tr><td><b><a name=\"CQL-05\"> </a></b>Test CQL execution</td><td>SHALL</td><td><div><p>Can validate CQL execution against test data using reference tooling.</p>\n</div></td></tr></table></div><div xml:lang=\"fr\" lang=\"fr\"><hr/><p><b>French</b></p><hr/><p class=\"res-header-id\"><b>Narratif généré : Requirements SGAuthoring.Skills.AuthorCQL</b></p><a name=\"fr-SGAuthoring.Skills.AuthorCQL\"> </a><a name=\"fr-hcSGAuthoring.Skills.AuthorCQL\"> </a><div style=\"display: inline-block; background-color: #d9e0e7; padding: 6px; margin: 4px; border: 1px solid #8da1b4; border-radius: 5px; line-height: 60%\"><p style=\"margin-bottom: 0px\"/><p style=\"margin-bottom: 0px\">Profil: <a href=\"StructureDefinition-SGRequirements.html\">SMART Guidelines Requirements</a></p></div><p>Ces exigences s'appliquent à l'acteur <a href=\"ActorDefinition-SGAuthoring.Persona.FHIRModeller.html\">FHIR Modeller</a></p><table class=\"grid\"><tr><td><b><a name=\"fr-CQL-01\"> </a></b>Write CQL decision logic</td><td>SHALL</td><td><div><p>Can write CQL libraries implementing L2 decision-support logic tables.</p>\n</div></td></tr><tr><td><b><a name=\"fr-CQL-02\"> </a></b>Write CQL scheduling logic</td><td>SHALL</td><td><div><p>Can write CQL libraries implementing L2 scheduling logic tables.</p>\n</div></td></tr><tr><td><b><a name=\"fr-CQL-03\"> </a></b>Write CQL indicator logic</td><td>SHALL</td><td><div><p>Can write CQL libraries implementing indicator calculations with numerator/denominator definitions.</p>\n</div></td></tr><tr><td><b><a name=\"fr-CQL-04\"> </a></b>Create CQL concept definitions</td><td>SHALL</td><td><div><p>Can create CQL concept and data element definitions for use across libraries.</p>\n</div></td></tr><tr><td><b><a name=\"fr-CQL-05\"> </a></b>Test CQL execution</td><td>SHALL</td><td><div><p>Can validate CQL execution against test data using reference tooling.</p>\n</div></td></tr></table></div><div xml:lang=\"ar\" lang=\"ar\"><hr/><p><b>Arabic</b></p><hr/><p class=\"res-header-id\"><b>السرد المُنشأ: Requirements SGAuthoring.Skills.AuthorCQL</b></p><a name=\"ar-SGAuthoring.Skills.AuthorCQL\"> </a><a name=\"ar-hcSGAuthoring.Skills.AuthorCQL\"> </a><div style=\"display: inline-block; background-color: #d9e0e7; padding: 6px; margin: 4px; border: 1px solid #8da1b4; border-radius: 5px; line-height: 60%\"><p style=\"margin-bottom: 0px\"/><p style=\"margin-bottom: 0px\">الملف الشخصي: <a href=\"StructureDefinition-SGRequirements.html\">SMART Guidelines Requirements</a></p></div><p>تنطبق هذه المتطلبات على الممثل <a href=\"ActorDefinition-SGAuthoring.Persona.FHIRModeller.html\">FHIR Modeller</a></p><table class=\"grid\"><tr><td><b><a name=\"ar-CQL-01\"> </a></b>Write CQL decision logic</td><td>SHALL</td><td><div><p>Can write CQL libraries implementing L2 decision-support logic tables.</p>\n</div></td></tr><tr><td><b><a name=\"ar-CQL-02\"> </a></b>Write CQL scheduling logic</td><td>SHALL</td><td><div><p>Can write CQL libraries implementing L2 scheduling logic tables.</p>\n</div></td></tr><tr><td><b><a name=\"ar-CQL-03\"> </a></b>Write CQL indicator logic</td><td>SHALL</td><td><div><p>Can write CQL libraries implementing indicator calculations with numerator/denominator definitions.</p>\n</div></td></tr><tr><td><b><a name=\"ar-CQL-04\"> </a></b>Create CQL concept definitions</td><td>SHALL</td><td><div><p>Can create CQL concept and data element definitions for use across libraries.</p>\n</div></td></tr><tr><td><b><a name=\"ar-CQL-05\"> </a></b>Test CQL execution</td><td>SHALL</td><td><div><p>Can validate CQL execution against test data using reference tooling.</p>\n</div></td></tr></table></div><div xml:lang=\"zh\" lang=\"zh\"><hr/><p><b>Chinese</b></p><hr/><p class=\"res-header-id\"><b>Generated Narrative: Requirements SGAuthoring.Skills.AuthorCQL</b></p><a name=\"zh-SGAuthoring.Skills.AuthorCQL\"> </a><a name=\"zh-hcSGAuthoring.Skills.AuthorCQL\"> </a><div style=\"display: inline-block; background-color: #d9e0e7; padding: 6px; margin: 4px; border: 1px solid #8da1b4; border-radius: 5px; line-height: 60%\"><p style=\"margin-bottom: 0px\"/><p style=\"margin-bottom: 0px\">Profile: <a href=\"StructureDefinition-SGRequirements.html\">SMART Guidelines Requirements</a></p></div><p>These requirements apply to the actor <a href=\"ActorDefinition-SGAuthoring.Persona.FHIRModeller.html\">FHIR Modeller</a></p><table class=\"grid\"><tr><td><b><a name=\"zh-CQL-01\"> </a></b>Write CQL decision logic</td><td>SHALL</td><td><div><p>Can write CQL libraries implementing L2 decision-support logic tables.</p>\n</div></td></tr><tr><td><b><a name=\"zh-CQL-02\"> </a></b>Write CQL scheduling logic</td><td>SHALL</td><td><div><p>Can write CQL libraries implementing L2 scheduling logic tables.</p>\n</div></td></tr><tr><td><b><a name=\"zh-CQL-03\"> </a></b>Write CQL indicator logic</td><td>SHALL</td><td><div><p>Can write CQL libraries implementing indicator calculations with numerator/denominator definitions.</p>\n</div></td></tr><tr><td><b><a name=\"zh-CQL-04\"> </a></b>Create CQL concept definitions</td><td>SHALL</td><td><div><p>Can create CQL concept and data element definitions for use across libraries.</p>\n</div></td></tr><tr><td><b><a name=\"zh-CQL-05\"> </a></b>Test CQL execution</td><td>SHALL</td><td><div><p>Can validate CQL execution against test data using reference tooling.</p>\n</div></td></tr></table></div><div xml:lang=\"ru\" lang=\"ru\"><hr/><p><b>Russian</b></p><hr/><p class=\"res-header-id\"><b>Сгенерированный нарратив: Requirements SGAuthoring.Skills.AuthorCQL</b></p><a name=\"ru-SGAuthoring.Skills.AuthorCQL\"> </a><a name=\"ru-hcSGAuthoring.Skills.AuthorCQL\"> </a><div style=\"display: inline-block; background-color: #d9e0e7; padding: 6px; margin: 4px; border: 1px solid #8da1b4; border-radius: 5px; line-height: 60%\"><p style=\"margin-bottom: 0px\"/><p style=\"margin-bottom: 0px\">Профиль: <a href=\"StructureDefinition-SGRequirements.html\">SMART Guidelines Requirements</a></p></div><p>Эти требования распространяются и на актера <a href=\"ActorDefinition-SGAuthoring.Persona.FHIRModeller.html\">FHIR Modeller</a></p><table class=\"grid\"><tr><td><b><a name=\"ru-CQL-01\"> </a></b>Write CQL decision logic</td><td>SHALL</td><td><div><p>Can write CQL libraries implementing L2 decision-support logic tables.</p>\n</div></td></tr><tr><td><b><a name=\"ru-CQL-02\"> </a></b>Write CQL scheduling logic</td><td>SHALL</td><td><div><p>Can write CQL libraries implementing L2 scheduling logic tables.</p>\n</div></td></tr><tr><td><b><a name=\"ru-CQL-03\"> </a></b>Write CQL indicator logic</td><td>SHALL</td><td><div><p>Can write CQL libraries implementing indicator calculations with numerator/denominator definitions.</p>\n</div></td></tr><tr><td><b><a name=\"ru-CQL-04\"> </a></b>Create CQL concept definitions</td><td>SHALL</td><td><div><p>Can create CQL concept and data element definitions for use across libraries.</p>\n</div></td></tr><tr><td><b><a name=\"ru-CQL-05\"> </a></b>Test CQL execution</td><td>SHALL</td><td><div><p>Can validate CQL execution against test data using reference tooling.</p>\n</div></td></tr></table></div><div xml:lang=\"es\" lang=\"es\"><hr/><p><b>Spanish</b></p><hr/><p class=\"res-header-id\"><b>Generated Narrative: Requirements SGAuthoring.Skills.AuthorCQL</b></p><a name=\"es-SGAuthoring.Skills.AuthorCQL\"> </a><a name=\"es-hcSGAuthoring.Skills.AuthorCQL\"> </a><div style=\"display: inline-block; background-color: #d9e0e7; padding: 6px; margin: 4px; border: 1px solid #8da1b4; border-radius: 5px; line-height: 60%\"><p style=\"margin-bottom: 0px\"/><p style=\"margin-bottom: 0px\">Profile: <a href=\"StructureDefinition-SGRequirements.html\">SMART Guidelines Requirements</a></p></div><p>These requirements apply to the actor <a href=\"ActorDefinition-SGAuthoring.Persona.FHIRModeller.html\">FHIR Modeller</a></p><table class=\"grid\"><tr><td><b><a name=\"es-CQL-01\"> </a></b>Write CQL decision logic</td><td>SHALL</td><td><div><p>Can write CQL libraries implementing L2 decision-support logic tables.</p>\n</div></td></tr><tr><td><b><a name=\"es-CQL-02\"> </a></b>Write CQL scheduling logic</td><td>SHALL</td><td><div><p>Can write CQL libraries implementing L2 scheduling logic tables.</p>\n</div></td></tr><tr><td><b><a name=\"es-CQL-03\"> </a></b>Write CQL indicator logic</td><td>SHALL</td><td><div><p>Can write CQL libraries implementing indicator calculations with numerator/denominator definitions.</p>\n</div></td></tr><tr><td><b><a name=\"es-CQL-04\"> </a></b>Create CQL concept definitions</td><td>SHALL</td><td><div><p>Can create CQL concept and data element definitions for use across libraries.</p>\n</div></td></tr><tr><td><b><a name=\"es-CQL-05\"> </a></b>Test CQL execution</td><td>SHALL</td><td><div><p>Can validate CQL execution against test data using reference tooling.</p>\n</div></td></tr></table></div></div>"
  },
  "extension" : [
    {
      "url" : "http://smart.who.int/base/StructureDefinition/SGTask",
      "valueCoding" : {
        "system" : "http://smart.who.int/base/CodeSystem/SGTasks",
        "code" : "scriptTask",
        "display" : "Script Task"
      }
    },
    {
      "url" : "http://smart.who.int/base/StructureDefinition/SGTask",
      "valueCoding" : {
        "system" : "http://smart.who.int/base/CodeSystem/SGTasks",
        "code" : "scriptTask",
        "display" : "Script Task"
      }
    },
    {
      "url" : "http://smart.who.int/base/StructureDefinition/SGTask",
      "valueCoding" : {
        "system" : "http://smart.who.int/base/CodeSystem/SGTasks",
        "code" : "scriptTask",
        "display" : "Script Task"
      }
    },
    {
      "url" : "http://smart.who.int/base/StructureDefinition/SGTask",
      "valueCoding" : {
        "system" : "http://smart.who.int/base/CodeSystem/SGTasks",
        "code" : "scriptTask",
        "display" : "Script Task"
      }
    },
    {
      "url" : "http://smart.who.int/base/StructureDefinition/SGTask",
      "valueCoding" : {
        "system" : "http://smart.who.int/base/CodeSystem/SGTasks",
        "code" : "scriptTask",
        "display" : "Script Task"
      }
    },
    {
      "extension" : [
        {
          "url" : "http://smart.who.int/base/StructureDefinition/SGString",
          "valueString" : "write CQL for decision logic, scheduling logic, and indicator calculations"
        },
        {
          "url" : "http://smart.who.int/base/StructureDefinition/SGString",
          "valueString" : "clinical decision-support and indicator calculations are computable and testable"
        }
      ],
      "url" : "http://smart.who.int/base/StructureDefinition/SGUserStory"
    }
  ],
  "url" : "http://smart.who.int/base/Requirements/SGAuthoring.Skills.AuthorCQL",
  "version" : "0.2.0",
  "name" : "SkillAuthorCQL",
  "title" : "Can author CQL",
  "status" : "draft",
  "experimental" : true,
  "date" : "2026-03-20T00:42:00+00:00",
  "publisher" : "WHO",
  "contact" : [
    {
      "name" : "WHO",
      "telecom" : [
        {
          "system" : "url",
          "value" : "http://who.int"
        }
      ]
    }
  ],
  "description" : "Capability to write Clinical Quality Language (CQL) for decision logic, scheduling logic, and indicator calculations.",
  "actor" : [
    🔗 "http://smart.who.int/base/ActorDefinition/SGAuthoring.Persona.FHIRModeller"
  ],
  "statement" : [
    {
      "key" : "CQL-01",
      "label" : "Write CQL decision logic",
      "conformance" : [
        "SHALL"
      ],
      "requirement" : "Can write CQL libraries implementing L2 decision-support logic tables."
    },
    {
      "key" : "CQL-02",
      "label" : "Write CQL scheduling logic",
      "conformance" : [
        "SHALL"
      ],
      "requirement" : "Can write CQL libraries implementing L2 scheduling logic tables."
    },
    {
      "key" : "CQL-03",
      "label" : "Write CQL indicator logic",
      "conformance" : [
        "SHALL"
      ],
      "requirement" : "Can write CQL libraries implementing indicator calculations with numerator/denominator definitions."
    },
    {
      "key" : "CQL-04",
      "label" : "Create CQL concept definitions",
      "conformance" : [
        "SHALL"
      ],
      "requirement" : "Can create CQL concept and data element definitions for use across libraries."
    },
    {
      "key" : "CQL-05",
      "label" : "Test CQL execution",
      "conformance" : [
        "SHALL"
      ],
      "requirement" : "Can validate CQL execution against test data using reference tooling."
    }
  ]
}