值清單 (LoV) 或枚舉在整個系統中使用。 LoV 用於根據關聯的對應資料類型來驗證傳入資料。 另請參閱 預設值清單 以取得預設類型和值的完整清單。
我們允許擴展和管理特定數據類型的能力。
- 學術科目
- 人口統計:種族
- 人口統計:種族
- 年級
- 組織類型
- 人員旗標
LoV (ENUMS) 的比對和驗證處理
在數據處理期間,學校數據同步 (SDS) 會驗證數據,將良好的數據帶入數據湖,並標示不正確的數據。
為了確定資料的健康情況,資料會透過資料比對和驗證規則傳遞。 這些規則旨在幫助保護僅進入數據湖的良好必要和選擇性數據。 未通過驗證的資料會識別為錯誤或警告,而且不會傳送至資料湖。
對於預設和客戶定義的 LoV,會使用下列比對和驗證處理。 如需詳細資訊,請參閱 為 LoV 傳遞不正確的程式碼值時的資料 健康情況和監視 。
| 配對 | 驗證 | 儲存的值 |
|---|---|---|
| 不區分大小寫 | 比對小寫 | 作為 LoV 代碼值 |
重要事項
年級 LoV 的傳入值缺少前導零 '0',例如 '1',將符合定義的值 '01' 清單,並將儲存為 '01'。
新增客戶定義的 LoV
警告
參考代碼值必須是唯一的。 例如,您無法建立另一個組織參照碼值 'School' 或 'school'。 顯示名稱不能超過 255 個字元。
- 導航至“設置” |“值列表”。
- 選取 新增至值清單 選項。 你看到一個飛出窗口。
- 選取下拉式清單,以取得適用於 「值清單」類型的可管理選項。 從顯示的選項中選擇適當的類型。
- 輸入對應於您要傳送的傳入資料的 值參考代碼 的代碼/文字。 新增值後,無法編輯該值。
- 輸入參考碼值的 顯示名稱 文字。 文字可用來在 SDS UI 中顯示易記字串。 添加值後可以編輯該值。
- 選取 新增。 系統會顯示進度訊息,並關閉飛出視窗。
- 新增 LoV 時,會顯示確認訊息。 您可以導覽至 「值清單」類型 ,以查看新的 LoV。 「 建立者」 欄會顯示「客戶」, 而「狀態」 欄會顯示「已啟用」。
編輯客戶定義的 LoV
注意事項
您可以編輯顯示名稱,但不能編輯 LoV 參考代碼值或類型。
- 導航至“設置” |“值列表”。
- 展開您要編輯之 LoV 的 [值清單] 類型 。
- 從顯示的清單中選擇您要編輯的 LoV 的相應行。 你看到一個飛出窗口。
- 輸入更新的顯示名稱文字,然後選取更新。 系統會顯示進度訊息,並關閉飛出視窗。
- 更新 LoV 時,會顯示確認訊息。
停用客戶定義的 LoV
重要事項
您可以停用但不能刪除客戶定義的 LoV。 這是因為歷程資料可能與先前資料執行的程式碼值相關聯。 停用可保持資料的完整性,但可讓您不再允許未來上傳的資料記錄根據傳遞的參考代碼值與 LoV 相關聯。
- 導航至“設置” |“值列表”。
- 展開您要停用之 LoV 的 [值清單] 類型 。
- 從顯示的清單中選取您要停用的 LoV 的對應列。 你看到一個飛出窗口。
- 將狀態切換更新為「已停用」,然後選取更新。 系統會顯示進度訊息,並關閉飛出視窗。
- 更新 LoV 時,會顯示確認訊息。
啟用客戶定義的 LoV
重要事項
與先前資料執行的程式碼值繫結的歷史資料仍會保留。 啟用將允許未來上傳的資料記錄根據傳遞的參考代碼值與 LoV 相關聯。
- 導航至“設置” |“值列表”。
- 展開您要啟用之 LoV 的 [值清單] 類型 。
- 從顯示的清單中選取您要啟用的 LoV 的對應列。 你看到一個飛出窗口。
- 將狀態切換更新為「已啟用」,然後選取更新。 系統會顯示進度訊息,並關閉飛出視窗。
- 更新 LoV 時,會顯示確認訊息。