---
sourceDocument: Xanadu 플랫폼 분석
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/xanadu/now-intelligence

 Release :

    - xanadu

ft:locale :

    - ko-KR

ft:publication_title :

    - Xanadu 플랫폼 분석

ft:clusterId :

    - par

bundleId :

    - par

workflow :

    - Platform


---

# 데이터 시각화와 함께 로컬 데이터 인스턴스 사용Use a local data instance with a data visualization

# 데이터 시각화와 함께 로컬 데이터 인스턴스 사용Use a local data instance with a data visualization {#ariaid-title1}

* 릴리스 버전: Xanadu
* 
* 업데이트 날짜 2024년 08월 01일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 4분

미리 구성된 데이터 원본을 사용하는 것보다 데이터 원본을 더 세밀하게 제어하려면 로컬 데이터 인스턴스를 만듭니다. 그런 다음 로컬 데이터 인스턴스를 데이터 시각화의 속성에 dataPassthrough 바인딩합니다.

## 시작하기 전에

중요사항:  
이것은 고급 절차입니다. 로컬 데이터 인스턴스가 필요한지 아니면 표준 데이터 원본을 사용할 수 있는지 신중하게 고려해야 합니다.

계속하기 전에 을 검토하십시오 .

필요한 역할: ui_builder_admin, admin

## 프로시저

1. 에서 UI 빌더기술 대시보드 또는 다른 UI 빌더 페이지를 엽니다.
2. 데이터 및 스크립트 서랍의 데이터 리소스에서 + 데이터 리소스 추가를 선택합니다.  

   ![아직 데이터 자원이 없는 경우 데이터 자원 링크를 추가합니다.]()  
3. 데이터 자원 선택 창에서 <kbd class="ph userinput">데이터 시각화</kbd>를 검색합니다.  
   사용할 수 있는 데이터 자원을 선택할 수 있습니다.  

4. 표시할 데이터 유형과 일치하는 데이터 자원을 선택합니다.
5. 정보 창을 읽고 구성 상세 정보를 복사하거나 메모합니다.
6. 추가를 선택합니다.
7. 이 데이터 인스턴스를 사용하려는 시각화 유형에 필요한 구성 옵션을 완료합니다.  
   동일한 데이터를 사용하려는 모든 시각화 유형에 대해 별도의 로컬 데이터 인스턴스를 만들고 구성합니다. 예를 들어 동일한 표시기의 점수를 표시하는 막대 및 시계열을 만들려는 경우 두 개의 로컬 데이터 인스턴스를 만듭니다. 막대 및 시계열 시각화에 대해 각각 하나씩, 그러나 둘 다 동일한 표시기에 있습니다.  
   팁:  
   페이지에 데이터 시각화를 추가하고 해당 구성 패널을 로컬 데이터 인스턴스에 대한 옵션과 비교할 수 있습니다.
8. 이 데이터 소스에 대한 `@data` 데이터 바인딩을 복사합니다.  

   <br />

9. 원하는 데이터 시각화 구성요소를 페이지에 추가합니다.
10. 해당 데이터 시각화에 대한 구성 패널의 데이터 소스 섹션에서 수동으로 데이터 정의를 켭니다.
11. 데이터 필드에서 데이터 바인딩 또는 스크립트 사용을 선택합니다.  

    <br />

12. 데이터에 데이터 바인딩 대화 상자의 데이터 형식에서 데이터 자원을 선택합니다.
13. Add a data output to this area(이 영역에 데이터 출력 추가) 섹션을 두 번 클릭하고 로컬 데이터 인스턴스에 대한 데이터 바인딩을 파란색 상자에 붙여넣습니다.
14. 데이터 바인딩의 끝에 <kbd class="ph userinput">.output.result</kbd> 를 추가합니다.  
    예를 들어 로컬 데이터 인스턴스 data_visualization_api_for_table_data_source_1에 대한 완료된 데이터 바인딩은 `@data.data_visualization_api_for_table_data_source_1.output.result`입니다.  

15. 적용을 선택합니다.

## 결과

로컬 데이터 인스턴스를 생성하여 데이터 시각화에 바인딩했습니다. 이제 데이터 시각화 구성을 완료할 수 있습니다.

## 로컬 데이터 인스턴스에 적용할 필터 사용 {#ariaid-title2}

뷰어가 데이터 시각화에 표시되는 필드 값 또는 세부 항목 요소 사이를 전환할 수 있도록 하려면 페이지에 필터 구성요소를 추가하십시오 UI 빌더 . 이러한 필터를 로컬 데이터 인스턴스에 적용하려면 그에 따라 해당 인스턴스를 구성합니다.

