Learn how to configure your Vault to support custom Dose Forms, Routes of Administration, and Unit of Measurement values.
About the Feature
In addition to system-provided values, you can use two (2) new Dictionary actions to add, edit, deprecate, and delete custom Dose Forms, Routes of Administration, and Unit of Measurement values within Vault Safety. Once loaded, custom values are immediately available for intake, Case processing, and EDQM mapping. System-provided values cannot be changed.
Once you enable this feature, see Manage Custom Dose Forms, Routes of Administration, and Units of Measurement for more information.
Update Layouts
The following new fields are available for easy identification of and information on custom values:
- Created By (dictionary): Identifies which user created the custom value
- Deprecated: Indicates whether a value is available in picklists for intake, Case processing, and EDQM mapping. When set to Yes or True, the value is not available.
- Last Modified By (dictionary): Identifies the person who last updated the custom value
- System Managed: Indicates whether a value is system-provided or user-created. When set to Yes, the value is system-provided and cannot be changed.
Add the fields to the following objects and layouts:
Object | Layout |
---|---|
Agency Unit of Measurement | Agency Unit of Measurement Detail Page Layout |
Dose Form | Dose Form Detail Page Layout |
Route of Administration | Route of Administration Detail Page Layout |
Unit of Measurement | Unit of Measurement Detail Page Layout |
- Go to Admin > Configuration > Objects > [object] > Layouts > [layout].
- Select Add and then select a field.
- Repeat step 2 for each field being added.
- Select Save.
Create Dictionary Records
Dictionaries enable you to upload CSV files with custom values and troubleshoot any issues. Create dictionaries for each of the following customizable values:
- Agency Unit of Measurement
- Dose Form
- Route of Administration
- Unit of Measurement
Use the following steps to create dictionaries:
- Go to Business Admin > Objects > Dictionaries.
- Select Create.
- In the Select Dictionary Type picklist, select a type and then select Continue.
- On the Create [Dictionary Type] page, enter a name for the dictionary in the Name field.
- Select Save.
Result
The dictionary is created with an Attachments section, where CSV files are uploaded for record management.
Create and Configure Custom Value Actions
You must create and then configure the Upsert Records and Delete Records actions.
Create Actions on the Dictionary Object
Complete the following steps to add the Upsert Records and Delete Records actions to the Dictionary object:
- Go to Admin > Configuration > Objects > Dictionary > Actions.
- Select Create.
- In the Select Action field, select Upsert Records and then Continue.
- On the Create Action page, select Save.
- Repeat steps 1–4 to add the Delete Records action.
Configure Actions on the Dictionary Object Lifecycle
Add the Upsert Records and Delete Records actions to the Dictionary object lifecycle for the following states:
- Active
- Error
Complete the following steps to add the actions:
- Go to Admin > Configuration > Object Lifecycles > Dictionary Lifecycle.
- In the States section, select a state.
- In the User Actions section, select Edit and then Create Rule.
- Select Perform with conditions.
- Select If Dictionary Type > includes > Agency Unit of Measurement, Dose Form, Route of Administration, Unit of Measurement.
- Under Allow the following actions, select the following:
- Upsert Records and add an Action Label
- Delete Records and add an Action Label
- Select Save.