GlideStringUtil - com escopo, global

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 globais e com escopo.

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. Retorna

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. Retorna

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. Retorna

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 htmlcadeia de caracteres)

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
Cadeia de caracteres html	Cadeia de caracteres	Texto a ser processado.

Tabela 8. Retorna

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
cadeia de caracteres de origem	Cadeia de caracteres	Texto a ser processado.

Tabela 10. Retorna

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 termo 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. Retorna

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 - escapeTcks(cadeia de caracteres cadeia de caracteres sourceString)

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

Tabela 13. Parâmetros

Nome	Tipo	Descrição
cadeia de caracteres de origem	Cadeia de caracteres	Texto a ser processado.

Tabela 14. Retorna

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. Retorna

Tipo	Descrição
Cadeia de caracteres	Texto com caracteres ilegais substituídos por notação HTML.

mydata='&';
htmlvalue=GlideStringUtil.getHTMLValue(mydata);
gs.info(htmlvalue);

Saída:

&

GlideStringUtil - getNumeric(cadeia de caracteres cadeia de caracteres cadeia de caracteres cadeia de caracteres)

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. Retorna

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. Retorna

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. Retorna

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. false: 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 caractere de nova 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. Retorna

Tipo	Descrição
Cadeia de caracteres	Texto com caracteres de nova linha substituídos pelo código de quebra 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 quebras de linha, 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. Retorna

Tipo	Descrição
Cadeia de caracteres	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 htmlcadeia de caracteres)

Substitui os caracteres de escape pelos respectivos caracteres.

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
Cadeia de caracteres html	Cadeia de caracteres	Cadeia de caracteres a ser processada.

Tabela 28. Retorna

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 inseguros e espaços para que você possa usar a cadeia de caracteres retornada na Internet. Usa codificação UTF-8. Usa 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. Retorna

Tipo	Descrição
Cadeia de caracteres	Cadeia de caracteres com caracteres não ASCII, caracteres ASCII inseguros 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