The Report Definitions screen manages the catalog of report templates used to generate compliance and quality reports, at the in-app routeDocumentation Index
Fetch the complete documentation index at: https://docs.encoreos.io/llms.txt
Use this file to discover all available pages before exploring further.
/cl/report-definitions.
Overview
The page is guarded bycl.report_definitions.view. A list of report definitions from cl_report_definitions is fetched via useReportDefinitionList. Each definition shows its name, report type badge (from REPORT_TYPE_OPTIONS), format, and active/inactive status. Users with cl.report_definitions.create see a “New Definition” button that opens a ReportDefinitionFormDialog for creating a template. Each row supports Edit (opens the same dialog pre-populated with existing values) and, for users with cl.report_definitions.delete, Delete. Users with cl.report_runs.run see a “Run” button per row that triggers useRunReport to initiate a report run. When no definitions exist, an empty state is shown with an optional “Create Definition” action.
Who it’s for
Requires permissioncl.report_definitions.view. Additional sub-permissions control write actions:
cl.report_definitions.create— enables “New Definition” and the Create action in the empty state.cl.report_definitions.delete— enables Delete per row.cl.report_runs.run— enables Run per row.
Before you start
- Permission
cl.report_definitions.viewmust be granted. - To create or edit definitions,
cl.report_definitions.createis required. - To run a report,
cl.report_runs.runis required; run history is visible at/cl/report-runs.
Steps
View existing definitions
The table lists all report definitions with name, type, format, and status. Inactive definitions show a secondary status badge.
Create a new definition (if permitted)
Click “New Definition” (requires
cl.report_definitions.create) to open the ReportDefinitionFormDialog and configure a new template.Edit an existing definition
Click “Edit” on any row to open the dialog pre-populated with that definition’s values.
Run a report (if permitted)
Click “Run” on any row (requires
cl.report_runs.run) to initiate a report run. Navigate to the Report History page at /cl/report-runs to monitor run status.Key concepts
Report type values
Report type values
joint_commission (Joint Commission), carf (CARF), hedis (NCQA / HEDIS), ahcccs (AHCCCS), azdhs_incident (AZDHS Incident), custom (Custom) — from REPORT_TYPE_OPTIONS in src/cores/cl/types/reporting.ts.Report format values
Report format values
pdf, csv, excel — displayed as uppercase short codes in the Format column.Empty and error states
Empty and error states
When no definitions exist, an empty state with a FileText icon is shown. A “Create Definition” action appears if
cl.report_definitions.create is held. A skeleton (header + 96px content block) is displayed while loading.Related
Clinical
Overview of the Clinical core.
Governance & parity
Documentation coverage and governance.
This page documents shipped product behavior. It is not medical, legal, or
billing advice. Verify against your organization’s policies and applicable
regulations before using it for clinical, compliance, or billing decisions.
Protected health information (PHI) shown in the product is governed by your
tenant’s access controls and is never exposed in this documentation.
Documentation sources
Documentation sources
- src/routes/cl.tsx
- src/cores/cl/pages/ReportDefinitionsListPage.tsx
- src/cores/cl/types/reporting.ts