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, 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 o 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 o 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 pelo URL. Por exemplo: _article&sys_id: 471ee81eff6002009b20ffffffff34

Tabela 2. Retornos

Tipo	Descrição
Cadeia de caracteres	URL legível para o especificado Portal de serviçosregistro. As variáveis de URL são resolvidas usando o conteúdo do aprovado 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çosregistro.

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çosregistro.

O exemplo de código a seguir mostra como chamar este método. Neste exemplo, o atual Portal de serviçosO 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 é "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 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çospágina associada ao aprovado Portal de serviçosID 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 as páginas 404 caso o registro associado ao seja 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çosID.
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 é 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çossys_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çosCom base no sufixo do portal do URL da solicitação.

O exemplo de código a seguir mostra como chamar esse método para um 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