校驗（轉換）器說明#

CKAN 具有校驗器（validator）機制，用以檢查欄位是否符合規定，故亦可視為值域。另有轉換器（converter），用以轉換欄位值俾符合規定。

內建校驗（轉換）器#

ckanext.data_depositario.converters.remove_blank_wrap(value, context)#: Remove blank and text wrap in the value.

ckanext.data_depositario.converters.value_string_convert(key, data, errors, context)#: Takes a list of values that is a comma-separated string (in data[key]) and parses values. These are added to the data dict, enumerated. Borrowed from tag_string_convert in CKAN core.

if_empty_same_as(name): 若空值則參照「網址」欄位
unicode: 必須是 unicode 字元
not_empty: 不能為空值
package_name_validator: 不得重複、長度需介於 2 至 100 字元（包含 2 與 100）
scheming_required: 若欄位為必填則不能為空值（套用 not_empty），反之則接受空值（套用 ignore_missing）
scheming_choices: 必須是空值或給定候選項之一
ignore_missing: 若欄位為空值，接受該空值並忽略位於其後之所有校驗器（若欄位非空值，則其後之所有校驗器仍有效）
tag_string_convert: 標籤長度須介於 1 至 100 字元（包含 1 與 100）、標籤須為 unicode 文數字或「-」、「_」與「.」符號
ignore_empty: 接受空值
wikidata_keyword: （經 API 上傳資料集時）只接受以 Python list 格式（如 ["Q1", "Q2"] ）或字串形式（如 "Q1, Q2" ）呈現之資料
scheming_multiple_choice: （經 API 上傳資料集時）只接受以 Python list 格式（如 ["Q1", "Q2"] ）或字串形式（如 "Q1, Q2" ）呈現之資料。資料值需為給定候選項中之一至多個
is_positive_integer: 必須是正整數
owner_org_validator: 必須為無指定專案或指定一個已存在之專案
email_validator: 必須符合電子郵件格式
remove_whitespace: 去除文字首尾空白
if_empty_guess_format: 若欄位為空值，嘗試猜測檔案格式
clean_format: 將檔案格式轉為小寫

備註

選填欄位基本校驗器：ignore_missing unicode

必填欄位基本校驗器：not_empty unicode

名稱	校驗（轉換）器
標題	if_empty_same_as(name) unicode
網址	not_empty unicode package_name_validator
摘要	選填欄位基本校驗器
資料類型	scheming_required scheming_multiple_choice
Wikidata 關鍵字	wikidata_keyword
標籤	ignore_missing tag_string_convert
語言	value_string_convert scheming_multiple_choice
備註	選填欄位基本校驗器

名稱	校驗（轉換）器
時間解析度	scheming_required scheming_choices
起始時間	ignore_empty
結束時間	ignore_empty end_time_validator
空間範圍	ignore_empty json_validator remove_blank_wrap
空間範圍.X.min	ignore_empty long_validator
空間範圍.X.max	ignore_empty long_validator
空間範圍.Y.min	ignore_empty lat_validator
空間範圍.Y.max	ignore_empty lat_validator
空間解析度	ignore_empty positive_float_validator

名稱	校驗（轉換）器
授權	必填欄位基本校驗器
產製者	必填欄位基本校驗器
資料產製時間	ignore_empty date_validator
資料處理歷程	選填欄位基本校驗器
專案	owner_org_validator unicode
聯絡人	選填欄位基本校驗器
聯絡人的電子郵件	ignore_missing unicode email_validator

名稱	校驗（轉換）器
網址	ignore_missing unicode remove_whitespace
名稱	選填欄位基本校驗器
摘要	選填欄位基本校驗器
字元編碼	scheming_required scheming_choices
座標參考系統	ignore_empty is_positive_integer
格式	if_empty_guess_format ignore_missing clean_format unicode