従来のワークスペースでのカスタム UI アクションの設定

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間：6分

    • 組織に合わせて従来のワークスペースをカスタマイズする UI アクションを設定します。UI アクションには、カスタムボタン、メニューアイテム、ユーザーのロールに基づくフォームへのアクセス制限などがあります。

    始める前に

    必要なロール：workspace_admin

    このタスクについて

    UI アクションは、UI アクションメニューのフォームボタンまたはリストアイテムとして表示されます。

    UI アクションボタンとリストアイテム

    各ワークスペースには、UI アクションが事前設定されています。ただし、UI アクションを追加したり事前設定された UI アクションを削除することはできます。

    レコードに対してアクションを実行する必要がないユーザーに対しては、UI アクションを非表示にすることができます。詳細については、「Hide the Details tab and UI Actions ([詳細] タブと UI アクションを非表示にする) 」を参照してください。

    手順

    1. 次のように移動する。 All (すべて) > システム定義 > UI アクション をクリックし、[ 新規] をクリックします。
    2. フォームのフィールドに入力します。
      注:
      次の表に記載されていないフィールドがフォームに表示されますが、ワークスペースでは機能しません。[UI アクション] フォームの各フィールドの詳細については、「 UI アクション」を参照してください。
      [Name (名前)] UI アクション名。これは、ワークスペース UI に表示されます (Assign incident to me など)。
      テーブル UI アクションが適用されるテーブル。エージェントがこのテーブルのレコードを表示するたびに、この UI アクションが表示されます。
      順番 水平リストでの UI アクションの配置。順番の数値は左から右に、小さいものから大きいものになります。
      アクション名 ログおよびテーブル列に表示される [名前] と同等のもの (assign_incident_to_me など)
      有効 切り替えて、UI アクションを表示します。
      レコード作成時に表示 切り替えて、[テーブル (Table)] にレコードの変更を挿入します。
      レコード更新時に表示 切り替えて [テーブル (Table)] に更新を表示します。
      クライアント

      システムがクライアント側スクリプトをチェックするように切り替えます。デフォルトはサーバー側スクリプトになっています。スクリプトで GlideAgentWorkspace API を使用して、指定したレコードを ワークスペース タブに開きます。
      上書き この UI アクションを上書きする UI アクション。
      コメント この UI アクションの説明。
      ヒント UI アクションにマウスを重ねたときに UI アクションの説明を表示します。
      クリック時 UI アクションのマウスクリックで実行されるアクション (confirmAndDeleteFromForm() など)。
      条件 UI アクションが表示されるために満たす必要のある条件 (current.isValidRecord() && current.canDelete() など)。
      スクリプト UI アクションを実装するサーバー側スクリプト。
      アプリケーション

      このコンポーネントが適用されるアプリケーション。[グローバル (Global)] とは、コンポーネントがすべてのアプリケーションに適用されることを意味します。
      フォームボタン 切り替えて、UI アクションをボタンとしてフォームペインに表示します。
      フォームのコンテキストメニュー 切り替えて、UI アクションを [関連アイテム] メニューのタブとして表示します。
      フォームリンク 切り替えて、UI アクションをリンクとしてフォームペインに表示します。
      フォームスタイル
      • プライマリ： UI アクションを青色にします。
      • 破棄： UI アクションを赤色にします。
      • 書式設定なし： UI アクションに色を付けません。
      リストバナーボタン 切り替えて、UI アクションをボタンとしてリストバナーに表示します。
      リスト下部ボタン 切り替えて、UI アクションをレコードのリストの下部にボタンとして表示します。
      リストコンテキストメニュー 切り替えて、UI アクションをリストのコンテキストメニューのエントリーとして表示します。

      コンテキストメニュー
      リスト選択肢 切り替えて、UI アクションをリストビューのドロップダウンリスト選択肢として表示します。
      リストリンク 切り替えて、UI アクションをリンクとしてリストビューに表示します。
      リストスタイル
      • プライマリ： UI アクションを青色にします。
      • 破棄： UI アクションを赤色にします。
      • 書式設定なし： UI アクションに色を付けません。
    3. オプション: UI アクションを実装するサーバー側スクリプトを作成するには、[スクリプト (Script)] フィールドにスクリプトを入力します。
      たとえば、インタラクションレコードから作成されたインシデントに発信者名と簡単な説明を含める場合は、GlideRecord を使用する次のスクリプトを使用できます 
      if(current.update()){
	var inc = new GlideRecord("incident");
	inc.newRecord();
	inc.caller_id = current.opened_for;
	inc.short_description = current.short_description;
	action.openGlideRecord(inc);
}

      システムは、このフィールドに含まれるクライアントスクリプトをすべて無視します。クライアントスクリプトには、ワークスペースクライアントスクリプトフィールドのみを使用できます。

    4. オプション: UI アクションを実装するクライアント側スクリプトを作成するには、「 サポートされているクライアント スクリプトの種類と API と サービス ポータルおよびクライアント スクリプト」を参照してください。
      注:
      クライアントスクリプトフォームで、クライアントスクリプトを従来のワークスペースで機能させるために [スクリプトを隔離] オプションを選択する必要があります。
    5. [ワークスペース] タブで、[ワークスペースフォームボタン] を選択して UI アクションを UI アクションの行に表示するか、[ワークスペースフォームメニュー] を選択してメニューリストにリストアイテムとして表示します。
      • ワークスペースフォームボタン：UI アクションを UI アクションのリストに表示する。
      • ワークスペースフォームメニュー：UI アクションを UI アクションに関連付けられたリストアイテムとしてメニューに表示する。
      • 構成可能なワークスペースの形式：UI アクションを構成可能なワークスペースに表示できる。
        注:
        新しい UI アクションの場合、ユーザーが [ワークスペースフォームボタン] または [ワークスペースフォームメニュー] を選択すると、このプロパティが自動的に選択されます。
        • ユーザーが [ワークスペースフォームボタン] または [ワークスペースフォームメニュー] を選択する前に [構成可能なワークスペース] を選択しようとすると、エラーメッセージが表示されます。
        • ユーザーが従来の (構成不可能な) AWS でのみアクションを表示する場合は、このチェックボックスをオフにする必要があります。
        • 既存の UI アクションを構成可能なワークスペースに表示する場合は、このチェックボックスをオンにしてレコードを保存する必要があります。
    6. オプション: [ワークスペースクライアントスクリプト] フィールドで、ワークスペース固有のクライアントスクリプトを作成します。
      ワークスペースには、サービスポータル と同様のクライアントスクリプトの制限があります。たとえば、クリックしてフォームを開くには、次のクライアントスクリプトを追加します。 
      function onClick(g_form) {

}
    7. ワークスペースセクションの [ロールが必要] タブで、UI アクションへのアクセスを制限するロールを追加します。
    8. [送信] または [更新] をクリックします。

    次のタスク

    設定するコンポーネントをクリックします。

    レコードビュー