# Add and Configure Actions

**To integrate information retrieved from a DataSource into a List, field mapping actions are performed.** This process ensures accurate data merging by setting a common field as a Key between the DataSource and List records. Through this mapping, data from various sources can be effectively consolidated and managed.

{% hint style="info" %}
**What is Key?**

A common value used to merge data from the DataSource into the List.
{% endhint %}

{% hint style="info" %}
**Action Mapping Notes**

* **DataSource Field**

  Displays the fields from the object specified in the DataSource. These fields provide the source data to be integrated into the List.
* **List Field**

  Displays the fields from the object specified in the List Configurator. These fields serve as the destination for mapping the DataSource data.
* **Virtual Field**

  Displays virtual columns created in the List. These fields allow for displaying additional data derived from the DataSource without modifying the original object structure.
  {% endhint %}

***

### :small\_orange\_diamond: Steps to Add and Configure Actions

1\. In the **Actions** section, click the edit icon in the **Key** row.

<figure><img src="https://3800415611-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNuSjRiJMvVhtdzNDzWBi%2Fuploads%2FZnyGOqro63Otc0mdvgTv%2Fimage.png?alt=media&#x26;token=b1617263-584f-48a8-9960-ea4af9b4d8ab" alt=""><figcaption><p>Key Setting</p></figcaption></figure>

2\. Select the DataSource field and the List field with common values, then click the **Save** button.

<figure><img src="https://3800415611-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNuSjRiJMvVhtdzNDzWBi%2Fuploads%2F9nHWIrgb8dizpHQbJ1fb%2Fimage.png?alt=media&#x26;token=da99187a-602e-486c-8cb1-b55a83eeb34d" alt=""><figcaption><p>Key Setting Modal</p></figcaption></figure>

3\. Verify that the configured **Key** is applied correctly, then click the **Add Action** button.

<figure><img src="https://3800415611-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNuSjRiJMvVhtdzNDzWBi%2Fuploads%2Fl3hCczPCY2ktcxVlT3f9%2Fexmaple_step3.png?alt=media&#x26;token=0f3e87d7-fa9b-4708-bd6f-757673ee6c57" alt=""><figcaption><p>Edit Key Modal</p></figcaption></figure>

4\. Select the DataSource field from which data will be retrieved and choose the List field or virtual field where the data will be saved, then click the **Save** button.

<div><figure><img src="https://3800415611-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNuSjRiJMvVhtdzNDzWBi%2Fuploads%2FtAx41xPDqZAJOkhVUhqW%2Fexample_step4_1.png?alt=media&#x26;token=88ee8ac1-ae3f-4ba8-a1b1-3572d35b9014" alt="" width="563"><figcaption><p>Add Action Modal</p></figcaption></figure> <figure><img src="https://3800415611-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNuSjRiJMvVhtdzNDzWBi%2Fuploads%2FVNGkfG5d6xaecJZgIfoy%2Fexmaple_step4_2.png?alt=media&#x26;token=63761969-c551-462f-9d59-88df35117d87" alt="" width="200"><figcaption><p>Datatable Setup</p></figcaption></figure></div>

***

### :small\_orange\_diamond: Example

You want to display the price from the PricebookEntry object alongside a product list configured with Product2 in the List.

1. Search for and select PricebookEntry in the DataSource.
2. (Optional) In the Condition field, enter `IsActive = true` (similar to an SOQL WHERE clause).
3. To merge data for the matching PricebookEntry record:
   1. Click the edit button in the **Key** row.
   2. In the popup, configure the following, then save:
      * **DataSource Field**: Product2Id
      * **List Field**: Id
4. To display the **UnitPrice** from **PricebookEntry** in the List:
   1. Create a **virtual column** (e.g., SBLS\_Virtual1) in the **Datatable Setup**.
   2. Click the **Add Action** button.
   3. In the popup, configure the following, then save:
      * **DataSource Field**: UnitPrice
      * **Virtual Column**: SBLS\_Virtual1

<figure><img src="https://3800415611-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNuSjRiJMvVhtdzNDzWBi%2Fuploads%2FvXJZTV8rH1aOFrCd9YAq%2FExample1.png?alt=media&#x26;token=7571c3b0-c548-4155-913b-cad2e4268458" alt=""><figcaption><p>Basic DataSource Setup</p></figcaption></figure>
