SPSEOUtilsSNC - Global

. SPSEOUtilsSNC A inclusão de script fornece métodos de utilitário que retornam URLs legíveis para uma página específica ou para a página atual, com base na solicitação de transação.

Esta API fornece outros métodos utilitários que você pode usar para obter informações necessárias para chamar outros métodos de URL legíveis.

SPSEOUtilsSNC - getHumanReadableUrl(GlideRecord pageGR, cadeia de caracteres querystring)

Retorna a URL legível de um registro especificado na tabela Página [sp_page ]. Usa os parâmetros de consulta aprovados para resolver variáveis de página dinâmica exigidas pelo URL.

Tabela 1. Parâmetros

Nome	Tipo	Descrição
PageGR	GlideRecord	Objeto GlideRecord do registro na tabela Página [sp_page] para a qual retornar a URL legível. Use SPSEOUtilsSNC - getPageRecordWithPageRoute(GlideRecord pageID, cadeia de caracteres portalId, boolian preventReRoute) Método para obter o GlideRecord sp_page desejado.
queryString	Cadeia de caracteres	Cadeia de caracteres de consulta a ser usada para resolver quaisquer parâmetros que possam precisar ser passados pelo URL. Por exemplo: e-mail: 471e81eff6002009b20ffffffffff34

Tabela 2. Retornos

Tipo	Descrição
Cadeia de caracteres	URL legível para o especificado Portal de serviços registro. As variáveis de URL são resolvidas usando o conteúdo do passado queryStringparâmetro.

O exemplo de código a seguir mostra como chamar este método para obter o URL legível.

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);

Saída:

"getting-around-in-windows"

SPSEOUtilsSNC - getHumanReadableUrlForCurrentRequest()

Retorna o URL legível para o atual Portal de serviços registro.

Este método replica os parâmetros no URL criptográfico da página atual, como idE os parâmetros de consulta, ao criar este URL legível.

Tabela 3. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 4. Retorna

Tipo	Descrição
Cadeia de caracteres	URL legível para o atual Portal de serviços registro.

O exemplo de código a seguir mostra como chamar este método. Neste exemplo, o atual Portal de serviços O registro usa a URL criptografada de <instance-url>/sp?id_article&sys_id_id_471e81ef6002009b20ffffffffffff34 E está configurado para mostrar a descrição resumida de um artigo da base de conhecimento que discute a navegação no Windows. A URL legível retornada para esta URL criptografada é "obter-em-janelas".

// In a script include
function() {
  var util = new global.SPSEOUtilsSNC()
  var hrUrl = util.getHumanReadableUrlForCurrentRequest();
}

Saída:

getting-around-in-windows

SPSEOUtilsSNC - getPageRecordWithPageRoute(GlideRecord pageID, cadeia de caracteres portalId, boolian preventReRoute)

Retorna o GlideRecord da tabela Páginas [sp_page] cujo campo ID corresponde ao parâmetro de ID aprovado ( pageId). Chame este método antes de chamar ObhumanReadableUrl() Método para obter o GlideRecord de sp_pages desejado.

Você também pode solicitar que o método use as informações de mapas de rota da página para retornar o GlideRecord da final Portal de serviços página associada ao aprovado Portal de serviços ID da página. Para obter informações adicionais sobre mapas de rotas de página, consulte Redirecione uma referência para um ID de página .

Tabela 5. Parâmetros

Nome	Tipo	Descrição
pageId	Cadeia de caracteres	ID do registro de páginas [sp_page] a ser retornado. Tabela: No campo ID da tabela Páginas [sp_page].
portalId	Cadeia de caracteres	Sys_id do registro do Portal de serviços associado [sp_portal]. Necessário para retornar o login apropriado ou as páginas 404 caso o registro associado ao seja aprovado pageIdo parâmetro não está acessível ou indisponível. Use SPSEOUtilsSNC - getPortalId() método para obter o desejado Portal de serviços ID.
PrevenReRoute	Booliano	Sinalizador que indica se os mapas de rota de página devem ser usados para retornar o GlideRecord para o último sp_page para o qual o ID de página aprovado resolve, em vez do registro sp_page correspondente. Valores possíveis: Verdadeiro: Use os mapas de rota de página para retornar o último registro sp_page para o qual o ID de página aprovado resolve. Falso: Retorna o registro sp_page ao qual o ID de página aprovado corresponde.

Tabela 6. Retornos

Tipo	Descrição
GlideRecord	Registro que corresponde à solicitação de consulta para o registro sp_page.

O exemplo de código a seguir mostra como chamar este método antes de chamar o. ObhumanReadableUrl() método.

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()

Retorna o sys_id do portal que está sendo carregado com base no sufixo do portal no URL da solicitação. Chame este método antes de chamar ObterPageRecordWithPageRoute() método para obter o desejado Portal de serviços sys_id.

Tabela 7. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 8. Retorna

Tipo	Descrição
Cadeia de caracteres	Sys_id do solicitado Portal de serviços Com base no sufixo do portal do URL da solicitação.

O exemplo de código a seguir mostra como chamar este método para um URL como <instance-url>/sp?id .

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);

Saída:

81b75d3147032100ba13a5554ee4902b