ナビゲーションハンドラー

  • リリースバージョン: Zurich
  • 更新日 2025年07月31日
  • 所要時間:2分
  • ナビゲーションハンドラーはスクリプト化されたビュールールであり、指定されたテーブルのデータがフォームビューで要求されるたびに実行されます。

    ナビゲーションハンドラーを作成する

    ナビゲーションハンドラー [sys_navigator] テーブルには、インスタンスのナビゲーションハンドラーが含まれています。このテーブルにアクセスするには、フィルターナビゲーターに 「sys_navigator.list 」と入力します。ナビゲーションハンドラーレコードには、ナビゲーションハンドラーが適用されるテーブルを指定する [テーブル ] フィールドと、スクリプト化されたビュールールを含む [スクリプト ] フィールドが含まれています。

    次のスクリプトは、HR プラグインに含まれるナビゲーションハンドラーから取得されます。スクリプトは、[ テーブル ] フィールドのテーブルのレコードで、ロールのないユーザーに対しては ESS ビューを、他のすべてのユーザーにはデフォルトビューを強制的に使用します。

    var now_GR = new GlideRecord(hr.TABLE_CASE);  
    if (gr.get(g_uri.get('sys_id'))) {  
         if (!gs.getUser().hasRoles())   
              g_uri.set('sysparm_view', 'ess');  
         else  
              g_uri.set('sysparm_view', '');  
    }  
      
      
    answer =  g_uri.toString('hr_case.do'); 

    表示ルールの前または後にナビゲーションハンドラーを実行する

    glide.ui.view_rule.check_after_nav_handler システムプロパティを使用して、ビュールールとナビゲーションハンドラーが適用される順序を制御します。ナビゲーションハンドラーの後にビュールールを処理するには、プロパティ値を True に設定します。システムプロパティがインスタンスに存在しない場合、ナビゲーションハンドラーが常に優先されます。

    システムプロパティは、ナビゲーションハンドラースクリプト関数が回答を返さない場合にのみ、ナビゲーションハンドラーを上書きします。上記のスクリプト例では、プロパティには効果がありません。これは、 回答 行が if ステートメントの外にあるため、このナビゲーションハンドラーは常に回答を返すためです。

    前の例のナビゲーション ハンドラー スクリプトにビュー ルールを優先させるには、次の手順を実行します。
    1. glide.ui.view_rule.check_after_nav_handler システムプロパティを作成します。
    2. プロパティの値を [true] に設定します。
    3. ビューを変更または強制する必要がある場合にのみ 回答 を返すように、ナビゲーションハンドラースクリプトを更新します。

    この例は、前のスクリプトを変更したものです。この場合、 回答 行は、ユーザーにロールがない場合にのみ表示されます。ユーザーがロールを持っている場合、 回答 には到達せず、同じテーブルの表示ルールがあればそれが適用されます。

    var now_GR = new GlideRecord(hr.TABLE_CASE);  
    if (gr.get(g_url.get('sys_id'))) {  
         if (!gs.getUser().hasRoles()) {  
              g_url.set('sysparm_view'),'ess');  
              answer = g_url.toString('hr_case.do');  
         }  
    }