> For the complete documentation index, see [llms.txt](https://help.smallbuilder.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.smallbuilder.com/ko/smallbuilder-lists/undefined-1-1/datasource-setup/basic-datasource/add-and-configure-actions.md).

# 작업 추가 및 설정

데이터 소스에서 가져온 정보를 리스트와 통합하기 위해 필드 매핑 작업을 수행합니다. **이 과정에서 데이터 소스와 리스트 레코드 간 공통된 값을 가진 필드를 키(key)로 설정하여 정확한 데이터 결합을 보장합니다.** 이러한 매핑 과정을 통해 다양한 소스의 데이터를 효과적으로 통합하고 관리할 수 있습니다.

{% hint style="info" %}
Key

* 데이터 소스와 리스트 레코드 간 공통된 값으로서 데이터 소스에서 가져온 정보를 리스트와 통합하는데 사용됩니다.
  {% endhint %}

{% hint style="info" %}
DataSource Field

* 데이터소스에서 지정한 개체의 필드를 보여줍니다.

Lists Field

* 리스트에서 지정한 개체의 필드를 보여줍니다.

Virtual Fiel

* 리스트에서 생성한 가상 열들을 보여줍니다.
  {% endhint %}

***

### :small\_orange\_diamond: 작업 추가 및 설정 방법

1\. 작업(Actions) 탭의 Key 행에 있는 편집 아이콘을 클릭합니다.

<figure><img src="/files/dgCSZpA7xbtKufrJSnyV" alt=""><figcaption><p>key 설정</p></figcaption></figure>

2\. 공통된 값을 가진 데이터 소스 필드와 리스트 필드를 선택하고 저장(Save) 버튼을 클릭합니다.

<figure><img src="/files/p0AJZmsrrnL5iwNmVyqu" alt=""><figcaption><p>Key 설정</p></figcaption></figure>

3\. 설정한 Key가 올바르게 적용됐는지 확인하고, 작업 추가(Add Action) 버튼을 클릭합니다.

<figure><img src="/files/Z2HdikbQ8OmCQjcYwf3G" alt=""><figcaption><p>작업 추가</p></figcaption></figure>

4\. 데이터를 가져올 데이터 소스 필드를 선택하고 이를 저장할 리스트 필드 또는 가상 필드를 선택한 후, 저장(Save) 버튼을 클릭합니다.

<figure><img src="/files/bRYzsPl2U7MDg8lZFEBC" alt=""><figcaption><p>작업 추가</p></figcaption></figure>

***

### :small\_orange\_diamond: 예시

리스트의 개체를 Product2로 지정하여 제품 목록을 검색하려고 합니다. 해당 목록에 PricebookEntry 개체에 있는 단가를 함께 표시하려고 합니다.

1. 버튼을 눌러 'PricebookEntry'를 검색 후 선택합니다.
2. (선택) Condition 란에 `Product2Id IN {$Current.Id}`를 입력합니다. (SOQL `Where`문과 동일)
3. Product에 맞는 PricebookEntry 데이터를 결합하기 위해 Key 행의 가장 우측에 있는 편집 버튼을 누릅니다.
4. 열린 팝업창에서 아래와 같이 선택 후 저장합니다.
   * DataSource Field : Product2Id
   * Lists Field : Id
5. PricebookEntry의 단가를 리스트 컬럼에 표시하기 위해 작업 추가(Add Action)을 누릅니다.\
   (작업하기 전 [**데이터 테이블 설정**](/ko/smallbuilder-lists/undefined-1-1/datatable-setup.md)에서 [**가상 열**](/ko/smallbuilder-lists/undefined-1-1/datatable-setup.md#virtual)을 생성합니다.)
6. 열린 팝업창에서 아래와 같이 선택 후 저장합니다.
   * DataSource Field : UnitPrice
   * Virtual Field : SBLDVirtual1 (작업하기 전 생성한 가상 열)

<figure><img src="/files/Jjg9G2oj6lmzTUqFFPZz" alt=""><figcaption></figcaption></figure>
