---
sourceDocument: 호주 API 참조
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/api-reference

 Release :

    - australia

ft:locale :

    - ko-KR

ft:publication_title :

    - 호주 API 참조

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# GlideSPUtil - 전역

# GlideSPUtil - 전역 {#ariaid-title1}

* 릴리스 버전: Australia
* 
* 업데이트 날짜 2026년 03월 12일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 6분

GlideSPUtil API서비스 포털는 .  
사용 가능한 유틸리티 방법:

* 페이지 \[sp_page\] 테이블에 위치한 지정된 서비스 포털 페이지와 연결된 동적 페이지 변수 \[sp_page_title_variable\] 테이블에 지정된 변수를 해결합니다.
* 기타 메서드

자세한 내용은 서비스 [포털 페이지를](https://servicenow.com/docs/bundle/vancouver-servicenow-platform/page/build/service-portal/task/add-human-readable-keywords-page-urls.html) 참조하십시오.

## GlideSPUtil - GlideSPUtil() {#ariaid-title2}

GlideSPUtil 객체를 인스턴스화합니다.
{#GSPUtil-GlideSPUtil__table_n14_4gg_hvb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 없음 |   |   |
[표 1. 매개변수]

{#GSPUtil-GlideSPUtil__table_n14_4gg_hvb}  
다음 코드 예제에서는 연결된 메서드를 호출하기 전에 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() {#ariaid-title3}

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

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 2. 매개변수]

{#GSPUtil-getHumReadUrl__table_rr4_wyg_hvb} {#GSPUtil-getHumReadUrl__table_sr4_wyg_hvb__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 변수가 문자열 맵의 내용으로 대체된 지정된 기록에 대해 서비스 포털 사용자가 읽을 수 있는 URL입니다 queryParams . |
[표 3. 반환]

{#GSPUtil-getHumReadUrl__table_sr4_wyg_hvb}  
다음 코드 예제에서는 방법을 보여 줍니다.

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

출력:

```

```

## GlideSPUtil - getHumanReadableUrl(GlideRecord pageGR, 문자열 queryParams) {#ariaid-title4}

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

| 이름 | 유형 | 설명 |
|-|-|-|
| pageGR | GlideRecord | URL 변수를 확인할 페이지 \[sp_page\] 테이블에 있는 기록의 GlideRecord 객체입니다. |
| 쿼리문자열 | 문자열 | 쿼리 문자열입니다. |
[표 4. 매개변수]

{#GSPUtil-getHumReadUrl_GR_S__table_vjm_wwg_hvb} {#GSPUtil-getHumReadUrl_GR_S__table_wjm_wwg_hvb__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 변수가 문자열 맵의 내용으로 대체된 지정된 기록에 대해 서비스 포털 사용자가 읽을 수 있는 URL입니다 queryParams . |
[표 5. 반환]

{#GSPUtil-getHumReadUrl_GR_S__table_wjm_wwg_hvb}  
다음 코드 예제에서는 방법을 보여 줍니다.

    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) {#ariaid-title5}

전달 서비스 포털 된 템플릿 페이지 객체의 사람이 읽을 수 있는 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](https://www.servicenow.com/docs/access?context=add-human-readable-keywords-page-urls&version=australia&pubname=australia-platform-user-interface&ft:locale=en-US).
{#GSPUtil-getHumReadUrl_GR_SM__table_dht_dpg_hvb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| pageGR | GlideRecord | 동적 URL 변수를 확인할 템플릿 페이지의서비스 포털 GlideRecord 객체입니다. 테이블: 페이지 \[sp_page\] |
| queryParams | 스팅맵 | 원하는 서비스 포털 페이지를 가져오는 데 사용할 URL 쿼리 매개변수입니다. 예: { "id": "sc_cat_item", "sys_id": "ec80c13297968d1021983d1e6253af32", "sysparm_catgory": "1e80c15697969f1032083d1e6253be15" } |
[표 6. 매개변수]

{#GSPUtil-getHumReadUrl_GR_SM__table_dht_dpg_hvb} {#GSPUtil-getHumReadUrl_GR_SM__table_eht_dpg_hvb__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 템플릿 페이지에 지정된 동적 변수에 대해 사용자가 읽을 수 있는 해결된 요소를 포함하는 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`. |
[표 7. 반환]

{#GSPUtil-getHumReadUrl_GR_SM__table_eht_dpg_hvb}  
다음 코드 예제에서는 특정 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);
    }