GlideStringUtil - com escopo, global

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 5 min. de leitura

    • A API GlideStringUtil 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 pontos por caracteres de sublinhado.

    Tabela 1. Parâmetros
    Nome Tipo Descrição
    cadeia de caracteres de origem 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
    cadeia de caracteres de origem 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
    cadeia de caracteres de origem 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(String htmlString)

    Substitui caracteres inválidos por seus códigos de escape.

    O uso deste método remove caracteres ilegais que podem fazer com que a IU seja renderizada incorretamente ou acionar um ataque do lado do cliente, como injeção de JavaScript ou 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 por sua notação imprimível.

    Tabela 9. Parâmetros
    Nome Tipo Descrição
    cadeia de caracteres de origem Cadeia de caracteres Texto a ser processado.
    Tabela 10. Retornos
    Tipo Descrição
    Cadeia de caracteres Texto com caracteres não imprimíveis substituídos 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 termos de consulta "^" pela sequência de escape "^^".

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

    Saída:

    test^^Test

    GlideStringUtil - escapeTics(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
    cadeia de caracteres de origem 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.

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

    Tabela 15. Parâmetros
    Nome Tipo Descrição
    cadeia de caracteres de origem Cadeia de caracteres Texto a ser processado.
    Tabela 16. Retornos
    Tipo Descrição
    Cadeia de caracteres Texto com caracteres inválidos substituídos por 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
    cadeia de caracteres de origem Cadeia de caracteres Texto a ser processado.
    Tabela 18. Retornos
    Tipo Descrição
    Cadeia de caracteres Texto que contém apenas 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
    cadeia de caracteres de origem 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 formatada em base64 válida.
    • 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, af, AF].

    Tabela 21. Parâmetros
    Nome Tipo Descrição
    cadeia de caracteres de origem 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 por sys_id válida.
    • falso: cadeia de caracteres formatada por sys_id inválida.
    		 
    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, por um código de quebra, <br/>.

    Tabela 23. Parâmetros
    Nome Tipo Descrição
    cadeia de caracteres de origem Cadeia de caracteres Texto a ser processado.
    Tabela 24. Retornos
    Tipo Descrição
    Cadeia de caracteres Texto com caracteres de nova 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 - normalizewhitespace(cadeia de caracteres sourceString)

    Substitui retornos de carro, feeds de linha e tabulações por espaços e, em seguida, remove espaços iniciais, finais e duplicados.

    Tabela 25. Parâmetros
    Nome Tipo Descrição
    cadeia de caracteres de origem Cadeia de caracteres Texto a ser processado.
    Tabela 26. Retornos
    Tipo Descrição
    Cadeia de caracteres O texto com retornos de carro, feeds de linha e tabulações 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 os caracteres de escape pelo respectivo caractere.

    Este método substitui estes caracteres de escape: < >: & "e;.

    Nota:
    Em aplicações com escopo, chame este método como unescapeHTML(String). Em aplicações globais, chame este método como unEscapeHTML(String).
    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 (cadeia de caracteres URL)

    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 a codificação de porcentagem (%).

    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