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

  • リリースバージョン: Xanadu
  • 更新日 2024年08月01日
  • 所要時間: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');  
         }  
    }