### 시작하기 전에

필요한 역할: ui_builder_admin, admin

### 이 태스크 정보

필터를 로컬 데이터 소스에 적용할 수 있도록 하려면 먼저 `parFilters` 라는 클라이언트 상태 매개변수를 만든 다음 해당 상태 매개변수를 로컬 데이터 인스턴스에 추가해야 합니다.

### 프로시저

1. 필터링할 UI 빌더 로컬 데이터 인스턴스와 데이터 시각화가 있는 페이지를 엽니다.
2. 데이터 및 스크립트 서랍에서 클라이언트 상태 매개 변수를 선택합니다.
3. + 추가를 선택합니다.
4. 클라이언트 상태 매개 변수 편집 대화 상자에서 새 매개 변수의 이름을 <kbd class="ph userinput">parFilters</kbd>로 지정하고, JSON 유형을 할당하고, 초기 값을 <kbd class="ph userinput">{}</kbd>로 설정합니다.  

   ![parFilters 클라이언트 상태 매개 변수 편집 대화 상자의 클라이언트 상태 매개 변수.]()  
5. Edit client state parameters(클라이언트 상태 매개변수 편집) 대화 상자를 닫습니다.
6. 데이터 및 스크립트 서랍의 데이터 리소스에서 원하는 로컬 데이터 인스턴스를 선택합니다.
7. \<로컬 데이터 인스턴스 이름\> 편집 대화상자에서 필터 구성 필드까지 아래로 스크롤합니다.
8. 필터 구성 필드에 <kbd class="ph userinput">@state.parFilters</kbd>를 입력하고 데이터 인스턴스 편집기를 닫습니다.
9. 이 로컬 데이터 자원을 사용하는 데이터 시각화의 구성 패널에서 데이터 업데이트 섹션의 필터 팔로우 를 켭니다.
10. **옵션:** 필터 아이콘 표시를 켭니다.
11. UI 빌더 페이지를 저장합니다.

### 다음에 수행할 작업

페이지에 필터 구성 요소를 UI 빌더 추가하고 로컬 데이터 인스턴스에서 관련 값에 대해 구성합니다.
**관련 개념**   

* [필터 위치 플랫폼 분석](https://servicenow-prod.fluidtopics.net/4JCHw_i_uN72A2EwkqqgbQ "가능한 데이터 값, 값이 참/거짓인지 여부 또는 날짜를 기준으로 대시보드의 목록 및 데이터 시각화를 필터링합니다. 필터는 필터 배치에 따라 동일한 대시보드 또는 동일한 대시보드 탭의 모든 요소에 적용됩니다.")

## 로컬 데이터 인스턴스에 대한 데이터 캐싱 사용 {#ariaid-title3}

데이터 시각화의 로드 시간을 줄이고 실시간 또는 매우 새로운 데이터가 필요하지 않은 경우 데이터 소스에서 데이터 캐싱을 활성화하십시오.

### 시작하기 전에

필요한 역할: ui_builder_admin, admin

### 프로시저

1. UI 빌더 데이터를 캐시할 로컬 데이터 인스턴스가 있는 페이지를 엽니다.
2. 데이터 및 스크립트 서랍의 데이터 리소스에서 원하는 로컬 데이터 인스턴스를 선택합니다.
3. 데이터 캐시 사용까지 아래로 스크롤하여 켭니다.  
   이 데이터 소스를 사용하는 모든 데이터 시각화는 데이터 소스의 캐시 설정을 사용합니다. 시각화 자체의 데이터 캐시 설정이 구성 패널에서 제거됩니다.
4. 필요에 따라 다른 캐싱 속성을 설정합니다.  
   {#enable-caching-local-data-instance__table_k5f_bng_2bc__entry__2}

   | 속성 | 설명 |
   |-|-|
   | 캐시 만료 시간 | 캐시가 만들어지면 캐시 새로 고침 작업에서 업데이트되기 전에 유지되는 기간입니다. |
   | 캐시 무효화 | 캐시를 무효화하고 새로운 데이터를 가져오기 위해 만드는 추가 논리와 함께 이 설정을 사용합니다. 예를 들어 Button 구성 요소를 페이지에 추가하고 해당 이벤트 핸들러를 스크립팅하여 캐시를 무효화할 수 있습니다. |
   | 추가 키 | 이 데이터 인스턴스에 생성된 각 데이터 캐시에 대한 고유 해시 키를 생성하는 데 기여할 문자열을 입력합니다. 각 로컬 데이터 인스턴스에 고유한 추가 키 값을 사용합니다. |
   [ ]

   {#enable-caching-local-data-instance__table_k5f_bng_2bc}