---
sourceDocument: 호주 애플리케이션 빌드 또는 수정
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/application-development

 Release :

    - australia

ft:locale :

    - ko-KR

ft:publication_title :

    - 호주 애플리케이션 빌드 또는 수정

ft:clusterId :

    - cadev

bundleId :

    - cadev

workflow :

    - Development, Data, and Analytics


---

# 클라이언트 상태 매개변수를 사용하여 구성요소의 상태 업데이트

# 클라이언트 상태 매개변수를 사용하여 구성요소의 상태 업데이트 {#ariaid-title1}

* 릴리스 버전: Australia
* 
* 업데이트 날짜 2026년 03월 12일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 3분

에서 구성요소 UI 빌더에 클라이언트 상태 매개변수 값을 생성하고 바인딩합니다. 구성요소에 사용자 지정 값을 추가하면 스크립트를 통해 이러한 구성요소를 자동으로 업데이트할 수 있습니다.

## 시작하기 전에

필요한 역할: ui_builder_admin

## 이 태스크 정보

페이지에 두 개의 구성요소를 추가한 다음 [클라이언트 상태 매개변수](https://servicenow-prod.fluidtopics.net/n9UkHaM8My2Hv3gyqpYW0w#gloss-client-state-parameter-ui-builder "해당 페이지에 대한 데이터(클라이언트 상태)만 저장하기 위해 페이지에 대해 정의된 페이지 변수입니다. 예를 들어, 기록을 생성하는 데 필요한 입력을 저장하고 목록을 새로 고칠 시기를 지정하는 세 가지 클라이언트 상태 매개변수를 생성합니다. 클라이언트 스크립트와 이벤트를 통해 페이지 변수를 업데이트하면 페이지를 동적으로 만들 수 있습니다.")[와 스크립트](https://servicenow-prod.fluidtopics.net/n9UkHaM8My2Hv3gyqpYW0w#gloss-client-script-ui-builder "페이지의 구성요소 및 클라이언트 상태 매개변수와 상호 작용하는 클라이언트 측 JavaScript 클라이언트 스크립트는 UI 빌더에서 이벤트 핸들러로 이벤트에 매핑됩니다.")를 사용하여 연결할 수 있습니다. 먼저 클라이언트 상태 매개변수를 만든 다음 클라이언트 상태 매개변수를 레이블과 같은 구성요소 중 하나에 바인딩합니다. 다음으로 클라이언트 스크립트를 생성하고 이벤트 핸들러를 사용하여 버튼과 같은 두 번째 구성요소에 바인딩합니다. 이벤트 핸들러를 만들 때 클라이언트 상태 매개변수 값을 바인딩하여 두 구성요소를 연결합니다. 한 구성요소를 클릭하면 다른 구성요소의 상태가 변경됩니다. 클라이언트 상태는 스크립트를 통해 자동으로 업데이트될 수 있는 구성요소에 사용자 지정 값을 추가할 수 있기 때문에 유용합니다. 클라이언트 상태를 페이지와 관련된 정보를 저장하기 위한 버킷으로 생각하십시오.

예를 들어 페이지에 버튼과 레이블 구성요소를 추가할 수 있습니다. 이 버튼은 텍스트 색 변경과 같이 레이블 값을 변경합니다.

## 프로시저

1. 다음으로 이동 모두Now Experience 프레임워크UI 빌더.
2. 선택하여 작업할 경험을 열거나 경험을 생성합니다. 작성경험.  
   경험 생성에 대한 자세한 내용은 다음을 참조하십시오 [UI 빌더에서 사용자가 애플리케이션과 상호 작용하는 방법 구성](https://servicenow-prod.fluidtopics.net/wmSXv2G8HVoRum7Zuh3W9w "에서 경험이 UI 빌더무엇인지 알아봅니다. 경험에 포함된 내용을 이해합니다.") .
3. 페이지를 만들거나 엽니다.  
   자세한 내용은 [페이지 및 페이지 변형 관리 UI 빌더](https://servicenow-prod.fluidtopics.net/zIp3eqVhhBAhq5PargLw8g "페이지가 UI 빌더무엇인지 알아봅니다. 열 레이아웃 및 구성요소와 같은 페이지의 UI 빌더 구성 요소를 이해합니다.") 문서를 참조하십시오.
4. 페이지에 두 개의 구성요소를 추가합니다.  
   자세한 내용은 [구성요소 추가 및 구성](https://servicenow-prod.fluidtopics.net/qmxQoGzAEcZmJDRXYpo1aw#add-components "에서 페이지에 UI 빌더구성요소를 추가하는 방법에 대해 알아봅니다. 구성요소를 추가하여 페이지가 빌드됩니다.") 문서를 참조하십시오.
5. 연결된 값으로 클라이언트 상태 매개변수를 정의하려면 왼쪽 아래 패널에서 클라이언트 상태 매개변수를 선택합니다.
6. + 추가를 선택합니다.
7. 클라이언트 상태 이름, 유형 및 초기 값의 이름을 입력합니다.  
   클라이언트 상태는 문자열, 숫자, 부울 및 JSON을 지원합니다. 예를 들어 이름을 <kbd class="ph userinput">dynamic_label_value</kbd>로, 유형을 <kbd class="ph userinput">문자열</kbd>로, 초기 값을 <kbd class="ph userinput">초기 값</kbd>으로 입력할 수 있습니다.
8. 클라이언트 상태 매개변수의 값을 구성요소에 바인딩합니다.
   1. 클라이언트 상태 매개변수를 바인딩할 구성요소를 선택합니다.
   2. 구성 패널을 열고 구성 탭을 선택합니다.
   3. 데이터를 바인딩할 필드를 가리키고 동적 데이터 바인딩 아이콘( ![동적 데이터 바인딩 아이콘.]())을 선택합니다.  
      데이터 바인딩 모달이 나타납니다.
   4. 데이터 유형 탭에서 클라이언트 상태를 선택합니다.
   5. 구성요소에 바인딩할 클라이언트 스크립트를 두 번 클릭합니다.
   6. 적용을 선택합니다.
   {#state-parameters__substeps_dvq_rh2_cqb}
9. 저장을 선택합니다.
10. 클라이언트 상태 값을 하나의 구성요소에 바인딩하고 스크립트를 생성하여 두 번째 구성요소를 첫 번째 구성요소에 연결합니다.
    1. 왼쪽 창에서 클라이언트 스크립트 옆에 있는 + 아이콘을 선택합니다.
    2. 작업을 설명하는 스크립트 이름을 입력합니다.  
       예를 들어, 스크립트에서 수행하려는 작업이므로 <kbd class="ph userinput">업데이트 레이블 값을</kbd> 입력할 수 있습니다.
    3. Now 코드 편집기에서 스크립트를 추가합니다.  
       호출할 API와 API에 대한 매개변수(예: 상태 및 값)를 선택한다고 가정해 보겠습니다. 예를 들어 <kbd class="ph userinput">api.setState</kbd>를 호출하고<kbd class="ph userinput"> dynamic_label_value</kbd> 를 첫 번째 매개변수로 포함하고 <kbd class="ph userinput">NEW VALUE</kbd> 를 두 번째 매개변수로 포함할 수 있습니다.
    {#state-parameters__substeps_w4m_nq3_d4b}
11. 이벤트 핸들러를 두 번째 구성요소에 추가하여 생성한 새 클라이언트 스크립트를 호출합니다.
    1. 페이지에서 스크립트를 바인딩할 구성요소를 선택합니다.
    2. 이벤트 탭을 선택합니다.
    3. + 새 이벤트 핸들러 추가를 선택합니다.
    4. 이벤트 핸들러의 스크립트 섹션에서 생성한 스크립트를 선택하고 + 를 선택하여 구성요소에 대한 이벤트 핸들러로 추가합니다.  
12. 저장을 선택합니다.
13. 페이지를 미리 보고 구성요소가 연결되어 있는지 테스트하려면 미리 보기를 선택합니다.  
    하나의 구성요소를 선택하면 두 번째 구성요소의 상태가 변경됩니다. 예를 들어 버튼 구성요소를 선택하여 레이블 값 구성요소 텍스트를 초기 값 에서 새 값으로 변경합니다.

## 결과

이 절차에서 수행한 작업:

* 페이지에 두 개의 구성요소가 추가되었습니다.
* 초기값이 있는 클라이언트 상태 매개변수를 정의했습니다.
* 클라이언트 상태 매개변수를 첫 번째 구성요소에 바인딩합니다.
* 클라이언트 상태 매개변수로 정의된 값을 업데이트하는 클라이언트 스크립트를 작성했습니다.
* 방금 만든 새 클라이언트 스크립트를 호출하는 두 번째 구성요소에 대한 이벤트 핸들러를 생성했습니다.
* 첫 번째 구성요소의 상태를 변경하도록 두 번째 구성요소를 선택했습니다.
{#state-parameters__ul_njc_2q3_d4b}

