---
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


---

# SPScriptedFacetService - scoped

# SPScriptedFacetService - scoped {#ariaid-title1}

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

고급 검색 소스에 대한 다중 선택 또는 단일 선택 패싯 객체를 생성합니다.

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

이 클래스에 대한 생성자가 없습니다. 대신 createFacet() 또는 createMultiChoiceFacet() 메서드를 사용하여 패싯 객체를 생성합니다.

## SPScriptedFacetService - createFacet(문자열 레이블, 문자열 ID) {#ariaid-title2}

단일 선택 패싯 객체를 작성합니다.
패싯 개체를 만든 후 SPScriptedFacet 클래스의 addFacetItem() 메서드를 사용하여 패싯에 패싯 항목 또는 매핑된 쿼리를 추가합니다.
{#SPSFServiceScoped-createFacet_S_S__table_apb_rfv_5cb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 레이블 | 문자열 | 패싯의 레이블입니다. |
| ID | 문자열 | 패싯의 ID입니다. |
[표 1. 매개변수]

{#SPSFServiceScoped-createFacet_S_S__table_apb_rfv_5cb} {#SPSFServiceScoped-createFacet_S_S__table_bpb_rfv_5cb__entry__2}

| 유형 | 설명 |
|-|-|
| 객체 | 단일 선택 패싯 객체입니다. 다음과 같은 경우 오류를 반환합니다. * 중복된 레이블 또는 ID가 발견되었습니다. * 레이블 또는 ID가 정의되지 않았습니다. {#SPSFServiceScoped-createFacet_S_S__ul_obk_vvw_xcb} |
[표 2. 반환]

{#SPSFServiceScoped-createFacet_S_S__table_bpb_rfv_5cb}  
서비스 포털 고급 검색 소스의 패싯 작성 스크립트에만 사용할 수 있습니다.

    var stateFacet = facetService.createFacet("State", "state");

## SPScriptedFacetService - createMultiChoiceFacet(문자열 레이블, 문자열 ID) {#ariaid-title3}

복수 선택 패싯 객체를 작성합니다.
패싯 개체를 만든 후 SPScriptedFacet 클래스의 addFacetItem() 메서드를 사용하여 패싯에 패싯 항목 또는 매핑된 쿼리를 추가합니다.
{#SPSFServiceScoped-createMultiSelectFacet_S_S__table_apb_rfv_5cb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 레이블 | 문자열 | 패싯의 레이블입니다. |
| ID | 문자열 | 패싯의 ID입니다. |
[표 3. 매개변수]

{#SPSFServiceScoped-createMultiSelectFacet_S_S__table_apb_rfv_5cb} {#SPSFServiceScoped-createMultiSelectFacet_S_S__table_bpb_rfv_5cb__entry__2}

| 유형 | 설명 |
|-|-|
| 객체 | 다중 선택 패싯 객체입니다. 다음과 같은 경우 오류를 반환합니다. * 중복된 레이블 또는 ID가 발견되었습니다. * 레이블 또는 ID가 정의되지 않았습니다. {#SPSFServiceScoped-createMultiSelectFacet_S_S__ul_obk_vvw_xcb} |
[표 4. 반환]

{#SPSFServiceScoped-createMultiSelectFacet_S_S__table_bpb_rfv_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
      }
    }