Enable Substances

Learn how to update your Vault’s configuration to enable tracking Substances in individual Products.

About the Feature

Vault Safety can now track substances and their use in individual products. When adding a Case Product that is associated with a pre-configured Substance, the substance information is snapshotted to the Case Product.

This feature was added to Vault Safety in 20R2 and is available in Vaults deployed in 20R2 or later by default. For Vaults deployed in 20R1 or earlier, an administrator must perform the following configuration changes to enable this feature.

Manage Products and Manage Studies provide more information about this feature.

Update Permission Sets for Object Access

As an Administrator, we recommend that you update the relevant permission sets for the following objects to comply with new object configurations. We also recommend that you enable the permission to Read Substance and Product Substance objects for all users. For users who will be managing Products, you should enable the permission to Edit Substance and Product Substance objects.

1. In the Admin area, go to Users & Groups > Permission Sets, and then select the permission set you want to update.
2. In the permission set, select Objects, and then select Edit.
3. For the respective objects, select the applicable checkboxes to grant permissions to the following objects.
   • Substance
   • Case Product Substance
   • Product Substance
   • Reporting Family Member Type
4. Select Save.

Result

Your permission set has been updated with your selected object permissions.

Configure the Product and Drug Layout to Insert Related Object Section for Substances

1. In the Admin area, go to Configuration > Objects > Product > Layouts, and then select Product Detail Page Layout.
2. Select Insert Section at the top of the page, and then select Related Object. A box will appear.
3. Fill in the specified fields:
   • Related Object: (Required) Enter Product Substance.
   • Section Label: (Required) Enter Substances.
   • Section Name: (Required) Enter substance.
     
4. Select Done.
5. Select Save at the top of the page.
6. Repeat the above steps for Drug Page Layout.

Result

Your Product and Drug records are now configured to have the Related Object section for Substances.

Configure the Substance Layout to Insert Related Objects Section for Products

1. In the Admin area, go to Configuration > Objects > Substance > Layouts, and then select Substance Detail Page Layout.
2. Select Insert Section at the top of the page, and then select Related Object. A box will appear.
3. Fill in the specified fields:
   • Related Object: (Required) Enter Product Substance.
   • Section Label: (Required) Enter Products.
   • Section Name: (Required) Enter product.
     
4. Select Done.
5. Select Save at the top of the page.

Result

Your Substance records are now configured to have the Related Object section for Product Substance.

Configure the Case Product Substance Layout to Add Strength (Number) and Strength (Unit) Fields

1. In the Admin area, go to Configuration > Objects > Case Product Substance > Layouts, and then select Case Product Substance Detail Page Layout.
2. There are two options available to add these fields
   • In the Details section, select Add, and then select . This is the combined Strength control that combines the Strength (Number) and Strength (Unit) fields together. We recommend you use this option.
   • In the Substance Details section, select Add, and then select Strength (Number) and Strength (Unit).
3. Select Save at the top of the page.

Result

Your Case Product Substance records are now configured to display the Strength field(s).

Configure the Study Product Substance Layout to Include the New Substance Field

1. In the Admin area, go to Configuration > Objects > Study Product Substance > Layouts, and then select Study Product Substance Detail Page Layout.
2. In the Details section, select Add, and then select Substance Name.
3. Select Save.

Result

Your Study Product Substance records are now configured to display the Substance field.

Verify the Case Product Layout Includes Substances

Most Vaults include the Substances section on the Case Product Layout by default. However, some Vaults based on older templates may not have this configuration.

Go to Configuration > Objects > Case Product > Layouts, and verify that there is a Substances related objects section in the following Case Product layouts:

• Biologic Page Layout
• Case Product Detail Page Layout
• Drug Page Layout
• External Product Page Layout
• Study Product Page Layout

If the section is not present, insert a related object section for Substances.

(Optional) Remove Study Product Substance from Layouts

This configuration is optional but highly recommended. Update this configuration on the following layouts:

• Biologic Page Layout
• Drug Page Layout
• External Product Page Layout
• Study Product Detail Page Layout

1. In the Admin area, go to Configuration > Objects > Study Product > Layouts, and then open the layout.
2. Remove the Substances related object section:
   
   
3. Save the layout and repeat these steps for each of the Study Product layouts mentioned above.

Result

The Substance section has been deleted from your Study Product records.

(Optional) Remove Study Product Substance from Layouts

You can optionally update your Vault’s Business Admin (Quick Access) navigation tab to add Substances as a subtab for convenient navigation. To add a subtab, go to Configuration > Vault Navigation > Tabs.