# Enable Combination Products

Learn how to update your Vault's configuration to enable _Combination Products_.

## About the Feature

Support for _Combination Products_ was added in 20R2. Vaults created in 20R2 or later include this functionality by default, while Vaults created in 20R1 or earlier must have the configuration upgrades described on this page to enable this feature.

Once you enable this feature, <a href="/en/gr/01214/">Manage Combination Products</a> describes how to set up and use _Combination Products_.

### 25R3 Update: Combination Product Type Identification {#r253}

With the 25R3 release, Safety includes the _Combination Product Type_ field on the _Product_ object, which Vault populates based on the product type of related active _Product Constituents_ and their _Product Registrations_. To use this feature, you must [configure][1] your Vault.

After configuring this feature, see <a href="/en/gr/01214/#combo-type">Manage Combination Products</a> for more information.

## Vaccine Combination Products

You must perform additional configuration to use combination products with a vaccine constituent. The <a href="/en/gr/01398/">vaccine feature enablement instructions</a> provide more information. 

## Mandatory Configuration

The following configuration is required to enable _Combination Products_.

### Add the Combination Product Layout

1. Navigate to **Admin > Configuration > Objects > Product**.
2. On the _Layouts_ tab, open the **Combination Product Detail Page Layout**. If this layout does not exist, create a new layout with this name for the _Combination Product_ object type.
3. Update the _Details_ section to include the following fields:
    * **Organization**
    * **Product Name**
    * **Combination Type**
    * **Abbreviation**
    * **Generic Name**
    * **Manufacturer**
    * **Core Datasheet**
4. Insert a **Product Constituents** Related Object section with the following details:
    * **Related Object**: Product Constituent
    * **Section Label**: Product Constituents
    * **Creation Option**: Create record in new page
    * **Columns**: 
         * Name
         * Product Type
         * Constituent Product
5. Insert a **Product Registrations** Related Object section with the following settings:
    * **Related Object**: Registration
    * **Section Label**: Product Registrations
    * **Creation Option**: Create record in new page
    * **Columns**: 
        * Name
        * Registration Type
        * Product Constituent
        * PMOA
        * Country
        * Agency

### Update the Case Layout

1. Navigate to **Admin > Configuration > Objects > Case**.
2. On the _Layouts_ tab, open the **Case Page Layout**.
3. Insert a _Device Details_ section with the following fields:
    * **Device Report Type**
    * **Malfunction-Only**
    * **Device Follow-Up Type**
    * **Remedial Action**
    * **Remedial Action - Other**

### Update the Device Case Product Layout

1. Navigate to **Admin > Configuration > Objects > Case Product**.
2. On the _Layouts_ tab, open the **Device Detail Page Layout**.
3. Edit the _Device Information_ section to add the following fields:
    * **Device Evaluated**
    * **Manufacture Date (combined control)**
    * **Device Usage Type**
    * **Device Age (combined control)**
4. Insert a _Device Problem and Evaluation Codes_ section with the following fields:
    * **Device Problem**
    * **Evaluation Method**
    * **Evaluation Result**
    * **Evaluation Conclusion**

### Update the Submission Layout

1. Navigate to **Admin > Configuration > Objects > Transmission**.
2. On the _Layouts_ tab, open the **Submission Detail Page Layout**.
3. Add the **FDA Report Type** field to the _Details_ section.

### Configure Tabs 

1. Navigate to **Admin > Configuration > Tabs**.
2. Expand _Business Admin (Quick Access)_ and select **Product Library**.
3. Add a new **Product Library** tab with all of the original object types, with the addition of _Combination Products_.
4. Remove the previously used **Product Library** tab.

### Update Permissions

You must update permission sets to make the Combination Products feature available to users.

#### Grant Read Access to Combination Product Components

Navigate to **Admin > Users & Groups > Permission Sets** and update the following permission sets: 

* _Administration Actions_
* _Case Distribution Actions_
* _Case Entry Actions_
* _Case Intake Actions_
* _Safety Operations Actions_
* _Safety Writer_
* _Submission Actions_

Ensure each of the above permission sets has _Read_ access to the following components:

