검색 소스 정의

  • 릴리스 버전: Zurich
  • 업데이트 날짜 2026년 03월 13일
  • 소요 시간: 3분

    • 인스턴스 테이블에서 데이터를 쿼리하도록 기본 검색 소스를 구성하거나, 고급 데이터 가져오기 스크립트를 구성하여 여러 테이블 및 데이터 소스에서 데이터를 쿼리하거나, 웹 어디에서나 데이터를 가져올 수 있습니다.

    시작하기 전에

    필요한 역할: 관리자

    프로시저

    1. 플랫폼 UI에서 서비스 포털 > 포털 을 클릭하고 검색 소스를 추가할 포털을 선택합니다.
    2. 검색 소스 관련 목록에서 새로 만들기를 클릭하여 검색 소스를 추가합니다.
    3. 검색 소스 양식에서 필드를 정의합니다.
      표 1. 검색 소스 양식
      필드 설명
      이름 검색 범주의 표시 값입니다.
      ID 기록 ID입니다. 값은 고유해야 하며 공백이나 특수 문자를 포함해서는 안 됩니다.
      애플리케이션 검색 소스의 범위입니다.
      역할 Service Portal 사용자 기준 지원 플러그인을 사용할 수 없는 경우 이 검색 소스에 액세스하기 위한 사용자 역할을 정의하십시오.
      검색 페이지 템플릿

      검색 결과를 표시하는 HTML 템플릿입니다. 기본 검색 소스를 정의하는 경우에는 기본 템플릿을 변경할 필요가 없습니다.

      수정된 템플릿의 예는 다음 문서를 참조하십시오 자습서: 외부 지식베이스 검색 소스 설정.
    4. 데이터 소스 탭의 필드를 작성합니다.
      필드 설명
      스크립팅된 소스 고급 데이터 가져오기 스크립트를 추가합니다. 인스턴스 테이블을 데이터 소스로 구성하는 경우 이 옵션을 선택하지 마십시오.
      데이터 임포트 스크립트

      데이터를 가져오기 위한 엔드포인트 및 API 호출을 정의하는 스크립트입니다. 이 필드는 스크립팅된 소스 임이 선택된 경우에만 표시됩니다.

      데이터 가져오기 스크립트의 예는 다음 문서를 참조하십시오 자습서: 외부 지식베이스 검색 소스 설정.

      주:
      패싯 생성 스크립트를 정의하는 경우, 패싯 개체를 데이터 가져오기 스크립트에 삽입하고 스크립트를 업데이트하여 각 패싯 항목에 대한 데이터를 생성합니다. 예를 들어, 지식베이스와 Service Catalog 검색 소스를 참조하십시오. 검색 패싯은 비 ServiceNow 사이트의 데이터를 쿼리하는 고급 검색 소스에 통합된 경우 예상대로 작동하지 않을 수 있습니다.
      패싯 작성 스크립트

      스크립트된 검색 소스에 대한 검색 패싯을 정의하는 스크립트입니다. 최종 사용자가 더 의미 있는 결과 세트를 얻기 위해 검색 결과를 필터링할 수 있습니다. 이 필드는 스크립팅된 소스 임이 선택된 경우에만 표시됩니다.

      주:
      패싯 생성 스크립트를 정의하는 경우, 패싯 개체를 데이터 가져오기 스크립트에 삽입하고 스크립트를 업데이트하여 각 패싯 항목에 대한 데이터를 생성합니다. 예를 들어, 지식베이스와 Service Catalog 검색 소스를 참조하십시오. 검색 패싯은 비 ServiceNow 사이트의 데이터를 쿼리하는 고급 검색 소스에 통합된 경우 예상대로 작동하지 않을 수 있습니다.
      테이블 목록에서 결과를 가져오려는 테이블을 선택합니다. 플랫폼에서 모든 테이블을 선택할 수 있습니다. 예를 들어 사용자 [sys_user] 또는 지식 [kb_knowledge]입니다.
      주:
      인덱싱된 테이블만 검색 결과를 반환합니다. 자세히 알아보기: Configure a table for indexing and searching.
      조건 정의된 조건을 기준으로 결과를 필터링합니다. 예를 들어 활성이 True입니다.
      기본 표시 필드 검색 결과 페이지에 표시할 필드를 선택합니다. 예: 이름
      표시 필드 검색 결과 페이지에 표시할 추가 필드를 선택합니다. 예를 들어 사용자 ID, 이메일 및 도시입니다.
      결과 페이지 매김

      검색 결과를 페이지 매김합니다. 기본값은 True입니다.

      스크립팅된 소스 임을 선택하면 값이 false로 업데이트됩니다. 스크립트된 검색 소스에 페이지 매김을 사용하려면 문서를 검색 소스 결과 페이지 매김참조하십시오.

      검색 페이지 위젯 또는 패싯이 적용된 검색 위젯 인스턴스 옵션에서 검색 소스에 대한 쿼리당 최대 결과 수를 정의합니다.
    5. 검색 결과가 사용자 입력에 따라 검색 필드를 채울 수 있도록 자동 완성 설정을 구성합니다.
      필드 설명
      자동 완성 활성화 자동 완성 기능을 허용합니다. 자동 완성을 검색 소스에 통합하지 않으려면 확인란의 선택을 취소합니다.
      고급 자동 완성 구성 필요에 따라 고급 자동 완성 스크립트를 추가하여 검색 결과가 표시되는 방식을 구성합니다. 자세한 내용은 고급 자동 완성 템플릿 생성 문서를 참조하십시오.
      자동 완성 상형 문자 각 자동 완성 결과 옆에 아이콘을 추가합니다.
      페이지 선택한 결과를 표시하는 서비스 포털 페이지를 정의합니다. 예를 들어, 양식 이 구성된 경우 선택한 자동 완성 결과가 양식에서 열립니다.

      자동 완성 탭 설정 예제. 페이지 필드가 양식으로 설정되었습니다.

    6. 제출을 클릭합니다.

    다음에 수행할 작업

    최종 사용자가 검색 결과를 세분화할 수 있도록 하기 위해 단순 검색 소스에 패싯 추가.