위젯 API 참조

  • 릴리스 버전: Zurich
  • 업데이트 날짜 2025년 07월 31일
  • 소요 시간: 2분
  • 서비스 포털 위젯 클라이언트 및 서버 스크립트에 사용할 클라이언트 및 서버 측 API가 포함되어 있습니다.

    서비스 포털 클라이언트 측 API

    서비스 포털 위젯 클라이언트 컨트롤러에서 사용할 수 있는 API입니다.

    자세한 클래스 및 메서드 정보는 API 레퍼런스를 참조하십시오.

    클래스 설명
    spAriaUtil

    화면 판독기에 메시지를 표시합니다.

    spContextManager

    위젯의 서비스 포털 데이터를 페이지의 다른 애플리케이션 및 서비스에서 서비스 포털 사용할 수 있도록 합니다. 예를 들어 위젯 데이터가 에이전트 채팅 페이지에서 열릴 서비스 포털 때 전달합니다.

    spUtil

    위젯 클라이언트 스크립트에서 공통 기능을 수행하는 유틸리티 메서드입니다 서비스 포털 .

    spModal

    위젯에 서비스 포털 경보, 프롬프트 및 확인 대화 상자를 표시합니다. spModal 클래스는 클라이언트 스크립트에서 서비스 포털 사용할 수 있습니다.

    주:
    전역 객체로 g_form 위젯 클라이언트 컨트롤러나 UI 스크립트에서 사용할 수 없습니다.

    서비스 포털 서버 측 API

    서비스 포털 위젯 서버 스크립트에서 사용할 수 있는 API입니다.

    클래스 설명
    GlideSPScriptable

    GlideSPScriptable API는 위젯에서 서비스 포털 데이터와 상호작용하고 기록 작업을 수행하는 메서드를 제공합니다.

    GlideSPSearchAnalytics

    GlideSPSearchAnalytics API는 사용자 지정 ServiceNow 검색 위젯에서 검색 분석을 생성하는 메서드를 제공합니다.

    SPScriptedFacet - Scoped

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

    SPScriptedFacetService - Scoped

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

    SPSEOUtilsSNC - Global

    트랜잭션 요청에 따라 특정 페이지 또는 현재 페이지에 대해 사용자가 읽을 수 있는 URL을 반환합니다.

    SPWidgetAccessControl - Global

    제공된 테이블에 위젯에 대한 액세스 권한이 부여되어 있는지 확인하여 의도한 대상이 위젯에 안전하게 액세스할 수 있도록 합니다.

    위젯 속성

    위젯 클라이언트 및 서버 스크립트에서 사용할 수 있는 전역 변수 및 함수입니다.

    서버 스크립트 전역 객체

    속성 설명
    입력 c.data에 설정된 클라이언트측 속성을 포함하는 객체입니다. 클라이언트 컨트롤러가 c.server.update()를 호출할 때까지 값이 정의되지 않습니다.
    데이터 서버측 실행 중에 설정된 속성을 포함하는 객체입니다.
    옵션 스키마 옵션 속성을 포함하는 개체입니다.

    클라이언트 스크립트 전역 함수

    속성 설명
    this.server.get([객체]) 서버를 호출하고 사용자 지정 입력을 보냅니다. Promise를 반환합니다.
    this.server.update() 서버를 호출하고 this.data 를 서버 스크립트에 게시합니다. Promise를 반환합니다.
    this.server.refresh() 서버를 호출하고 서버 응답의 현재 옵션과 데이터를 자동으로 대체합니다. Promise를 반환합니다.

    promise는 비동기 작업의 최종 결과를 나타냅니다. 프라미스에 대한 자세한 내용은 또는 AngularJS 설명서를 참조하십시오https://promisesaplus.com/.