GlideStringUtil - escopo, global

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

    • . GlideStringUtil A API fornece métodos de manipulação de cadeia de caracteres.

    Acesse esses métodos usando o objeto estático GlideStringUtil. Esta classe está disponível em scripts com escopo e globais.

    GlideStringUtil - dotToUnderBar(cadeia de caracteres sourceString)

    Substitui períodos por caracteres de sublinhado.

    Tabela 1. Parâmetros
    Nome Tipo Descrição
    SourceString Cadeia de caracteres Texto a ser processado.
    Tabela 2. Retornos
    Tipo Descrição
    Cadeia de caracteres Texto com pontos substituídos por sublinhados. 
    var filename="../../../../../../etc/passwd";
cleanFilename=GlideStringUtil.dotToUnderBar(filename);
gs.info(cleanFilename);

    Saída:

     __/__/__/__/__/__/etc/passwd

    GlideStringUtil - escapeAllQuotes(cadeia de caracteres sourceString)

    Remove aspas de uma cadeia de caracteres.

    Tabela 3. Parâmetros
    Nome Tipo Descrição
    SourceString Cadeia de caracteres A cadeia de caracteres a ser processada.
    Tabela 4. Retornos
    Tipo Descrição
    Cadeia de caracteres A cadeia de caracteres com aspas removidas. 
    mystring="let's escape some quotes";
escapeQuote=GlideStringUtil.escapeAllQuotes(mystring);
gs.info(escapeQuote);

    Saída:

    lets escape some quotes

    GlideStringUtil - escapeForHomePage(cadeia de caracteres sourceString)

    Substitui caracteres de problema por caracteres de escape.

    Tabela 5. Parâmetros
    Nome Tipo Descrição
    SourceString Cadeia de caracteres Texto a ser processado.
    Tabela 6. Retornos
    Tipo Descrição
    Cadeia de caracteres Texto com caracteres de problema substituídos por caracteres de escape. 
    mystring="<test> string \n to escape";
escapedString=GlideStringUtil.escapeForHomePage(mystring);
gs.info(escapedString);

    Saída:

    %3ctest%3e string \n to escape

    GlideStringUtil - escapeHTML(cadeia de caracteres htmlString)

    Substitui caracteres ilegais por seus códigos de escape.

    Usar este método remove caracteres ilegais que podem fazer com que a IU seja renderizada incorretamente ou acionar um ataque do lado do cliente, como JavaScript ou injeção de HTML.

    Tabela 7. Parâmetros
    Nome Tipo Descrição
    HtmlString Cadeia de caracteres Texto a ser processado.
    Tabela 8. Retornos
    Tipo Descrição
    Cadeia de caracteres Texto com caracteres ilegais substituídos por seus códigos de escape. 
    mydata='"<>&';
mydata=GlideStringUtil.escapeHTML(mydata);
gs.info(mydata);

    Saída:

    "<>&

    GlideStringUtil - escapeNonprintable(cadeia de caracteres sourceString)

    Substitui caracteres não imprimíveis pela notação imprimível.

    Tabela 9. Parâmetros
    Nome Tipo Descrição
    SourceString Cadeia de caracteres Texto a ser processado.
    Tabela 10. Retornos
    Tipo Descrição
    Cadeia de caracteres Texto com caracteres não imprimíveis substituído por notação imprimível. 
    mystring="test \x09 non \x00 printable \x07 chars";
escapedString=GlideStringUtil.escapeNonPrintable(mystring);
gs.info(escapedString);

    Saída:

    test \t non \u0000 printable \u0007 chars

    GlideStringUtil - escapeQueryTermSeparator(cadeia de caracteres sourceString)

    Substitui os separadores de termo de consulta "" pela sequência de escape "".

    Tabela 11. Parâmetros
    Nome Tipo Descrição
    SourceString Cadeia de caracteres Texto a ser processado.
    Tabela 12. Retornos
    Tipo Descrição
    Cadeia de caracteres Texto com separadores de termo de consulta substituídos pelos caracteres de escape. 
    myquery="test^Test";
