KVS Factor 清單指南
介紹如何瀏覽專案中記錄的 KVS（鍵值儲存）factor 項目，並直接跳轉到各 factor 的歷史紀錄或最新值。
📋 概述
KVS Factor 清單頁面讓您在單一畫面上瀏覽所選專案（CSN）中記錄的 factor 項目。您可以檢視代理收集的各類 factor——指標、清單、行程列表等——並直接跳轉到各項目的歷史紀錄頁面或最新值頁面。存取此頁面需要登入。
🔍 畫面構成
1. 專案選擇（CSN）
在頂部的下拉選單中選擇要查詢的專案。清單會自動填入目前登入帳號可存取的專案，若工作階段中已儲存某個專案，則預設選取該專案。
2. 執行（Run）
點擊 [Run] 按鈕會針對所選專案執行指令 KVSFactorList * <csn>。* 表示不限定特定 kType，而是查詢所有類型的 factor。載入期間按鈕會顯示為 Loading... 狀態。
3. 結果清單
結果以表格（桌面端）或卡片（行動端）形式顯示，通常包含 kType（鍵類型）、kKey（伺服器 LSSN 或資料庫 ID）、kFactor（資料分類名）等欄位。若資料無法解析為表格，則按原樣顯示原始回應文字。
4. 列跳轉按鈕
factor 欄位會在值旁邊顯示兩個跳轉按鈕。
- [List]：將該列的 kType、kKey、kFactor 儲存到工作階段，然後跳轉到 **KVS 清單頁面（
/zh-TW/kvslist）**檢視歷史紀錄清單。 - [Last]：將 kType、kKey、kFactor 作為查詢參數傳遞，跳轉到 最新值頁面（
/zh-TW/kvslast）。
🛠️ 使用技巧
- 變更專案後，所選值會儲存到工作階段，因此在其他 KVS 頁面中也會保持。
- 對於缺少 kType/kKey 資訊的舊資料，系統在處理跳轉時會將
lssn視為預設類型。
💡 注意事項
- 如果結果為空，可能是所選專案尚無已記錄的 factor，或專案指定有誤。
- 本頁面僅供查詢。關於 factor 資料的記錄（KVSPut），請參閱下方的 API 參考。
API 參考
有關此功能背後的 KVS API 詳細規格，請參閱專門指南。
疑難排解
| 症狀 | 原因 | 解決方法 |
|---|---|---|
| 被跳轉回登入畫面 | 工作階段已逾期或未驗證 | 重新登入後再開啟頁面。 |
| 專案下拉選單為空 | 未擷取到可存取的專案 | 檢查登入狀態與帳號權限，然後重新整理頁面。 |
結果顯示 No results. | 所選專案沒有已記錄的 factor | 確認是否選對專案，並先以 KVSPut 記錄資料。 |
| 結果顯示原始文字而非表格 | 回應無法解析為表格 | 檢查回應內容，確認資料格式是否正確。 |
| [List]/[Last] 跳轉後資料為空 | 舊資料缺少 kType/kKey，按預設值處理 | 重新記錄目標 factor 或確認 kKey 值。 |
版本: 1.0
最後更新: 2026-07-22
原始檔: giipv3/public/help/kvsfactorlist.zh-TW.md