GlideStringUtil – Scoped, Global

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 4 Minuten Lesedauer

    • Die GlideStringUtil Die API stellt Zeichenfolgenbehandlungsmethoden bereit.

    Greifen Sie auf diese Methoden mit dem statischen Objekt GlideStringUtil zu. Diese Klasse ist in bereichsbezogenen und globalen Skripts verfügbar.

    GlideStringUtil – dotToUnderBar(String sourceString)

    Ersetzt Punkte durch Unterstriche.

    Tabelle : 1. Parameter
    Name Typ Beschreibung
    sourceString Zeichenfolge Zu verarbeitender Text.
    Tabelle : 2. Rückgaben
    Typ Beschreibung
    Zeichenfolge Text mit Punkten, die durch Unterstriche ersetzt wurden. 
    var filename="../../../../../../etc/passwd";
cleanFilename=GlideStringUtil.dotToUnderBar(filename);
gs.info(cleanFilename);

    Ausgabe:

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

    GlideStringUtil – escapeAllQuotes(String sourceString)

    Entfernt Anführungszeichen aus einer Zeichenfolge.

    Tabelle : 3. Parameter
    Name Typ Beschreibung
    sourceString Zeichenfolge Zu verarbeitende Zeichenfolge.
    Tabelle : 4. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Zeichenfolge mit entfernten Anführungszeichen. 
    mystring="let's escape some quotes";
escapeQuote=GlideStringUtil.escapeAllQuotes(mystring);
gs.info(escapeQuote);

    Ausgabe:

    lets escape some quotes

    GlideStringUtil – escapeForHomePage(String sourceString)

    Ersetzt Problemzeichen durch Escape-Zeichen.

    Tabelle : 5. Parameter
    Name Typ Beschreibung
    sourceString Zeichenfolge Zu verarbeitender Text.
    Tabelle : 6. Rückgaben
    Typ Beschreibung
    Zeichenfolge Text mit Problemzeichen durch Escape-Zeichen ersetzt. 
    mystring="<test> string \n to escape";
escapedString=GlideStringUtil.escapeForHomePage(mystring);
gs.info(escapedString);

    Ausgabe:

    %3ctest%3e string \n to escape

    GlideStringUtil – escapeHTML(String htmlString)

    Ersetzt ungültige Zeichen durch ihre Escape-Codes.

    Bei Verwendung dieser Methode werden unzulässige Zeichen entfernt, die dazu führen könnten, dass die Benutzeroberfläche nicht ordnungsgemäß gerendert wird oder ein clientseitiger Angriff wie JavaScript oder HTML-Injection ausgelöst wird.

    Tabelle : 7. Parameter
    Name Typ Beschreibung
    htmlString Zeichenfolge Zu verarbeitender Text.
    Tabelle : 8. Rückgaben
    Typ Beschreibung
    Zeichenfolge Text mit ungültigen Zeichen durch Escape-Codes ersetzt. 
    mydata='"<>&';
mydata=GlideStringUtil.escapeHTML(mydata);
gs.info(mydata);

    Ausgabe:

    "<>&

    GlideStringUtil – escapeNonPrintable(String sourceString)

    Ersetzt nicht druckbare Zeichen durch ihre druckbare Notation.

    Tabelle : 9. Parameter
    Name Typ Beschreibung
    sourceString Zeichenfolge Zu verarbeitender Text.
    Tabelle : 10. Rückgaben
    Typ Beschreibung
    Zeichenfolge Text mit nicht druckbaren Zeichen wurde durch druckbare Schreibweise ersetzt. 
    mystring="test \x09 non \x00 printable \x07 chars";
escapedString=GlideStringUtil.escapeNonPrintable(mystring);
gs.info(escapedString);

    Ausgabe:

    test \t non \u0000 printable \u0007 chars

    GlideStringUtil – escapeQueryTermSeparator(String sourceString)

    Ersetzt die Trennzeichen für Abfragebegriffe (^) durch ihre Escape-Sequenz (^^).

    Tabelle : 11. Parameter
    Name Typ Beschreibung
    sourceString Zeichenfolge Zu verarbeitender Text.
    Tabelle : 12. Rückgaben
    Typ Beschreibung
    Zeichenfolge Text mit Abfragebegriff-Trennzeichen durch Escape-Zeichen ersetzt. 
    myquery="test^Test";
