【文章內(nèi)容簡(jiǎn)介】 接口方案中規(guī)定的校驗(yàn)規(guī)則和異常處理規(guī)則，保證提供數(shù)據(jù)的質(zhì)量。 數(shù)據(jù)接收方的責(zé)任? 負(fù)責(zé)與源數(shù)據(jù)提供方的信息交互和溝通。? 負(fù)責(zé)對(duì)源數(shù)據(jù)提供方提供的接口數(shù)據(jù)文件、接口校驗(yàn)文件進(jìn)行即時(shí)的讀取、接收、核對(duì)及傳輸。 接口文件命名規(guī)則 中央業(yè)務(wù)平臺(tái)列表? 飛信平臺(tái)5 / 29 接口單元編碼規(guī)則對(duì)中央業(yè)務(wù)平臺(tái)的各接口單元的編碼采用平臺(tái)代碼與序列號(hào)組成，其中平臺(tái)代碼為三位數(shù)字，序列號(hào)為兩位數(shù)值，各接口單元的編碼規(guī)則是：平臺(tái)代碼序列號(hào) 。平臺(tái)代碼編碼表：系統(tǒng)名稱(chēng) 平臺(tái)代碼飛信業(yè)務(wù)平臺(tái) 400 文件分類(lèi)及命名規(guī)則文件類(lèi)型 文件名格式 備注接口數(shù)據(jù)文件 正常數(shù)據(jù)：增量/全量/新增數(shù)據(jù)標(biāo)志_省份編碼_數(shù)據(jù)日期_接口如正常數(shù)據(jù)為：增量_省份編碼_數(shù)據(jù)日期_接口單元編接口校驗(yàn)文件 正常數(shù)據(jù)：增量/全量/新增數(shù)據(jù)標(biāo)志_省份編碼_數(shù)據(jù)日期_接口對(duì)同一個(gè)抽取周期同一個(gè)接口單元產(chǎn)生的接口數(shù)據(jù)，如果有文件拆分的，需要將這些文件的校驗(yàn)信息寫(xiě)在同一個(gè)接口校驗(yàn)文件內(nèi)，所以文件名不需要序列號(hào)文件級(jí)校驗(yàn)報(bào)告單個(gè)報(bào)告文件命名：正常數(shù)據(jù)：f_增量/全量/新增數(shù)據(jù)標(biāo)志_省份編碼_數(shù)據(jù)日期_接口單元編碼_重傳序號(hào)_序列號(hào).verf每一個(gè)數(shù)據(jù)文件，對(duì)應(yīng)一個(gè)文件級(jí)校驗(yàn)報(bào)告省份編碼參見(jiàn)：附錄一6 / 29 文件命名說(shuō)明? 文件名稱(chēng)中的要素取值? 增量/全量標(biāo)志取值為：增量：“a”，全量：“i” ，新增數(shù)據(jù)：“s”；? 省份編碼具體編碼請(qǐng)參見(jiàn)附錄一。? 接口單元編碼接口單元編碼是每一個(gè)接口單元的唯一標(biāo)識(shí)，各接口單元的編碼請(qǐng)參見(jiàn)下文。? 數(shù)據(jù)日期數(shù)據(jù)日期是描述當(dāng)前抽取周期中，數(shù)據(jù)的發(fā)生日期（如：20221201，則表示抽取的數(shù)據(jù)是 2022 年 12 月 1 日的快照）。按日抽取的數(shù)據(jù)文件，其數(shù)據(jù)日期就是數(shù)據(jù)的發(fā)生日期；按月抽取的數(shù)據(jù)文件，則數(shù)據(jù)日期取數(shù)據(jù)發(fā)生的年月（對(duì)數(shù)據(jù)日期有特殊要求的接口單元，將在其“數(shù)據(jù)要求”中詳細(xì)描述）。? 系統(tǒng)日期系統(tǒng)日期是描述程序處理的日期。例如：記錄日志文件時(shí)，操作日志文件的日期即為當(dāng)時(shí)取得的操作系統(tǒng)時(shí)間。? 重傳序號(hào)重傳序號(hào)必須是二位數(shù)字型字符。重傳序號(hào)是用于描述同一個(gè)接口單元的同一數(shù)據(jù)日期內(nèi)，由于數(shù)據(jù)異常、校驗(yàn)重傳等原因，需要重新生成、上傳數(shù)據(jù)時(shí)，則需要通過(guò)重傳序號(hào)來(lái)描述當(dāng)前接口文件的重傳順序號(hào)：00：表示該數(shù)據(jù)日期的接口文件是首次正常生成數(shù)據(jù)上傳（非重傳）01：表示該數(shù)據(jù)日期的接口文件是第一次重傳02：表示該數(shù)據(jù)日期的接口文件是第二次重傳…N+1: 表示該數(shù)據(jù)日期的接口文件是第 N+1 次重傳7 / 29? 序列號(hào)序列號(hào)必須是三位數(shù)字型字符。序列號(hào)是用于描述同一個(gè)接口單元在同一個(gè)抽取周期中的文件順序號(hào)，若一個(gè)接口單元被分割成多個(gè)文件或每日多次抽取同一個(gè)接口單元，則其流水號(hào)必須不同，并且依次遞增，如： 0000003；? 接口數(shù)據(jù)文件、接口校驗(yàn)文件、接口文件校驗(yàn)報(bào)告等所有文件在文件生成過(guò)程中，后綴為 .tmp ，待生成文件成功后，再改成 .dat 等后綴名；此措施用于防止文件生成過(guò)程中發(fā)生異常。? 所有的文件名稱(chēng)中用到的字母均需小寫(xiě)。 接口文件設(shè)計(jì) 設(shè)計(jì)原則在滿足要求的前提下，為了使應(yīng)用接口盡量簡(jiǎn)單、明了，并便于實(shí)現(xiàn)，一級(jí)經(jīng)營(yíng)分析系統(tǒng)下發(fā)的中央業(yè)務(wù)平臺(tái)的數(shù)據(jù)采用文本文件方式，文件格式采用ASCII 碼格式。為了保證接口數(shù)據(jù)的一致性，避免各類(lèi)數(shù)據(jù)類(lèi)型和格式錯(cuò)誤，在形成所傳輸?shù)?ASCII 格式文件之前，將數(shù)據(jù)轉(zhuǎn)成本接口方案所規(guī)定的數(shù)據(jù)類(lèi)型和格式。接口文件均按本方案要求的數(shù)據(jù)內(nèi)容、數(shù)據(jù)類(lèi)型長(zhǎng)度及順序采用定長(zhǎng)方式記錄數(shù)據(jù)，每行數(shù)據(jù)以回車(chē)換行符 0x0D0A 結(jié)束（抽取的數(shù)據(jù)內(nèi)容中不能包含此符號(hào)） 。如果數(shù)據(jù)的實(shí)際字節(jié)長(zhǎng)度小于方案中要求的字段長(zhǎng)度，則必須用空格補(bǔ)齊（右補(bǔ)齊） ，如果數(shù)據(jù)的實(shí)際長(zhǎng)度大于方案中的要求，則需要截?cái)啵ㄈ缱址枋觯?。接口數(shù)據(jù)文件均按此描述及順序，以定長(zhǎng)方式記錄數(shù)據(jù)，并以 0x0D0A(回車(chē)換行符) 為每行的結(jié)束標(biāo)志，因此，數(shù)據(jù)內(nèi)容中不能包含 0x0D0A(回車(chē)換行符)。8 / 29 接口文件格式接口數(shù)據(jù)文件的格式請(qǐng)參見(jiàn)下文中對(duì)各接口單元的具體描述。接口校驗(yàn)文件是由源數(shù)據(jù)提供方負(fù)責(zé)，用于描述每一個(gè)傳輸周期內(nèi)，提供的接口文件的文件列表及數(shù)據(jù)校驗(yàn)信息，數(shù)據(jù)采用定長(zhǎng)方式，校驗(yàn)文件中的信息由以下內(nèi)容組成：順序信息內(nèi)容數(shù)據(jù)類(lèi)型及長(zhǎng)度說(shuō)明1 接口數(shù)據(jù)文件名稱(chēng) char(40)2 文件的大?。ㄗ止?jié)數(shù)）number(20) 文件的物理存儲(chǔ)大小3 文件中包含的記錄數(shù) number(20) 文件中包含的記錄數(shù)4 數(shù)據(jù)日期 char(8) 日期格式：YYYYMMDD，如果抽取周期為月，則格式為：YYYMM，后兩位補(bǔ)空格；5 文件的生成時(shí)間 char(14) 日期格式：YYYYMMDDHH24MMSS6 0x0D0A 回車(chē)換行符 數(shù)據(jù)質(zhì)量保障 數(shù)據(jù)轉(zhuǎn)換規(guī)則源數(shù)據(jù)提供方在生成接口數(shù)據(jù)文件時(shí)，必須遵守如下數(shù)據(jù)轉(zhuǎn)換規(guī)則：? 無(wú)意義維度取值的轉(zhuǎn)換對(duì)中央業(yè)務(wù)平臺(tái)中維度取值為 NULL 值、空值，必須轉(zhuǎn)換成規(guī)定長(zhǎng)9 / 29度的空格。? 編碼格式? 漢字：GBK 內(nèi)碼? 西文：ASCII 碼? 數(shù)字格式? 在接口數(shù)據(jù)文件中，數(shù)字的表示必須規(guī)范，小數(shù)點(diǎn)的前后必需有數(shù)字，如： 或 ,不能用“.01”或“34.”表示；? 符號(hào)處理：數(shù)字最高位的左邊第一位為符號(hào)位。對(duì)于負(fù)數(shù)，符號(hào)位為“”，正數(shù)不用加符號(hào)位；? 左對(duì)齊，必須以空格右填充至定義的長(zhǎng)度；? 字符格式? 左對(duì)齊，必以空格右填充至定義的長(zhǎng)度；? 空記錄（NULL）數(shù)據(jù)倉(cāng)庫(kù)系統(tǒng)中不允許出現(xiàn) NULL，所有中央業(yè)務(wù)平臺(tái)中出現(xiàn)的 NULL 被認(rèn)為是無(wú)意的，所以在上傳數(shù)據(jù)文件中，NULL 必須按照如下規(guī)則轉(zhuǎn)換：? 字符類(lèi)型的 NULL，以空格填充至定義的長(zhǎng)度? 數(shù)字類(lèi)型的 NULL，以 0 填充，并加以空格填充至定義的長(zhǎng)度? 時(shí)間類(lèi)型的 NULL，以空格填充至定義的長(zhǎng)度? 空格? 在業(yè)務(wù)系統(tǒng)中，字段的值完全為空格（一個(gè)或多個(gè)）或字段值首尾包含的空格，在數(shù)據(jù)倉(cāng)庫(kù)中視為無(wú)意義，所以如果在業(yè)務(wù)系統(tǒng)存在中以上類(lèi)型的空格，必須轉(zhuǎn)換為有意義的其它字符，字符串的前后空格均視為無(wú)意義。? 日期類(lèi)型? 日期類(lèi)型統(tǒng)一采用 YYYYMMDD 格式，YYYYMMDD 必須為有意義的日期? YYYY 為四位數(shù)字，必須是有效的年份? MM 為兩位數(shù)字，必須是有效的月份（0112）10 / 29? DD 為兩位數(shù)字，必須是有效的日期（0131）? 對(duì)于不符合日期約束規(guī)則的日期值，處理方式存在以下兩種情況：1) 無(wú)值的日期或者無(wú)意義的日期，這時(shí)在接口中一律以“00010101”（公元元年 1 月 1 日）填充；2) 接口單元中的“失效日期”在表示“未失效”含義時(shí)，一律以“29991231”（公元 2999 年 12 月 3