Clinical Templates
Last updated
Last updated
This page documents a feature in SanteDB 3.0 with SanteEMR 3.0 plugins enabled and activated on the administrative panel.
SanteEMR clinical data templates exist as a method of further specializing acts (observations, procedures, substance administrations) into a specific templated model and a series of views which allow for the editing, and viewing of those types of acts. Templates combine:
A model template which:
Defines the default and fixed values for entry of data
The information or components within the act which is to be populated
Views which define:
Data entry formlets used for data capture of information in the template
Views which are used for displaying the information in a clinical summary or in a detail view
Examples of a clinical template may be:
A standardized input for childhood milestone development (CodedObservations
)
A pain scale input
The templates which are installed on the system are located in the SanteEMR > Templates area of the administrative panel.
The template library allows an administrator to:
Create a New clinical data template and model from scratch
Upload a clinical data template that was prepared by another developer or downloaded from another instance of SanteEMR
Search for clinical data templates which are installed on the SanteEMR instance
View and Edit existing clinical data templates
Remove a clinical data template
Enable or Disable a clinical template
Clinical templates which are marked as Read-only are typically built-in or system templates. Removing these templates may result in them being re-installed when an applet is upgraded
To upload an existing template into the SanteEMR instance, use the Upload option. Select the downloaded template definition file and press upload.
Uploading a template which has the same identifier as a system or readonly template will result in an error. To upload an override of a built-in template, remove the readonly template and then upload the replacement ensuring that the version
is a higher number than 2
(which is used by the default readonly template installers.
To create a template, press the New button on the summary screen. Enter the required information and press Save
mnemonic
A unique name which is used by developers to identify the template in program code.
org.example.pain
Universal ID
An OID which is used when acts created using this template are disclosed over a standardized API (FHIR, HL7, etc.)
1.3.xxxxxx
(PEN)
2.25.xxxxxx
(UUID)
Name
A short human readable name which is used in drop-downs in the EMR interface when adding new acts to an encounter.
Pain Scale
Applies To
One or more encounter types (see: Visit Types & Flows) where this template can be added to.
The template details page is used to edit and/or modify existing template definitions in the SanteEMR instance.
The details page has three tabs in a default installation of the SanteEMR:
Properties: Used to edit the core properties (from the create template modal)
Model / Template: Used to define the RIM model which is used to create new instances
Views / Forms: Used to define the view, edit forms of the template in the SanteEMR clinic user interface.
The model/template tab in view mode will show the current definition as described in the template definition. The view shows an object explorer of the defined object which allows an administrator to expand and view the interpreted RIM model as the CDR will construct new data.
Read-only or system templates will provide an option to edit the model or template.
Clicking on the pencil icon will activate the editor for the RIM template, which is expressed in JSON view model (see: Conceptual Information Model).
The editor supports the CTRL+S keyboard shortcut for saving the current contents of the editor model.
Only valid models (with no issue markers) can be saved using CTRL+S or the Submit option
When the views and forms panel is in edit mode, new views can be created, this is done by clicking on the drop down and indicating the type of view that is being created, and pressing Add.
The view types are:
Entry: Used when a single data element is being captured today
Back Entry: Used for multiple data elements being back-entered
Detail View: The view as it appears in the encounter detail view
Summary View: The view as it appears in the encounter summary
When a new view or form is added, the default format is a Simplified form creation language. The editor allows developers to switch to HTML which provides more features, however does require more work and knowledge of HTML and the CDR.
Like the RIM editor, the CTRL+S key will save the current view. The live preview of the form as it would appear in the EMR user interface is rendered on the right-hand side of the screen.
Developers can also switch their views to HTML, this allows complete control over the behavior and rendering of the input form. Editing in HTML uses the same controls as described in the AngularJS section.
You can start your form in the simplified view to get a general layout of the input format and then convert the layout to HTML automatically to do fine tuning.
The simplified view to render a simple input would be expressed as:
In HTML this same view is expressed as:
Hovering over a UUID will load the definition of the UUID and display it for the developer
The RIM model is automatically loaded along with the documentation for each of the properties
Errors with the model are indicated with an error marker at the location where the error occurred