---
sourceDocument: Referência de API do Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Referência de API do Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# GlideStringUtil - com escopo, global

# GlideStringUtil - com escopo, global {#ariaid-title1}

* Versão de lançamento: Xanadu
* 
* Atualizado 1 de ago. de 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 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) {#ariaid-title2}

Substitui pontos por caracteres de sublinhado.
{#GSUS-dotToUnderBar_S__table_vvg_gbv_5cb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| cadeia de caracteres de origem | Cadeia de caracteres | Texto a ser processado. |
[Tabela 1. Parâmetros]

{#GSUS-dotToUnderBar_S__table_vvg_gbv_5cb} {#GSUS-dotToUnderBar_S__table_wvg_gbv_5cb__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | Texto com pontos substituídos por sublinhados. |
[Tabela 2. Retorna]

{#GSUS-dotToUnderBar_S__table_wvg_gbv_5cb}  

    var filename="../../../../../../etc/passwd";
    cleanFilename=GlideStringUtil.dotToUnderBar(filename);
    gs.info(cleanFilename);

Saída:

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

## GlideStringUtil - escapeAllQuotes(cadeia de caracteres sourceString) {#ariaid-title3}

Remove aspas de uma cadeia de caracteres.
{#GSUS-escapeAllQuotes_S__table_pyk_bd4_5cb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| cadeia de caracteres de origem | Cadeia de caracteres | A cadeia de caracteres a ser processada. |
[Tabela 3. Parâmetros]

{#GSUS-escapeAllQuotes_S__table_pyk_bd4_5cb} {#GSUS-escapeAllQuotes_S__table_qyk_bd4_5cb__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | A cadeia de caracteres com aspas removidas. |
[Tabela 4. Retorna]

{#GSUS-escapeAllQuotes_S__table_qyk_bd4_5cb}  

    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) {#ariaid-title4}

Substitui caracteres de problema por caracteres de escape.
{#GSUS-escapeForHomePage_S__table_r25_cgv_5cb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| cadeia de caracteres de origem | Cadeia de caracteres | Texto a ser processado. |
[Tabela 5. Parâmetros]

{#GSUS-escapeForHomePage_S__table_r25_cgv_5cb} {#GSUS-escapeForHomePage_S__table_s25_cgv_5cb__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | Texto com caracteres de problema substituídos por caracteres de escape. |
[Tabela 6. Retorna]

{#GSUS-escapeForHomePage_S__table_s25_cgv_5cb}  

    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) {#ariaid-title5}

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.
{#GSUS-escapeHTML_S__table_mtt_fym_5cb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| htmlString | Cadeia de caracteres | Texto a ser processado. |
[Tabela 7. Parâmetros]

{#GSUS-escapeHTML_S__table_mtt_fym_5cb} {#GSUS-escapeHTML_S__table_ntt_fym_5cb__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | Texto com caracteres ilegais substituídos por seus códigos de escape. |
[Tabela 8. Retorna]

{#GSUS-escapeHTML_S__table_ntt_fym_5cb}  

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

Saída:

    "<>&

## GlideStringUtil -- escapeNonprintable(cadeia de caracteres sourceString) {#ariaid-title6}

Substitui caracteres não imprimíveis por sua notação imprimível.
{#GSUS-escapeNonPrintable_S__table_qm1_f1v_5cb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| cadeia de caracteres de origem | Cadeia de caracteres | Texto a ser processado. |
[Tabela 9. Parâmetros]

{#GSUS-escapeNonPrintable_S__table_qm1_f1v_5cb} {#GSUS-escapeNonPrintable_S__table_rm1_f1v_5cb__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | Texto com caracteres não imprimíveis substituídos por notação imprimível. |
[Tabela 10. Retorna]

{#GSUS-escapeNonPrintable_S__table_rm1_f1v_5cb}  

    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) {#ariaid-title7}

Substitui os separadores de termos de consulta "\^" pela sequência de escape "\^\^".
{#GSUS-escapeQTermSeparator_S__table_zwy_fdv_5cb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| cadeia de caracteres de origem | Cadeia de caracteres | Texto a ser processado. |
[Tabela 11. Parâmetros]

{#GSUS-escapeQTermSeparator_S__table_zwy_fdv_5cb} {#GSUS-escapeQTermSeparator_S__table_axy_fdv_5cb__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | Texto com separadores de termos de consulta substituídos pelos caracteres de escape. |
[Tabela 12. Retorna]

{#GSUS-escapeQTermSeparator_S__table_axy_fdv_5cb}  

    myquery="test^Test";
    escapedQuery=GlideStringUtil.escapeQueryTermSeparator(myquery);
    gs.info(escapedQuery);

Saída:

    test^^Test

## GlideStringUtil - escapeTics(cadeia de caracteres sourceString) {#ariaid-title8}

Substitui aspas por caracteres de escape adicionando uma barra invertida antes de cada aspas.
{#GSUS-escapeTicks_S__table_ixz_zd4_5cb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| cadeia de caracteres de origem | Cadeia de caracteres | Texto a ser processado. |
[Tabela 13. Parâmetros]

{#GSUS-escapeTicks_S__table_ixz_zd4_5cb} {#GSUS-escapeTicks_S__table_jxz_zd4_5cb__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | Texto com barras invertidas adicionadas antes das aspas. |
[Tabela 14. Retorna]

{#GSUS-escapeTicks_S__table_jxz_zd4_5cb}  

    mystring="let's try escapeTicks";
    escaped=GlideStringUtil.escapeTicks(mystring);
    gs.info(escaped); 

Saída:

    let\'s try escapeTicks

## GlideStringUtil -- getHTMLValue(cadeia de caracteres sourceString) {#ariaid-title9}

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.
{#GSUS-getHTMLValue_S__table_bbb_q14_5cb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| cadeia de caracteres de origem | Cadeia de caracteres | Texto a ser processado. |
[Tabela 15. Parâmetros]

{#GSUS-getHTMLValue_S__table_bbb_q14_5cb} {#GSUS-getHTMLValue_S__table_cbb_q14_5cb__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | Texto com caracteres inválidos substituídos por notação HTML. |
[Tabela 16. Retorna]

{#GSUS-getHTMLValue_S__table_cbb_q14_5cb}  

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

Saída:

    &

## GlideStringUtil -- getNumeric(cadeia de caracteres sourceString) {#ariaid-title10}

Extrai caracteres numéricos de uma cadeia de caracteres.
{#GSUS-getNumeric_S__table_wzj_yb4_5cb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| cadeia de caracteres de origem | Cadeia de caracteres | Texto a ser processado. |
[Tabela 17. Parâmetros]

{#GSUS-getNumeric_S__table_wzj_yb4_5cb} {#GSUS-getNumeric_S__table_xzj_yb4_5cb__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | Texto que contém apenas caracteres numéricos. |
[Tabela 18. Retorna]

{#GSUS-getNumeric_S__table_xzj_yb4_5cb}  

    mystring='123 test 456 String 789 cleaning';
    onlyNumeric=GlideStringUtil.getNumeric(mystring);
    gs.info(onlyNumeric); 

Saída:

    123456789

## GlideStringUtil - isBase64(cadeia de caracteres sourceString) {#ariaid-title11}

Valida se a cadeia de caracteres especificada é uma cadeia de caracteres base64 válida.
{#GSUS-isBase64_S__table_xzl_h3v_5cb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| cadeia de caracteres de origem | Cadeia de caracteres | Texto a ser processado. |
[Tabela 19. Parâmetros]

{#GSUS-isBase64_S__table_xzl_h3v_5cb} {#GSUS-isBase64_S__table_yzl_h3v_5cb__entry__2}

| 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. {#GSUS-isBase64_S__ul_npg_wwp_3pb} |
[Tabela 20. Retorna]

{#GSUS-isBase64_S__table_yzl_h3v_5cb}  

    //(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) {#ariaid-title12}

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\].
{#GSUS-isEligibleSysID_S__table_cgh_2jv_5cb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| cadeia de caracteres de origem | Cadeia de caracteres | Texto a ser processado. |
[Tabela 21. Parâmetros]

{#GSUS-isEligibleSysID_S__table_cgh_2jv_5cb} {#GSUS-isEligibleSysID_S__table_dgh_2jv_5cb__entry__2}

| 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. {#GSUS-isEligibleSysID_S__ul_npg_wwp_3pb} |
[Tabela 22. Retorna]

{#GSUS-isEligibleSysID_S__table_dgh_2jv_5cb}  

    sysID="62826bf03710200044e0bfc8bcbe5df1";
    isElig=GlideStringUtil.isEligibleSysID(sysID);
    gs.info(isElig);

Saída:

    true

## GlideStringUtil - newLinesToBreaks(cadeia de caracteres sourceString) {#ariaid-title13}

Substitui o novo caractere de linha, `/n`, por um código de quebra, `<br/>`.
{#GSUS-newLinesToBreaks_S__table_mty_zn4_5cb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| cadeia de caracteres de origem | Cadeia de caracteres | Texto a ser processado. |
[Tabela 23. Parâmetros]

{#GSUS-newLinesToBreaks_S__table_mty_zn4_5cb} {#GSUS-newLinesToBreaks_S__table_nty_zn4_5cb__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | Texto com caracteres de nova linha substituídos pelo código de quebra de HTML. |
[Tabela 24. Retorna]

{#GSUS-newLinesToBreaks_S__table_nty_zn4_5cb}  

    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) {#ariaid-title14}

Substitui retornos de carro, feeds de linha e tabulações por espaços e, em seguida, remove espaços iniciais, finais e duplicados.
{#GSUS-normalizeWhitespace_S__table_xdj_yy5_5cb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| cadeia de caracteres de origem | Cadeia de caracteres | Texto a ser processado. |
[Tabela 25. Parâmetros]

{#GSUS-normalizeWhitespace_S__table_xdj_yy5_5cb} {#GSUS-normalizeWhitespace_S__table_ydj_yy5_5cb__entry__2}

| 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. |
[Tabela 26. Retorna]

{#GSUS-normalizeWhitespace_S__table_ydj_yy5_5cb}  

    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) {#ariaid-title15}

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).
{#GSUS-unescapeHTML_S__table_uzm_zzm_5cb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| htmlString | Cadeia de caracteres | Cadeia de caracteres a ser processada. |
[Tabela 27. Parâmetros]

{#GSUS-unescapeHTML_S__table_uzm_zzm_5cb} {#GSUS-unescapeHTML_S__table_vzm_zzm_5cb__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | Cadeia de caracteres com os caracteres de escape substituídos. |
[Tabela 28. Retorna]

{#GSUS-unescapeHTML_S__table_vzm_zzm_5cb}  
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) {#ariaid-title16}

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.
{#GSUS-urlEncode_S__table_bcw_xvt_lyb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| URL | Cadeia de caracteres | Cadeia de caracteres a ser codificada. |
[Tabela 29. Parâmetros]

{#GSUS-urlEncode_S__table_bcw_xvt_lyb} {#GSUS-urlEncode_S__table_ccw_xvt_lyb__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | Cadeia de caracteres com caracteres não ASCII, caracteres ASCII não seguros e espaços codificados. |
[Tabela 30. Retorna]

{#GSUS-urlEncode_S__table_ccw_xvt_lyb}  

    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