GlideSPUtil - 전역

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 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, 문자열 queryParams)

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

    표 4. 매개변수
    이름 유형 설명
    pageGR 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을 사용하는 대신 다음을 수행합니다.

    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. 매개변수
    이름 유형 설명
    pageGR 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);
}