省系统接口说明
附件1：
市级系统接口参考页面
1 说明
本文档是关于……，要求……。已达到……目的。
2 参考页面
第一步
客户端首先要设置web service的连接地址、用户名和密码三项。远程地址固定为：http://124.133.54.21/services/DataService。用户名和密码为省总队分配。
参考界面如下：
帐号：3702-00-01
密码: 123456
第二步
企业填报自己月报数据然后提交。
第三步
市级用户审核企业提交的月报数据。
第四步
市级进入提交审核页面。审核通过的企业将在“企业列表”中显示。将企业选择进“已选企业”。然后点击“上传至省平台”按钮。操作完成。
参考界面如下：
附件2：
山东省节能信息系统数据导入接口协议
1 简介
本协议用于山东省节能信息系统与通过API接入山东省节能信息系统的客户端的数据传输通讯。两者的数据传输通讯采用TCP协议、短连接方式，山东省节能信息系统为服务器方。
缩略语清单：
client ：所有通过Web Service接口接入山东省节能信息系统的客户端2 Web Service接口说明
2.1 山东省节能信息系统Web Service地址
WSDL：http://124.133.54.21/services/DataService?wsdl
地址：http://124.133.54.21/services/DataService
2.2 接口说明
2.2.1 i mportYearReportData方法
public String importYearReportData(
String loginName,
String loginPwd,
String cityCode,
int year,
String reportData)
方法说明：
从各地市系统上传本市已经审核确认的企业年报数据到省系统，如果省系统中企业当年年报数据还未上传过，则添加年报数据，如果年报数据已经上传过，则更新已上传年报数据。
返回值定义：第一行为错误代码，其他行为调用失败时的详细错误信息
ok：数据导入成功
invalidate-city：错误的地市编码
invalidate-date：错误的年份
invalidate-user：访问用户不可用
not-allow-op：用户没有操作权限
illegal-report-data：不合法的报表数据格式
error-report-style：错误的报表样式
error-verify-relations：错误的校验关系
2.2.2 i mportMonthReportData方法
public String importMonthReportData(
String loginName,
String loginPwd,
String cityCode,
int year,
int month,
String reportData)
方法说明：
从各地市系统上传本市已经审核确认的企业月报数据到省系统，如果省系统中企业当月月报数据还未上传过，则添加月报数据，如果月报数据已经上传过，则更新已上传月报数据。
返回值定义：第一行为错误代码，其他行为当调用失败时的详细错误信息
ok：数据导入成功
invalidate-city：错误的地市编码
invalidate-date：错误的年份或月份
invalidate-user：访问用户不可用
not-allow-op：用户没有操作权限
illegal-report-data：不合法的报表数据格式
error-report-style：错误的报表样式
error-verify-relations：错误的校验关系
2.2.3 e xportDictionary
public String exportDictionary(String catalog)
方法说明：
导出省级系统定义的各类字典编码数据，企业注册信息、月报数据、年报数据中相关字段所使用的编码将从系统定义的字典编码中选取。
参数说明：
返回值定义：返回的各种字典编码数据，每行为一条编码，每个编码包含code和name，中间用“$@$”分隔。
返回值示例：
1.能源种类
01$@$原煤
02$@$洗精煤
…
2.计量单位
0103$@$毫克
0106$@$微克
…
3.产品指标
0001$@$万元产值综合能耗（当量值）
000101$@$万元产值综合能耗（等量值）
…
4.企业类型
001$@$国家千家重点用能单位
002$@$省千户重点用能单位
003$@$市属重点用能单位
5.行业分类
06$@$煤炭
17$@$纺织
…
6.行业编码
06$@$煤炭开采和洗选业
08$@$黑色金属采选业
…
7.产业编码
1$@$第一产业
2$@$第二产业
3$@$第三产业
4$@$其他产业
8.省级编码
370000$@$山东
…
9.地市编码
370100$@$济南
370200$@$青岛
…
10.区县编码
370101$@$市辖区
370102$@$历下区
370103$@$市中区
…
3 错误码使用说明
对于方法调用的返回值，ok代表数据导入成功，其他表示失败，具体错误码见下表。
4 附录
4.1 报表数据格式定义
1. 年报和月报数据格式包含多个表数据（表定义见附录4.3、4.4、4.5），每个表包含1到多个用能单位的上报数据，即：表1的上报数据，表2的上报数据，…,表n的上报数据。
2. 每个表数据第一行是表名标识行，以“@@”开头，后跟表数据所对应的表的编码，第二行是表字段定义行，定义了该表所使用的字段名称，各个字段名之间用“$@$”分隔。剩下行是表数据行，存放各个企业对该表的上报数据，要求数据行的各个字段值必须和字段定义行的各个字段相一致，各个数据值之间用“$@$”分隔。各行之间用回车换行（\r\n）分隔。
3. 填报的数据，对于字符型和日期型，要求在数据两边加单引号。
4. 报表数据各行的各个字段要求必须有值，如果企业数据没有填写，那么使用初始数据填充，数值型数据初始值为0，字符型和日期型数据初始值为空字符串（不是null）。
5. 要求导入的数据要遵循对应报表的数据校验关系，系统会根据数据校验关系对数据进行校验，校验不通过时不能被导入，并返回错误码。
6. 导入数据可以传入指定报表的某个年月的多家企业的报表数据。导入时如果该企业该年月有数据则采用覆盖的方式处理，否则数据为添加的方式。
7. 每次调用接口上报年报或月报的企业数量不要超过50家，如果需要上报企业超过50家，建议分为多次调用上报。
月报报表数据格式示例：
@@nyqyzcxxb
qy_code$@$qy_name$@$qy_qyfl_code$@$qy_address$@$qy_hy_code$@$qy_province$@$qy_city$@$qy_coun ty$@$qy_sscy$@$des
'12345678-0'$@$'山东XXXX有限公司'$@$'06'$@$'山东省xx 市xx 路xx 号'$@$'001'$@$'370000'$@$'370100'$@$''$@$'370101'$@$'1'$@$''
…
@@nygjxfkcb
qy_code$@$nyzl_code$@$qkcl$@$gjl_swl$@$gjl_je$@$xfl_gyscxf$@$xfl_gyscxf_yyycl$@$xfl_fgyscxf$ @$xfl_ysgjxf$@$qmkcl$@$cyzbxs$@$dwfzr$@$tjfzr$@$tbr$@$dh$@$tbrq
…
@@nygjxfkcb_zyzb
qy_code$@$bq_zhnyxfl$@$sq_zhnyxfl$@$bq_gyzcz_dnj$@$bq_gyzcz_snj$@$sq_gyzcz_dnj$@$sq_fgyscxf$ @$sq_dlxfhj$@$sq_gyscdlxf$@$sq_dlcc$@$sq_hlfdtr
…
@@nygjxfkcfb
qy_code$@$nyzl_code$@$hlfd$@$gr$@$ymrx$@$lj$@$ly$@$zq$@$trqyh$@$jgmzp$@$nyjgzhcc$@$hsly$@$dw fzr$@$tjfzr$@$tbr$@$dh$@$tbrq
…
@@dwcpzhnhzbqkb
qy_code$@$cpzb_code$@$bnd_zxz$@$bnd_mxz$@$snd_mxz$@$snd_zxz$@$dwfzr$@$tjfzr$@$tbr$@$dh$@$tbr
q
…
4.2 地市编码表
4.3 企业注册信息表定义
4.4 需要导入年报报表定义暂无
4.5 需要导入月报报表定义
4.6 客户端调用方法
本节介绍如何使用XFire工具访问数据接口进行数据操作，开发语言为JAVA。你也可以采用其他你所熟悉的SOAP兼容库进行开发。该程序只作为参考实现，未考虑运行效率，请客户端开发者根据自己实际情况修改。
首先我们通过 http://124.133.54.21/services/DataService?wsdl可以获得 WSDL 文件 DataService.wsdl ，并将其放在 src 目录下面，接着我们通过程序访问该 WSDL 文件，并调用需测试的方法。此时测试类 WebServiceClientTest.java 的关键代码如下所示：String wsdl = " DataService.wsdl " ; // 对应的WSDL文件
Resource resource = new ClassPathResource(wsdl);
Client client = new Client(resource.getInputStream(), null ); // 根据WSDL创建客户实例
Object[] params = new Object[6];
params [0] = "loginUser" ; //用户名
params [1] = "loginPwd" ; //用户口令
params [2] = "3701" ; //地市编码
params [3] = 2010 ; //年报年份
params [4] = "" ; //年报数据
// 调用特定的Web Service方法
Object[] results = client.invoke( "importYearReportData" , params);
System.out.println( "result: " + results[0]);
接口使用说明文档
中国移动短信网关 SP端接口使用手册 China Mobile Shot Message Gateway Interface for SP Manual 作者：沈岗 日期：2004年1月 版本：V1.2
一、CMSMIF.CMPPApp 简要说明： 该类采用CMPP协议(V2.0)实现了SP端与移动短信网关的连接处理。 本类中，采用长连接方式与ISMG通讯。通信双方以客户-服务器方式建立TCP连接，用于双方信息的相互提交。当信道上没有数据传输时，通信双方应每隔时间C发送链路检测包以维持此连接，当链路检测包发出超过时间T后未收到响应，立即再发送链路检测包，再连续发送N-1次后仍未得到响应则断开此连接。参数C、T、N可通过属性配置。 消息发送时采用并发方式，即发送一条消息不等待网关回复确认，继续向网关发送短信，这样发送消息速度非常快，完全取决于网关的处理速度及网络速度。为避免消息丢失，同时采用了滑动窗口流量控制，窗口大小可通过属性设置。 消息接收、网络断开等采用事件触发方式，不需应用程序轮询，在此接口基础之上编程方便。 类中运用了多线程技术，如一条线程处理发送网络包，而另一条线程处理从网关上接收网络包，其他还有一些线程处理检测包、网络连接情况监测等，使程序思路明确、执行效率很高、运行非常稳定。 （一）属性 1.ActiveInterval 说明：检测包发送时间间隔，单位：毫秒。默认值为120000，即120秒。为上 述类说明中的C参数。 2.MaxNetworkPackSize 说明：与ISMG通讯时最大网络包大小，单位：字节。默认值为512Byte。 3.MaxRetryTimes 说明：网络超时最大重发次数,单位：次。默认值为3次。为类说明中的N。 4.OverTime 说明：网络包发送超时时间,单位:毫秒,超过此值还未收到回复则重发。默认值 为60000，即60秒。为类说明中的T。 5.QueueLength 说明：网络队列大小，单位：个，默认值为20。为类说明中的滑动窗口大小， 以控制发送流量。 （二）方法 1.ConnectToIsmg 方法说明： 连接到远程短信网关ISMG上，只有连接到远程短信网关上，才可进行短信收发操作。 在本操作中，自动初始化本地Socket，以连接到指定IP服务器的指定端口上。 声明原型：int ConnectToIsmg(string ServerIP,int Port,string SP_ID,string Secret，string SN) 参数说明： ServerIP：远程短信网关服务器的IP地址，如211.138.200.51 Port：远程短信网关服务器的端口号，如7890 SP_ID：企业服务代码
各种接口说明资料
视频基础知识 目前，国内外各个视频会议生产厂家都陆续推出了自己的各种高清或超清产品，都在不遗余力的宣传图像分辨率。但是，要达到高清/超清的视频会议，单单有720p或者1080p的图像分辨率是不够的。视频会议作为多媒体的一种应用，整个系统涉及到前端视频采集、图像的编码能力、高质量的网络传输、高清晰的视频显示设备。另外，如果我们在观看高清晰视频图像的时候，不能得到一个更清晰、连续的音频效果，那么这个过程实际上就没有任何意义，所以高质量音频的重要性完全不亚于视频。所以在高清或者超清的视频会议中有几个关键的知识点需要了解：高清的视频分辨率、高清视频显示设备的接口、高质量的音频传输接口、高质量的音频。技术的发展都是循序渐进的过程，在本文档中不但列出了高清视频的相关术语，还把非高清视频系统中的相关术语也一并列出，这样会有一个很直观的比较过程。 1视频接口 我们经常在家里的电视机、各种播放器上，视频会议产品和监控产品的编解码器的视频输入/输出接口上看到很多视频接口，这些视频接口哪些是模拟接口、哪些是数字接口，哪些接口可以传输高清图像等，下面就做一个详细的介绍。 目前最基本的视频接口是复合视频接口、S-vidio接口；另外常见的还有色差接口、VGA接口、DVI接口、HDMI 接口、SDI接口。 1.1复合视频接口 1.1.1接口图 1.1.2说明 复合视频接口也叫AV接口或者Video接口，是目前最普遍的一种视频接口，几乎所有的电视机、影碟机类产品都有这个接口。 它是音频、视频分离的视频接口，一般由三个独立的RCA插头（又叫梅花接口、RCA接口）组成的，其中的V接
口连接混合视频信号，为黄色插口；L接口连接左声道声音信号，为白色插口；R接口连接右声道声音信号，为 红色插口。 1.1.3评价 它是一种混合视频信号，没有经过RF射频信号调制、放大、检波、解调等过程，信号保真度相对较好。图像品质 影响受使用的线材影响大，分辨率一般可达350-450线，不过由于它是模拟接口，用于数字显示设备时，需要一 个模拟信号转数字信号的过程，会损失不少信噪比，所以一般数字显示设备不建议使用。 1.2S-Video接口 1.2.1接口图 1.2.2说明 S接口也是非常常见的接口，其全称是Separate Video，也称为SUPER VIDEO。S-Video连接规格是由日本人开发的一种规格，S指的是“SEPARATE（分离）”，它将亮度和色度分离输出，避免了混合视讯讯号输出时亮度和色度的相互干扰。S接口实际上是一种五芯接口，由两路视亮度信号、两路视频色度信号和一路公共屏蔽地线共五条芯线组成。 1.2.3评价 同AV 接口相比，由于它不再进行Y/C混合传输，因此也就无需再进行亮色分离和解码工作，而且使用各自独立的传
软件系统之间的接口方式
软件系统之间的接口方式 ?? 概述 软件接口是实现一个系统跟另外系统进行信息交互的桥梁，在不同的系统之间，根据系统的关联程度的不同存在紧耦合和松耦合两种：紧耦合要求接口响应反应快，消息不能阻塞；松耦合对响应反应要求比较低。在目前应用中， Socket 、消息队列（Message Queue）、 WebService等都有相应的应用，但是应用中发现各通讯方式有自己固有的特征，“适合的才是最好的”，这是真理。 在接口和系统信息交互的过程中，两种模式使用得很普遍：同步调用和异步调用，同步调用要求接口发出请求消息后必须等待服务端系统的应答消息，接口阻塞直至超时；异步调用则发出请求消息后，接口可以从事其它处理，定时轮询服务端应答消息和消息或事件通知。同步方式简单，但是很容易造成接口阻塞，造成消息积压超时。 ?? 技术实现 ?? Socket 通讯 Socket 通讯相对来说是很古老的通讯方式，也是最常用的通讯方式。 Socket 通讯有阻塞和非阻塞两种方式。在同步方式，采用阻塞编程比较简单，但是为了防止接口阻塞，我们需要设置 Socket 超时，因此可以使用 Socket 的 SELECT 模型（参考如下示例代码）： ReceLen=0; CurReceLen=0; for(;;) { iResult=select(0,&fdread,NULL,NULL,&timeout);
if(iResult==0) { AfxMessageBox("接收应答消息超时!!!",MB_OK|MB_ICONERROR); closesocket(Socket); return FALSE; } CurReceLen = recv(Socket, oBuf+ReceLen, len, NO_FLAG_SET); if((CurReceLen>0) && (CurReceLen != SOCKET_ERROR)) { oBuf[ReceLen+CurReceLen]='\0'; memcpy((char *)&MsgLen,oBuf,sizeof(WORD32)); MsgLen=ntohl(MsgLen); if(ReceLen+CurReceLen==MsgLen) { ReceLen+=CurReceLen; break; } ReceLen+=CurReceLen; }
时钟系统对时接口说明
时钟系统对时接口说明 时钟系统可以为其它系统提供标准时间信号以保证各系统间的时钟统一。时钟系统可以提供两钟对时信号，一种是RS422接口形式的对时信号，另一种是NTP网络时间信号。具体说明如下： 1. RS422接口的标准时间输出 1.1 RS422标准时间接口说明： 时钟系统可以为本系统外的其它系统，例如为公务电话系统、专用电话系统、无线通信系统、电视监视系统、广播等系统提供标准时间信号。 接口功能：为其它系统提供对时信息。 接口类型：RS422接口线缆 物理接口方式：RS422 通讯协议：参照时钟系统标准时间接口协议 接口数量：每个系统各1路。 接口位置及工程界面：控制中心通信系统设备室综合配线架的外侧。 1.2 时钟系统标准时间接口协议： ①输出接口：标准RS-422端口 ②波特率：9600bit/s ③数据位：8位
④起始位：1位 ⑤停止位：1位 ⑥校验位：无 ⑦工作方式：异步 ⑨数据格式：（ASCII字符串，共21个字符） ebh,90h, 起始符 c: 41h 无外时钟校时, 47h GPS校时 n4,n3,n2,n1 年 m2,m1 月 d2,d1 日 w(30h～36h) 星期 h2,h1 时 m2,m1 分 s2,s1 秒 xxh 校验码（累加检验，取低8位） cr(odh) 1ah; 结束符. 例：EB 90 47 32 30 30 39 30 33 33 31 32 31 30 32 34 33 36 XX 0D 1A 信息为：2009-03-31 星期二10：24：36 有外部较时。 ⑩传输距离：1200米（采用0.5平方毫米的双绞软线，超过1200米需增加中继器）2. NTP接口的标准时间输出 时钟系统也可以通过NTP网络时间服务器为本系统外的其它系统提供基于以太网协议网络接口时间信号。具体说明如下： ☉网络协议: NTP v2, v3 & v4 (RFC1119& 1305) NTP broadcast mode SNTP Simple Network Time Protocol （RFC2030） MD5 Authentication （RFC 1321） Telnet （RFC854） DHCP （RFC2132） FTP （RFC 959）
时钟系统对时接口说明
时钟系统可以为其它系统提供标准时间信号以保证各系统间的时钟统一。时钟系统可以提供两钟对时信号，一种是RS422接口形式的对时信号，另一种是NTP网络时间信号。具体说明如下： 1. RS422接口的标准时间输出 RS422标准时间接口说明： 时钟系统可以为本系统外的其它系统，例如为公务电话系统、专用电话系统、无线通信系统、电视监视系统、广播等系统提供标准时间信号。 接口功能：为其它系统提供对时信息。 接口类型：RS422接口线缆 物理接口方式：RS422 通讯协议：参照时钟系统标准时间接口协议 接口数量：每个系统各1路。 接口位置及工程界面：控制中心通信系统设备室综合配线架的外侧。 时钟系统标准时间接口协议： ①输出接口：标准RS-422端口 ②波特率： 9600bit/s ③数据位： 8位 ④起始位： 1位 ⑤停止位： 1位 ⑥校验位：无 ⑦工作方式：异步 ⑨数据格式：（ASCII字符串，共21个字符） ebh,90h, 起始符 c: 41h 无外时钟校时, 47h GPS校时 n4,n3,n2,n1 年
m2,m1 月 d2,d1 日 w(30h～36h) 星期 h2,h1 时 m2,m1 分 s2,s1 秒 xxh 校验码（累加检验，取低8位） cr(odh) 1ah; 结束符. 例：EB 90 47 32 30 30 39 30 33 33 31 32 31 30 32 34 33 36 XX 0D 1A 信息为： 2009-03-31 星期二 10：24：36 有外部较时。 ⑩传输距离：1200米（采用平方毫米的双绞软线，超过1200米需增加中继器） 2. NTP接口的标准时间输出 时钟系统也可以通过NTP网络时间服务器为本系统外的其它系统提供基于以太网协议网络接口时间信号。具体说明如下： ☉网络协议: NTP v2, v3 & v4 (RFC1119& 1305) NTP broadcast mode SNTP Simple Network Time Protocol （RFC2030） MD5 Authentication （RFC 1321） Telnet （RFC854） DHCP （RFC2132） FTP （RFC 959） ☉输入/输出接口: 网络接口：1个10/100自适应以太网接口（其他系统的IP需根NTP在同一网段）； 1路RS-422串行口输出：9针接口 秒脉冲接口： TTL电平方式。 定时准确度： 300纳秒 ☉时间服务功能（一级网络时间服务器） GPS ☉
完整的接口解决方案说明书
文档编号：T-JKJS 文档版本：0.01 项目编号：XX-DX- PECS 《XX电信工程外部协作系统》 Project Exterior Cooperation System 施工单位接口技术解决方案 编写人：南疯日期：2006-10-30 审核人：日期： 批准人：日期： XXXXXX信息科技股份有限公司 地址：XXXXXXX 邮编：XXXXXX 电话：XXXXXXXX传真：XXXXXX 网站：XXXXXXXXX 修改记录（Revision Chart） 版本号批准人修改人修改0.01南疯2006-10-30 0.02详细修改记录： 序号
1引言 1.1编写目的 1.2覆盖范围 1.3预期读者与阅读建议 1.4文档约定 1.5术语与缩略语 1.6参考文献 2概述 3接口方式 4接口安全 4.1接口认证 4.2数据安全 5事务处理 6性能考虑 7容错处理 8数据格式 8.1约定 8.2施工系统向外协系统发送请求 8.2.1请求查询一个业务数据 8.2.2新增一条记录，得到记录的键值 8.2.3修改一条记录 8.2.4删除一条记录 8.2.5文档上传 8.2.6一条记录中一个文档字段上传多个文件 8.2.7补充上传文档 8.2.8在记录中删除一个文档 8.2.9获得文档的基本信息 8.2.10获得文档的所有兄弟信息 8.2.11获得文档的所有父亲信息 8.2.12下载一个文档 8.2.13获得字典 8.3外协系统向施工系统发送请求 8.3.1发送变更后的数据 8.3.2发送变更后的字典 8.3.3文档发送请求 9信息数据项 9.1数据表 9.2字段信息 9.3字典类型
系统对接方案说明
WORD格式可编辑 系统对接设计 1.1.1 对接方式 系统与外部系统的对接方式以web service方式进行。 系统接口标准： 本系统采用SOA体系架构，通过服务总线技术实现数据交换以及实现各业务子系统间、外部业务系统之间的信息共享和集成，因此SOA体系标准就是我们采用的接口核心标准。主要包括： 服务目录标准：服务目录API接口格式参考国家以及关于服务目录的元数据指导规范，对于W3C UDDI v2 API结构规范，采取UDDI v2的API的模型，定义UDDI的查询和发布服务接口，定制基于Java和SOAP的访问接口。除了基于SOAP1.2的Web Service 接口方式，对于基于消息的接口采用JMS或者MQ的方式。 交换标准：基于服务的交换，采用HTTP/HTTPS作为传输协议，而其消息体存放基于SOAP1.2协议的SOAP消息格式。SOAP的消息体包括服务数据以及服务操作，服务 数据和服务操作采用WSDL进行描述。 Web服务标准：用WSDL描述业务服务，将WSDL发布到UDDI用以设计/创建服务，SOAP/HTTP服务遵循WS-I Basic Profile 1.0，利用J2EE Session EJBs实现新的业务服务，根据需求提供SOAP/HTTP or JMS and RMI/IIOP接口。 业务流程标准：使用没有扩展的标准的BPEL4WS，对于业务流程以SOAP服务形式进行访问，业务流程之间的调用通过SOAP。 数据交换安全：与外部系统对接需考虑外部访问的安全性，通过IP白名单、SSL 认证等方式保证集成互访的合法性与安全性。 数据交换标准：制定适合双方系统统一的数据交换数据标准，支持对增量的数据自动进行数据同步，避免人工重复录入的工作。 1.1.2 接口规范性设计 系统平台中的接口众多，依赖关系复杂，通过接口交换的数据与接口调用必 须遵循统一的接口模型进行设计。接口模型除了遵循工程统一的数据标准和接口专业知识整理分享
楼控系统与相关专业的接口要求及说明
楼宇自控系统与相关专业的接口要求及相关说明 一、楼宇自控系统与电气专业的接口及要求 楼宇自控系统作为大楼内一个重要的组成系统,其实现自身的功能已经比较成熟和完善,但在系统实施过程中,经常由于接口问题而导致系统的最终功能不完善,丢项、甩项等事情经常发生。 由于接口的问题牵扯的面比较多,涉及到工程实施中的暖通、给排水、变配电等多个专业,因此在工程的前期将接口问题进行明确,非常必要。从另一个角度将接口方面的问题进行明确,可以使业主在工程前期,在设备订货之前就明确提出接口要求,从而得以实现。 ☆明确各方面的责任及工作内容,避免出现问题时,互相扯皮。 ☆确保实现系统设计的全部功能,避免资金的浪费。 1.风机、水泵电控箱的接口要求 空调机组/新风机组送风机: 楼宇自控系统对空调机组/新风机组送风机的监控信号为:风机运行状态反馈、风机故障状态反馈、风机手/自动状态反馈、风机启停控制。 ①楼宇自控系统监测的风机运行状态反馈信号应由交流接触器的无源辅助 触点引出(此接点为一对无源常开接点)。 ②楼宇自控系统监测的风机故障状态反馈信号应由热保护继电器的无源 辅助触点引出(此接点为一对无源常开接点)。
③电气专业应在空调机组/新风机组送风机的电控箱二次控制回路中设置 手/自动转换开关,并向楼宇自控系统提供一对无源辅助触点(此接点 为一对无源常开接点),作为风机的手/自动状态反馈信号。 ④楼宇自控系统提供一对无源常开接点信号引入风机的二次控制回路,用 于当风机的手/自动开关处于自动状态时,自动控制风机的启停。 水泵 楼宇自控系统对各种水泵(其中包括:冷冻水循环泵、冷却水循环泵、热水循环泵、排污泵等)的监控信号为:水泵运行状态反馈、水泵故障状态反 馈、水泵手/自动状态反馈、水泵启停控制。 ①楼宇自控系统监测的水泵运行状态反馈信号应由交流接触器的无源辅助 触点引出(此接点为一对无源常开接点)。 ②楼宇自控系统监测的水泵故障状态反馈信号应由热保护继电器的无源辅 助触点引出(此接点为一对无源常开接点)。 ③电气专业应在水泵电控箱的二次控制回路中设置手/自动转换开关,并 向楼宇自控系统提供一对无源辅助触点(此接点为一对无源常开接 点),作为水泵的手/自动状态反馈信号。 ④楼宇自控系统提供一对无源常开接点信号引入水泵的二次控制回路,用
joomla接口说明
Joomla!接口使用手册 一、简介 1、本接口应用于Joomla! 文章发布； 2、发布时请使用管理员用户帐号； 3、Joomla! 是utf8网站，请在发布规则中选择编码为UTF-8； 4、本接口基于Joomla! 1.5.18官方中文版制作，应用于其他版本时请自行测试调整； 5、接口文件无须任何改动即可使用，如果你希望增加校验或其他功能，请仔细修改； 6、2个接口文件请复制在administrator网站根目录下使用； 二、安装接口 在接口文件夹中找到接口文件，如图： 请将etchk.php、etpost.php等接口文件上传到指定目录，请使用二进制方式上传，如图： 三、配置发布规则 1、复制范例发布规则或者将本节后附的范例规则文本导入ET2发布配置即可，如图：
2、将检查网址和发布网址中的“您的网站”改为您要发布的网站网址，如图： 3、在参数取值页，填上您要发布的网站栏目的单元ID和分类ID，分类ID可留空，如图： 这里查看单元ID：
这里查看分类ID： 4、填上您的管理账号、密码，注意格式，如图：
四、接口说明 一、检查接口 1、接口文件名etchk.php，为保密，请自行修改文件名； 2、本接口文件复制在网站administrator目录下使用； 3、主要参数 title文章标题 sectioned 单元ID，用于限定检查范围，可不填，请对照管理中心查看单元ID； catid 分类ID，用于限定检查范围，可不填，请对照管理中心查看分类ID； vercode 安全校验码，请自行设定，并在检查接口文件开始处修改vercode 使其一致； 4、发布配置-文章检查网址处，可以如下填写： http://您的网站/administrator/etchk.php?sectionid=&catid=&title=<%title%> 注：使用大小写敏感的服务器的用户请注意网址大小写和网站文件一致 5、接口文件无须任何改动即可使用，如果你希望增加校验或其他功能，请仔细修改； 二、发布接口 1、接口文件名etpost.php，为保密，请自行修改文件名； 2、本接口文件请复制在网站administrator目录下使用； 注：以下参数名后“=”号为示范取值而用，参数名本身不含“=”号； 固定取值的参数，可以在发布规则-参数取值中设置； 采集取值的参数项，请在发布规则-发布项中添加； 3、主要参数 Username 会员名参数名 passwd 密码参数名 title 主题标题参数名 text 内容参数名（若要进行分页请在数据整理中将ET2正文分隔标记“#-0-#”替换为Joomla分页标记
） etattachs 文件列表参数名； 4、附加参数 sectioned 单元ID，请对照管理中心查看； catid 分类ID，请对照管理中心查看； vercode 安全校验码，请自行设定，本项用以防止接口被他人利用，如果需
酒店门锁管理系统接口说明
深圳市同创新佳科技有限公司技术文件 LS-PMS酒店门锁管理系统 集成发卡接口说明书 Hotel Locks Management System PMS Integrate Keycards Encode SDK User Guide 版本号：2.0
目录 1目的和范围 (4) 2系统组成 (4) Windows API接口与TCP/IP接口. (4) 系统结构 (4) 3Windows API接口 (4) 接口特点以及接口使用条件 (4) Windows API接口文件说明 (5) Windows API接口函数库说明 (5) 4Windows API接口函数说明 (5) Init –接口初始化 (5) IssueCard –发行客人卡 (6) ReadCard –读取客人卡 (7) CancelCard –注销客人卡 (7) Windows API接口示例使用说明 (8) 5Windows API接口返回值说明 (11) 6. TCP/IP接口 (11) 6.1 接口特点以及接口使用条件 (11) 6.2 TCP/IP接口文件如下表: (11) 7 TCP/IP数据通讯协议 (12) 7．2 信息格式 (12) 7.3 命令详解 (14)
前言 本说明书由深圳市同创新佳科技有限公司提出。 本说明书主要起草单位：深圳市同创新佳科技有限公司技术部。本说明书主要起草人：颜炜东、凌彬。 本说明书于2009年3月25日首次制定。
LS-PMS 酒店门锁管理系统集成发卡接口说明书 Hotel Locks Management System PMS Integration Keycards Encode SDK User Guide 1 目的和范围 该接口主要为酒店管理软件与我公司的读写卡设备提供标准的接口，以便酒店管理软件可以通过该接口对我公司设备进行操作。 2 系统组成 Windows API 接口与TCP/IP 接口. 系统结构 Windows API 接口系统结构: TCP/IP 接口系统结构:: 3 Windows API 接口 接口特点以及接口使用条件 该接口具有单机与网络2种接口，其特点是不管是单机还是网络接口，每个接口都必须安装一台发卡机，只能在安装了发卡机的电脑上调用ICDLL 动态库完成制卡操作。 正常使用该接口必须满足如下要求： 3.1.1首先安装 创佳门锁公司提供的门锁软件，正常运行软件，发行各种设置卡（包括：授权卡、时钟卡、房号卡），使用设置卡完成门锁设置（如果有多台电脑发卡，则每台电脑都必须安装我们门锁软件并注册，然后用主电脑上的授权卡恢复授权，详细操作请参考门锁设置说明）。 3.1.2使用前先调用初始化函数初始化软件使用环境即调用init 函数 3.1.3使用windows98/2000/XP 操作系统. 3.1.4 动态库ICDLL.dll
完整的接口解决方案说明书
XXXXXX信息科技股份有限公司
1引言 1.1编写目的 本文档为XX电信工程外部协作系统（以下简称外协系统）与电信工程施工单位内部系统（以下简称施工系统）接口技术解决方案，以此作为外协系统与施工系统实施接口的技术方案依据和项目设计标准。 1.2覆盖范围 XX电信工程外部协作系统项目组 施工系统接口开发技术组 1.3预期读者与阅读建议 XX电信企业信息化部 XX电信工程建设部 XXXX公司开发人员 施工系统开发人员
1.4文档约定 粗体正文表示强调内容 红色正文表示未完成或需要今后考虑的内容 蓝色正文表示待讨论内容 1.5术语与缩略语 1.6参考文献 (XXXX) 2概述 建设XX电信工程外部协作系统的目标，是在工程项目的管理、建设、使用和实施单位之间搭建起数据交换和协同工作的信息平台，延伸与拓展工程建设管理信息化的应用范围，实现通信工程建设过程的信息化管理，促进工程项目的管理部门、建设部门、实施部门和使用部门之间业务流程协调有序地开展，实现工程项目设计、施工、监理管理功能，将相关的设计、施工、监理单位纳入到工程建设管理中，完善工程项目建设过程管理体系，通过信息化推动管理的规范化，在信息化的应用过程中不断探索市场环境下工程建设管理的新思路和新方法。 根据工程部业务工作的实际情况，项目首先满足工程建设管理中应用最广泛、问题最突出的基本需求。 项目功能需求包括： ?建立工程外部协作系统与MSS等系统的接口； ?建立设计协作服务、监理协作服务、施工协作服务模块，为邮电设计院、电话监理公司和电信工程公司提供工程部所需的协作服务，保证工程建设实施流程的开展； ?在建立工程协作服务模块的基础上，建立工程外部协作系统与邮电设计院、电话监理公司、电信工程公司信息系统的接口，实现工程部与三家实施单位的信息交互与
省系统接口说明范文
附件1： 市级系统接口参考页面 1 说明 本文档是关于……，要求……。已达到……目的。 2 参考页面 第一步 客户端首先要设置web service的连接地址、用户名和密码三项。远程地址固定为：http://124.133.54.21/services/DataService。用户名和密码为省总队分配。 参考界面如下： 帐号：3702-00-01 密码:
第二步 企业填报自己月报数据然后提交。 第三步 市级用户审核企业提交的月报数据。 第四步 市级进入提交审核页面。审核通过的企业将在“企业列表”中显示。将企业选择进“已选企业”。然后点击“上传至省平台”按钮。操作完成。 参考界面如下：
附件2： 山东省节能信息系统数据导入接口协议 1 简介 本协议用于山东省节能信息系统与通过API接入山东省节能信息系统的客户端的数据传输通讯。两者的数据传输通讯采用TCP协议、短连接方式，山东省节能信息系统为服务器方。 缩略语清单： client ：所有通过Web Service接口接入山东省节能信息系统的客户端2 Web Service接口说明 2.1 山东省节能信息系统Web Service地址 WSDL：http://124.133.54.21/services/DataService?wsdl
地址：http://124.133.54.21/services/DataService 2.2 接口说明 2.2.1 i mportYearReportData方法 public String importYearReportData( String loginName, String loginPwd, String cityCode, int year, String reportData) 方法说明： 从各地市系统上传本市已经审核确认的企业年报数据到省系统，如果省系统中企业当年年报数据还未上传过，则添加年报数据，如果年报数据已经上传过，则更新已上传年报数据。 返回值定义：第一行为错误代码，其他行为调用失败时的详细错误信息 ok：数据导入成功 invalidate-city：错误的地市编码 invalidate-date：错误的年份 invalidate-user：访问用户不可用 not-allow-op：用户没有操作权限 illegal-report-data：不合法的报表数据格式 error-report-style：错误的报表样式 error-verify-relations：错误的校验关系 2.2.2 i mportMonthReportData方法 public String importMonthReportData( String loginName, String loginPwd,
http接口说明模板
http接口说明模板
一、查询菜品列表接口(DONE) 1、功能说明 接受提供的菜品 XXX画面XXX功能（比如人口查询画面-查询 | 人口查询画面-详细等） 2、接口调用说明 2.1获取地址 http://192.168.0.6:8080/FamilyServiceSystem/BookDinnerQueryAction?op eration=queryServiceItem 2.2http请求方式 GET 2.3数据返回格式 JSON 2.4传递参数 类型示例描述 参数名称是否 必须 page 是String 1 获取第几个分页的菜 品，默认第一个分页 为1
pageSize 是String 5 每页显示多少个菜 品，默认为5 isFood 是String true 查询食物还是饮料， 查询食物为true 饮料为false 饮料和食物为空 2.5成功返回结果 [ “serverResponse”:”Success”, “totalRecords”:”52”, “page” : “10”, “pageSize” : “5”, “data”：{ “id” : “123”, “itemName” : “皇堡”, “priceNow” : “10”, “pricePast” : “12”, “servicePicture” :”s9118668.jpg”, “serviceStars” : “3” }, ……. { “id” : “”, “itemName” : “”,
“priceNow” : “”, “pricePast” : “”, “servicePicture” :” s9118668.jpg”, “serviceStars” : “3” } ] 2.6返回结果解释 参数名称类型描述备注 page String 当前返回的 是第几页 id Int 菜品编号itemName String 菜品名字priceNow String 现价 pricePast String 原价servicePicture String 菜品图片 serviceStars String 菜品星级
软件系统之间的接口方式
软件系统之间的接口方式 ?概述 软件接口是实现一个系统跟另外系统进行信息交互的桥梁，在不同的系统之间，根据系统的关联程度的不同存在紧耦合和松耦合两种：紧耦合要求接口响应反应快，消息不能阻塞；松耦合对响应反应要求比较低。在目前应用中， Socket 、消息队列（Message Queue）、 WebService等都有相应的应用，但是应用中发现各通讯方式有自己固有的特征，“适合的才是最好的”，这是真理。 在接口和系统信息交互的过程中，两种模式使用得很普遍：同步调用和异步调用，同步调用要求接口发出请求消息后必须等待服务端系统的应答消息，接口阻塞直至超时；异步调用则发出请求消息后，接口可以从事其它处理，定时轮询服务端应答消息和消息或事件通知。同步方式简单，但是很容易造成接口阻塞，造成消息积压超时。 ?技术实现 ? Socket 通讯 Socket 通讯相对来说是很古老的通讯方式，也是最常用的通讯方式。 Socket 通讯有阻塞和非阻塞两种方式。在同步方式，采用阻塞编程比较简单，但是为了防止接口阻塞，我们需要设置 Socket 超时，因此可以使用 Socket 的 SELECT 模型（参考如下示例代码）： ReceLen=0; CurReceLen=0; for(;;) { iResult=select(0,&fdread,NULL,NULL,&timeout);
if(iResult==0) { AfxMessageBox("接收应答消息超时!!!",MB_OK|MB_ICONERROR); closesocket(Socket); return FALSE; } CurReceLen = recv(Socket, oBuf+ReceLen, len, NO_FLAG_SET); if((CurReceLen>0) && (CurReceLen != SOCKET_ERROR)) { oBuf[ReceLen+CurReceLen]='\0'; memcpy((char *)&MsgLen,oBuf,sizeof(WORD32)); MsgLen=ntohl(MsgLen); if(ReceLen+CurReceLen==MsgLen) { ReceLen+=CurReceLen; break; } ReceLen+=CurReceLen; }
http接口说明模板
一、查询菜品列表接口(DONE) 1、功能说明 接受提供的菜品 XXX画面XXX功能（比如人口查询画面-查询| 人口查询画面-详细等）2、接口调用说明 2.1获取地址 2.2http请求方式 GET 2.3数据返回格式 JSON 2.4传递参数
2.5成功返回结果 [ “serverResponse”:”Success”, “totalRecords”:”52”, “page” : “10”, “pageSize” : “5”, “data”：{ “id” : “123”, “itemName” : “皇堡”, “priceNow” : “10”, “pricePast” : “12”, “servicePicture” :”s9118668.jpg”, “serviceStars” : “3” }, ……. { “id” : “”, “itemName” : “”, “priceNow” : “”, “pricePast” : “”, “servicePicture” :” s9118668.jpg”, “serviceStars” : “3” } ] 2.6返回结果解释
二、查询广告接口（DONE） 1、功能说明 接受广告图片，目前为一张 2、接口调用说明 2.1获取地址 2.2http请求方式 GET 2.3数据返回格式 JSON 2.4传递参数
2.5成功返回结果 { "serverResponse":"Success", “advertisePicture” : “0f736a68b929b0955b319ebc41336.jpg”} 2.6返回结果解释 三、查询订单列表接口(DONE) 1、功能说明 根据指定的客户id查询订单 2、接口调用说明 2.1获取地址 2.2http请求方式 GET 2.3数据返回格式 JSON
信息系统接口规格说明书-sse
上海证券交易所技术文档 上海证券交易所 新一代交易系统 托管银行（含基金公司）系统接口规格说明书 2016版 上海证券交易所 二○一六年一月
2016年1月对本文档进行了修订。主要修订内容为： （一）盘后文件数据包添加ZQY及IPOGH。 为便于管理和分发，2009年12月对本文档进行了修订。主要修订内容为：（一）文字推敲； （二）格式统一；
1托管银行（含基金公司）接口物理架构 (1) 2托管银行盘后数据文件 (2) 3基金公司盘后数据文件 (3) 4托管银行及基金公司数据文件解密工具 (4) 4.1数据文件解密工具功能 (5) 4.2解密使用示例 (6) 4.3重要提示（FAQ） (6)
1托管银行（含基金公司）接口物理架构
1 上海证券交易所通过单向卫星系统在盘后发送基金公司及托管银行数据文件。如图1，来自核心交易系统、大宗交易系统及固定收益平台的盘后数据文件经过打包加密后，通过单向卫星系统发送到托管银行与基金公司的卫星接收小站。托管银行与基金公司收到此文件后，运行上海证券交易所提供的解密程序，输入预设密码解密并解包出所需数据文件，进行后续处理。 托管银行（基金公司） 上海证券交易所单向卫星发送服务器 核心交易系统大宗交易系统卫星接收小站 固定收益平台 图1 托管银行（含基金公司）接口物理架构 交易过户数据（ghXXXXX.dbf ） 固定收益成交（bjYYYY.dbf ） 打包数据（YYYY.zip ）加密数据（YYYY.sse ） encryptfile 加密卫星发送 加密数据（YYYY.sse ） 打包数据（YYYY.zip ）encryptfile 解密大宗过户数据(dghXXXXX.dbf ） zip 打包 固定收益成交数据仅 限托管银行 图2 托管银行（含基金公司）接口数据流图 2 托管银行盘后数据文件
接口说明
phpcms v9文章模型栏目接口第三版使用手册 一、简介 1、本接口应用于phpcms v9.2.4 - v9.3.3版文章模型栏目文章发布； 2、本接口支持非默认站点发布； 3、本接口支持自动获取关键词、自动提取缩略图、自动摘要、自动分页、自定义字段等功能，详见发布接口部分说明； 4、支持网站后台栏目生成HTML设置； 5、发布时请使用具有管理权限的用户帐号； 6、本接口基于phpcms v9 UTF8版制作，适用于phpcms v9 GBK/utf-8等版本，应用于其他版本时请自行测试调整； 7、在phpcms v9 utf8版使用本接口时，请在发布规则中选择编码为UTF-8； 8、接口文件无须任何改动即可使用，如果你希望增加校验或其他功能，请仔细修改； 9、2个接口文件请复制在phpcms v9网站根目录下使用； 二、安装接口 在接口文件夹中找到接口文件，如图： 请将etchk_cms.php、etpost_cms.php等接口文件上传到指定目录，请使用二进制方式上传，如图： 三、配置发布规则 1、将范例发布规则文本导入ET2发布配置，或使用软件内置发布规则范例，如图：
2、将检查网址和发布网址中的“您的网站”改为您要发布的网站网址，如图： 3、在检查网址填上您的栏目ID，如图： 4、在检查网址填上您的站点ID，站点ID如留空则默认为1，如图： 5、在参数取值页，填上您要发布的栏目ID和站点ID，如图： 6、在网站后台内容管理-栏目管理处，可以看到各栏目的catid号，如图：
7、在网站后台-设置-站点管理中，可以查看站点ID，如图： 8、填上您的账号、密码，注意格式和账号权限，如图：
接口设计说明(IDD)
接口设计说明(IDD) 说明： 1.《接口设计说明》(IDD)描述了一个或多个系统或子系统、硬件配置项HWCI、计算机软件配置项CSCI、手工操作或其他系统部件的接口特性。一个IDD可以说明任何数量的接口。 2.IDD可用于补充《系统/子系统设计(结构设计)说明》(SSDD)、《软件(结构)设计说明》(SDD)和《数据库(顶层)设计说明》(DBDD)。IDD及其相伴的《接口需求规格说明》(IRS)用于沟通和控制接口的设计决策。 接口设计说明的正文的格式如下： 1引言 本章应分以下几条。 1.1标识 本条应包含本文档适用的系统、接口实体和接口的完整标识，(若适用)包括标识号、标题、缩略词语、版本号、发行号。 1.2系统概述 本条应简述本文档适用的系统和软件的用途。它应描述系统与软件的一般性质；概述系统开发、运行和维护的历史；标识项目的投资方、需方、用户、开发方和支持机构；标识当前和计划的运行现场；并列出其他有关文档。 1.3文档概述 本条应概括本文档的用途与内容，并描述与其使用有关的保密性或私密性要求。 1.4基线 说明编写本系统设计说明书所依据的设计基线。
2引用文件 本章应列出本文档引用的所有文档的编号、标题、修订版本和日期。本章也应标识不能通过正常的供货渠道获得的所有文档的来源。 3接口设计 本章应分条描述一个或多个系统、子系统、配置项、手工操作和其他系统部件的接口特性。如果设计的部分或全部依赖于系统状态或方式，则应指出这种依赖性。如果设计信息在多条中出现，则可只描述一次，而在其他条加以引用。如果此信息的部分或全部在别处提供，则此处可以引用。应给出或引用为了理解设计所需的设计约定。 3.1接口标识和接口图 对于1.1中所标识的每个接口，本条应陈述赋予该接口的项目唯一标识符，(若适用)并用名字、编号、版本和文档引用等标识接口实体(系统、配置项、用户等)。该标识应说明哪些实体具有固定的接口特性(因而要对这些接口实体强加接口需求)，哪些实体正被开发或修改(从而已将接口需求施加于它们)。(若适用)可用一个或多个接口图来描述这些接口。 3.x(接口的项目唯一标识符) 本条(从3.2开始编号)应通过项目唯一标识符标识接口，应简要标识接口实体，并且应根据需要划分为几条描述接口实体的单方或双方的接口特性。如果一给定的接口实体本文没有提及(例如，一个外部系统)，但是其接口特性需要在本文描述的接口实体时提到，则这些特性应以假设、或“当[未提到实体]这样做时，[被提到的实体]将……”的形式描述。本条可引用其他文档(例如数据字典、协议标准、用户接口标准)代替本条的描述信息。(若适用)本设计说明应包括以下内容，它们可按适合于要提供的信息的任何次序给出，并且应从接口实体角度指出这些特性之间的区别(例如数据元素的大小、频率或其他特性的不同期望)。 a.接口实体分配给接口的优先级别； b.要实现的接口的类型(如：实时数据传送、数据的存储和检索等)；
接口说明文档
接口说明文档 本文档提供面向openflowjava项目的扩展yang模型说明。yang模型文件（sptn-match.yang&sptn-action.yang）根据CMCC提供的ttp文件书写。 1.Match 1.1.扩展Match相关yang元素的命名方式 本节提供扩展match相关yang元素的命名方式说明，其中粗体部分与ttp文件的映射关系见表1。 identity：”sptnxm-sptnx-“ + Match grouping：”ofj-sptnxm-sptnx-“ +Match+”-grouping” case：Match+”-case-value” 1.2.Match扩展例子 以vlan-dei为例
1.Match field within the class identity sptnxm-sptnx-vlan-dei { base ofoxm:match-field; } 2.value of the match container vlan-dei -values { leaf value { type uint8; } } 3.在openflow-augments: experimenter-id-case中扩展 augment "/ofoxm:oxm-container/ofoxm:match-entry-value/aug:experimenter-id-case" { ext:augment-identifier "ofj-aug-sptnx-match"; choice sptnx-match-entry-value { case vlan-dei -case-value { uses ofj-sptnxm-sptnx- vlan-dei -grouping; } } }