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