---
sourceDocument: 호주 API 참조
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/api-reference

 Release :

    - australia

ft:locale :

    - ko-KR

ft:publication_title :

    - 호주 API 참조

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# SPScriptedFacet - 범위 지정됨

# SPScriptedFacet - 범위 지정됨 {#ariaid-title1}

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

패싯 객체에 대한 패싯 항목, 필터 또는 매핑된 쿼리를 정의합니다.

검색 소스의 패싯 작성 스크립트에서만 SPScriptedFacet API를 서비스 포털 사용할 수 있습니다. 패싯 작성 스크립트는 스크립팅된 소스를 선택한 경우에만 표시됩니다.

이 클래스에 대한 생성자가 없습니다. 대신 [SPScriptedFacetService](https://servicenow-prod.fluidtopics.net/PA3WRvmDmfD3ao5JJuuXUw#SPScriptedFacetServiceScopedAPI "고급 검색 소스에 대한 다중 선택 또는 단일 선택 패싯 객체를 생성합니다.") 클래스의 [createFacet()](https://servicenow-prod.fluidtopics.net/PA3WRvmDmfD3ao5JJuuXUw#SPSFServiceScoped-createFacet_S_S "단일 선택 패싯 객체를 작성합니다.") 또는 [createMultiChoiceFacet()](https://servicenow-prod.fluidtopics.net/PA3WRvmDmfD3ao5JJuuXUw#SPSFServiceScoped-createMultiSelectFacet_S_S "복수 선택 패싯 객체를 작성합니다.") 메서드를 사용하여 패싯 개체를 생성합니다.

## SPScriptedFacet - addFacetItem(String label, Object valueObj) {#ariaid-title2}

패싯 항목 또는 매핑된 쿼리를 패싯 객체에 추가합니다.
패싯 개체에 패싯 항목을 추가하기 전에 SPScriptedFacetService 클래스의 createFacet() 또는 createMultiChoiceFacet() 메서드를 사용하여 패싯 개체를 만듭니다.
{#SPSFScoped-addFacetItem_S_O__table_jzf_lfv_5cb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 레이블 | 문자열 | 패싯 항목 또는 매핑된 쿼리의 표시 레이블입니다. |
| 값 객체 | 객체 | 패싯에 대한 패싯 항목 또는 매핑된 쿼리입니다. 문자열, 숫자, 부울 및 이중 유형만 포함할 수 있습니다. |
[표 1. 매개변수]

{#SPSFScoped-addFacetItem_S_O__table_jzf_lfv_5cb} {#SPSFScoped-addFacetItem_S_O__table_kzf_lfv_5cb__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 2. 반환]

{#SPSFScoped-addFacetItem_S_O__table_kzf_lfv_5cb}  

    function createMultiChoiceFacetFromKB(label, variable, values, orderBy){
      if(!values || values.length == 0)
        return;

      var kbFacet = facetService.createMultiChoiceFacet(label, variable);
      var kbMap = {};
      for(var i in values) {
        var key = values[i].label;
        var value = values[i].id;
        var parent = new KBParentData().getParentCategory(value, key);
        key = parent.join(' > ');
        kbMap[key] = value;
      }

      var labels = Object.keys(kbMap).sort();
      for (i = 0; i < labels.length; i++) {
        var currentLabel = labels[i];
        kbFacet.addFacetItem(currentLabel, kbMap[currentLabel]);
        //adds facet search options for each kbMap entry
      }
    }