SPSEOUtilsSNC - 전역

SPSEOUtilsSNC 스크립트 포함은 트랜잭션 요청에 따라 특정 페이지 또는 현재 페이지에 대해 사용자가 읽을 수 있는 URL을 반환하는 유틸리티 메서드를 제공합니다.

또한 이 API는 사람이 읽을 수 있는 다른 URL 메서드를 호출하는 데 필요한 정보를 가져오는 데 사용할 수 있는 다른 유틸리티 메서드를 제공합니다.

SPSEOUtilsSNC - getHumanReadableUrl(GlideRecord pageGR, String queryString)

페이지 [sp_page] 테이블의 지정된 기록에 대해 사용자가 읽을 수 있는 URL을 반환합니다. 전달된 쿼리 매개변수를 사용하여 URL에 필요한 동적 페이지 변수를 확인합니다.

표 1. 매개변수

이름	유형	설명
페이지GR	GlideRecord	사람이 읽을 수 있는 URL을 반환할 페이지 [sp_page] 테이블에 있는 기록의 GlideRecord 객체입니다. SPSEOUtilsSNC - getPageRecordWithPageRoute(GlideRecord pageId, 문자열 portalId, 부울 preventReRoute) 메서드를 사용하여 원하는 sp_page GlideRecord를 얻습니다.
쿼리 문자열	문자열	URL로 전달해야 할 수 있는 매개변수를 확인하는 데 사용할 쿼리 문자열입니다. 예: ?id=kb_article&sys_id=471ee81eff6002009b20ffffffffff34

표 2. 반환

유형	설명
문자열	지정된 서비스 포털 기록에 대해 사용자가 읽을 수 있는 URL입니다. URL 변수는 전달 queryString 된 매개변수의 내용을 사용하여 확인됩니다.

다음 코드 예제에서는 이 메서드를 호출하여 사람이 읽을 수 있는 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);

출력:

"getting-around-in-windows"

SPSEOUtilsSNC - getHumanReadableUrlForCurrentRequest()

현재 서비스 포털 기록에 대해 사용자가 읽을 수 있는 URL을 반환합니다.

이 메서드는 사람이 읽을 수 있는 이 URL을 만들 때 매개변수 및 쿼리 매개변수와 같은 id 현재 페이지의 암호화된 URL에 있는 매개변수를 복제합니다.

표 3. 매개변수

이름	유형	설명
없음

표 4. 반환

유형	설명
문자열	현재 서비스 포털 기록에 대해 사용자가 읽을 수 있는 URL입니다.

다음 코드 예제에서는 이 메서드를 호출하는 방법을 보여 줍니다. 이 예에서 현재 서비스 포털 레코드는 <instance-url>/sp?id=kb_article&sys_id=471ee81eff6002009b20ffffffffff34 의 암호 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)

ID 필드가 전달된 ID 매개변수()와 일치하는 페이지 [sp_page] 테이블에서 GlideRecord를pageId 반환합니다. getHumanReadableUrl() 메서드를 호출하기 전에 이 메서드를 호출하여 원하는 sp_pages GlideRecord를 가져옵니다.

페이지 경로 맵 정보를 사용하여 전달 서비스 포털 된 페이지 ID와 연결된 최종 서비스 포털 페이지의 GlideRecord를 반환하도록 메서드에 요청할 수도 있습니다. 페이지 경로 맵에 대한 자세한 내용은 참조를 페이지 ID로 리디렉션을 참조하십시오.

표 5. 매개변수

이름	유형	설명
pageId	문자열	반환할 페이지 [sp_page] 기록의 ID입니다. id 페이지 [sp_page] 테이블의 필드에 있습니다.
포털 ID	문자열	연결된 Service Portal [sp_portal] 기록의 Sys_id입니다. 전달 pageId 된 매개변수와 연결된 기록에 접근할 수 없거나 사용할 수 없는 경우 적절한 로그인 또는 404 페이지를 반환하는 데 필요합니다. 메서드를 SPSEOUtilsSNC - getPortalId() 사용하여 원하는 서비스 포털 ID를 가져옵니다.
preventReRoute	부울	페이지 경로 맵을 사용하여 일치하는 sp_page 기록 대신 전달된 페이지 ID가 확인되는 마지막 sp_page에 대한 GlideRecord를 반환할지 여부를 나타내는 플래그입니다. 가능한 값: true: 페이지 경로 맵을 사용하여 전달된 페이지 ID가 확인하는 마지막 sp_page 기록을 반환합니다. false: 전달된 페이지 ID가 일치하는 sp_page 레코드를 반환합니다.

표 6. 반환

유형	설명
GlideRecord	sp_page 기록에 대한 쿼리 요청과 일치하는 기록입니다.

다음 코드 예제에서는 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()

요청 URL의 포털 접미사를 기반으로 로드되는 포털의 sys_id 반환합니다. getPageRecordWithPageRoute() 메서드를 호출하기 전에 이 메서드를 호출하여 원하는 서비스 포털 sys_id 가져옵니다.

표 7. 매개변수

이름	유형	설명
없음

표 8. 반환

유형	설명
문자열	요청 URL의 포털 접미사를 기반으로 하는 요청 서비스 포털 Sys_id입니다.

다음 코드 예제에서는 <instance-url>/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