* _Combination Product_ object type under _Product_
* _Product Constituent_ object
* Each field within the _Product Constituent_ object
* _Device Follow-Up Type_ object type under _Controlled Vocabulary_
* _Device Usage Type_ object type under _Controlled Vocabulary_
* _Remedial Action_ object type under _Controlled Vocabulary_
* _Device Problem_ object type under _Device Code_
* _Evaluation Conclusion_ object type under _Device Code_
* _Evaluation Method_ object type under _Device Code_
* _Evaluation Result_ object type under _Device Code_

#### Grant Full Combination Product Management Access to Admins

For the _Administration Action_ permission set, grant _Create_, _Edit_, and _Delete_ permissions to the following components: 

* _Combination Product_ object type under _Product_
* _Product Constituent_ object

## Recommended Configuration

The following configuration is optional but recommended for the best user experience.

### Add Combination Products to the Organization Layout for Sponsors 

1. Navigate to **Admin > Configuration > Objects > Organization**.
2. On the _Layouts_ tab, open the **Sponsor Detail Page Layout**.
3. Edit the **Product** related object section to add the following filter:
      <br>`Product Type` | `is not equal to` | `Combination Product`
4. Insert a **Combination Products** related object section with the following filter:
      <br>`Product Type` | `is equal to` | `Combination Product`
5. In the **Combination Products** section, add the following columns:
     * Product Name
     * Combination Type

### Add Combination Products to Product Layouts

Make the changes described in this section to the following layouts:

* _Device Detail_
* _Biologic_
* _Drug_
 
1. Navigate to **Admin > Configuration > Objects > Product > Layouts**.
2. Select a layout.
3. Edit the _Registrations_ section to add the **PMOA** field.
4. Insert a new related object section with the following details:
   * **Related Object**: `Product Constituent`
   * **Section Label**: `Combination Products`
   * **Columns**: 
     * Name
     * Combination Product

### Update the Product Registration Layout

1. Navigate to **Admin > Configuration > Objects > Product Registration**.
2. On the _Layouts_ tab, open the **Product Registration Detail Page Layout**.
3. Edit the _Details_ section to add the following fields:
   * **Product Constituent**
   * **Product Type**
   * **PMOA**

### Update Case Product Layouts

Make the changes described in this section to the following layouts:

* _Device Detail_
* _Biologic_
* _Drug_

1. Navigate to **Admin > Configuration > Objects > Case Product > Layouts**.
2. Select a layout.
3. Edit the _Details_ section to add the following fields:
   * **Combination Product**
   * **Combination Product Registration**

### Optional Template Updates for Combination Products

The following configuration was a <a class="external-link " href="https://rn.veevavault.help/en/gr/archive/safety/20r3/20r3-safety-template-revisions/" target="_blank" rel="noopener">20R3 Template Revision<i class="fa fa-external-link" aria-hidden="true"></i></a> and is included by default in Vaults configured in 20R3 or later.

For legacy Vaults, this configuration is optional but may improve user experience.

#### Update the Case Layout Rules with Device Details

1. Navigate to **Admin > Configuration > Objects > Case > Layouts > Case Page Layout > Layout Rules**.
2. Select **Create**.
3. Create the layout rule with the following details:
    * **Label**: Device Details
    * **Name**: `device_details__c`
    * **Hide the following Page Layout Items**:
        * **Type**: Sections
        * **Values**: Device Details
    * **IF this Layout Rule Expression is TRUE**: `product_type__vr.name__v != "Combination Product"`
4. Select **Save**.

#### Update the Constituent Product Field on Product Constituent Object

1. Navigate to **Admin > Configuration > Objects > Product Constituent > Fields > Constituent Product**.
2. Select **Edit**.
3. Update the Criteria VQL field to:<br> `organization_v = this.organizationv AND object_typevr.api_namev != 'combination_product_v'`
4. Select **Save**.

## (25R3) Configure Combination Product Type Identification {#configure-product-type}

To configure your Vault to identify the product type of _Combination Products_ based on _Product Constituents_ and their _Product Registrations_, <a href="/en/gr/26387/#how-to-add-object-fields">add</a> the **Combination Product Type** field to the _Combination Product Detail Page Layout_ of the _Product_ object.

[1]: #configure-product-type