【Servicenow】Workspace内のリスト作成方法

# 【ServiceNow】Workspaceのリスト表示をカスタマイズする手順まとめ
この記事では、**ServiceNowのWorkspaceにリストを作成する手順**を解説します。  
カテゴリ・リスト・オーディエンスの作成、およびその関連付けまで一通り紹介します。

## カスタマイズできる主な設定項目

Workspaceのリスト表示では、以下のような柔軟なカスタマイズが可能です。
これにより、**ユーザーの用途に応じたリストの表示最適化**が実現できます。

| 項目 | 説明 |
|------|------|
| **Table** | 表示する対象テーブルを指定（例：`incident`, `change_request` など） |
| **Filter（Condition）** | データの絞り込み条件を設定（例：`status = opend`） |
| **Columns** | 表示するフィールドを指定（例：`number`, `short_description`, `state`） |
| **Role条件** | 誰がこのリストを閲覧できるかを制御可能（オーディエンス設定と連携） |

## Workspaceリストのテーブル構成
| 概要                       | テーブル名                        |
|----------------------------|-----------------------------------|
| カテゴリの作成            | `sys_ux_list_category_list`       |
| リストの作成              | `sys_ux_list`                     |
| オーディエンスの作成      | `sys_ux_applicability`            |
| リストとオーディエンスの紐づけ | `sys_ux_applicability_m2m_list`   |

## 作成後の完成イメージ
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3941772/fd18ff7c-d35a-4259-b3c3-92e1d789135d.png)

## 1. カテゴリを作成する
① `sys_ux_list_category_list` に遷移  
② `New`ボタン押下

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3941772/223d70eb-c3d5-450b-953a-ce61f6533aa8.png)

③ 以下を入力：
   - Title（任意の名前）
   - Order（表示順）
   - Configuration（対象のWorkspaceなど）

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3941772/50a5bdb8-0420-4cbf-ae27-869ab158c4eb.png)

**作成後イメージ：**

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3941772/98bbeb21-e685-4146-8b1d-6225895b3c36.png)

## 2. リストを作成する
① 作成したカテゴリを開く
② `New`ボタンをクリック

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3941772/10d9a962-d7d2-41c1-bd09-84322981781d.png)

③ リストに必要な設定を行う
**設定可能な項目が多いので、作成する際には要確認**

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3941772/8a7567c5-a5cd-4b45-a4ac-79f2ed1bca43.png)

**作成後イメージ：**

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3941772/6fd874e7-2079-47af-864c-8dfa520df30e.png)

## 3. オーディエンスを作成する
① `sys_ux_applicability`に遷移  
② `New`ボタン押下

![https___qiita-image-store.s3.ap-northeast-1.amazonaws.com_0_3941772_62551f0b-ef78-4f28-a756-39f2ba8115e6.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3941772/4f5bb60d-b687-4525-8f68-c2397635044f.jpeg)

③ 以下を入力：
   - Name / Description：任意の名称
   - Role：対象ユーザーが保有するロール

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3941772/8d0b5107-dee1-480b-bd83-12fcec40c50c.png)

**作成後イメージ：**

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3941772/d1dcb4ef-7955-4c89-929a-2843b40fc3a2.png)

## 4. リストとオーディエンスを紐づける
① `sys_ux_applicability_m2m_list` に遷移
② `New`ボタン押下

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3941772/f11291c6-7b03-4ead-9757-8299a406030d.png)

③ 対象の**リスト**と**オーディエンス**を選択

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3941772/26524760-fee7-4fb0-ac8f-0d18f5cd1c47.png)

## 5. リストを確認
設定を行った該当のリストのみがユーザーのワークスペースに表示される

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3941772/77ca088a-4489-4deb-88f6-918813de4ac7.png)