GlideStringUtil - スコープ対象、グローバル

文字列処理メソッドを提供します。

これらのメソッドにアクセスするには、静的オブジェクト GlideStringUtil を使用します。このクラスは、スコープ対象のスクリプトとグローバルスクリプトで使用できます。

GlideStringUtil - dotToUnderBar(文字列 sourceString)

ピリオドをアンダースコア文字に置き換えます。

表 : 1. パラメーター

名前	タイプ	説明
sourceString	文字列	処理するテキスト。

表 : 2. 返される内容

タイプ	説明
文字列	ピリオドをアンダースコアに置き換えたテキスト。

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

出力:

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

GlideStringUtil - escapeAllQuotes(文字列 sourceString)

文字列から引用符を削除します。

表 : 3. パラメーター

名前	タイプ	説明
sourceString	文字列	処理される文字列。

表 : 4. 返される内容

タイプ	説明
文字列	引用符が削除された文字列。

mystring="let's escape some quotes";
escapeQuote=GlideStringUtil.escapeAllQuotes(mystring);
gs.info(escapeQuote);

出力:

lets escape some quotes

GlideStringUtil - escapeForHomePage(文字列 sourceString)

問題の文字をエスケープ文字に置き換えます。

表 : 5. パラメーター

名前	タイプ	説明
sourceString	文字列	処理するテキスト。

表 : 6. 返される内容

タイプ	説明
文字列	問題の文字をエスケープ文字に置き換えたテキスト。

mystring="<test> string \n to escape";
escapedString=GlideStringUtil.escapeForHomePage(mystring);
gs.info(escapedString);

出力:

%3ctest%3e string \n to escape

GlideStringUtil - escapeHTML(文字列 htmlString)

無効な文字をエスケープコードに置き換えます。

このメソッドを使用すると、UI が不適切に表示されたり、JavaScript や HTML インジェクションなどのクライアント側の攻撃がトリガーされたりする可能性のある無効な文字が削除されます。

表 : 7. パラメーター

名前	タイプ	説明
htmlString	文字列	処理するテキスト。

表 : 8. 返される内容

タイプ	説明
文字列	無効な文字をエスケープコードに置き換えたテキスト。

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

出力:

"<>&

GlideStringUtil - escapeNonPrintable(文字列 sourceString)

印刷不可能な文字を印刷可能な表記に置き換えます。

表 : 9. パラメーター

名前	タイプ	説明
sourceString	文字列	処理するテキスト。

表 : 10. 返される内容

タイプ	説明
文字列	印刷不可能な文字を印刷可能な表記に置き換えたテキスト。

mystring="test \x09 non \x00 printable \x07 chars";
escapedString=GlideStringUtil.escapeNonPrintable(mystring);
gs.info(escapedString);

出力：

test \t non \u0000 printable \u0007 chars

GlideStringUtil - escapeQueryTermSeparator(文字列 sourceString)

クエリ用語のセパレーター「^」をエスケープシーケンス「^^」に置き換えます。

表 : 11. パラメーター

名前	タイプ	説明
sourceString	文字列	処理するテキスト。

表 : 12. 返される内容

タイプ	説明
文字列	クエリ用語のセパレーターをエスケープ文字に置き換えたテキスト。

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

出力：

test^^Test

GlideStringUtil - escapeTicks(文字列 sourceString)

各引用符の前にバックスラッシュを追加して、引用符をエスケープ文字に置き換えます。

表 : 13. パラメーター

名前	タイプ	説明
sourceString	文字列	処理するテキスト。

表 : 14. 返される内容

タイプ	説明
文字列	引用符の前にバックスラッシュが追加されたテキスト。

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

出力：

let\'s try escapeTicks

GlideStringUtil - getHTMLValue(文字列 sourceString)

無効な HTML 文字を HTML 表記に置き換えます。

このメソッドを使用すると、UI が不適切に表示されたり、JavaScript や HTML インジェクションなどのクライアント側の攻撃がトリガーされたりする可能性のある無効な文字が削除されます。

表 : 15. パラメーター

名前	タイプ	説明
sourceString	文字列	処理するテキスト。

表 : 16. 返される内容

タイプ	説明
文字列	無効な文字を HTML 表記に置き換えたテキスト。

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

出力：

&

GlideStringUtil - getNumeric(文字列 sourceString)

文字列から数字を抽出します。

表 : 17. パラメーター

