Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Configure the mapping between a dosage characteristic and a dosage details field

Use scripted extension points to decide which dosage characteristics are mapped to the fields on the Dosage details section of a Medication Prescription form.

Before you begin

Set the application scope to Healthcare and Life Sciences Service Management Core using the application picker. For more information, see Application picker.

Role required: admin

About this task

The Healthcare and Life Sciences Service Management Core application installs the sn_hcls.DosageCharacteristicsMapper script include and the DosageCharacteristicsMapper extension point.

The DosageCharacteristicsMapper extension point in the sn_hcls.DosageCharacteristicsMapper script include is preconfigured for the mapping between characteristics in the dosage-related characteristic groups and the Dosage details fields on a medication prescription. The default implementation of the getMappingObject method in the DosageCharacteristicsMapper extension point maps the dosage-related characteristic groups and Dosage details fields of a Medication Prescription form as shown in the following table.

Dosage characteristic groupDosage details field
Dosage - dosageDosage
Dosage - number of authorized refillsNumber of authorized refills
Dosage - instructions for patientInstructions for patient
Dosage - quantityQuantity

Using extension points makes it easier to integrate customizations without actually altering the base code. You can extend standard base functionality using customized scripts. For more information, see Using extension points to extend application functionality.

An implementation is available in the base system for scripted extension points. You can modify the data and add additional fields.

Procedure

  1. Navigate to All > System Extension Points > Scripted Extension Points.

  2. In the API Name column, search for and click sn_hcls.DosageCharacteristicsMapper.

  3. On the Extension Point form, select a script include to use the DosageCharacteristicsMapper extension point.

    • Modify the existing script by going to the Implementations related list and clicking DosageCharacteristicsMapper.
    • Create and register a custom script include.
    • Include your mapping logic by adding the getMappingObject method to your script include that implements the DosageCharacteristicsMapper extension point.

    You can create multiple implementations for the extension point and provide an order number for each implementation. The implementation that has the lowest order number is executed first.

  4. On the Extension Point form, click Update.