Beta | Commands Module

Overview #

The commands module is a new, standardized framework for building commands in Canvas. In this new framework, commands are defined by two elements:

  1. The form: This is what the user sees in the front-end. It consists of the fields that the user can fill out, the actions the user can take, and how the command is laid out on the screen.

  2. The event handler: This is Python code that carries out actions depending on actions the user takes in the user-facing form.

Expected benefits #

Commands migrated to the new framework will function similarly if not identically (minus any confusing quirks or bugs!).However, the following are benefits that we anticipate with SDK commands:

Current State #

  • Improved performance. The framework dramatically simplifies the data model behind commands in Canvas, and we expect that this much simpler data model will have a noticeable impact on note load times.
  • Zero chance for data loss to occur. The simpler data model allows information to be captured consistently at several layers in the application – starting with the user’s browser cache – which means that your data is persisted in some form as soon as it’s entered.
  • Consistent keyboard controls. The framework uses built-in browser accessibility features to provide a first-class keyboard navigation experience across all commands.
  • Carry forward previous respones The ability to pull forward the last recorded response will be available more widely across commands.
  • Add partially complete commands to automations. Migrated commands can be added to automations before they are committed, allowing users to include commands that are not fully filled out.
  • A fully-auditable command lifecycle. The framework tracks all changes to a command over time, allowing for detailed auditing and the ability to revert to previous changes.

Read more about SDK commands.

Future State #

  • Customizable commands. The framework will enable customers to customize existing commands and create new ones by implementing a simple interface consisting of a form and one or more event handlers (roughly outlined above).
  • Editing committed commands. In order to maintain a complete audit trail, current commands cannot be edited after they have been committed. Instead, they must be entered-in-error and re-created, which is cumbersome and often annoying. The framework abstracts this requirement away, allowing commands to be edited after they are committed by handling the enter-in-error and re-creation lifecycle seamlessly behind the scenes.

Progress #

</tr> </tr> </tbody> </table>
CommandStatusChanges
Plan Released - GA
HPI Released - GA
Reason for Visit Released - GA
Stop Medication Released - GA
Questionnaire Released - GA
  • No longer supports same encounter carry forward setting
  • Comment bubbles always show and are color coded to indicate whether content is present (yellow)
  • Blank free text responses will no longer print with the question name (i.e ~TXT~)
Assess Released - GA
  • Assessing from the condition list adds an uncommitted command directly into the note (based on cursor placement), rather than opening a modal
Goal Released - GA
Update Goal Released - GA
Medication Statement Released - GA
Prescribe Released - Beta
  • Adds max refill validation for epcs
  • Limits to 2 indications
Perform Released - GA
Instruct Released - GA
Diagnose Released - Beta
  • The command now restricts adding duplicate diagnoses. Users will be prevented from committing the command and warned to add an assess command if the condition already exists
Lab Order Released - Beta
  • The indications drop down defaults with active conditions as quick picks
  • Validation will prevent sending orders if a patient does not have an address or if the provider does not have an NPI
Family History Released - GA
Allergy Released - GA
Remove Allergy Released - GA
Surgical History Released - GA
Medical History Released - GA
Task Released - Beta
  • Attachments are added through a modal
Refill Released - Beta
  • Adds max refill validation for epcs
  • Limits to 2 indications
Vitals Released - Beta
  • Updated layout
Change Diagnosis Released - Beta
Close Goal Released - GA
Educational Material Released - GA
  • The preview of the article is now located in the triple dot menu
Image Released - Beta
  • Attachments are added through a modal
Snooze Protocol Released - Beta
Immunization Statement Released - Beta
Immunize Released - Beta
Physical Exam Released - Beta
Review of Systems Released - Beta
Structured Assessment Released - Beta
Refer Next up
Follow Up Next up