SpUtil - Cliente

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 8 min. de leitura

    • . SpUtil A API fornece métodos de utilitário para executar funções comuns em um Portal de serviços client script de widget.

    Estas funções incluem:

    Para obter informações adicionais sobre widgets, consulte Widgets do Portal de serviços .

    SpUtil - addErrorMessage (mensagem de cadeia de caracteres)

    Exibe uma mensagem de erro de notificação.

    Tabela 1. Parâmetros
    Nome Tipo Descrição
    message Cadeia de caracteres Mensagem de erro a ser exibida.
    Tabela 2. Retornos
    Tipo Descrição
    vazio 
    spUtil.addErrorMessage("There has been an error processing your request")

    SpUtil - addInfoMessage (mensagem de cadeia de caracteres)

    Exibe uma mensagem informativa de notificação.

    Tabela 3. Parâmetros
    Nome Tipo Descrição
    message Cadeia de caracteres Mensagem a ser exibida.
    Tabela 4. Retornos
    Tipo Descrição
    vazio 
    spUtil.addInfoMessage("Your order has been placed")

    SpUtil - addTrivialMessage(mensagem de cadeia de caracteres)

    Exibe uma mensagem de notificação trivial.

    Mensagens triviais desaparecem após um curto período de tempo.

    Tabela 5. Parâmetros
    Nome Tipo Descrição
    message Cadeia de caracteres Mensagem a ser exibida.
    Tabela 6. Retornos
    Tipo Descrição
    vazio 
    spUtil.addTrivialMessage("Thanks for your order")

    SpUtil - createUid()

    Crie um identificador exclusivo .

    Tabela 7. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 8. Retorna
    Tipo Descrição
    Cadeia de caracteres Um ID exclusivo de 32 caracteres.

    SpUtil - Get (String widgetId Object data)

    Incorpora um modelo de widget em um client script de widget.

    A função de retorno de chamada retorna o modelo de widget completo. Para obter informações adicionais sobre widgets, consulte Widgets do Portal de serviços .

    Tabela 9. Parâmetros
    Nome Tipo Descrição
    WidgetId Cadeia de caracteres ID do widget ou sys_id do widget a ser incorporado.
    dados Objeto Opcional. Pares de nome/valor de parâmetros a serem passados para o modelo de widget.
    Tabela 10. Retornos
    Tipo Descrição
    Objeto Modelo do widget incorporado.

    Sem dados passados.

    spUtil.get("widget-cool-clock").then(function(response) {
  c.coolClock = response;
});

    Com dados aprovados.

    spUtil.get('pps-list-modal', {title: c.data.editAllocations, 
  table: 'resource_allocation', 
  queryString: 'GROUPBYuser^resource_plan=' + c.data.sysId, 
  view: 'resource_portal_allocations' }).then(function(response) {
    var formModal = response;
    c.allocationListModal = response;
  });

    SpUtil - getHeaders()

    Recupera todos os cabeçalhos a serem usados para chamadas de API.

    Tabela 11. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 12. Retorna
    Tipo Descrição
    Objeto Todos os cabeçalhos a serem usados para chamadas de API.

    SpUtil - getHost()

    Retorna o domínio do host completo.

    Tabela 13. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 14. Retorna
    Tipo Descrição
    Cadeia de caracteres O domínio do host completo, por exemplo hi.servicenow.com

    SpUtil - getPreference (preferência de cadeia de caracteres, retorno de chamada da função)

    Executa o retorno de chamada com a resposta de preferência do usuário passando o nome da preferência.

    Tabela 15. Parâmetros
    Nome Tipo Descrição
    preferência Cadeia de caracteres Nome da preferência.
    retorno de chamada Função Defina a função de retorno de chamada.
    Tabela 16. Retornos
    Tipo Descrição
    vazio

    SpUtil - getURL()

    Retorna as informações da URL do portal de serviços atual.

    Tabela 17. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 18. Retorna
    Tipo Descrição
    Cadeia de caracteres URL do portal de serviços atual.

    SpUtil - format(Modelo de cadeia de caracteres, Dados do objeto)

    Formata uma cadeia de caracteres que contém variáveis.

    Use este método como uma alternativa à concatenação de cadeia de caracteres.

    Tabela 19. Parâmetros
    Nome Tipo Descrição
    modelo Cadeia de caracteres Modelo de cadeia de caracteres que contém valores para substituição de variável.
    dados Objeto Objeto que contém os valores das variáveis definidas na cadeia de caracteres do modelo.
    Tabela 20. Retornos
    Tipo Descrição
    Cadeia de caracteres Cadeia de caracteres que contém os valores das variáveis em vez da nomenclatura das variáveis. 
    spUtil.format('An error ocurred: {error} when loading {widget}', {error: '404', widget: 'sp-widget'})

    Saída:

    'An error occurred: 404 when loading sp-widget'

    SpUtil - isMobile()

    Verifica se o cliente atual é um dispositivo móvel.

    Tabela 21. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 22. Retorna
    Tipo Descrição
    Booliano Sinalizador que indica se o cliente atual é um dispositivo móvel.
    Valores válidos:
    • Verdadeiro: O cliente atual é um dispositivo móvel.
    • Falso: O cliente atual não é um dispositivo móvel.

    SpUtil - parseAttributes (atributos de cadeia de caracteres)

    Analisa os atributos separados por vírgulas em uma cadeia de caracteres especificada.

    Tabela 23. Parâmetros
    Nome Tipo Descrição
    atributos Cadeia de caracteres Cadeia de caracteres que contém atributos separados por vírgulas, como Atributos campo de um registro de dicionário.
    Tabela 24. Retornos
    Tipo Descrição
    Matriz Matriz de objetos que contém os atributos analisados. 
    function getRefQualElements() {
  var refQualElements = [];
  if (field && field.attributes && field.attributes.indexOf('ref_qual_elements') > -1) {
    var attributes = spUtil.parseAttributes(field.attributes);
    refQualElements = attributes['ref_qual_elements'].split(';');
  }
  return refQualElements;
}

    SpUtil - recordWatch(escopo do objeto, tabela de cadeia de caracteres, filtro de cadeia de caracteres, retorno de chamada da função)

    Verifica se há atualizações em uma tabela ou filtro e retorna o valor da função de retorno de chamada.

    Permite que um desenvolvedor de widget responda a atualizações de tabela em tempo real. Por exemplo, usando RecordWatch() , O widget Lista simples pode ouvir mudanças em sua tabela de dados. Se registros forem adicionados, removidos ou atualizados, o widget será atualizado automaticamente.

    Nota:
    Ao passar por escopo argumento em RecordWatch() injeção escopo nos parâmetros da sua função de script de cliente.
    Tabela 25. Parâmetros
    Nome Tipo Descrição
    escopo Objeto Escopo do objeto de dados atualizado pela função de retorno de chamada.
    tabela Cadeia de caracteres Tabela observada.
    filtros Cadeia de caracteres Filtre os campos a serem observados.
    retorno de chamada Função Opcional. Parâmetro para definir a função de retorno de chamada.
    Tabela 26. Retornos
    Tipo Descrição
    Promessa Valor de retorno da função de retorno de chamada. 
    //A simple recordWatch function.
