/fw/decision-tables.
Overview
This screen renders a list/table of decision tables loaded viauseDecisionTables, scoped to the current user’s organization. Filters include a text search and a status dropdown (draft, published, archived). Each row shows the table name, hit policy (from HIT_POLICY_LABELS), status badge, and a link to the editor. A New Decision Table button (gated by fw.decision_tables.manage via PermissionGate) navigates to /fw/decision-tables/new.
Who it’s for
No explicit route-level permission gate. The New Decision Table button is gated byfw.decision_tables.manage (FW_PERMISSIONS.DECISION_TABLES_MANAGE).
- To view decision tables, navigate to
/fw/decision-tables. - To create or edit tables, hold
fw.decision_tables.manage.
Finding a decision table
- Navigate to
/fw/decision-tables. - Use the search input and status dropdown to locate a specific table.
- Click a table name to navigate to
/fw/decision-tables/:id/edit. - Click New Decision Table (requires
fw.decision_tables.manage) to navigate to/fw/decision-tables/new.
- Hit policy — determines how matching rules are evaluated (e.g., first match vs. all matches); labels sourced from
HIT_POLICY_LABELS. - Decision table status —
draft,published, orarchived.
Creating a decision table
The New Decision Table page opens the Decision Table Editor in creation mode at/fw/decision-tables/new. It uses the same DecisionTableEditorPage component as the edit route; when no id query parameter is present the editor creates a new form on save. Requires fw.decision_tables.manage.
Before you start: choose a descriptive name and select the hit policy that matches your rule evaluation strategy before adding rows, as it affects how multiple matching rules are handled.
- Navigate to
/fw/decision-tablesand select New Table, or navigate directly to/fw/decision-tables/new. - Enter a Name (required) and optional Description and Tags in the Configuration card.
- Select a Hit Policy from the dropdown.
- Add input and output columns to the rule grid using the
DecisionTableGridcontrols. - Define rule rows by filling in condition values for each input column and result values for each output column.
- Select Save. On success the browser redirects to
/fw/decision-tables/:id/editand the table status isdraft. - To make the table available for use, select Publish and optionally add a change summary in the confirmation dialog.
- Draft vs. published — a table starts in
draftstatus. Only published tables are available for reference by automations and workflows. - Version — each publish action increments the version number displayed in the editor header.
Editing a decision table
The Edit Decision Table screen (/fw/decision-tables/:id/edit) provides a full editor for a decision table’s metadata, rule grid, test panel, and version history. This screen also serves the create flow (when id === 'new', routing from /fw/decision-tables/new).
Table metadata (name, description, hit policy) is editable inline. The rule grid (DecisionTableGrid) displays input and output columns with editable cells. Four tabs organize the editor: rule grid, test panel (DecisionTableTestPanel), version history (DecisionTableVersionHistory), and a rule evaluations audit log (RuleEvaluationsAuditLog). Actions include save draft, publish (DecisionTablePublishDialog), archive, and delete. Edit actions are gated by fw.decision_tables.manage (canManage).
Requires fw.decision_tables.manage to perform edits. Viewing is gated by fw.decision_tables.view.
Before you start: hold fw.decision_tables.manage to create or edit tables. Access from the Decision Tables list or navigate directly with a valid id.
- Navigate to
/fw/decision-tables/:id/editor click a table in the list. - Update the table name, description, and hit policy in the header form.
- Use the rule grid tab to add, edit, or remove input/output columns and rule rows.
- Switch to the Test tab to run test inputs against the current rule set.
- Click Save to store as draft, or Publish to make the table active in automations.
- Switch to the Version History tab to view past versions and the audit log.
- Input columns / Output columns — structured condition and result definitions for each rule row.
- Publish — moves the table from
drafttopublishedstatus, making it available to automations.
Related
Forms & Workflow
Forms & Workflow core overview.
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/fw.tsx
- src/cores/fw/pages/DecisionTableListPage.tsx
- src/cores/fw/pages/DecisionTableEditorPage.tsx
- src/cores/fw/hooks/useDecisionTable.ts
- src/cores/fw/hooks/useDecisionTableMutation.ts
- src/cores/fw/types/decision-tables.ts
- src/platform/permissions/constants.ts