escapedQuery=GlideStringUtil.escapeQueryTermSeparator(myquery);
gs.info(escapedQuery);

    Saída:

    test^^Test

    GlideStringUtil - escapeTicks(cadeia de caracteres sourceString)

    Substitui aspas por caracteres de escape adicionando uma barra invertida antes de cada aspas.

    Tabela 13. Parâmetros
    Nome Tipo Descrição
    SourceString Cadeia de caracteres Texto a ser processado.
    Tabela 14. Retornos
    Tipo Descrição
    Cadeia de caracteres Texto com barras invertidas adicionadas antes das aspas. 
    mystring="let's try escapeTicks";
escaped=GlideStringUtil.escapeTicks(mystring);
gs.info(escaped);

    Saída:

    let\'s try escapeTicks

    GlideStringUtil - getHTMLValue(cadeia de caracteres sourceString)

    Substitui caracteres HTML ilegais em notação HTML.

    Usar este método remove caracteres ilegais que podem fazer com que a IU seja renderizada incorretamente ou acionar um ataque do lado do cliente, como JavaScript ou injeção de HTML.

    Tabela 15. Parâmetros
    Nome Tipo Descrição
    SourceString Cadeia de caracteres Texto a ser processado.
    Tabela 16. Retornos
    Tipo Descrição
    Cadeia de caracteres Texto com caracteres ilegais substituído pela notação HTML. 
    mydata='&';
htmlvalue=GlideStringUtil.getHTMLValue(mydata);
gs.info(htmlvalue);

    Saída:

    &

    GlideStringUtil - getNumeric(cadeia de caracteres sourceString)

    Extrai caracteres numéricos de uma cadeia de caracteres.

    Tabela 17. Parâmetros
    Nome Tipo Descrição
    SourceString Cadeia de caracteres Texto a ser processado.
    Tabela 18. Retornos
    Tipo Descrição
    Cadeia de caracteres Texto que contém somente caracteres numéricos. 
    mystring='123 test 456 String 789 cleaning';
onlyNumeric=GlideStringUtil.getNumeric(mystring);
gs.info(onlyNumeric);

    Saída:

    123456789

    GlideStringUtil - isBase64(cadeia de caracteres sourceString)

    Valida se a cadeia de caracteres especificada é uma cadeia de caracteres base64 válida.

    Tabela 19. Parâmetros
    Nome Tipo Descrição
    SourceString Cadeia de caracteres Texto a ser processado.
    Tabela 20. Retornos
    Tipo Descrição
    Booliano Sinalizador que indica se a cadeia de caracteres especificada está no formato base64 válido.
    Valores possíveis:
    • Verdadeiro: Cadeia de caracteres válida formatada em base64.
    • Falso: Cadeia de caracteres formatada em base64 inválida.
    		 
    //(adding a "*" to corrupt the base64 format)
base64="GethdTYehdtshetB*";
isValid=GlideStringUtil.isBase64(base64);
gs.info(isValid);

    Saída:

    false

    GlideStringUtil - isEligibleSysID(cadeia de caracteres sourceString)

    Valida se a cadeia de caracteres especificada está no formato sys_id válido.

    O formato sys_id é uma sequência de 32 caracteres hexadecimais em que todos os caracteres estão no intervalo [0-9, a-f, A-F].

    Tabela 21. Parâmetros
    Nome Tipo Descrição
    SourceString Cadeia de caracteres Texto a ser processado.
    Tabela 22. Retornos
    Tipo Descrição
    Booliano Sinalizador que indica se a cadeia de caracteres especificada está no formato sys_id válido.
    Valores possíveis:
    • Verdadeiro: Cadeia de caracteres formatada sys_id válida.
    • Inválido: Cadeia de caracteres formatada sys_id.
    		 
    sysID="62826bf03710200044e0bfc8bcbe5df1";