spUtil.recordWatch($scope, "live_profile", "sys_id=" + liveProfileId);

//In a widget client script
function(spUtil, $scope) {
  /* widget controller */
  var c =this;

  // Registers a listener on the incident table with the filter active=true, 
  // meaning that whenever something changes on that table with that filter, 
  // the callback function is executed.    
  // The callback function takes a single parameter 'response', which contains 
  // the property 'data'. The 'data' property contains information about the changed record. 
  spUtil.recordWatch($scope, "incident", "active=true", function(response) {
        
    // Returns the data inserted or updated on the table 
    console.log(response.data);   
    
    });
}

    SpUtil - atualização (objeto

    Chama o servidor e substitui o atual opções e. dados com a resposta do servidor.

    Chamando SpUtil.refresh() é semelhante à chamada server.refresh() . No entanto, quando você liga SpUtil.refresh() , você pode definir o objeto de escopo.

    Tabela 27. Parâmetros
    Nome Tipo Descrição
    escopo Objeto Escopo definido para a atualização.
    Tabela 28. Retornos
    Tipo Descrição
    Objeto Objetos de dados e opções atualizadas.

    SpUtil - scrollTo (seletor de cadeia de caracteres, número de tempo)

    Rola até o elemento com o seletor especificado durante um período especificado.

    Tabela 29. Parâmetros
    Nome Tipo Descrição
    seletor Cadeia de caracteres Seletor para rolar.
    hora Número Tempo necessário para rolar até o seletor especificado.

    Unidade: Milissegundos
    Tabela 30. Retornos
    Tipo Descrição
    vazio

    SpUtil - setBreadCrumb(escopo do objeto, trilhas de matriz)

    Atualiza as trilhas de cabeçalho.

    Tabela 31. Parâmetros
    Nome Tipo Descrição
    escopo Objeto Escopo definido para a tabela.
    Trilhas Matriz Condições usadas para criar o filtro de trilha.
    Tabela 32. Retornos
    Tipo Descrição
    vazio

    SpUtil - setPreference(cadeia de caracteres pref, valor da cadeia de caracteres)

    Define uma preferência do usuário.

    Tabela 33. Parâmetros
    Nome Tipo Descrição
    pref Cadeia de caracteres Nome de preferência
    valor Cadeia de caracteres Valor de preferência
    Tabela 34. Retornos
    Tipo Descrição
    vazio

    SpUtil - setSearchPage (cadeia de caracteres SearchPage)

    Atualiza a página de pesquisa.

    Tabela 35. Parâmetros
    Nome Tipo Descrição
    SearchPage Cadeia de caracteres Nome da página de pesquisa.
    Tabela 36. Retornos
    Tipo Descrição
    vazio

    SPUtil - update (objeto

    Atualiza o objeto de dados no servidor em um determinado escopo.

    Este método é semelhante a. server.update() , mas inclui um parâmetro de escopo que define o escopo a ser passado.

    Tabela 37. Parâmetros
    Nome Tipo Descrição
    escopo Objeto Escopo definido para a atualização.
    Tabela 38. Retornos
    Tipo Descrição
    Objeto Objeto de dados atualizado.

    O exemplo a seguir inclui um widget P1 que observa mudanças no campo de estado e usa um filtro para observar todos os P1s ativos e permite que a função de retorno de chamada determine se os dados devem ser atualizados. . data.changesa propriedade contém uma matriz de todos os campos atualizados. Se o estado de qualquer campo tiver mudado, os dados serão atualizados no widget.

    var q = "priority=1^active=true^EQ";
spUtil.recordWatch($scope, "incident", q, function(event, data) {
   if (data.changes.includes("state")) { // only update if state was updated.
      spUtil.update($scope);
   }
});