13 哈爾濱供水營業(yè)收費管理信息系統(tǒng) 抄表器接口規(guī)范.docx

哈爾濱供水營業(yè)收費管理信息系統(tǒng) 抄表器接口規(guī)范哈爾濱供水集團抄表器業(yè)務(wù)說明版本 1.0修訂歷史版本號作者內(nèi)容提要核準(zhǔn)人發(fā)布日期1.0厚凱，韋政抄表機業(yè)務(wù)交換規(guī)范2013-06-181.1于水Sn5變?yōu)楣芾韱T條碼2013-11-281.2于水接口中增加字段：ifdzsb，倒表標(biāo)志2014-1-91.3于水字段userKard(C36)變更為“表身碼”，抄表器所有接口下裝時，都要下載表身碼；“抄表接口”上傳時，不需要更新系統(tǒng)內(nèi)的表身碼；“入戶掛簽接口”上傳時，需要更新系統(tǒng)內(nèi)的表身碼2014-7-231.4于水字段Jing (C19)變更為“表耗”，抄表器接口下裝時，需要下載表耗。2014-7-25目 錄1 概述11.1 名詞解釋11.2 目標(biāo)讀者22 抄表器接口22.1 數(shù)據(jù)源文件轉(zhuǎn)化為文本文件22.2 文本文件轉(zhuǎn)換為數(shù)據(jù)源文件33 系統(tǒng)功能33.1 系統(tǒng)配置33.2 數(shù)據(jù)交換文件33.2.1 文件轉(zhuǎn)換63.2.2 下載到抄表機63.2.3 上傳抄表數(shù)據(jù)7III1 概述1.1 名詞解釋數(shù)據(jù)交換通用格式自來水系統(tǒng)與抄表器之間的數(shù)據(jù)傳輸采用文本文件格式（tab鍵分割），自來水公司提供的文本文件為 read.txt抄表器數(shù)據(jù)文件目錄用于存放抄表器上傳的數(shù)據(jù)文件，系統(tǒng)默認為 d:read， 用戶可以按照實際情況修改,此目錄下有swap 交換種子文件（本例不用）down 下裝交換文件upload 上傳交換文件readlog 下裝日志文件目錄backlog 上裝日志文件目錄d:read-down10007-upload10007-readlog10007-backlog10007抄表員數(shù)據(jù)交換目錄系統(tǒng)支持按照抄表員下裝和上裝，如果本目錄不存在系統(tǒng)自動為每個抄表員建立交換目錄例如 10007 抄表員下裝 初始抄表信息， 系統(tǒng)下裝時自動建立 d:readreadlog10007下裝交換日志文件例如 10007 抄表員下裝 初始抄表信息， 系統(tǒng)下裝時在d:readlog10007 目錄下生成 read.txt 交換文件上傳交換日志文件例如 10007 抄表員下裝 抄表信息， 系統(tǒng)上傳時在 d:backlog10007 目錄下生成 read.txt 交換文件1.2 目標(biāo)讀者l 哈爾濱供水集團信息中心l 抄表機廠家l 中水新華l 武漢易維開發(fā)人員2 抄表器接口除已有接口外，抄表器廠商還需要提供2個轉(zhuǎn)換函數(shù)以實現(xiàn)抄表器的數(shù)據(jù)源文件與自來水公司提供的文本文件相互轉(zhuǎn)化，本文檔以dbf數(shù)據(jù)文件為例。2.1 數(shù)據(jù)源文件轉(zhuǎn)化為文本文件int dbftotxt(filename)傳入?yún)?shù)為dbf文件名，將dbf中的表格數(shù)據(jù)提取到txt文件中，列與列之間用tab鍵分隔。2.2 文本文件轉(zhuǎn)換為數(shù)據(jù)源文件int txttodbf(filename)傳入?yún)?shù)為txt文件名，首先清空抄表器dbf中的原有數(shù)據(jù)，然后將txt中的數(shù)據(jù)導(dǎo)入到dbf文件中。3 系統(tǒng)功能3.1 系統(tǒng)配置為實現(xiàn)抄表器數(shù)據(jù)的上傳與下載，需要修改營業(yè)收費系統(tǒng)安裝目錄中的“system.ini”配置文件，指定抄表器數(shù)據(jù)文件目錄和系統(tǒng)數(shù)據(jù)源目錄。3.2 數(shù)據(jù)交換文件字段名是否上傳中文類型注釋MiidN水表號C1Varchar2(10)BarcodeN條碼號C2Varchar2(20)原水賬標(biāo)識號AreaN區(qū)域C3Varchar2(20)recMonthN調(diào)查年月C4Number(6)yyyymmRemarkN用戶性質(zhì)C5Char(60)備注BookidN抄本C6Varchar2(10)BookorderN抄表次序C7NUMBER(10)OperatoridN抄表員編號C8Varchar2(10)OperatorN抄表員姓名C9Varchar2(10)mustReadDateN應(yīng)抄日期C10datetimeyyyy-mm-dd mastReadDN偏移天數(shù)C11Number(2)MetertypeN表態(tài)C12Char(2)01正常02表異常03零水量meterStatusN表況C13Char(2)見表況描述VolumeN固定量C14Number(8,0)If_actN是否已入帳C15Char(1)該水量調(diào)查信息是否已經(jīng)導(dǎo)入到系統(tǒng)中。1：已經(jīng)完成導(dǎo)入；0：未導(dǎo)入系統(tǒng)。ReadokN抄見標(biāo)志C16Char(1)1 抄見NameY用戶名C17Varchar2(60)AddressY地址C18Varchar2(60)JingN表耗C19Varchar2(20)由“表井”變更為“表耗”connect_infoN表位C20Varchar2(30)sn1N封號1C21Varchar2(30)sn2N封號2C22Varchar2(20)sn3N封號3C23Varchar2(20)sn4N封號4C24Varchar2(20)sn5N管理員條碼 C25Varchar2(20)PeopleY人口數(shù)C26Number(6,0)IstotalN總分表 合收標(biāo)志C27Char(1)1 普通 2 總表 3 分表meterParentN總分表父表號C28Varchar2(10)總分表父表號MIPRIFLAGN合收表標(biāo)志C29Varchar2(1)Y合收表 N 普通MIPRIIDN合收表主表號C30Varchar2(10)合收表主表號tel1Y電話C31Varchar2(19)tel2Y手機C32Varchar2(19)flag_mN水表信息是否修改上傳C33Char(1)1 走抄表機信息變更流程 0 沒有變更（默認）RfidY電子標(biāo)簽C34Varchar2(19)flag_rN電子標(biāo)簽是否匹配C35Char(1)1 存回電子標(biāo)簽，0 不傳（默認）userKardY表身碼C36Varchar2(19)原“用戶卡”字段變更為“表身碼”flag_c用戶卡是否匹配C37Char(1)1 需要上傳用戶卡 0 不傳（默認）NometerN無表標(biāo)志C38Char(1)1 無表 讀水量， 不讀止碼 0 讀止碼LastcodeN起碼C39Number(6,0)CurrcodeY止碼C40Number(6,0)WateruseY水量C41Number(6,0)PaidflagN計費標(biāo)志C42Char(1)Y算費 N不算費AvgpriceN綜合單價C43Number(6,2)WatertypeN水價類別C44Varchar2(8)字符+數(shù)字price_sN水價類別描述C45Varchar2(60)用水信息描述MIIFMPN混合標(biāo)志C46Number(6,0)Y 混合用水 N 單一用水p1N水價C47Number(6,2)p2N污水價C48Number(6,2)p3N其他費3C49Number(6,2)p4N其他費4C50Number(6,2)p5N其他費5C51Number(6,2)ReadingdateY抄表時間C52Datetimeyyyy-mm-dd hh24:mm:ssLastdateN上次時間C53Datetimeyyyy-mm-dd hh24:mm:ssLastuseN上次水量C54Number(6,0)avg3N前三月平均量C55Number(6,0)DowndateN下載日期C56Datetimeyyyy-mm-dd hh24:mm:ssDischargeN欠費金額C57Number(12,2)余額-真實欠費DiscountN欠費筆數(shù)C58Number(6,0)DisdateN最早欠費月C59Varchar2(8)yyyymmddlast_paydateN上次繳費日期C60Datetimeyyyy-mm-dd hh24:mm:sslast_paymoneyN上次繳費金額C61Number(12,2)PaymoneyY收費金額C62Number(12,2)BillnoY票據(jù)號C63Varchar2(18)PrintnoY打印次數(shù)C64Number(6,0)flag_pN收費數(shù)據(jù)是否上傳C65Char(1)echoLimitN報警限額上線C66Number(6,0)用水性質(zhì)限額限制 0 不報警MridN抄表流水號C67Varchar2 (10)唯一流水ifdzsbN倒表標(biāo)志C68char(1)1：倒表 0：正常表抄表表態(tài)有三種:正常、表異常、零水量：01正常02表異常03零水量每種表態(tài)下屬表況描述04正常表況正常 非正常數(shù)據(jù)05零水量表況本次同上次長期無人停業(yè)閉栓不用水非正常數(shù)據(jù)06表異常表況表停無表計量倒表表銹表失靈水表自轉(zhuǎn)3.2.1 文件轉(zhuǎn)換調(diào)用抄表器廠商提供的接口中的txttodbf()函數(shù)，將自來水公司生成的txt文檔寫入抄表器數(shù)據(jù)文件目錄下的dbf文件中。3.2.2 下載到抄表機調(diào)用抄表器廠商提供的接口將抄表器數(shù)據(jù)文件目錄下的txt 文件轉(zhuǎn)換成dbf文件下載到抄表機中。追加下載下載時提示：下載數(shù)據(jù)將清除抄表機數(shù)據(jù)， 請確認抄表機是否仍有未上傳數(shù)據(jù)。是否繼續(xù)下載（Y/N）API 調(diào)用規(guī)范抄表機廠家提供以下的api 供系統(tǒng)調(diào)用（兼容pascal 參數(shù)傳遞規(guī)則）dll: 函數(shù)名：int down(string filename)返回值return0 成功10 通信失敗11 文件轉(zhuǎn)換失敗3.2.3 上傳抄表數(shù)據(jù)讀取upload文件到系統(tǒng)中，將抄表數(shù)據(jù)更新到數(shù)據(jù)表的相應(yīng)字段中去，符合例外數(shù)據(jù)的則不更新。API 調(diào)用規(guī)范抄表機廠家提供以下的api 供系統(tǒng)調(diào)用（兼容pascal 參數(shù)傳遞規(guī)則）dll: 函數(shù)名：int upload