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

  • Release version: Australia
  • Updated March 12, 2026
  • 1 minute to read

    • 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.
    Table 1. Default mapping of the dosage-related characteristic groups and Dosage details fields

    Dosage characteristic group

    Dosage details field

    Dosage - dosage

    Dosage

    Dosage - number of authorized refills

    Number of authorized refills

    Dosage - instructions for patient

    Instructions for patient

    Dosage - quantity

    Quantity

    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.
    4. 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.
    5. On the Extension Point form, click Update.