GlideSPUtil - 전역

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

    • GlideSPUtil API는 를 서비스 포털지원하는 공통 백엔드 함수를 수행하는 유틸리티 메서드를 제공합니다.

    사용 가능한 유틸리티 방법:
    • 페이지 [sp_page] 테이블에 있는 지정된 서비스 포털 페이지와 연결된 동적 페이지 변수 [sp_page_title_variable] 테이블에 지정된 변수를 확인합니다.
    • 기타 방법

    자세한 내용은 서비스 포털 페이지를 참조하십시오.

    GlideSPUtil - GlideSPUtil()

    GlideSPUtil 객체를 인스턴스화합니다.

    표 1. 매개변수
    이름 유형 설명
    없음

    다음 코드 예제에서는 연결된 메서드를 호출하기 전에 GlideSPUtil 개체를 인스턴스화하는 방법을 보여 줍니다.

    function() {
  var spUtil = new GlideSPUtil();
  var pageGR = spUtil.getPageRecordWithPageRoute('kb_article', '81b75d3147032100ba13a5554ee4902b', false);
  var queryParams = RP.getParameters();
  var hrUrl = spUtil.getHumanReadableUrl(pageGR, queryParams);
}

    GlideSPUtil - getHumanReadableUrl()

    포털 페이지(pageGR)를 식별하기 위해 "id" 쿼리 매개변수를 고려하고 현재 트랜잭션의 쿼리 문자열을 사용하여 getHumanReadableUrl(GlideRecord pageGR, String, queryString)을 호출하고 사람이 읽을 수 있는 최종 항목을 반환합니다.

    표 2. 매개변수
    이름 유형 설명
    없음
    표 3. 반환
    유형 설명
    문자열 지정된 서비스 포털 기록에 대해 사용자가 읽을 수 있는 URL로, 변수가 문자열 맵의 queryParams 내용으로 대체됩니다.

    다음 코드 예제에서는 방법을 보여 줍니다.

    function() {
  var spUtil = new GlideSPUtil();
  var hrUrl = spUtil.getHumanReadableUrl();
}

    출력:

    GlideSPUtil - getHumanReadableUrl(GlideRecord pageGR, String queryParams)

    전달된 queryParms 문자열 매개변수를 문자열 맵으로 변환한 다음 sp_page 기록에 제공된 "사람이 읽을 수 있는 URL 구조" 문자열의 변수를 확인하고 URL의 사람이 읽을 수 있는 최종 부분을 반환합니다.

    표 4. 매개변수
    이름 유형 설명
    페이지GR GlideRecord URL 변수를 확인할 페이지 [sp_page] 테이블에 있는 기록의 GlideRecord 객체입니다.
    쿼리문자열 문자열 쿼리 문자열입니다.
    표 5. 반환
    유형 설명
    문자열 지정된 서비스 포털 기록에 대해 사용자가 읽을 수 있는 URL로, 변수가 문자열 맵의 queryParams 내용으로 대체됩니다.

    다음 코드 예제에서는 방법을 보여 줍니다.

    function() {
  var spUtil = new GlideSPUtil();
  var pageGR = spUtil.getPageRecordWithPageRoute('kb_article', '81b75d3147032100ba13a5554ee4902b', false);
  var queryString = GlideTransaction.get().getRequest().getQueryString();
  var hrUrl = spUtil.getHumanReadableUrl(pageGR, queryParams);
}

    출력:

    GlideSPUtil - getHumanReadableUrl(GlideRecord pageGR, StringMap queryParams)

    전달된 서비스 포털 템플릿 페이지 객체의 사람이 읽을 수 있는 URL 구조 필드의 변수를 해결하고 지정된 쿼리 매개변수와 확인된 사람이 읽을 수 있는 매개변수가 포함된 URL을 반환합니다.

    URL에 사람이 읽을 수 있는 키워드를 사용하여 다음을 수행합니다.
    • URL이 연결된 페이지의 컨텍스트에 없는 경우 고객이 URL의 목적을 더 잘 이해할 수 있도록 합니다.
    • 페이지를 더 잘 찾을 수 있도록 검색 엔진에 키워드를 제공합니다.

    예를 들어, 다음과 같이 인식할 수 없는 키-값 쌍이 포함된 URL을 갖는 대신 다음을 수행할 수 있습니다.

    https://instance_name.servicenow.com/sp/en?id=sc_cat_item&sys_id=ec80c13297968d1021983d1e6253af32&sysparm_catgory=1e80c15697969f1032083d1e6253be15

    URL의 용도를 보다 쉽게 이해할 수 있도록 URL에 항목 이름을 추가할 수 있습니다.

    https://instance_name.servicenow.com/sp/en/apple-iphone-13?id=sc_cat_item&sys_id=ec80c13297968d1021983d1e6253af32&sysparm_catgory=1e80c15697969f1032083d1e6253be15

    이 메서드를 사용하려면 먼저 URL에 동적 컨텐츠를 포함할 각 서비스 포털 템플릿에 사용할 수 있는 동적 페이지 변수를 정의해야 합니다. 이러한 변수 추가에 대한 자세한 내용은 을 참조하십시오 Add human readable keywords to page URLs.

    표 6. 매개변수
    이름 유형 설명
    페이지GR GlideRecord 동적 URL 변수를 해결할 템플릿 페이지의서비스 포털 GlideRecord 객체입니다.

    테이블: 페이지 [sp_page]
    queryParams 스팅맵 원하는 서비스 포털 페이지를 가져오는 데 사용할 URL 쿼리 매개변수입니다.
    예:
    {
  "id": "sc_cat_item",
  "sys_id": "ec80c13297968d1021983d1e6253af32",
  "sysparm_catgory": "1e80c15697969f1032083d1e6253be15"
}
    표 7. 반환
    유형 설명
    문자열 템플릿 페이지에 지정된 동적 변수에 대해 사용자가 읽을 수 있는 해결된 요소를 포함하는 URL입니다 서비스 포털 .

    예를 들어, 정의된 동적 변수가 다음과 %item_name같은 경우 URL에는 사용자가 선택한 항목의 이름(예: "apple-iphone-13") 및 지정된 모든 쿼리 매개변수가 포함됩니다.

    https://instance_name.servicenow.com/sp/en/apple-iphone-13?id=sc_cat_item&sys_id=ec80c13297968d1021983d1e6253af32&sysparm_catgory=1e80c15697969f1032083d1e6253be15 참조.

    다음 코드 예제에서는 특정 KB 문서를 가져오고 getHumanReaadableUrl() 을 호출하여 연결된 동적 변수를 적용하는 방법을 보여 줍니다.

    function() {
  var spUtil = new GlideSPUtil();
  var pageGR = spUtil.getPageRecordWithPageRoute('kb_article', '81b75d3147032100ba13a5554ee4902b', false);
  var queryParams = RP.getParameters();
  var hrUrl = spUtil.getHumanReadableUrl(pageGR, queryParams);
}