--- 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 --- # SPSEOUtilsSNC - 전역 # SPSEOUtilsSNC - 전역 {#ariaid-title1} * 릴리스 버전: Australia * * 업데이트 날짜 2026년 03월 12일 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 6분 SPSEOUtilsSNC 스크립트 포함은 트랜잭션 요청에 따라 특정 페이지 또는 현재 페이지에 대해 사용자가 읽을 수 있는 URL을 리턴하는 유틸리티 메소드를 제공합니다. 또한 이 API는 사람이 읽을 수 있는 다른 URL 메서드를 호출하는 데 필요한 정보를 가져오는 데 사용할 수 있는 다른 유틸리티 메서드를 제공합니다. ## SPSEOUtilsSNC - getHumanReadableUrl(GlideRecord pageGR, 문자열 queryString) {#ariaid-title2} 페이지 \[sp_page\] 테이블의 지정된 기록에 대해 사용자가 읽을 수 있는 URL을 반환합니다. 전달된 쿼리 매개변수를 사용하여 URL에 필요한 동적 페이지 변수를 해결합니다. {#SPSU-getHumReadUrl_GR_S__table_vjm_wwg_hvb__entry__3} | 이름 | 유형 | 설명 | |-|-|-| | pageGR | GlideRecord | 사람이 읽을 수 있는 URL을 반환할 페이지 \[sp_page\] 테이블에 있는 기록의 GlideRecord 객체입니다. 이 메서드를 [SPSEOUtilsSNC - getPageRecordWithPageRoute(GlideRecord pageId, 문자열 portalId, 부울 preventReRoute)](https://servicenow-prod.fluidtopics.net/BD7BYlxb1XihfE9Nq4SDaA#SPSU-getPageRecWPageRte_S_S_B "ID 필드가 전달된 ID 매개변수(sp_pagepageId)와 일치하는 페이지 [] 테이블에서 GlideRecord를 반환합니다. getHumanReadableUrl() 메서드를 호출하기 전에 이 메서드를 호출하여 원하는 sp_pages GlideRecord를 가져옵니다.") 사용하여 원하는 sp_page GlideRecord를 얻습니다. | | queryString | 문자열 | URL로 전달해야 할 모든 매개변수를 해결하는 데 사용할 쿼리 문자열입니다. 예: `?id=kb_article&sys_id=471ee81eff6002009b20ffffffffff34` | [표 1. 매개변수] {#SPSU-getHumReadUrl_GR_S__table_vjm_wwg_hvb} {#SPSU-getHumReadUrl_GR_S__table_wjm_wwg_hvb__entry__2} | 유형 | 설명 | |-|-| | 문자열 | 지정된 서비스 포털 기록에 대해 사용자가 읽을 수 있는 URL입니다. URL 변수는 전달 queryString 된 매개변수의 내용을 사용하여 확인됩니다. | [표 2. 반환] {#SPSU-getHumReadUrl_GR_S__table_wjm_wwg_hvb} 다음 코드 예제에서는 이 메서드를 호출하여 사람이 읽을 수 있는 URL을 가져오는 방법을 보여 줍니다. function() { var util = new global.SPSEOUtilsSNC(); var portalId = util.getPortalId(); var pageGR = util.getPageRecordWithPageRoute( 'kb_article', portalId, false); var queryString = "?id=kb_article&sys_id=471ee81eff6002009b20ffffffffff34"; var hrUrl = util.getHumanReadableUrl(pageGR, queryString); {#SPSU-getHumReadUrl_GR_S__codeblock_epr_kgh_vvb} 출력: "getting-around-in-windows" ## SPSEOUtilsSNC - getHumanReadableUrlForCurrentRequest() {#ariaid-title3} 현재 서비스 포털 기록에 대해 사용자가 읽을 수 있는 URL을 반환합니다. 이 메서드는 사람이 읽을 수 있는 이 URL을 만들 때 매개변수 및 쿼리 매개변수와 같은 id 현재 페이지의 비밀 URL에 있는 매개변수를 복제합니다. {#SPSU-getHumanReadUrlForCurReq__table_cwl_4rp_tvb__entry__3} | 이름 | 유형 | 설명 | |-|-|-| | 안 함 | | | [표 3. 매개변수] {#SPSU-getHumanReadUrlForCurReq__table_cwl_4rp_tvb} {#SPSU-getHumanReadUrlForCurReq__table_dwl_4rp_tvb__entry__2} | 유형 | 설명 | |-|-| | 문자열 | 현재 서비스 포털 기록에 대해 사용자가 읽을 수 있는 URL입니다. | [표 4. 반환] {#SPSU-getHumanReadUrlForCurReq__table_dwl_4rp_tvb} 다음 코드 예제에서는 이 메서드를 호출하는 방법을 보여 줍니다. 이 예에서 현재 서비스 포털 기록은 `/sp?id=kb_article&sys_id=471ee81eff6002009b20ffffffff34` 의 비밀 URL을 사용하며 Windows에서의 탐색에 대해 설명하는 KB 문서의 짧은 설명을 표시하도록 구성되어 있습니다. 이 비밀스러운 URL에 대해 반환된 사람이 읽을 수 있는 URL은 "getting-around-in-windows"입니다. // In a script include function() { var util = new global.SPSEOUtilsSNC() var hrUrl = util.getHumanReadableUrlForCurrentRequest(); } 출력: getting-around-in-windows ## SPSEOUtilsSNC - getPageRecordWithPageRoute(GlideRecord pageId, 문자열 portalId, 부울 preventReRoute) {#ariaid-title4} ID 필드가 전달된 ID 매개변수(sp_pagepageId)와 일치하는 페이지 \[\] 테이블에서 GlideRecord를 반환합니다. getHumanReadableUrl() 메서드를 호출하기 전에 이 메서드를 호출하여 원하는 sp_pages GlideRecord를 가져옵니다. 또한 메서드가 페이지 경로 맵 정보를 사용하여 전달된 서비스 포털 페이지 ID와 연결된 최종 서비스 포털 페이지의 GlideRecord를 반환하도록 요청할 수 있습니다. 페이지 경로 맵에 대한 자세한 내용은 [페이지 ID로 참조 리디렉션](https://www.servicenow.com/docs/access?context=reroute-page&version=australia&pubname=australia-platform-user-interface&ft:locale=en-US)을 참조하세요. {#SPSU-getPageRecWPageRte_S_S_B__table_hhx_rzn_tvb__entry__3} | 이름 | 유형 | 설명 | |-|-|-| | pageId | 문자열 | 반환할 페이지 \[sp_page\] 기록의 ID입니다. 테이블: 페이지 \[sp_page\] 테이블의 ID 필드에 있습니다. | | portalId | 문자열 | 연결된 서비스 포털 \[sp_portal\] 레코드의 Sys_id입니다. 전달 pageId 된 매개변수와 관련된 기록에 접근할 수 없거나 사용할 수 없는 경우 적절한 로그인 또는 404 페이지를 반환하는 데 필요합니다. 해당 방법을 사용하여 [SPSEOUtilsSNC - getPortalId()](https://servicenow-prod.fluidtopics.net/BD7BYlxb1XihfE9Nq4SDaA#SPSU-getPortalId "요청 URL의 포털 접미사를 기반으로 로드되는 포털의 sys_id 반환합니다. getPageRecordWithPageRoute() 메서드를 호출하기 전에 이 메서드를 호출하여 원하는 서비스 포털 sys_id 가져옵니다.") 원하는 서비스 포털 ID를 가져옵니다. | | preventReRoute | 부울 | 페이지 경로 맵을 사용하여 일치하는 sp_page 기록 대신 전달된 페이지 ID가 확인되는 마지막 sp_page에 대한 GlideRecord를 반환할지 여부를 나타내는 플래그입니다. 가능한 값: * true: 페이지 경로 맵을 사용하여 전달된 페이지 ID가 확인하는 마지막 sp_page 기록을 반환합니다. * 아니오: 전달된 페이지 ID가 일치하는 sp_page 기록을 반환합니다. | [표 5. 매개변수] {#SPSU-getPageRecWPageRte_S_S_B__table_hhx_rzn_tvb} {#SPSU-getPageRecWPageRte_S_S_B__table_ihx_rzn_tvb__entry__2} | 유형 | 설명 | |-|-| | GlideRecord | sp_page 기록에 대한 쿼리 요청과 일치하는 기록입니다. | [표 6. 반환] {#SPSU-getPageRecWPageRte_S_S_B__table_ihx_rzn_tvb} 다음 코드 예제에서는 getHumanReadableUrl() 메서드를 호출하기 전에 이 메서드를 호출하는 방법을 보여 줍니다. function() { var util = new global.SPSEOUtilsSNC(); var portalId = util.getPortalId(); var pageGR = util.getPageRecordWithPageRoute( 'kb_article', portalId, false); var queryString = "?id=kb_article&sys_id=471ee81eff6002009b20ffffffffff34"; var hrUrl = util.getHumanReadableUrl(pageGR, queryString); ## SPSEOUtilsSNC - getPortalId() {#ariaid-title5} 요청 URL의 포털 접미사를 기반으로 로드되는 포털의 sys_id 반환합니다. getPageRecordWithPageRoute() 메서드를 호출하기 전에 이 메서드를 호출하여 원하는 서비스 포털 sys_id 가져옵니다. {#SPSU-getPortalId__table_l5r_sxg_tvb__entry__3} | 이름 | 유형 | 설명 | |-|-|-| | 안 함 | | | [표 7. 매개변수] {#SPSU-getPortalId__table_l5r_sxg_tvb} {#SPSU-getPortalId__table_m5r_sxg_tvb__entry__2} | 유형 | 설명 | |-|-| | 문자열 | 요청 URL의 포털 접미사를 기반으로 요청된 서비스 포털 Sys_id입니다. | [표 8. 반환] {#SPSU-getPortalId__table_m5r_sxg_tvb} 다음 코드 예제에서는 `/sp?id=index`와 같은 URL에 대해 이 메서드를 호출하는 방법을 보여 줍니다. function() { var util = new global.SPSEOUtilsSNC(); var portalId = util.getPortalId(); var pageGR = util.getPageRecordWithPageRoute( 'kb_article', portalId, false); var queryString = "?id=kb_article&sys_id=471ee81eff6002009b20ffffffffff34"; var hrUrl = util.getHumanReadableUrl(pageGR, queryString); 출력: 81b75d3147032100ba13a5554ee4902b