SPSEOUtilidades - Global

. SPSEOUtilidades A inclusão de script fornece métodos utilitários 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.

Além disso, essa 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 para um registro especificado na tabela Página [sp_page ]. Usa os parâmetros de consulta passados para resolver todas as variáveis de página dinâmicas 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 o. 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 parâmetros que possam precisar ser passados pela URL. Por exemplo: e, em seguida, clique em "ok_article" e "sys_id"

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 esse método para obter a 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 o URL criptografado de <instance-url>/sp?id 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 é "obtendo-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 de páginas [sp_page] cujo campo de ID corresponde ao parâmetro de ID aprovado ( pageId). Chame este método antes de chamar o. GetHumanReadableUrl() Método para obter o GlideRecord desejado sp_pages.

Você também pode solicitar que o método use as informações dos 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 da 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 de 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 404 páginas caso o registro associado ao tenha sido aprovado pageIdo parâmetro não está acessível ou indisponível. Use o. SPSEOUtilsSNC - getPortalId() método para obter o desejado Portal de serviços ID.
PreventReRoute	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 foi resolvido, 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 foi resolvido. 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. GetHumanReadableUrl() 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 o. GetPageRecordWithPageRoute() 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 esse método para uma URL como <instance-url>/sp .

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