Enable the New Substance Name Field in the Product Library

Learn how to configure your Vault to export 250-character Substance Names for greater E2B compliance.

Note Beginning with 24R1 in April 2024 and for all subsequent releases, the new Vault Safety Help site is the official site for all Vault Safety Help content. This site reflects updates until the 23R3 release only. For the latest information, visit the new site.

About the Feature

To match E2B guidance, the Vault Safety Product Library now supports up to 250 characters when adding Substance Names. This feature means that more accurate Substance descriptions can be entered, improving compliance on E2B Transmissions in the following data elements:

  • E2B(R3): G.k.2.3.r.1 Substance / Specified Substance Name
  • E2B(R2): B.4.k.2.2 Substance / Specified Substance Name

When your Product Library is configured with the new 250-character Substance Name field, that value is populated during Case processing for Case Product Substance Names and Localized Case Product Substance Names. If the new field is blank, the value in the existing 128-character Substance Name field is populated. The value on the Case or Localized Case is then exported to E2B reports.

In the 23R2 release, the 250-character Substance Name field will be included in the Vault Safety template. For Vaults created earlier, you can complete the following configuration outlined below. Then, see Manage Products: Add Substances for more information about using this feature.

Configure the Substance and Localized Substance Objects

To export 250-character Substance Names from Cases and Localized Cases on E2B reports, you must update the Substance and Localized Substance page layouts.

In addition, we recommend configuring the Substance and Localized Substance objects so that Business Admins can enter values in only the new Substance Name field. This overrides the requirement to enter a value in the existing 128-character Substance Name field.

Update the Substance Page Layout

Complete the following steps to add the Substance Name field that supports 250 characters to the Substance page layout.

  1. Go to Admin > Configuration > Objects > Substance > Page Layouts > Substance Detail Page Layout.
  2. In the Details section, select Add, and then add the Substance Name field.
  3. Select Save.

Note To differentiate the Substance Name fields, you can edit the label of either the original Substance Name (name__v) or the new Substance Name (substance_name__v) field. Go to the Fields tab, select a field, and then edit the Label.

(Optional) Configure Substance Name Entry on Substances

Complete the following steps to make the 128-character Substance Name field read-only, so that Business Admins must enter values only in the 250-character Substance Name field.

  1. Go to Admin > Configuration > Objects > Substance > Fields.
  2. Select the Substance Name (name__v) field.
  3. Select Edit.
  4. In the Options section, select the System manages field value (read-only) checkbox.
    Result: The Value Format* field is populated with “VV-{######}” and the Starting Number field is populated with “1”.
  5. Select Save.

Update the Localized Substance Page Layout

Complete the following steps to add the Substance Name field that supports 250 characters to the Localized Substance page layout.

  1. Go to Admin > Configuration > Objects > Localized Substance > Page Layouts > Localized Substance Detail Page Layout.
  2. In the Details section, select Add, and then add the Substance Name field.
  3. Select Save.

Note If you edited a Substance Name label on the Substance object, we recommend making the same change on the Localized Substance object.

(Optional) Configure Substance Name Entry on Localized Substances

Complete the following steps to make the 128-character Substance Name field read-only, so that Business Admins must enter values only in the 250-character Substance Name field.

  1. Go to Admin > Configuration > Objects > Localized Substance > Fields.
  2. Select the Name (name__v) field.
  3. Select Edit.
  4. In the Options section, select the System manages field value (read-only) checkbox.
    Result: The Value Format* field is populated with “VV-{######}” and the Starting Number field is populated with “1”.
  5. Select Save.