GlideSPUtil - Global

. GlideSPUtil A API fornece métodos de utilitário para executar funções de back-end comuns que oferecem suporte a Portal de serviços.

Métodos de utilitário disponíveis:

• Resolva variáveis especificadas na tabela Variáveis de página dinâmica [sp_page_title_variable] associadas a um especificado Portal de serviços Página localizada na tabela Página [sp_page].
• Outros métodos

Para obter informações adicionais, consulte Páginas do Portal de serviços .

GlideSPUtil - GlideSPUtil()

Instancia um objeto GlideSPUtil.

Tabela 1. Parâmetros

Nome	Tipo	Descrição
Nenhum(a)

O exemplo de código a seguir mostra como instanciar um objeto GlideSPUtil antes de chamar qualquer um de seus métodos associados.

function() {
  var spUtil = new GlideSPUtil();
  var pageGR = spUtil.getPageRecordWithPageRoute('kb_article', '81b75d3147032100ba13a5554ee4902b', false);
  var queryParams = RP.getParameters();
  var hrUrl = spUtil.getHumanReadableUrl(pageGR, queryParams);
}

GlideSPUtil - getHumanReadableUrl()

Considera parâmetro de consulta "id" Para identificar a página do portal (pageGR) e. Usa a cadeia de caracteres de consulta da transação atual para chamar getHumanReadableUrl(GlideRecord pageGR, cadeia de caracteres querystring) e retorna o legível final.

Tabela 2. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 3. Retorna

Tipo	Descrição
Cadeia de caracteres	URL legível para o especificado Portal de serviços registro com as variáveis substituídas pelo conteúdo do queryParamsmapa de cadeia de caracteres.

Exemplo de código a seguir mostra como fazer .

function() {
  var spUtil = new GlideSPUtil();
  var hrUrl = spUtil.getHumanReadableUrl();
}

Saída:

GlideSPUtil - getHumanReadableUrl(GlideRecord pageGR, cadeia de caracteres queryParams)

Converte o aprovado queryParmsparâmetro de cadeia de caracteres em um mapa de cadeia de caracteres e, em seguida, resolve as variáveis no Cadeia de caracteres "Estrutura de url legível" fornecido no registro sp_page e retorna o. Parte legível final do URL.

Tabela 4. Parâmetros

Nome	Tipo	Descrição
PageGR	GlideRecord	Objeto GlideRecord do registro na tabela Página [sp_page] na qual as variáveis de URL serão resolvidas.
consulta Cadeia de caracteres	Cadeia de caracteres	Cadeia de caracteres de consulta .

Tabela 5. Retornos

Tipo	Descrição
Cadeia de caracteres	URL legível para o especificado Portal de serviços registro com as variáveis substituídas pelo conteúdo do queryParamsmapa de cadeia de caracteres.

Exemplo de código a seguir mostra como fazer .

function() {
  var spUtil = new GlideSPUtil();
  var pageGR = spUtil.getPageRecordWithPageRoute('kb_article', '81b75d3147032100ba13a5554ee4902b', false);
  var queryString = GlideTransaction.get().getRequest().getQueryString();
  var hrUrl = spUtil.getHumanReadableUrl(pageGR, queryParams);
}

Saída:

GlideSPUtil - getHumanReadableUrl(GlideRecord pageGR, StringMap queryParams)

Resolve as variáveis no Estrutura de url legível campo do aprovado Portal de serviços Objeto de página de modelo e retorna um URL que contém os parâmetros de consulta especificados e os parâmetros legíveis resolvidos.

Use palavras-chave legíveis em um URL para:

• Permita que seus clientes entendam melhor a finalidade do URL quando ele não estiver no contexto da página associada.
• Forneça palavras-chave aos mecanismos de pesquisa para localizar melhor a página.

Por exemplo, em vez de ter apenas um URL que contém pares de chave-valor irreconhecíveis, como este:

https://instance_name.servicenow.com/sp/en?id=sc_cat_item&sys_id=ec80c13297968d1021983d1e6253af32&sysparm_catgory=1e80c15697969f1032083d1e6253be15

Você pode adicionar o nome do item ao URL para que seja mais fácil entender a finalidade do URL:

https://instance_name.servicenow.com/sp/en/apple-iphone-13?id=sc_cat_item&sys_id=ec80c13297968d1021983d1e6253af32&sysparm_catgory=1e80c15697969f1032083d1e6253be15

Antes de usar este método, você deve definir as variáveis de página dinâmica que estão disponíveis para cada um dos Portal de serviços Modelos para os quais você deseja incluir conteúdo dinâmico no URL. Para obter detalhes sobre como adicionar essas variáveis, consulte Add human readable keywords to page URLs.

Tabela 6. Parâmetros

Nome	Tipo	Descrição
PageGR	GlideRecord	Objeto GlideRecord do Portal de serviços Página de modelo para a qual as variáveis de URL dinâmicas serão resolvidas. Página [sp_page]
queryParams	StingMap	Parâmetros de consulta de URL a serem usados para obter o desejado Portal de serviços página. Por exemplo: { "id": "sc_cat_item", "sys_id": "ec80c13297968d1021983d1e6253af32", "sysparm_catgory": "1e80c15697969f1032083d1e6253be15" }

Tabela 7. Retornos

Tipo

Descrição

Cadeia de caracteres

URL que contém os elementos legíveis resolvidos para as variáveis dinâmicas especificadas em Portal de serviços página de modelo. Por exemplo, se a variável dinâmica definida for %item_name, O URL contém o nome do item que o usuário selecionou, como "apple-iphone-13, e todos os parâmetros de consulta especificados: https://instance_name.servicenow.com/sp/en/apple-iphone-13?id=sc_cat_item&sys_id=ec80c13297968d1021983d1e6253af32&sysparm_catgory=1e80c15697969f1032083d1e6253be15 .

O exemplo de código a seguir mostra como obter um artigo da base de conhecimento específico e chamar o. ObtDehumanReaadableUrl() para aplicar as variáveis dinâmicas associadas.

function() {
  var spUtil = new GlideSPUtil();
  var pageGR = spUtil.getPageRecordWithPageRoute('kb_article', '81b75d3147032100ba13a5554ee4902b', false);
  var queryParams = RP.getParameters();
  var hrUrl = spUtil.getHumanReadableUrl(pageGR, queryParams);
}