スキルマトリックス

Prev Next

:::(Info)To download, visit: Library.
:::

「スキルマトリックスウィジェット」とは何ですか?

「スキルマトリックスウィジェット」を使用すると、マトリックス形式の表でユーザーのスキルやタスクの習熟度を可視化、フィルタリング、管理することができます。

Screenshot 2025-08-08 at 17.32.49.png

このウィジェットは、以下の用途にご利用いただけます:

  • オペレーターのスキルを把握し、スキルギャップを特定する
  • ユーザー、グループ、タスク、またはレベルごとにスキルを確認する
  • スキルデータを動的にフィルタリングする
  • マトリックスのセルを操作して、詳細レコードを表示したりアクションをトリガーしたりする

このガイドでは、Tulipにおける「スキルマトリックス」ウィジェットの設定方法と使用方法について説明します。


前提条件

開始する前に、以下の条件を満たしていることを確認してください:

  • Tulipアカウントへのアクセス権
  • サービスアカウントの閲覧およびテーブルの管理権限
  • TulipアカウントのURLおよびワークスペースID

1. 必須パラメータの設定

1.1 サービスアカウントの取得

Feature rename

Prior to r383, Service Accounts were called "API Tokens".

  1. Tulipの右上にあるユーザーアイコンをクリックします。
  2. 「アカウント設定」に移動します。
  3. 左側のメニューから「Tulip API」をクリックします。
  4. 「サービスアカウントを作成」をクリックします。
  5. サービスアカウントに名前を付けます(例:SkillMatrixWidget)。
  6. 以下のスコープを割り当ててください:
  7. table-queries:read
  8. tables:read
  9. tables:write
  10. users:read
  11. [作成] をクリックします。
  12. 「Auth Header」をコピーしますが、「Basic」という単語とその後のスペースは削除してください。
  13. ウィジェットの設定時:サービスアカウントについて**「変数**」と**「静的値」のどちらを選択するか尋ねられた場合は、「静的値**」を選択し、認証情報**(「Basic」を除く)**をフィールドに直接貼り付けてください。
Caution

Never share your Service Account credentials publicly.


1.2 Tulip アカウントの URL を確認する

アカウントの URL は通常、次のような形式になります。
your-account.tulip.co


1.3 タスクテーブル ID の確認

  1. Tulipの「テーブル」セクションに移動します。
  2. 該当するタスクテーブルをクリックします。
  3. 詳細セクションからテーブル UIDをコピーします。

1.4 フィールドIDの特定

以下のフィールドIDを確認してください:

  • ユーザー(例:名前またはユーザーID)
  • スキル/タスク名
  • スキルレベル

フィールドのIDを確認するには:

  1. テーブルを開きます。
  2. 列ヘッダーをクリックします。
  3. プロパティパネルでフィールドIDを確認します。
Tip

There are no enforced default names for these fields; you must decide which of your fields will be treated as user/skill/level when configuring the widget.


2. オプションパラメータの設定

以下のオプションパラメータを使用して、ウィジェットをさらにカスタマイズできます:

  • グループフィールド ID:チームや部署などごとにデータを整理します。
  • ステータス: ステータス(例: アクティブ、完了)でフィルタリングします。
  • レベルの色:スキルレベルごとに独自の色を割り当てます。

2.1 フィルター

オプションのフィルターを追加して、マトリックスに表示されるデータをカスタマイズできます。

フィルター 説明
タイトル デフォルトでは、[タイトル] フィルターは通常、グループ、スキル名、またはタスクカテゴリのフィールドを指します。
表示 レコードの表示/非表示を制御します。デフォルトはtrue です。

:::(情報) (注)
フィルターはオプションであり、使用目的に合わせて設定してください。

複数のfields に対してフィルターを設定でき、設定後は不要なフィルターを簡単に無効にできます。データに影響を与えるのは、アクティブなフィルターのみです。
:::


2.2 詳細設定

APIクエリフィルター

カスタムAPIフィルタークエリを使用して、表示されるレコードを制御できます。

Note

When you apply multiple filter conditions, they are combined using a logical AND. This means all conditions must be true for a record to be returned.

クエリの例:json{"field":"-fieldID1-", "arg":"-value-", "functionType":"greaterThanOrEqual"},{"field":"-fieldID2-", "arg":"-value-", "functionType":"lessThanOrEqual"}

**API 制限:**読み込まれる行数を制限します。

2.3. ワークスペース ID の設定

  • ワークスペース IDは、Tulip の URL の/w/ の後に記載されています。例:https://your-account.tulip.co/w/DEFAULT→ ワークスペース ID はDEFAULTです
  • デフォルトのワークスペースの場合は、「DEFAULT」を使用するか、フィールドを空白のままにしてください。

3. スキルマトリックスウィジェットの使用

3.1. スキルデータの表示

設定が完了すると、ウィジェットには以下のマトリックスが表示されます:

  • ユーザー
  • タスクまたはスキル
  • 対応するスキルレベル

組み込みのドロップダウンフィルター(グループ、スキル、レベル)を使用して、表示結果を絞り込むことができます。

3.2. 再読み込みとフィルタリング

  • [フィルタをクリア] をクリックして、すべてのフィルタ選択を解除します。
  • 「再読み込み」をクリックしてデータを更新します。

3.3. 事前フィルタリング

事前フィルタは、以下に基づいてデータを動的にフィルタリングします:

  • 現在ログインしているユーザー
  • 選択されたチームまたは部署
  • 日付範囲またはシフト
Tip

Use pre-filters to personalize views for operators or supervisors.

4. インタラクティブなアクション用のトリガーを追加する

ユーザーがセルをクリックした際にアクションが実行されるよう、ウィジェットを設定できます。

  1. 「トリガー」パネルを開きます。
  2. セルがクリックされた際の「レコード ID」に対するアクションを設定します。
  3. 「レコードを読み込む」を有効にして、ユーザーやスキルに関する詳細情報を表示します。

ヒント

  • 入力ミスを防ぐため、テーブル ID とフィールド IDを再確認してください。
  • フィルターを使用して、役割ごとにダッシュボードをカスタマイズしてください。
  • 本番環境に展開する前に、テストデータを使用してテストを行ってください。

トラブルシューティング

問題 考えられる原因 推奨される修正方法
Matrixが読み込まれない APIの認証情報またはURLが無効です 認証情報またはURLを再確認してください
データが表示されない フィルタの設定が厳しすぎる フィルタを削除するか、条件を緩和してください
「未定義」のフィールド 誤ったフィールドIDが使用されています テーブルのフィールドIDを確認してください
セルがクリックできない トリガーが設定されていない ウィジェットでトリガーを設定してください

関連情報:

Tulip Tableのレコード一覧TulipAPIの設定方法