名前	タイプ	説明
sourceString	文字列	処理するテキスト。

表 : 18. 返される内容

タイプ	説明
文字列	数字のみを含むテキスト。

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

出力：

123456789

GlideStringUtil - isBase64(文字列 sourceString)

指定された文字列が有効な Base64 文字列かどうかを検証します。

表 : 19. パラメーター

名前	タイプ	説明
sourceString	文字列	処理するテキスト。

表 : 20. 返される内容

タイプ	説明
ブーリアン	指定された文字列が有効な Base64 形式かどうかを示すフラグ。 可能な値： true：有効な Base64 形式の文字列。 false：無効な Base64 形式の文字列。

//(adding a "*" to corrupt the base64 format)
base64="GethdTYehdtshetB*";
isValid=GlideStringUtil.isBase64(base64);
gs.info(isValid);

出力：

false

GlideStringUtil - isEligibleSysID(文字列 sourceString)

指定された文字列が有効な sys_id 形式かどうかを示すフラグ。

sys_id 形式は、すべての文字が 0 ～ 9、a ～ f、A ～ F の範囲内である 32 桁の 16 進数です。

表 : 21. パラメーター

名前	タイプ	説明
sourceString	文字列	処理するテキスト。

表 : 22. 返される内容

タイプ	説明
ブーリアン	指定された文字列が有効な sys_id 形式かどうかを示すフラグ。 可能な値： true：有効な sys_id 形式の文字列。 false：無効な sys_id 形式の文字列。

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

出力：

true

GlideStringUtil - newLinesToBreaks(文字列 sourceString)

改行文字 /n をブレークコード <br/> に置き換えます。

表 : 23. パラメーター

名前	タイプ	説明
sourceString	文字列	処理するテキスト。

表 : 24. 返される内容

タイプ	説明
文字列	改行文字を HTML ブレークコードに置き換えたテキスト。

mystring="new line break \n, this is after the break";
replaceNewLine=GlideStringUtil.newLinesToBreaks(mystring);
gs.info(replaceNewLine); 

出力：

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

GlideStringUtil - normalizeWhitespace(文字列 sourceString)

キャリッジリターン、改行、タブをスペースに置き換えた後、先頭のスペース、末尾のスペース、重複するスペースを削除します。

表 : 25. パラメーター

名前	タイプ	説明
sourceString	文字列	処理するテキスト。

表 : 26. 返される内容

タイプ	説明
文字列	キャリッジリターン、改行、タブをスペースに置き換えた後、先頭のスペース、末尾のスペース、重複するスペースを削除したテキスト。

mystring="test with \n (new line) and \t (tabulation)";
normalizedString=GlideStringUtil.normalizeWhitespace(mystring);
gs.info(normalizedString);

出力：

test with (new line) and (tabulation)

GlideStringUtil - unEscapeHTML(文字列 htmlString)

エスケープ文字をそれぞれの文字に置き換えます。

このメソッドは、エスケープ文字 (< &gt:   & &quote;) を置き換えます。

注:

スコープ対象のアプリケーションでは、このメソッドを unscapeHTML(文字列) として呼び出します。グローバルアプリケーションでは、このメソッドを unEscapeHTML(文字列) として呼び出します。

表 : 27. パラメーター

名前	タイプ	説明
htmlString	文字列	処理する文字列。

表 : 28. 返される内容

タイプ	説明
文字列	エスケープ文字が置き換えられた文字列。

このコード例は、グローバルアプリケーションで呼び出されるメソッドを示しています。

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

出力：

"<>&

このコード例は、スコープ対象のアプリケーションで呼び出されるメソッドを示しています。

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

出力：

"<>&

GlideStringUtil - urlEncode(文字列 url)

返された文字列をインターネットで使用できるように、非 ASCII 文字、安全でない ASCII 文字、およびスペースをエンコードします。UTF-8 エンコーディングを使用します。パーセント (%) エンコーディングを使用します。

注:

グローバルスコープでのみ使用できます。

表 : 29. パラメーター

名前	タイプ	説明
url	文字列	エンコードする文字列。

表 : 30. 返される内容

タイプ	説明
文字列	非 ASCII 文字、安全でない ASCII 文字、およびエンコードされたスペースを含む文字列。

var mystring='Test characters: " < > & " < > &';
escapedString=GlideStringUtil.urlEncode(mystring);
gs.info(escapedString);

出力:

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