GlideStringUtil – Scoped, Global

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 2024
  • 4 Minuten Lesedauer

    • Die GlideStringUtil- API stellt Methoden zur Verarbeitung von Zeichenfolgen 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. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Text, bei dem Punkte durch Unterstriche ersetzt werden. 
    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. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Text, in dem Problemzeichen durch Escape-Zeichen ersetzt wurden. 
    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. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Text mit ungültigen Zeichen wurde durch ihre 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. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Text mit nicht Druckbaren Zeichen, die durch Druckbare Notation ersetzt wurden. 
    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. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Text mit Trennzeichen für Abfragebegriffe, die durch Escape-Zeichen ersetzt wurden. 
    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 Anführungszeichen ein umgekehrter Schrägstrich hinzugefügt wird.

    Tabelle : 13. Parameter
    Name Typ Beschreibung
    sourceString Zeichenfolge Zu verarbeitender Text.
    Tabelle : 14. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Text mit umgekehrten Schrägstrichen vor Anführungszeichen. 
    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 durch die 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. Ergebnisse
    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. Ergebnisse
    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)

    Überprüft, ob die angegebene Zeichenfolge eine gültige Base64-Zeichenfolge ist.

    Tabelle : 19. Parameter
    Name Typ Beschreibung
    sourceString Zeichenfolge Zu verarbeitender Text.
    Tabelle : 20. Ergebnisse
    Typ Beschreibung
    Boolean Kennzeichnung, die angibt, ob die angegebene Zeichenfolge ein gültiges Base64-Format aufweist.
    Mögliche Werte:
    • true: Gültige Zeichenfolge im Base64-Format.
    • „falsch“: Ungültige Zeichenfolge im Base64-Format.
    		 
    //(adding a "*" to corrupt the base64 format)
base64="GethdTYehdtshetB*";
isValid=GlideStringUtil.isBase64(base64);
gs.info(isValid);

    Ausgabe:

    false

    GlideStringUtil – isEligibleSysID(String sourceString)

    Überprüft, ob die angegebene Zeichenfolge ein gültiges sys_id-Format aufweist.

    Das Format „sys_id“ ist eine Sequenz von 32 Hexadezimalzeichen, wobei alle Zeichen im Bereich [0–9, af, AF] liegen.

    Tabelle : 21. Parameter
    Name Typ Beschreibung
    sourceString Zeichenfolge Zu verarbeitender Text.
    Tabelle : 22. Ergebnisse
    Typ Beschreibung
    Boolean Kennzeichnung, die angibt, ob die angegebene Zeichenfolge ein gültiges sys_id-Format aufweist.
    Mögliche Werte:
    • „wahr“: Gültige Zeichenfolge im Sys_id-Format.
    • „falsch“: Ungültige Zeichenfolge im sys_id-Format.
    		 
    sysID="62826bf03710200044e0bfc8bcbe5df1";
isElig=GlideStringUtil.isEligibleSysID(sysID);
gs.info(isElig);

    Ausgabe:

    true

    GlideStringUtil – newLinesToBreaks(String sourceString)

    Ersetzt das Neue-Zeile-Zeichen /ndurch den Umbruchcode <br/>.

    Tabelle : 23. Parameter
    Name Typ Beschreibung
    sourceString Zeichenfolge Zu verarbeitender Text.
    Tabelle : 24. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Text mit neuen Zeilenzeichen, die durch HTML-Umbruchcode ersetzt wurden. 
    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. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Text mit Zeilenumbrüchen, Zeilenumbrüchen und durch Leerzeichen ersetzten Tabulatoren; anschließend werden führende, 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(String htmlString)

    Ersetzt Escape-Zeichen durch das entsprechende Zeichen.

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

    Hinweis:
    Rufen Sie diese Methode in bereichsbezogenen Anwendungen als unescapeHTML(String) auf. In globalen Anwendungen rufen Sie diese Methode als unEscapeHTML(String) auf.
    Tabelle : 27. Parameter
    Name Typ Beschreibung
    htmlString Zeichenfolge Zu verarbeitende Zeichenfolge.
    Tabelle : 28. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Zeichenfolge mit ersetzten Escape-Zeichen.

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

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

    Ausgabe:

    "<>&

    Dieses Codebeispiel zeigt, wie die -Methode 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, sodass 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. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Zeichenfolge mit codierten Nicht-ASCII-Zeichen, unsicheren ASCII-Zeichen und 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