有効な UI アクション

  • リリースバージョン: Zurich
  • 更新日 2025年07月31日
  • 所要時間:2分
  • UI アクションを構成するには、UI アクションを セキュリティアナリストワークスペース で構成できるように事前に特定のステップを実行して有効化する必要があります。

    注:
    UI アクションを変更するには、次のロールを持つユーザーとしてログインします。
    • ui_action_admin
    • ui_page_admin
    • web_service_admin
    セキュリティアナリストワークスペース に構成できる UI アクションには 2 つのタイプがあります。
    • ダイアログベースの UI アクション
    • サーバー側 UI アクション

    ダイアログベースの UI アクション

    セキュリティアナリストワークスペース でダイアログベースの UI アクションを有効化するには、それぞれの標準 UI アクションに関連付けられた UI ページに次の変更を加えます。

    1. HTML セクション:HTML セクションを変更して、react 入力タグを含めます。react 入力タグ値は、UI ページが セキュリティアナリストワークスペース から起動されたかどうかを識別するためにクライアントスクリプトセクションで使用されます。例を次に示します。

      <input id="react" name="react" type="hidden" value="${JS,HTML:sysparm_react}" />

    2. クライアントスクリプトreact フラグが true の場合、クライアントスクリプトに追加のロジックを記述する必要があります。これは、ダイアログウィンドウの一部として表示される [送信] および [キャンセル] ボタンのイベントを処理するために必要です。
      1. onCancel () イベントハンドラーは、セキュリティアナリストワークスペース から「SIR_WORKBENCH_POPUP_CANCEL」イベントをディスパッチする必要があります。
      2. onSubmit () イベントハンドラーは、セキュリティアナリストワークスペース から「SIR_WORKBENCH_POPUP_SUBMIT」イベントをディスパッチする必要があります。
    3. react 入力タグの値が true のときは false を返すように「onSubmit」アクションを変更したため、処理スクリプトの実行は セキュリティアナリストワークスペース のコンテキストからスキップされます。処理スクリプトのロジックは、(GlideAjax API を介して呼び出される) クライアント呼び出し可能スクリプトまたは REST リソースエンドポイントのいずれかを介して処理する必要があります。
    詳細については、次のサンプルの UI ページを参照してください。
    • 関連リストの UI アクションの例:ウォッチリストに公開 (UI ページ名:publish_to_watchlist)
    • フォームの UI アクションの例:問題の作成 (UI ページ名:create_prb_change_inc)

    サーバー側 UI アクション

    サーバー側 UI アクションを有効化するには、次の操作を行う必要があります。

    標準 UI アクションスクリプトのロジックは、スクリプト化された REST リソースの一部として処理する必要があります。

    詳細については、次のサンプルフォームの UI アクションを参照してください。
    • 機能停止の作成
    • キャンセル