escapedQuery=GlideStringUtil.escapeQueryTermSeparator(myquery);
gs.info(escapedQuery);

    Ausgabe:

    test^^Test

    GlideStringUtil – escapeTicks(String sourceString)

    Ersetzt Anführungszeichen durch Escape-Zeichen, indem vor jedem Angebot ein umgekehrter Schrägstrich hinzugefügt wird.

    Tabelle : 13. Parameter
    Name Typ Beschreibung
    sourceString Zeichenfolge Zu verarbeitender Text.
    Tabelle : 14. Rückgaben
    Typ Beschreibung
    Zeichenfolge Text mit umgekehrten Schrägstrichen, der vor Anführungszeichen hinzugefügt wurde. 
    mystring="let's try escapeTicks";
escaped=GlideStringUtil.escapeTicks(mystring);
gs.info(escaped);

    Ausgabe:

    let\'s try escapeTicks

    GlideStringUtil – getHTMLValue(String sourceString)

    Ersetzt ungültige HTML-Zeichen in HTML-Schreibweise.

    Bei Verwendung dieser Methode werden unzulässige Zeichen entfernt, die dazu führen könnten, dass die Benutzeroberfläche nicht ordnungsgemäß gerendert wird oder ein clientseitiger Angriff wie JavaScript oder HTML-Injection ausgelöst wird.

    Tabelle : 15. Parameter
    Name Typ Beschreibung
    sourceString Zeichenfolge Zu verarbeitender Text.
    Tabelle : 16. Rückgaben
    Typ Beschreibung
    Zeichenfolge Text mit ungültigen Zeichen wurde durch HTML-Schreibweise ersetzt. 
    mydata='&';
htmlvalue=GlideStringUtil.getHTMLValue(mydata);
gs.info(htmlvalue);

    Ausgabe:

    &

    GlideStringUtil – getNumeric(String sourceString)

    Extrahiert numerische Zeichen aus einer Zeichenfolge.

    Tabelle : 17. Parameter
    Name Typ Beschreibung
    sourceString Zeichenfolge Zu verarbeitender Text.
    Tabelle : 18. Rückgaben
    Typ Beschreibung
    Zeichenfolge Text, der nur numerische Zeichen enthält. 
    mystring='123 test 456 String 789 cleaning';
onlyNumeric=GlideStringUtil.getNumeric(mystring);
gs.info(onlyNumeric);

    Ausgabe:

    123456789

    GlideStringUtil – isBase64(String sourceString)

    Validiert, ob die angegebene Zeichenfolge eine gültige base64-Zeichenfolge ist.

    Tabelle : 19. Parameter
    Name Typ Beschreibung
    sourceString Zeichenfolge Zu verarbeitender Text.
    Tabelle : 20. Rückgaben
    Typ Beschreibung
    Boolean Kennzeichnung, die angibt, ob die angegebene Zeichenfolge im gültigen Base64-Format vorliegt.
    Mögliche Werte:
    • Wahr: Gültige Zeichenfolge im Base64-Format.
    • Falsch: Ungültige base64-formatierte Zeichenfolge.
    		 
    //(adding a "*" to corrupt the base64 format)
base64="GethdTYehdtshetB*";
isValid=GlideStringUtil.isBase64(base64);
gs.info(isValid);

    Ausgabe:

    false

    GlideStringUtil – isEligibleSysID(String sourceString)

    Validiert, ob die angegebene Zeichenfolge ein gültiges sys_ID-Format hat.

    Das sys_ID-Format ist eine Sequenz von 32 Hexadezimalzeichen, wobei alle Zeichen im Bereich [0–9, a–f, A–F] liegen.

    Tabelle : 21. Parameter
    Name Typ Beschreibung
    sourceString Zeichenfolge Zu verarbeitender Text.
    Tabelle : 22. Rückgaben
    Typ Beschreibung
    Boolean Kennzeichnung, die angibt, ob die angegebene Zeichenfolge ein gültiges sys_ID-Format hat.
    Mögliche Werte:
    • Wahr: Gültige sys_ID-formatierte Zeichenfolge.
    • Falsch: Ungültige sys_ID-formatierte Zeichenfolge.
    		 
    sysID="62826bf03710200044e0bfc8bcbe5df1";
