---
schema_version: "1"
id: 2a86d1e152c8e057afc5c25bfeddeab511883f7e454347bb4d2da54e48fe9da3
title: Create a Basic List Merge Example (Managed Package)
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/xcloud/264-0-0/os_create_a_basic_list_merge_example.md
canonical_url: https://help.salesforce.com/s/articleView?id=xcloud.os_create_a_basic_list_merge_example.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: a88563836a4745348c44c63b251d1ce74ce34f310ada60ef67ccc9c0d20ec3b0
description: For the managed package runtime, the first Integration Procedure retrieves all Contacts with the same AccountId in two lists, one containing addresses, the other birthdates. It then merges the two lists into one.
products:
  - Omnistudio
release: "264"
---
# Create a Basic List Merge Example (Managed Package)

For the managed package runtime, the first Integration Procedure retrieves all Contacts with the same AccountId in two lists, one containing addresses, the other birthdates. It then merges the two lists into one.

![Managed Package app icon](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-xcloud-omnistudio_for_managed_packages-264-0-0-production-enus/aa2554ec-624a-4ee6-8da4-6435670e6e62/resources-global/_corporate/images/managedpackageicon.png) This information is for Omnistudio for Managed Packages. For Omnistudio on standard runtime, see [Omnistudio Help](https://help.salesforce.com/s/articleView?id=xcloud.os_omnistudio_standard.htm&language=en_US).

To download a DataPack of this example for Omnistudio for Managed Packages, click [here](https://volt.my.salesforce.com/sfc/p/o0000000IKm8/a/3m0000005uJ4/ASj5zMjJi_JWfK4_zaIMT9Jt0N5SMJfzgL11UZAxYBE).

The Integration Procedure has these components:

1. An Omnistudio Data Mapper Extract Action component named DRExtractAddresses
2. A Data Mapper Extract Action component named DRExtractBirthdates
3. A List Merge Action named ListAction1
4. A Response Action named ResponseAction1

The Structure panel looks like this:

![The contents of the Structure panel are listed in the preceding text.](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-xcloud-omnistudio_for_managed_packages-264-0-0-production-enus/aa2554ec-624a-4ee6-8da4-6435670e6e62/omnistudio_for_managed_packages/images/iplistmerge1.png)

To build this Integration Procedure:

1. Create the Data Mapper Extract that the DRExtractAddresses component calls. Name it GetAddresses and give it these settings: <table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small ">
          <tbody><tr class="">
            <th style="vertical-align:top;" headers="d302008e89-option" id="d302008e93">Extract</th>

            <td style="vertical-align:top;" headers="d302008e89-desc d302008e93">A Contact extract step set to&nbsp;contact <kbd>AccountId =
                id</kbd>
            </td>

          </tr>
          <tr class="">
            <th style="vertical-align:top;" headers="d302008e89-option" id="d302008e105">Output</th>

            <td style="vertical-align:top;" headers="d302008e89-desc d302008e105">These mappings:<ul>
                <li><kbd>contact:Id</kbd> to
                  <kbd>contact:id</kbd>
                </li>
                <li><kbd>contact:FirstName</kbd>&nbsp;to&nbsp;<kbd>contact:firstName</kbd>
                </li>
                <li><kbd>contact:LastName</kbd>&nbsp;to&nbsp;<kbd>contact:lastName</kbd>
                </li>
                <li><kbd>contact:MailingStreet</kbd>&nbsp;to&nbsp;<kbd>contact:street</kbd>
                </li>
                <li><kbd>contact:MailingCity</kbd>&nbsp;to&nbsp;<kbd>contact:city</kbd>
                </li>
                <li><kbd>contact:MailingState</kbd>&nbsp;to&nbsp;<kbd>contact:state</kbd>
                </li>
              </ul>

            </td>

          </tr>
        </tbody></table>
    
    If you aren't sure how to create a Data Mapper Extract, see the examples in [Omnistudio Data Mapper Extract Examples (Managed Package)](https://help.salesforce.com/s/articleView?id=xcloud.os_dataraptor_extract_examples.htm&release=264.0.0&type=5 "For the managed package runtime, Data Mapper Extract examples demonstrate object relationships, paging with data values, paging with offsets, working with attributes, and relationship notation.").
2. Create the Data Mapper Extract that the DRExtractBirthdates component calls:
    1. Clone the GetAddresses Data Mapper and name the clone GetBirthdates.
    2. On the Output tab, delete the city, state, and street mappings.
    3. Add a mapping from contact:Birthdate to contact:birthdate.
3. From the Omnistudio Integration Procedures tab, click **New**.
4. Provide an **Integration Procedure Name**, a **Type**, and a **SubType**, and click **Save**.
5. Drag the first Data Mapper Extract Action component into the Structure panel.
6. Give the component an **Element Name** of DRExtractAddresses and a **Data Mapper Interface** of GetAddresses.
7. Drag the second Data Mapper Extract Action component into the Structure panel below the first.
8. Give the component an **Element Name** of DRExtractBirthdates and a **Data Mapper Interface** of GetBirthdates.
9. Drag a List Action component into the Structure panel below the second Data Mapper Extract Action component and give it these settings: <table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small ">
          <tbody><tr class="">
            <th style="vertical-align:top;" headers="d302008e282-option" id="d302008e286">MERGE LISTS ORDER</th>

            <td style="vertical-align:top;" headers="d302008e282-desc d302008e286">
              <ul>
                <li>
                  <kbd>DRExtractAddresses:contact</kbd>
                </li>

                <li>
                  <kbd>DRExtractBirthdates:contact</kbd>
                </li>

              </ul>

            </td>

          </tr>
          <tr class="">
            <th style="vertical-align:top;" headers="d302008e282-option" id="d302008e310">MERGE FIELDS</th>

            <td style="vertical-align:top;" headers="d302008e282-desc d302008e310">
              <kbd>id</kbd>
            </td>

          </tr>
          <tr class="">
            <th style="vertical-align:top;" headers="d302008e282-option" id="d302008e322">SORT BY</th>

            <td style="vertical-align:top;" headers="d302008e282-desc d302008e322">
              <ul>
                <li>
                  <kbd>lastName</kbd>
                </li>

                <li>
                  <kbd>firstName</kbd>
                </li>

              </ul>

            </td>

          </tr>
        </tbody></table>
10. Drag a Response Action component below all the others.
11. Give the component a **Send JSON Path** of ListAction1 and a **Send JSON Node** of contactMerge.
12. On the Preview tab, in the Input Parameters pane, click Add New Key/Value Pair.
13. Enter id as the **Key** and an Account Id from your org as the **Value**.
14. Click **Execute**.
    
    The output looks like this:
    
    ```
    {
      "contactMerge": [
        {
          "birthdate": "1975-10-03",
          "street": "300 Broadway",
          "state": "FL",
          "city": "Orlando",
          "lastName": "Jones",
          "id": "0036100001E5xrWAAR",
          "firstName": "Cathy"
        },
        {
          "birthdate": "1976-10-04",
          "street": "400 Washington Blvd",
          "state": "AZ",
          "city": "Phoenix",
          "lastName": "Jones",
          "id": "0036100001E5xrvAAB",
          "firstName": "Doug"
        },
        {
          "birthdate": "1973-10-01",
          "street": "100 Main Street",
          "state": "CA",
          "city": "San Francisco",
          "lastName": "Smith",
          "id": "0036100001E5xqnAAB",
          "firstName": "Albert"
        },
        {
          "birthdate": "1974-10-02",
          "street": "200 Second Street",
          "state": "OR",
          "city": "Portland",
          "lastName": "Smith",
          "id": "0036100001E5xr2AAB",
          "firstName": "Ben"
        }
      ]
    }
    ```

What’s next: [Create an Advanced List Merge Example (Managed Package)](https://help.salesforce.com/s/articleView?id=xcloud.os_create_an_advanced_list_merge_example.htm&release=264.0.0&type=5 "For the managed package runtime, the next Integration Procedure is a modified version of the previous example. Instead of matching list items using Id fields, it uses the Advanced Merge feature to match first and last names.").