校驗(轉換)器說明

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