DB51T 2848-2021 四川省公共數(shù)據(jù)開(kāi)放技術(shù)規(guī)范

DB51四川省市場(chǎng)監(jiān)督管理局發(fā)布I II II1四川省公共數(shù)據(jù)開(kāi)放技術(shù)規(guī)范3.13.23.3注：元數(shù)據(jù)元素在元數(shù)據(jù)實(shí)體中是唯一的。3.4注：可以包含一個(gè)或一個(gè)以上元數(shù)據(jù)實(shí)體。24.1總則文名稱、數(shù)據(jù)類(lèi)型、值域、縮寫(xiě)名、約束/條件、最大出現(xiàn)次數(shù)、取值示例。4.3定義4.4英文名稱大寫(xiě)，詞匯其他字母均為小寫(xiě)。元數(shù)據(jù)實(shí)體的每個(gè)詞匯首字母大寫(xiě)，詞匯其他字母均4.5數(shù)據(jù)類(lèi)型4.6值域4.7縮寫(xiě)名元數(shù)據(jù)實(shí)體或元數(shù)據(jù)元素的英文縮寫(xiě)名稱，縮寫(xiě)d)元數(shù)據(jù)實(shí)體或元數(shù)據(jù)元素由英文名稱或其他自定義的標(biāo)識(shí)符組成時(shí)，默認(rèn)取每個(gè)單詞前三位字母作為其縮寫(xiě)名標(biāo)識(shí)。若此取詞方式不能保證縮寫(xiě)名唯一性時(shí)，則增加獲取單詞后一位字e)元數(shù)據(jù)元素縮寫(xiě)名拼寫(xiě)規(guī)則：所有組成縮寫(xiě)詞匯為無(wú)縫連寫(xiě)，首縮寫(xiě)詞匯均為小寫(xiě)字母，其f)元數(shù)據(jù)實(shí)體縮寫(xiě)名拼寫(xiě)規(guī)則：所有組成縮寫(xiě)詞匯為無(wú)縫連寫(xiě)，每個(gè)縮寫(xiě)詞匯的首字母大寫(xiě)，4.8約束/條件元數(shù)據(jù)實(shí)體或元數(shù)據(jù)元素是否選取的說(shuō)明描述符。描含必選元素，但是，如果一個(gè)可選實(shí)體未被選用，則該實(shí)體所包含的元素（包括必選元素）34.9最大出現(xiàn)次數(shù)5.1概述開(kāi)放屬性、更新周期、更新時(shí)間、領(lǐng)域名稱、行業(yè)名稱、資源類(lèi)——版本號(hào)（5.2.4）——數(shù)據(jù)項(xiàng)（5.2.10）4resourceTitleresourceTitle提供單位名稱提供單位代碼提供單位地址提供單位名稱提供單位代碼提供單位地址提供單位聯(lián)系人提供單位聯(lián)系電話資源代碼abstractcontact資源摘要contactversion版本號(hào)資源提供單位信息openAttribute開(kāi)放屬性版權(quán)所屬機(jī)構(gòu)代碼版權(quán)所屬機(jī)構(gòu)的名稱版權(quán)所屬機(jī)構(gòu)代碼版權(quán)所屬機(jī)構(gòu)的名稱tdtaCopyright元數(shù)據(jù)copyrightNotice版權(quán)信息元數(shù)據(jù)copyrightNotice版權(quán)聲明更新時(shí)間版權(quán)聲明DataUnit數(shù)據(jù)項(xiàng)標(biāo)識(shí)數(shù)據(jù)項(xiàng)名稱數(shù)據(jù)項(xiàng)標(biāo)識(shí)數(shù)據(jù)項(xiàng)名稱領(lǐng)域名稱數(shù)據(jù)類(lèi)型行業(yè)名稱資源類(lèi)型definition行業(yè)名稱資源類(lèi)型definition資源格式類(lèi)型備注資源格式類(lèi)型資源格式最大長(zhǎng)度資源格式數(shù)據(jù)標(biāo)簽數(shù)據(jù)項(xiàng)擴(kuò)展屬性數(shù)據(jù)標(biāo)簽數(shù)據(jù)項(xiàng)擴(kuò)展屬性scaleExtendAttribute精度ExtendAttribute屬性名稱必選元數(shù)據(jù)可選元數(shù)據(jù)屬性名稱必選元數(shù)據(jù)可選元數(shù)據(jù)attributeValue屬性值55.2元數(shù)據(jù)描述5.2.1資源名稱英文名稱：resourceTitle縮寫(xiě)名：resTit5.2.2資源代碼5.2.3資源摘要英文名稱：abstract取值示例：四川省生態(tài)旅游示范區(qū)5.2.4版本號(hào)英文名稱：version取值示例：0.05.2.5資源提供單位信息6提供單位名稱提供單位代碼定義：提供公共數(shù)據(jù)政務(wù)部門(mén)的統(tǒng)一社會(huì)信用代碼提供單位地址提供單位聯(lián)系人7提供單位聯(lián)系電話5.2.6開(kāi)放屬性5.2.7更新周期5.2.8更新時(shí)間85.2.9版權(quán)信息版權(quán)所屬機(jī)構(gòu)名稱版權(quán)所屬機(jī)構(gòu)代碼版權(quán)聲明5.2.10數(shù)據(jù)項(xiàng)9數(shù)據(jù)項(xiàng)標(biāo)識(shí)數(shù)據(jù)項(xiàng)名稱數(shù)據(jù)類(lèi)型數(shù)據(jù)項(xiàng)定義英文名稱：definition備注最大長(zhǎng)度最小長(zhǎng)度精度5.2.11領(lǐng)域名稱5.2.12行業(yè)名稱5.2.13資源類(lèi)型5.2.14資源格式類(lèi)型值域：見(jiàn)表E.15.2.15資源格式值域：見(jiàn)表E.25.2.16數(shù)據(jù)標(biāo)簽5.2.17數(shù)據(jù)項(xiàng)擴(kuò)展屬性縮寫(xiě)名：ExtAtt屬性名稱屬性值英文名稱：attributeValue5.3元數(shù)據(jù)的擴(kuò)展5.3.1概述5.3.2擴(kuò)展原則a)新建的元數(shù)據(jù)不應(yīng)與本規(guī)范定義的元數(shù)據(jù)中現(xiàn)有的元數(shù)據(jù)實(shí)體b)增加的元數(shù)據(jù)元素應(yīng)按照本規(guī)范所確定的層次關(guān)系進(jìn)行合理的組織。如果本規(guī)范現(xiàn)有的元數(shù)據(jù)實(shí)體無(wú)法滿足新增元數(shù)據(jù)的需要，則可以新建元數(shù)c)擴(kuò)展的元數(shù)據(jù)元素可組成新的基本數(shù)據(jù)類(lèi)型，但不能成為核心元）；）；f)可對(duì)元數(shù)據(jù)元素的約束/條件和最大出現(xiàn)次數(shù)施以更嚴(yán)格的限制（例如，在本規(guī)范中定義為可選的元數(shù)據(jù)，在擴(kuò)展后可以是必選的；在本規(guī)范中定義為無(wú)限次重復(fù)出現(xiàn)的元數(shù)據(jù)，在擴(kuò)展5.3.3擴(kuò)展要求a)元數(shù)據(jù)擴(kuò)展時(shí)，既要考慮公共數(shù)據(jù)在應(yīng)用中的特點(diǎn)以及工作的復(fù)雜、難易程度，又要充分滿b)選取的元數(shù)據(jù)不但要滿足當(dāng)前階段的應(yīng)用需求，更應(yīng)該考慮將來(lái)一定時(shí)間內(nèi)可能產(chǎn)生的標(biāo)準(zhǔn)化需求。擴(kuò)展過(guò)程中，要積極參考國(guó)內(nèi)和國(guó)c)擴(kuò)展的元數(shù)據(jù)實(shí)體或元素，應(yīng)按本規(guī)范定義中文名稱、定義、英文名稱、數(shù)據(jù)類(lèi)型、值域、縮寫(xiě)名、約束/條件、最大出現(xiàn)次數(shù)，并宜給出適當(dāng)?shù)睦?。公共?shù)據(jù)所有者對(duì)公共數(shù)據(jù)的版權(quán)進(jìn)行聲明，并聲明相關(guān)的使用a)無(wú)條件開(kāi)放（公共數(shù)據(jù)經(jīng)評(píng)估后可直接開(kāi)放，無(wú)附加條件，公眾）；b)有條件開(kāi)放（公共數(shù)據(jù)經(jīng)評(píng)估后不可直接開(kāi)放，有附加條件，公眾要獲得授權(quán)需登記用戶基）；c)更新方式：須明確數(shù)據(jù)更新方式是增量更新還是全a)數(shù)據(jù)完整性是指數(shù)據(jù)的精確性和可靠性。它是應(yīng)防止數(shù)據(jù)庫(kù)中存在不符合語(yǔ)義規(guī)定的數(shù)據(jù)和防止因錯(cuò)誤信息的輸入輸出造成無(wú)效操作或錯(cuò)誤信息而提出的。數(shù)據(jù)完整性分為四類(lèi)：實(shí)體完整性、域完整性、參照完整性、用戶自定義完整性。例如數(shù)據(jù)信息是否存在缺失的狀況，數(shù)據(jù)缺失的情況可能是整個(gè)數(shù)據(jù)記錄缺失，也可能是數(shù)據(jù)中某個(gè)字段信息的b)數(shù)據(jù)一致性通常指關(guān)聯(lián)數(shù)據(jù)之間的邏輯關(guān)系是否正確和完整。公共數(shù)據(jù)所有者的源頭數(shù)據(jù)和開(kāi)放的公共數(shù)據(jù)之間的數(shù)據(jù)保持狀態(tài)以及值域、格式c)準(zhǔn)確性也叫準(zhǔn)確度，是指公共數(shù)據(jù)在進(jìn)行整理、清洗、脫敏、格式轉(zhuǎn)換后數(shù)據(jù)庫(kù)記錄的信息是否存在異?；蝈e(cuò)誤，如字符亂碼，數(shù)值異常的大或者小，與現(xiàn)實(shí)10.2.1通訊協(xié)議10.2.2消息頭屬性名稱約束類(lèi)型最大長(zhǎng)度取值說(shuō)明必選string請(qǐng)求者身份標(biāo)識(shí)必選string服務(wù)調(diào)用時(shí)間必選string簽名信息必選string操作隨機(jī)碼防止重放攻擊10.2.3消息體10.2.4返回內(nèi)容父元素元素名稱約束類(lèi)型最大長(zhǎng)度取值說(shuō)明--必選string返回消息的狀態(tài)碼--必選string返回消息結(jié)果描述--必選----返回消息體注：接口返回內(nèi)容說(shuō)明見(jiàn)附錄F10.3.1元數(shù)據(jù)注冊(cè)接口URL樣式：http://IP/opendata_api/catalog/register內(nèi)容類(lèi)型：application/json名稱是否必須類(lèi)型最大長(zhǎng)度描述是string公共數(shù)據(jù)資源的唯一標(biāo)識(shí)否string標(biāo)簽resourceTitle是string公共數(shù)據(jù)資源內(nèi)容的標(biāo)題是string數(shù)據(jù)項(xiàng)取值的類(lèi)型definition是string信息項(xiàng)描述是string數(shù)據(jù)項(xiàng)名稱否string信息項(xiàng)的英文名稱是int是否為空，0-可以為空；1-不可為空abstract是string描述公共數(shù)據(jù)的摘要內(nèi)容否string數(shù)據(jù)項(xiàng)取值的最大長(zhǎng)度是string領(lǐng)域id（多種時(shí)以英文逗號(hào)分隔）是string領(lǐng)域名稱（多種時(shí)以英文逗號(hào)分隔）名稱是否必須類(lèi)型最大長(zhǎng)度描述industryId否string行業(yè)id（多種時(shí)以英文逗號(hào)分隔）否string行業(yè)名稱（多種時(shí)以英文逗號(hào)分隔）joinType否string掛接資源的類(lèi)型，多種時(shí)以逗號(hào)分隔，1-庫(kù)表2-文件3-API4-鏈接openAttribute是string公共數(shù)據(jù)對(duì)社會(huì)公開(kāi)的方式，1-有條件開(kāi)放；2-無(wú)條件開(kāi)放否string開(kāi)放條件，開(kāi)放類(lèi)型為有條件開(kāi)放時(shí)填寫(xiě)是string數(shù)據(jù)提供單位的統(tǒng)一社會(huì)信用代碼是string數(shù)據(jù)提供單位的名稱是string行政區(qū)劃碼是string資源格式說(shuō)明是string資源格式類(lèi)型說(shuō)明是string公共數(shù)據(jù)更新頻率的說(shuō)明注1：注冊(cè)元數(shù)據(jù)接口提交參數(shù)示例見(jiàn)附錄G.1注2：元數(shù)據(jù)注冊(cè)接口提交的參數(shù)不分先后順序10.3.2元數(shù)據(jù)變更接口URL樣式：http://IP/opendata_api/catalog/register內(nèi)容類(lèi)型：application/json名稱是否必須類(lèi)型最大長(zhǎng)度描述是string公共數(shù)據(jù)資源的唯一標(biāo)識(shí)否string標(biāo)簽resourceTitle是string公共數(shù)據(jù)資源內(nèi)容的標(biāo)題是string數(shù)據(jù)項(xiàng)取值的類(lèi)型definition是string信息項(xiàng)描述是string數(shù)據(jù)項(xiàng)名稱否string信息項(xiàng)的英文名稱是int是否為空，0-可以為空；1-不可為空abstract是string描述公共數(shù)據(jù)的摘要內(nèi)容否string數(shù)據(jù)項(xiàng)取值的最大長(zhǎng)度名稱是否必須類(lèi)型最大長(zhǎng)度描述是string領(lǐng)域id（多種時(shí)以英文逗號(hào)分隔）是string領(lǐng)域名稱（多種時(shí)以英文逗號(hào)分隔）industryId否string行業(yè)id（多種時(shí)以英文逗號(hào)分隔）否string行業(yè)名稱（多種時(shí)以英文逗號(hào)分隔）joinType否string掛接資源的類(lèi)型，多種時(shí)以逗號(hào)分隔，1-庫(kù)表2-文件3-API4-鏈接openAttribute是string公共數(shù)據(jù)對(duì)社會(huì)公開(kāi)的方式，1-有條件開(kāi)放；2-無(wú)條件開(kāi)放否string開(kāi)放條件，開(kāi)放類(lèi)型為有條件開(kāi)放時(shí)填寫(xiě)是string數(shù)據(jù)提供單位的統(tǒng)一社會(huì)信用代碼是string數(shù)據(jù)提供單位的名稱是string行政區(qū)劃碼是string資源格式說(shuō)明是string資源格式類(lèi)型說(shuō)明是string公共數(shù)據(jù)更新頻率的說(shuō)明注1：變更元數(shù)據(jù)接口提交參數(shù)示例見(jiàn)附錄G.2注2：元數(shù)據(jù)變更接口提交的參數(shù)不分先后順序10.3.3元數(shù)據(jù)撤銷(xiāo)接口內(nèi)容類(lèi)型：application/json名稱是否必須類(lèi)型最大長(zhǎng)度描述是string公共數(shù)據(jù)資源的唯一標(biāo)識(shí)注：撤銷(xiāo)元數(shù)據(jù)接口提交參數(shù)示例見(jiàn)附錄G.3編碼更新周期1實(shí)時(shí)2每日3每周4每月5每季度6每半年7每年8不定期9其他編碼數(shù)據(jù)類(lèi)型1字符型C2數(shù)值型N3貨幣型Y45日期時(shí)間型T6邏輯型L7備注型M8通用型G9雙精度型B整型I浮點(diǎn)型F二進(jìn)制blob長(zhǎng)文本text編碼數(shù)據(jù)領(lǐng)域信用服務(wù)醫(yī)療衛(wèi)生社保就業(yè)公共安全城建住房交通運(yùn)輸教育文化科技創(chuàng)新資源能源生態(tài)環(huán)境工業(yè)農(nóng)業(yè)商貿(mào)流通財(cái)稅金融安全生產(chǎn)市場(chǎng)監(jiān)管社會(huì)救助法律服務(wù)生活服務(wù)氣象服務(wù)地理空間機(jī)構(gòu)團(tuán)體其他注：采用《公共信息資源開(kāi)放試點(diǎn)工作方案》（中網(wǎng)辦發(fā)文〔2017〕24號(hào)）數(shù)據(jù)領(lǐng)域編碼行業(yè)ind-1農(nóng)、林、牧、漁業(yè)ind-2采礦業(yè)ind-3制造業(yè)ind-4電力、熱力、燃?xì)饧八a(chǎn)和供應(yīng)業(yè)ind-5建筑業(yè)ind-6批發(fā)和零售業(yè)ind-7交通運(yùn)輸、倉(cāng)儲(chǔ)和郵政業(yè)ind-8住宿和餐飲業(yè)ind-9信息傳輸、軟件和信息技術(shù)服務(wù)業(yè)金融業(yè)房地產(chǎn)業(yè)租賃和商務(wù)服務(wù)業(yè)科學(xué)研究和技術(shù)服務(wù)業(yè)水利、環(huán)境和公共設(shè)施管理業(yè)居民服務(wù)、修理和其他服務(wù)業(yè)教育衛(wèi)生和社會(huì)工作文化、體育和娛樂(lè)業(yè)公共管理、社會(huì)保障和社會(huì)組織表E.1資源格式分類(lèi)編碼資源格式分類(lèi)電子文件電子表格數(shù)據(jù)庫(kù)圖形圖像流媒體自描述格式資源格式見(jiàn)