--- title: "スキルマトリックス" slug: "skill-matrix" updated: 2026-10-22T17:13:40Z published: 2026-10-22T17:13:40Z canonical: "support.tulip.co/skill-matrix" --- > ## Documentation Index > Fetch the complete documentation index at: https://support.tulip.co/llms.txt > Use this file to discover all available pages before exploring further. # スキルマトリックス :::(Info)To download, visit: [Library](https://library.tulip.co/apps/skill-matrix). ::: ## 「スキルマトリックスウィジェット」とは何ですか? 「**スキルマトリックスウィジェット**」を使用すると、マトリックス形式の表でユーザーのスキルやタスクの習熟度を可視化、フィルタリング、管理することができます。 ![Screenshot 2025-08-08 at 17.32.49.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Screenshot%202025-08-08%20at%2017.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](https://support.tulip.co/apidocs/list-records-of-a-tulip-table)[のレコード一覧Tulip](https://support.tulip.co/apidocs/list-records-of-a-tulip-table)[APIの設定方法](https://support.tulip.co/docs/set-up-a-tulip-api)