isElig=GlideStringUtil.isEligibleSysID(sysID);
gs.info(isElig);

    Ausgabe:

    true

    GlideStringUtil – newLinesToBreaks(String sourceString)

    Ersetzt das neue Zeilenzeichen, /N , Mit Pausencode, <br/>.

    Tabelle : 23. Parameter
    Name Typ Beschreibung
    sourceString Zeichenfolge Zu verarbeitender Text.
    Tabelle : 24. Rückgaben
    Typ Beschreibung
    Zeichenfolge Text mit neuen Zeilenzeichen durch HTML-Pausencode ersetzt. 
    mystring="new line break \n, this is after the break";
replaceNewLine=GlideStringUtil.newLinesToBreaks(mystring);
gs.info(replaceNewLine);

    Ausgabe:

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

    GlideStringUtil – normalizeWhitespace(String sourceString)

    Ersetzt Zeilenumbrüche, Zeilenvorschübe und Tabulatoren durch Leerzeichen und entfernt dann führende, nachgestellte und doppelte Leerzeichen.

    Tabelle : 25. Parameter
    Name Typ Beschreibung
    sourceString Zeichenfolge Zu verarbeitender Text.
    Tabelle : 26. Rückgaben
    Typ Beschreibung
    Zeichenfolge Text mit Zeilenumbruch, Zeilenvorschub und Registerkarten durch Leerzeichen ersetzt und dann vorangestellte, nachfolgende und doppelte Leerzeichen entfernt. 
    mystring="test with \n (new line) and \t (tabulation)";
normalizedString=GlideStringUtil.normalizeWhitespace(mystring);
gs.info(normalizedString);

    Ausgabe:

    test with (new line) and (tabulation)

    GlideStringUtil – unEscapeHTML(Zeichenfolge htmlString)

    Ersetzt Escape-Zeichen durch das entsprechende Zeichen.

    Diese Methode ersetzt diese Escape-Zeichen: < >: & &Quote; .

    Hinweis:
    Rufen Sie diese Methode in bereichsbezogenen Anwendungen als auf UnescapeHTML (Zeichenfolge) . Rufen Sie diese Methode in globalen Anwendungen als auf UnEscapeHTML (Zeichenfolge) .
    Tabelle : 27. Parameter
    Name Typ Beschreibung
    htmlString Zeichenfolge Zu verarbeitende Zeichenfolge.
    Tabelle : 28. Rückgaben
    Typ Beschreibung
    Zeichenfolge Zeichenfolge mit den Escape-Zeichen ersetzt.

    Dieses Codebeispiel zeigt die Methode, die in einer globalen Anwendung aufgerufen wird.

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

    Ausgabe:

    "<>&

    Dieses Codebeispiel zeigt die Methode, die in einer bereichsbezogenen Anwendung aufgerufen wird.

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

    Ausgabe:

    "<>&

    GlideStringUtil – urlEncode(Zeichenfolgen-url)

    Codiert nicht-ASCII-Zeichen, unsichere ASCII-Zeichen und Leerzeichen, damit Sie die zurückgegebene Zeichenfolge im Internet verwenden können. Verwendet die UTF-8-Codierung. Verwendet eine prozentuale Codierung (%).

    Hinweis:
    Nur im globalen Bereich verfügbar.
    Tabelle : 29. Parameter
    Name Typ Beschreibung
    URL Zeichenfolge Zu codierende Zeichenfolge.
    Tabelle : 30. Rückgaben
    Typ Beschreibung
    Zeichenfolge Zeichenfolge mit nicht-ASCII-Zeichen, unsicheren ASCII-Zeichen und codierten Leerzeichen. 
    var mystring='Test characters: " < > & " < > &';
escapedString=GlideStringUtil.urlEncode(mystring);
gs.info(escapedString);

    Ausgabe:

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