필터 패싯 위젯 인스턴스 옵션 구성

  • 릴리스 버전: Zurich
  • 업데이트 날짜 2025년 07월 31일
  • 소요 시간: 4분

    • 서비스 포털 검색 결과 페이지에서 필터 패싯 위젯에 지식 관리 대한 위젯 인스턴스 옵션을 구성합니다.

    시작하기 전에

    필요한 역할: sp_admin 또는 admin

    이 태스크 정보

    홈페이지는 여러 위젯을 사용하여 검색 결과 목록의 항목을 필터링합니다. 패싯 위젯에는 다음 두 가지 유형이 있습니다.
    • 지식베이스 테이블 필드에 기반한 단순한 필드 패싯
    • 지식베이스 테이블의 사용자 정의 쿼리에 기반한 고급 쿼리 패싯
    위젯 인스턴스 옵션을 사용하여 이러한 패싯 위젯을 사용자 지정할 수 있습니다.
    • 지식베이스 필드 패싯 (지식베이스, 지식베이스 범주 및 저자별 필터링용)
    • 지식베이스 태그 패싯(태그별 필터링용)
    • 기술 자원 패싯(문서와 같은 자원별 필터링용)
    • 지식베이스 쿼리 패싯(등급, 최종 수정 및 조회 횟수별 필터링용)
      주:
      쿼리 패싯은 페이지에 하나 이상의 지식 필드 패싯이 추가된 경우에 표시됩니다.

    기본 지식 언어 위젯을 사용하여 지식 검색 결과 페이지에 언어 필터를 포함합니다. 사용자 지정 언어 위젯을 추가하려면 Knowledge 검색 결과 페이지에서 Knowledge 언어 위젯을 비활성화해야 합니다.

    프로시저

    1. 지식 관리 서비스 포털 검색 결과 페이지로 이동합니다.
    2. 필터 패싯 위젯을 Control + 마우스 오른쪽 버튼으로 클릭합니다.
    3. 인스턴스 옵션을 클릭합니다.
    4. 선택한 패싯 위젯 유형에 대해 원하는 설정을 구성합니다.
      인스턴스 옵션 설명
      직위 필터 패싯 위젯의 제목입니다.
      글리프 제목 왼쪽에 나타나는 아이콘입니다.
      순서 검색 결과 페이지 왼쪽에 필터 패싯 위젯이 표시되는 순서입니다. 비어 있으면 필터 패싯 위젯이 알파벳순으로 정렬됩니다.
      부트스트랩 색상 필터 패싯 위젯 헤더의 색입니다.
      CSS 위젯에 있는 요소의 모양과 느낌을 결정하는 사용자 지정 구성입니다. 자세한 내용은 Service Portal SCSS Primer를 참조하십시오.
      소스 테이블 필터 패싯 위젯 옵션을 제공하는 데 사용되는 소스 필드를 포함하는 테이블입니다. 기본 테이블은 Knowledge(kb_knowledge)입니다.
      소스 필드 필터 패싯 위젯 옵션을 제공하는 소스 테이블의 필드입니다. 소스 필드로 사용할 수 있는 필드 유형에는 문자열, Glide 목록, 정수, 참조 및 부울이 포함됩니다.
      패싯 식별자 스크립트 코드에 사용할 수 있는 사용자 지정 쿼리 패싯의 고유한 이름입니다.
      패싯 템플릿 패싯 상호작용의 유형을 결정하는 템플릿입니다.
      지식베이스 필드 패싯 위젯 템플릿:
      • 단일 선택: 사용자는 이 위젯에서 하나의 필터만 선택할 수 있습니다.
      • 다중 선택: 사용자는 이 위젯에서 둘 이상의 필터를 선택할 수 있습니다.
      • 드롭다운 선택: 사용자는 드롭다운 메뉴에서 둘 이상의 필터를 선택할 수 있습니다.
      지식 쿼리 패싯 위젯 템플릿
      • 단순 쿼리: 각 패싯 값에 대한 레이블을 표시합니다.
      • 등급: 등급 별을 표시합니다.
      사용자 지정 템플릿 패싯 상호작용 및 값 선택을 결정하는 사용자 지정 템플릿입니다.
      패싯 옵션 각 패싯 값에 대한 레이블, ID, 순서 및 쿼리에 대한 JSON 형식의 사용자 지정 쿼리입니다. 테이블, 값(인코딩된 쿼리) 및 표시 값(인코딩된 쿼리)이 포함됩니다.
      정렬 기준 패싯 위젯 내의 필터 옵션 순서입니다. 기본 순서는 레이블이 옵션들을 알파벳 순으로 정렬하는 것입니다. 참조 필드의 경우 참조 필드 테이블의 순서를 지정할 수도 있습니다.
      필터 검색 창을 표시하기 위한 최소 결과 필터 패싯 위젯의 상단에 검색 창을 표시하는 데 필요한 최소 결과 수입니다.
      스크롤 막대 표시의 최소 결과 필터 패싯 위젯에 스크롤 막대를 표시하는 데 필요한 최소 결과 수입니다.
      문자열 필드의 최대 길이 최대 필드 길이입니다. 길이가 이 값보다 작은 필드만 필터 패싯으로 추가할 수 있습니다.
      대체 URL 매개변수 URL에서 검색 매개변수로 사용되는 경우 이 필터 패싯을 초기화하는 데 사용되는 URL 매개변수의 이름.
      최대값 가져오기

      검색 결과의 모든 지식 문서에서 필터 값을 가져오는 옵션입니다.

      최대값 가져오기 옵션을 선택하면 검색 결과 로드 시간에 영향을 줄 수 있습니다. 이 옵션을 사용하지 않도록 설정하면 속성 값에 따라 glide.knowman.search.facet_depth 로드 시간이 향상됩니다.

      속성이 glide.knowman.search.apply_acls true로 설정된 경우 해당 필터 값에 대한 검색 결과가 없는 경우에도 필터 값이 필터 패싯에 나타날 수 있습니다. 예를 들어 문서가 없는 지식베이스는 지식베이스 필터 패싯에 값으로 나타날 수 있습니다.
      빈 값 표시 사용하도록 설정하면 사용자가 이 필드가 설정되지 않은 문서를 필터링하기 위해 선택할 수 있는 빈 필터 패싯 옵션이 표시됩니다.

      예를 들어, 문서에 할당된 범주가 없는 경우 빈 옵션을 클릭하면 범주가 할당되지 않은 모든 문서가 나열됩니다.
      패싯 값만 표시 일치하는 결과 모든 값을 표시하는 대신 검색 결과와 일치하는 필터 값만 표시하는 동적 필터 패싯 위젯을 만듭니다. 이 인스턴스 옵션을 비활성화하면 필터 패싯 데이터를 로드하는 데 필요한 시간이 줄어듭니다.
      범주 계층 구조 표시(kb_category에만 유효) 사용하도록 설정하면 네 번째 수준까지의 계층 구조 목록이 있는 범주가 표시됩니다. 이 옵션을 사용하면 한 번에 하나의 범주만 선택할 수 있습니다. 네 번째 수준 이외의 하위 범주에 포함된 모든 문서는 네 번째 수준 범주에도 표시됩니다. 선택한 상위 범주에서 필터링된 검색 결과에는 해당 범주 내의 문서와 모든 연결된 하위 범주가 포함됩니다.
      주:
      • 검색 결과에 반환되는 지식 문서 수가 검색 패싯 깊이보다 많으면 모든 범주가 이 패싯에 표시됩니다. 따라서 이 패싯에 표시된 일부 범주는 검색 결과의 지식 문서와 연결되지 않을 수 있습니다. 기본적으로 패싯 깊이는 300으로 설정되고 속성의 관리자가 glide.knowman.search.facet_depth 구성합니다.
      • 필터를 추가하여 지식 검색 결과 페이지 위젯을 구성합니다. 특히 언어에 대한 필터를 적용해야 하는 경우 OOB 지식 언어 위젯을 사용해야 합니다. 필드 패싯 위젯은 유사한 동작에 대한 인스턴스 옵션의 언어 필드를 사용하여 구성할 수 있지만, 이 경우 지식 검색 결과 페이지에서 OOB 지식 언어 위젯 인스턴스를 비활성화해야 합니다.
    5. 저장을 클릭합니다.