isElig=GlideStringUtil.isEligibleSysID(sysID);
gs.info(isElig);

    Saída:

    true

    GlideStringUtil - newLinesToBreaks(cadeia de caracteres sourceString)

    Substitui o novo caractere de linha, /n , com um código de interrupção, <br/>.

    Tabela 23. Parâmetros
    Nome Tipo Descrição
    SourceString Cadeia de caracteres Texto a ser processado.
    Tabela 24. Retornos
    Tipo Descrição
    Cadeia de caracteres Texto com novos caracteres de linha substituídos pelo código de quebra de HTML. 
    mystring="new line break \n, this is after the break";
replaceNewLine=GlideStringUtil.newLinesToBreaks(mystring);
gs.info(replaceNewLine);

    Saída:

    new line break <br/>, this is after the break

    GlideStringUtil - normalizeEspaço em branco (cadeia de caracteres sourceString)

    Substitui retornos de carro, feeds de linha e guias por espaços e remove espaços iniciais, finais e duplicados.

    Tabela 25. Parâmetros
    Nome Tipo Descrição
    SourceString Cadeia de caracteres Texto a ser processado.
    Tabela 26. Retornos
    Tipo Descrição
    Cadeia de caracteres Texto com retornos de carro, feeds de linha e guias substituídos por espaços e, em seguida, espaços iniciais, finais e duplicados removidos. 
    mystring="test with \n (new line) and \t (tabulation)";
normalizedString=GlideStringUtil.normalizeWhitespace(mystring);
gs.info(normalizedString);

    Saída:

    test with (new line) and (tabulation)

    GlideStringUtil - unEscapeHTML(cadeia de caracteres htmlString)

    Substitui caracteres de escape por seus respectivos caracteres.

    Este método substitui estes caracteres de escape:  e &cotação; .

    Nota:
    Em aplicações com escopo, chame este método como UnescapeHTML (cadeia de caracteres) . Em aplicações globais, chame este método como UnEscapeHTML (cadeia de caracteres) .
    Tabela 27. Parâmetros
    Nome Tipo Descrição
    HtmlString Cadeia de caracteres Cadeia de caracteres a ser processada.
    Tabela 28. Retornos
    Tipo Descrição
    Cadeia de caracteres Cadeia de caracteres com os caracteres de escape substituídos.

    Este exemplo de código mostra o método que está sendo chamado em uma aplicação global.

    mydata='"<>&';
unescaped=GlideStringUtil.unEscapeHTML(mydata);
gs.info(unescaped);

    Saída:

    "<>&

    Este exemplo de código mostra o método que está sendo chamado em uma aplicação com escopo.

    mydata='"<>&';
unescaped=GlideStringUtil.unescapeHTML(mydata);
gs.info(unescaped);

    Saída:

    "<>&

    GlideStringUtil - UrlEncode (url da cadeia de caracteres)

    Codifica caracteres não ASCII, caracteres ASCII não seguros e espaços para que você possa usar a cadeia de caracteres retornada na Internet. Usa codificação UTF-8. Usa codificação percentual (%).

    Nota:
    Disponível somente no escopo global.
    Tabela 29. Parâmetros
    Nome Tipo Descrição
    URL Cadeia de caracteres Cadeia de caracteres a ser codificada.
    Tabela 30. Retornos
    Tipo Descrição
    Cadeia de caracteres Cadeia de caracteres com caracteres não ASCII, caracteres ASCII não seguros e espaços codificados. 
    var mystring='Test characters: " < > & " < > &';
escapedString=GlideStringUtil.urlEncode(mystring);
gs.info(escapedString);

    Saída:

    Test+characters%3A+%22+%3C+%3E+%26+%26quot%3B+%26lt%3B+%26gt%3B+%26amp%3B