GlideURI - グローバル

GlideURI API は、グローバルアプリケーションで URI パラメーターを処理するためのメソッドを提供します。

注:

エクスポート中またはバックグラウンドジョブで実行されるスクリプトでは GlideURI API を使用しないでください。

URI の使用の詳細については、次のページを参照してください。

• URL で移動
• ナビゲーションスタック

「アクション - getGlideURI()」も参照してください。

GlideURI - deleteMatchingParameter(文字列 match)

指定された文字列の先頭に一致する URI から 1 つ以上のパラメーターを削除します。

表 : 1. パラメーター

名前	タイプ	説明
一致	文字列	URI のクエリー部分から削除する 1 つ以上のパラメーターの名前の一部。

表 : 2. 返される内容

タイプ	説明
なし

次の例では、指定された名前と部分的に一致する URI パラメーターを削除する方法を示しています。

// create the GlideURI object
var uri = action.getGlideURI();

uri.deleteMatchingParameter('sysparm_list_');
uri.deleteMatchingParameter('sysparm_record_');

スコープ対応

このメソッドはスコープ対象のアプリケーションでは使用できません。

GlideURI - deleteParameter(文字列 name)

指定されたパラメーターを URI のクエリー部分から削除します。

表 : 3. パラメーター

名前	タイプ	説明
name	文字列	URI のクエリー部分から削除するパラメーターの名前。

表 : 4. 返される内容

タイプ	説明
なし

次の例は、URI パラメーターを削除する方法を示しています。

// create the GlideURI object
var uri = action.getGlideURI(); 

uri.deleteParameter('sysparm_referring_url');

スコープ対応

このメソッドはスコープ対象のアプリケーションでは使用できません。

GlideURI - get(文字列 name)

指定されたパラメーターの値を返します。

表 : 5. パラメーター

名前	タイプ	説明
name	文字列	パラメーター名。

表 : 6. 返される内容

タイプ	説明
文字列	指定されたパラメーターの値。

// create the GlideURI object
var uri = action.getGlideURI();
uri.set('sysparm_query', 'priority=2^active=true' );
var fileString = uri.get('sysparm_query');
gs.info(fileString);

出力：

priority=2^active=true

スコープ対応

スコープ対象のアプリケーションで get() メソッドを使用するには、対応するスコープ付きメソッド GlideURI - get(文字列名) を使用します。

GlideURI - getFileFromPath()

URI のファイル名部分を返します。

表 : 7. パラメーター

名前	タイプ	説明
なし

表 : 8. 返される内容

タイプ	説明
文字列	URI のファイル名部分。

var gURI = action.getGlideURI();
        
var fileString = gURI.getFileFromPath();
gs.info(fileString);

スコープ対応

スコープ対象のアプリケーションで getFileFromPath() メソッドを使用するには、対応するスコープ付きメソッド GlideURI - getFileFromPath() を使用します。

GlideURI - getMap()

クエリーの各パラメーターとそれに関連する値を含むマップ (キーと値のペア) を返します。

表 : 9. パラメーター

名前	タイプ	説明
なし

表 : 10. 返される内容

タイプ	説明
オブジェクト

次の例は、sysparm_query パラメーターを取得する方法を示しています。 アクション - getGlideURI() も参照してください。

gs.action.getGlideURI().getMap().get('sysparm_query');

スコープ対応

このメソッドはスコープ対象のアプリケーションでは使用できません。

GlideURI - set(文字列 name, 文字列 value)

指定されたパラメーターを指定された値に設定します。

表 : 11. パラメーター

名前	タイプ	説明
name	文字列	パラメーター名。
value	文字列	値。

表 : 12. 返される内容

タイプ	説明
なし

次の例は、sysparm_query フィールドの値を設定する方法を示しています。 アクション - getGlideURI() も参照してください。

var gURI = action.getGlideURI();
gURI.set('sysparm_query', 'priority=2^active=true' );
var fileString = gURI.get('sysparm_query');
gs.info(fileString);

出力：

priority=2^active=true

スコープ対応

スコープ対象のアプリケーションで set() メソッドを使用するには、対応するスコープ付きメソッド GlideURI - set(String name, String value) を使用します。

GlideURI - setView(文字列 view)

名前付きビューを使用して sysparm_view パラメーターをクエリーに追加します。

ビューは、ユーザーがフォームまたはリストを開いたときに表示される要素を定義します。sysparm_view パラメーターは、リストまたはフォームに使用するビューを指定します。ビューの詳細については、「 ビュー管理」を参照してください。

関連項目：

• アクション:getGlideURI()
• GlideModalV3 - switchView()

表 : 13. パラメーター

名前	タイプ	説明
view	文字列	URI クエリーで設定する sysparm_view パラメーターの名前。

表 : 14. 返される内容

タイプ	説明
なし

次の例は、インシデント [incident] テーブルの URI クエリーに重大なインシデントのビューを追加する方法を示しています。たとえば、sysparm_view=Major%20Incidents などです。 アクション - getGlideURI() も参照してください。

// create the GlideURI object
var uri = action.getGlideURI(); 

// Adds the Major incidents to the query
uri.setView('Major Incidents');

// https://instance.service-now.com/incident.do?sys_id=0&sysparm_view=Major%20Incidents ...

スコープ対応

このメソッドはスコープ対象のアプリケーションでは使用できません。

GlideURI - toString(文字列 path)

URI 文字列を再構築し、無効な文字を URL コードに変換して適切な URL エンコードを実行します。たとえば、& を「%26」に変換します。

set() メソッドで設定されたパラメーターも URI でエンコードされます。

表 : 15. パラメーター

名前	タイプ	説明
path	文字列	URI が追加されるシステム URL のベース部分。

表 : 16. 返される内容

タイプ	説明
文字列	URL。

次の例は、無効な文字をインスタンス URL の URL コードに変換する方法を示しています。 アクション - getGlideURI() も参照してください。

var gURI = action.getGlideURI();
fileString = gURI.toString('https://<your instance>.service-now.com/navpage.do');

スコープ対応

スコープ対象のアプリケーションで toString() メソッドを使用するには、対応するスコープ対象のメソッド GlideURI - toString(String path) を使用します。