完整的接口解决方案说明书
- 格式:doc
- 大小:934.74 KB
- 文档页数:35
接口设计说明书(软件设计文档范例)接口设计说明书(软件设计文档范例)1.引言1.1 文档目的本文档旨在描述软件系统的接口设计,提供开发人员进行开发和集成工作的指导。
1.2 读者对象本文档适用于软件开发团队、测试人员和其他与系统开发和集成相关的人员。
2.系统概述2.1 系统描述系统为一个类型的软件系统,主要功能包括但不限于、和。
2.2 系统架构系统采用了架构,主要包括以下模块和组件:- 模块1:描述模块1的功能和接口- 模块2:描述模块2的功能和接口-3.接口设计3.1 接口概述系统的接口主要分为内部接口和外部接口,用于不同模块之间的通信和数据传递。
3.2 内部接口3.2.1 模块1接口模块1提供以下接口供其他模块使用:- 接口1:描述接口1的功能和输入输出参数- 接口2:描述接口2的功能和输入输出参数-3.2.2 模块2接口模块2提供以下接口供其他模块使用:- 接口1:描述接口1的功能和输入输出参数- 接口2:描述接口2的功能和输入输出参数-3.3 外部接口3.3.1 数据输入接口系统支持以下数据输入接口:- 接口1:描述接口1的功能和输入参数格式- 接口2:描述接口2的功能和输入参数格式-3.3.2 数据输出接口系统支持以下数据输出接口:- 接口1:描述接口1的功能和输出数据格式- 接口2:描述接口2的功能和输出数据格式-4.接口标准4.1 接口命名规范- 内部接口:采用驼峰命名法,例如getUserName()- 外部接口:采用大写字母和下划线的形式,例如GET_USER_INFO4.2 接口参数规范- 参数类型:根据具体需求确定参数的类型,例如字符串、整数等- 参数命名:采用有意义的命名,易于理解和使用4.3 接口返回值规范- 返回值类型:根据具体需求确定返回值的类型,例如字符串、整数等- 返回值说明:对返回值的含义和可能取值进行详细说明5.附件本文档涉及的附件包括:- 附件1:x- 附件2:x-6.法律名词及注释6.1 法律名词1:定义1- 注释1:x6.2 法律名词2:定义2- 注释2:x7.全文结束。
接口方案模板【接口方案模板】一、背景介绍随着科技的发展和信息化的推进,各个行业之间的系统互联成为了必然趋势。
接口方案作为系统之间数据传输的桥梁,具有重要意义。
本文将探讨一种通用的接口方案模板,以指导接口的开发和实施工作。
二、接口需求分析在设计接口方案之前,首先需要对接口的需求进行全面分析。
根据系统之间的数据交互场景和功能要求,对接口进行详细的需求定义和规划,并确定接口的输入输出参数、数据格式和通信协议等。
三、接口设计原则在设计接口方案时,应遵循以下原则:1.标准化:采用行业通用标准和规范,确保接口的互通性和兼容性;2.简洁性:接口应尽可能简洁明了,减少冗余信息,降低系统开发和维护的成本;3.安全性:采取必要的安全措施,确保数据传输和处理的安全性和机密性;4.可扩展性:考虑到未来需求的变化,设计接口具备一定的可扩展性,方便后续的功能升级和拓展。
四、接口方案模板下面是一个通用的接口方案模板示例:1.接口基本信息接口名称:接口版本:接口类型:接口描述:接口文档更新记录:2.接口功能功能描述:输入参数:输出参数:3.数据格式数据传输格式:数据编码格式:数据协议:4.安全措施身份验证方式:访问权限控制:5.错误处理错误码定义:错误处理机制:6.性能指标接口响应时间:并发处理能力:7.接口测试测试用例:测试环境:测试步骤和结果:五、接口实施与测试在实施和测试阶段,需要按照接口方案进行开发和部署,并进行全面的测试,包括单元测试、集成测试和系统测试等。
确保接口在各个环节的稳定性和正确性。
六、接口后续维护接口的维护是一个长期的过程,需要及时响应和处理接口的问题和需求变更。
在接口正式上线后,建立完善的问题反馈机制和变更管理流程,确保接口的稳定性和可靠性。
总结:本文介绍了一个通用的接口方案模板,旨在指导接口开发与实施工作。
在具体应用时,可以根据实际需求进行适当的调整和扩展。
接口方案的设计和实施对于不同系统之间的数据交互具有重要的意义,可以提高系统的交互效率和数据的准确性,为企业的信息化建设提供有力的支持。
3Universal TR SeriesContentsDescription PageUniversal TR SeriesProduct Selection . . . . . . . . . . . . . . . . . . . . . . .V7-T3-177Technical Data and Specifications . . . . . . . . . .V7-T3-177Wiring Diagrams . . . . . . . . . . . . . . . . . . . . . . .V7-T3-178Dimensions . . . . . . . . . . . . . . . . . . . . . . . . . . .V7-T3-179TR Series . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .V7-T3-180TMR5 Series . . . . . . . . . . . . . . . . . . . . . . . . . . . . .V7-T3-183TMR6 Series . . . . . . . . . . . . . . . . . . . . . . . . . . . . .V7-T3-187TMRP Series . . . . . . . . . . . . . . . . . . . . . . . . . . . . .V7-T3-189Universal TR SeriesProduct DescriptionEaton’s Universal TR Seriestimers are our most flexibleand cost-effective timingrelays available. Products areavailable with up to sevenuser-selectable functions andseven user-selectable timeranges. Each unit is DIN railmountable with a directconnection, eliminating theneed for additional sockets.The Universal TR Seriestimers are available in SPDTand DPDT contactconfigurations, and have acompact IEC-style footprintand a universal input voltagerange for AC and DCapplications.Application DescriptionA timing relay is a simpleform of time-based control,allowing the user to open orclose the contacts based ona specified timing function.The Universal TR Seriestimers are equipped with aset of selector switches,which can easily be set to aspecific function and time,thereby reducing the numberof product variations required.The universal input voltage(either 12–240 Vac/Vdc or24–240 Vac/Vdc, dependingon the model) furtherreduces the number ofproduct variations.The Universal TR Seriestimers are ideal for high-variability operations, suchas systems integrators,distributors, and smallequipment manufacturers.The compact design savespanel space, and the lowcost and high flexibility ofthe units reduce inventoryrequirements.Features●Multiple user-selectabletiming functions and timingranges in a single unitreduce product variationsand stock keeping units(SKUs)●Universal input voltagesfrom 12 or 24 to 240 Vac orVdc eliminate the need toorder and stock separatecoil voltages●Compact, DIN railmountable case reducespanel size●Advanced LED indicationmakes troubleshootingeasy●Staggered terminallocations allow accessto lower-level terminalsafter wiring●SPDT or DPDT contactswith 8A ratingsStandards and Certifications●cULus listed●CE marked●RoHS compliant●IEC/EN 618123T iming RelaysProduct SelectionUniversal TR Timing RelaysTechnical Data and SpecificationsUniversal TR Timing RelaysNote1Refer to Function Code Cross-Reference Guide on Page V7-T3-171 for function details.Supply Voltage DescriptionCatalog Number4-Function 24–240 Vac/Vdc Compact DIN rail mount, SPDTTRL047-Function 24–240 Vac/Vdc Compact DIN rail mount, SPDT TRL0712–240 Vac/VdcCompact DIN rail mount, DPDT TRL27Asymmetrical pulse generator, DPDTTRW27Single-Pole ModelDescription TRL04TRL07TRL27TRW27Functions 1E, R, Wu, Bp E, R, Wu, Bp, Ws, Wa, Es E, R, Wu, Bp, Ws, Wa, Es Ii, Ip, ER, Ewu, Ews, WsWa, Wt Time range 0.05 sec to 100 hours0.05 sec to 100 hours0.05 sec to 100 hours0.05 sec to 100 hoursInput Supply voltage 24–240 Vac/Vdc 24–240 Vac/Vdc 12–240 Vac/Vdc 12–240 Vac/Vdc Rated supply frequency +10% /–15%+10% /–15%±10%±10%Rated consumption 4 VA (1.5W) 4 VA (1.5W) 6 VA (2W) 6 VA (2W)Duty cycle 100%100%100%100%Reset time 100 ms 100 ms 100 ms 100 ms Residual ripple for DC 10%10%10%10%dropout voltage >30% of rated supply voltage >30% of rated supply voltage >30% of rated supply voltage >30% of rated supply voltage Overvoltage category III (in accordance with IEC 60664-1)III (in accordance with IEC 60664-1)III (in accordance with IEC 60664-1)III (in accordance with IEC 60664-1)Rated surge voltage 4 kV4 kV4 kV4 kVOutputContact configuration SPDT (one changeover contact)SPDT (one changeover contact)DPDT (two changeover contacts)DPDT (two changeover contacts)Rated voltage 250 Vac250 Vac250 Vac250 VacSwitching capacity 2000 VA (8A/250V)2000 VA (8A/250V)2000 VA (8A/250V)2000 VA (8A/250V)Fusing 8A fast acting 8A fast acting 8A fast acting 8A fast acting Mechanical life 20 x 10^6 operations20 x 10^6 operations20 x 10^6 operations20 x 10^6 operationsElectrical life 2 x 10^5 operations at 1000 VA load, resistive2 x 10^5 operations at 1000 VA load, resistive2 x 10^5 operations at 1000 VA load, resistive2 x 10^5 operations at 1000 VA load, resistiveSwitching frequency Max. 6/min. at 1000 VA resistive load (in accordance with IEC 60947-5-1)Max. 6/min. at 1000 VA resistive load (in accordance with IEC 60947-5-1)Max. 6/min. at 1000 VA resistive load (in accordance with IEC 60947-5-1)Max. 6/min. at 1000 VA resistive load (in accordance with IEC 60947-5-1)Overvoltage category III (in accordance with IEC 60664-1)III (in accordance with IEC 60664-1)III (in accordance with IEC 60664-1)III (in accordance with IEC 60664-1)Rated surge voltage 4 kV4 kV4 kV4 kVControl Signal LoadableYes Yes Yes Yes Maximum cable length 10m10m10m10mTrigger level (sensitivity)Automatic adaption to supply voltageAutomatic adaption to supply voltage Automatic adaption to supply voltage Automatic adaption to supply voltage Minimum control pulse length DC 50 ms/AC 100 msDC 50 ms/AC 100 msDC 50 ms/AC 100 msDC 50 ms/AC 100 ms3Universal TR Timing Relays, continuedT erminal CapacityWiring DiagramsSingle-Pole, Double-Throw Units (SPDT)—TRL04 and TRL07Double-Pole, Double-Throw Units (DPDT)—TRL27 and TRW27Description TRL04TRL07TRL27TRW27AccuracyBase accuracy±1% of maximum scale value±1% of maximum scale value±1% of maximum scale value±1% of maximum scale value Adjustment accuracy<5% of maximum scale value<5% of maximum scale value<5% of maximum scale value<5% of maximum scale value Repetition accuracy<0.5% or ±5 ms<0.5% or ±5 ms<0.5% or ±5 ms<0.5% or ±5 ms Temperature influence<0.01% /°C<0.01% /°C<0.01% /°C<0.01% /°CPhysicalAmbient temperature–25 to 55°C–25 to 55°C–25 to 55°C–25 to 55°CStorage temperature–25 to 70°C–25 to 70°C–25 to 70°C–25 to 70°CRelative humidity15% to 85% (in accordancewith IEC60721-3-3 Class 3K3)15% to 85% (in accordancewith IEC60721-3-3 Class 3K3)15% to 85% (in accordancewith IEC60721-3-3 Class 3K3)15% to 85% (in accordancewith IEC60721-3-3 Class 3K3)Pollution degree2, if built in 3 (in accordancewith IEC60664-1)2, if built in 3 (in accordancewith IEC60664-1)2, if built in 3 (in accordancewith IEC60664-1)2, if built in 3 (in accordancewith IEC60664-1)Housing material Self-extinguishing plastic housing,IP40 rating Self-extinguishing plastic housing,IP40 ratingSelf-extinguishing plastic housing,IP40 ratingSelf-extinguishing plastic housing,IP40 ratingMounting Mounted on DIN rail TS 35 accordingto EN 60715, any positionMounted on DIN rail TS 35 accordingto EN 60715, any positionMounted on DIN rail TS 35 accordingto EN 60715, any positionMounted on DIN rail TS 35 accordingto EN 60715, any position Terminal rating Shockproof terminal connectionaccording to VBG 4 (PZ1 required),IP20 ratingShockproof terminal connectionaccording to VBG 4 (PZ1 required),IP20 ratingShockproof terminal connectionaccording to VBG 4 (PZ1 required),IP20 ratingShockproof terminal connectionaccording to VBG 4 (PZ1 required),IP20 ratingTightening torque Max. 1 Nm Max. 1 Nm Max. 1 Nm Max. 1 NmDescription1 x 0.5 to 2.5 mm2 with/without multicore cable end1 x 4 mm2 without multicore cable end2 x 0.5 to 1.5 mm2 with/without multicore cable end2 x 2.5 mm2 flexible without multicore cable end3T iming RelaysDimensionsApproximate Dimensions in Inches (mm)17.5 mm (TRL04 and TRL07)35 mm (TRL27 and TRW27)。
山东能源财务接口取数公式制作操作手册2023年2月一、安装久其财务提数引擎功能概述:(1)财务数据引擎客户端通过报表界面或者批量提取工具旳功能调用以完毕取数过程, 并且可以通过公式制作工具编辑取数公式, 客户机只安装客户端即可。
(2)操作向导:单击“VASetup.exe”图标, 运行安装程序。
进入安装向导界面, 如下图:图1-1 接口安装向导点击“下一步”, 进入许可协议选择界面。
如下图:图1-2 协议选择选择“我同意此协议”, 点击“下一步”按钮, 进入安装途径选择界面, 如图:图1-3 安装途径选择选好安装途径后, 点击“下一步”, 进入安装模块选择界面, 如图:图1-4 安装模块选择一般旳当地顾客只需选择“客户端安装内容”即可, 选择完毕后, 持续点击“下一步”进入准备安装界面, 如图:图1-5 准备安装点击“完毕”, 开始安装程序, 安装完毕后弹出安装完毕界面, 如图:图1-6 安装完毕点击“完毕”按钮, 完毕安装。
二、制作取数公式点击取数公式制作程序, 会弹出程序登录界面, 如下图:图2-1 登陆界面登录顾客名为组织机构代码, 初始密码为空, 服务器地址为: :9000 点击登录按钮进行登录。
组织机构代码可以进入系统录入界面在单位列表下方勾选进行查询, 如下图显示:图2-2 查询组织机构代码登录到系统后旳界面如下图:图2-3 接口取数在这里可以看见集团旳取数方案, 点击按钮, 可以新建一套我司旳公式方案,如下图:图2-4 新建公式方案点开某张报表, 可以看到如图所示:图2-5 公式编辑双击某个单元格, 如图所示:图2-6 进入公式编辑器点击按钮, 进入公式编辑器, 点击如下图所示:图2-7 登录公式编辑器登录名为组织机构代码, 密码为空, 服务器地址为172.61.7.198, 端口默认为9002,点击“确定”。
图2-8 选择数据源选择与浪潮接口旳数据源gs, 点击“确定”。
图2-9 公式编辑器(1)选择单位(2)选择公式类型(3)选择取数类型(4)填入公告项目(5)点击填入取数公式点击“语法检查”假如公式对旳弹出如下窗口:图2-10 公式对旳(6)取数测试图2-11 取数测试(7)保留当可以纯熟地操作公式制作之后, 可以不用公式编辑器, 直接在粉红色旳单元格上或者体现式栏中写公式即可, 并且系统支持公式旳复制粘贴。
6 接口设计6.1 接口基本要求为保证平台信息交互稳定性、便捷性和可扩展性,管道基础大数据平台服务接口应满足以下基本要求:a)接口对外接入应提供企业级的支持,在系统高并发时提供安全可靠的接入,应防止大量访问以及大量占用资源的情况发生,以实现对信息的全面保护,保障系统的正常运行;b)接口能够实现系统的平滑移植和扩展,在系统并发增加时提供系统资源的动态扩展;c)在进行扩容、新增扩展时,接口应能提供快速、方便、准确的信息交互实现方式;d)应支持跨语言、跨操作系统调用。
6.2 数据格式要求1、字符串遵循GB2312-1980 《信息交换用汉字编码字符集》的相关规定。
2、接口编码方式接口编码主要是对管道大数据平台所提供的调用接口进行统一的编码标识和命名。
本着适用、常用、易理解的原则,接口以帕斯卡命名法(pascal)方式编码,每个单词首字母大写。
3、接口参数格式参数格式规定如下:a)分为请求类参数和响应返回类参数,部分参数只有其中一类;b)所有的请求及响应返回类型可以是JSON,默认的类型在服务器启动参数里设置,也可以通过type=json参数强制指定;c)字段说明应包括参数名称、参数个数、参数类型和值。
4、接口响应格式接口响应的数据基于JSON(成功与失败通用返回)格式,其他要求如下:a)接口响应数据所使用的编码方式必须在返回encoding属性中说明;b)接口响应通用状态码如表1表1 接口响应通用状态码6.3 数据清单6.3.1 数据接口6.3.2 通用功能接口6.4 接口说明6.4.1 数据接口1、应急资源数据●接口描述:应急资源数据●请求参数:●请求类型:GET●响应字段说明2、应急仓库数据●接口描述:应急仓库数据●请求参数●请求类型:GET请求●响应字段说明3、应急队伍数据●接口描述:应急队伍数据●请求参数●请求类型:GET请求●响应字段说明4、传感器实时监测数据●接口描述:传感器实时监测数据●请求参数●请求类型:POST请求●响应字段说明5、城市基础地图数据●接口描述:城市基础地图数据●请求参数●请求类型:GET请求●响应字段说明6、城市行政区划数据●接口描述:城市行政区划数据●请求参数●请求类型:GET请求●响应字段说明6.4.2 通用接口1、镜头操控(1)定点巡查●镜头飞定点调用示例ue4api.camera.FlyTo(_x, _y, _z, _roll, _pitch, _yaw, _callBack, _time= 2);参数说明●停止镜头飞行调用示例ue4api.camera.cancelFlight();(2)镜头切换●设置镜头位置调用示例let options = {destination : new Vector3(36.81, -78.35, 24.4),orientation: new Rotator(0, -15, -46)}ue4api.camera.setView(options);参数说明(3)镜头围绕观察调用示例ue4api.camera.rotate (_time, _degrees, function (data) { (data);});参数说明2、POI点操控(1)添加文字调用示例:初始化let param = {id : 1, //唯一标识,不可重复,ue4x : 1000, //x轴ue4坐标ue4y : 1000, //y轴ue4坐标ue4z : 0,//z轴ue4坐标size : new Vector2(480, 180),//label的大小text : '测试文字',//显示的文字scale : 1,//缩放type : 'Type1',//可选字符串参数:Default,Type1,Type2backgroundColor : new Color(0.266356, 0.467784, 0.021219, 1),//文字框背景色fillColor : DefaultColor.yellow,//文字颜色distanceDisplayCondition : new Vector2(),//预留字段visibility : true//默认是否显示}var obj = ue4api.ObjectFactory.CreateLabel(param);参数说明:显示文字obj.show(true);隐藏文字obj.show(false);移除文字obj.removeFromMap();点选功能ue4api.measure.PickPosition(function (e) { (e);//点选文字的id});框选功能开启框选ue4api.SelectTool.select(function (data) { (data);data.selectedObj;//框选的文字的id数组})关闭框选ue4api.SelectTool.disSelect();(2)添加POI点调用示例:初始化let param = {id : 1, //唯一标识,不可重复,ue4x : 1000, //x轴ue4坐标ue4y : 1000, //y轴ue4坐标ue4z : 0,//z轴ue4坐标image: https:///down/png/1904/food-icons-const/waffles.png,//图片地址scale : 0.5,//缩放clickedScale : 0.7,visibility : true//默认是否显示alertWindow : {//可选,点击弹窗url : "http://localhost/testAlertWindow.html",//弹窗地址size : new Vector2(180, 90),//弹窗大小offset : new Vector2(50,-100)//弹窗位置,右:x正,下:y正}}var obj = ue4api.ObjectFactory.CreateBillboard(param);参数说明:显示POIobj.show(true);隐藏POIobj.show(false);移除POIobj.removeFromMap();点选功能ue4api.measure.PickPosition(function (e) {(e);//点选的点位信息//其中e.clickType做为单击事件,还是双击事件的判断//当单击点选时,e.clickType = 1//当双击点选时,e.clickType = 2});框选功能开启框选ue4api.SelectTool.select(function (data) {(data);data.selectedObj;//框选的文字的id数组})关闭框选ue4api.SelectTool.disSelect();3、路线操控(1)绘制路径调用示例:初始化let param = {id : 1, //唯一标识,不可重复showLength : true,//是否显示总长度pathWidth : 5000,//路径宽度faceScreen : false,//始终面向相机pathColor : DefaultColor.green,//路径颜色data : [new Vector3(-129.99,-7.41,0),new Vector3(-131.00,-134.96,0),new Vector3(113.83,-128.26,0),new Vector3(123.84,-550.99,0)… …]//路径点位数组,ue4坐标}var obj = ue4api.ObjectFactory.CreatePolyline(param);参数说明4、量测功能(1)高度量测调用示例开启量测var temp = ue4api.analysis.getMeasureHeight(function (e) {//回调alert(JSON.stringify(e));});移除量测temp.deleteObject();(2)折线距离量测调用示例开启量测var temp = ue4api.analysis.getDistanceHorizontal(function (e) { //回调alert(JSON.stringify(e));});移除量测temp.deleteObject();(3)平面面积量测调用示例开启量测var temp = ue4api.analysis.getPlaneArea(function (e) {//回调alert(JSON.stringify(e));});移除量测temp.deleteObject();(4)获取坐标调用示例开启获取坐标ue4api.measure.PickPosition(function (e) {alert(JSON.stringify(e));//e. objectName:模型内部编号//e. location:点击点位的ue4坐标});**拾取:左键双击**取消:右键单击5、特殊效果(5)时间特效调用示例ue4api.environment.ShowEffect(param);参数说明ue4api.environment.ShowEffect('evening'); 移除特效调用示例ue4api.environment.DisableEffect(param);参数说明同上指定时间调用示例ue4api.environment.SpecificTime(time);参数说明ue4api.environment.SpecificTime('8:15');(6)热力图特效调用示例let param = {id:1, //唯一标识,不可重复bbox: new bounds(-105000, 105000, 105000, -105000),//热力图覆盖区域边界,ue4坐标,(西,东,南,北)height:1000,//热力图整体高度data:[{x:0,//热力点ue4坐标y:0, //热力点ue4坐标value:0.8,//热力值,0~1radius: 5000//热力点范围},{x:500,y:500,value:0.5,radius: 3000}… …]}let heatObj = ue4api.ObjectFactory.CreateHeatmap(param);参数说明显示heatObj.show(true);隐藏heatObj.show(false);移除heatObj.removeFromMap();6、组件控件(1)柱状统计调用示例1、初始化let param = {id : 1, //唯一标识,不可重复value : 500,//值,必填buildingName :"SM_Building_20",//ue4中的建筑名称,可通过PickPosition获取location: new Vector(0,0,1000),//此参数跟buildingName二选一,指定柱状位置uintValue : 100,//单位高度代表的值,默认2500uintHeight: 1000,//单位高度,默认1000radius: 500, //柱子半径,默认500fontSize: 24,//显示数字大小,默认24divideValue : [150,450],//分组值,长度可变divideColor : [new Color(0.266356, 0.467784, 0.021219, 1), new Color(0.8125, 0.450415, 0, 1), new Color(0.817708, 0.017036, 0.017036,1)] //分组颜色,长度比divideValue多一个}ue4api.View.CreateStatisticCylinder(param);参数说明2.显示柱状obj.show(true);3、隐藏柱状obj.show(false);4、移除柱状obj.removeFromMap();。
接口设计说明书修订历史记录目录0.模板说明 (4)0.1编写目的 (4)0.2适用范围 (4)0.3术语定义 (4)1.说明 (4)2.新增接口 (4)2.1新增对象so*** (4)2.1.1说明: (4)2.1.2属性 (4)2.1.3方法 (5)3.修改接口 (5)3.1修改控件:Super*** (5)3.1.1新增接口 (5)3.1.2修改接口 (5)3.2修改对象so*** (6)3.2.1新增接口 (6)3.2.2修改接口 (6)3.3修改常数 (7)3.3.1新增常数 (7)3.3.2修改常数 (7)0.模板说明0.1编写目的[本报告的主要目的:本报告相关流程活动]0.2适用范围[本报告适用范围(角色、部门、岗位、人员)使用本报告的约束条件本报告不适用的领域]0.3术语定义[列出本报告中所使用的所有术语和缩略语。
可引用已有的数据字典,如没有则需要在此列出。
例如:参见《数据字典.doc》术语——列出在本报告中用到的关键词和专用词,并给出其含义;缩略语——列出在本报告中用到的所有缩略语,并给出中英文全称;另外在正文中缩略语首次出现处要给出中英文全称。
]1.说明[SuperMap Objects(COM)的接口设计采用此说明书,其他产品,如SuperMap Objects .NET、SuperMap Objects Java、SuperMap IS Java和SuperMap IS .NET等产品由于采用Java和.NET技术,接口可以通过先写完接口定义代码,然后通过集成环境自动生成相应接口说明文档。
其他产品如果需要制定接口设计说明书,则可以参考本说明书制定。
]2.新增接口2.1新增对象so***2.1.1说明:2.1.2属性2.1.3方法3.修改接口3.1修改控件:Super***3.1.1新增接口属性方法事件3.1.2修改接口属性方法事件3.2修改对象so*** 3.2.1新增接口属性方法3.2.2修改接口属性方法3.3修改常数3.3.1新增常数3.3.2修改常数。
num1060控制器接口说明书摘要:1.控制器接口说明书简介2.控制器接口概述3.控制器接口功能4.控制器接口信号描述5.控制器接口连接方式6.控制器接口操作流程7.控制器接口示例8.控制器接口常见问题及解决方案9.控制器接口技术支持正文:um1060控制器接口说明书1.控制器接口说明书简介本说明书详细介绍了num1060控制器的接口设计、功能、连接方式、操作流程等,旨在为使用num1060控制器的工程师和技术人员提供参考和指导。
2.控制器接口概述um1060控制器接口分为输入接口和输出接口。
输入接口用于接收外部信号,输出接口用于输出控制信号。
控制器接口采用标准化设计,便于与其他设备连接。
3.控制器接口功能um1060控制器接口具有以下功能:- 数据输入:接收外部传感器、开关等设备的数据信号。
- 数据处理:对输入数据进行处理,生成控制信号。
- 数据输出:将生成的控制信号输出给执行器、显示器等设备。
4.控制器接口信号描述输入接口信号包括:- 传感器信号:模拟信号或数字信号。
- 开关信号:数字信号,表示设备的开关状态。
输出接口信号包括:- 控制信号:模拟信号或数字信号,用于控制执行器、显示器等设备。
5.控制器接口连接方式控制器接口采用标准接插件,可以与其他设备进行方便连接。
连接时,请注意以下几点:- 确保接插件接触良好。
- 接线顺序应与接线图一致。
- 使用合适的接线材料,避免信号干扰。
6.控制器接口操作流程控制器接口操作流程如下:- 连接输入设备:将传感器、开关等设备的信号线接入控制器输入接口。
- 连接输出设备:将执行器、显示器等设备的信号线接入控制器输出接口。
- 接通电源:给控制器供电。
- 设置参数:通过编程或拨码开关设置控制器的参数。
- 运行系统:控制器开始工作,处理输入数据并输出控制信号。
7.控制器接口示例以下是一个简单的控制器接口示例:输入接口:- 温度传感器:模拟信号,范围0-100℃。
- 压力开关:数字信号,表示压力是否超过设定值。
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-300.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字典类型10网页地址11Web Service接口11.1接口命名规范11.2输入参数11.3输出参数11.4外协系统提供的其他接口12附录:待定问题1引言1.1编写目的本文档为XX电信工程外部协作系统(以下简称外协系统)与电信工程施工单位内部系统(以下简称施工系统)接口技术解决方案,以此作为外协系统与施工系统实施接口的技术方案依据和项目设计标准。
NC接口解决方案和思路NC(NCS)是一种基于云计算和虚拟化技术的新一代计算平台,提供了一种全新的数据中心和企业级应用的解决方案。
NC接口解决方案的主要目标是提高运营效率、降低成本、增强安全性和灵活性。
在本文中,将详细介绍NC接口解决方案的思路和实施步骤。
一、NC接口解决方案的思路1.确定需求:首先,确定组织或企业的需求,并分析该需求是否适合采用NC接口解决方案。
需求可能包括数据中心的扩展、提高IT运维效率、降低成本、强化信息安全等。
2.设计架构:根据需求,设计NC接口解决方案的架构。
该架构应该考虑到数据中心的规模、业务需求、安全性和可扩展性等因素。
在设计架构时,需要选择合适的硬件设备、网络设备和软件工具。
3.实施部署:根据架构设计,实施NC接口解决方案的部署。
这包括购买、安装和配置所需的硬件设备、网络设备和软件工具。
在部署过程中,需要确保各个组件的正常运行,并进行必要的测试和调优。
4.数据迁移:如果NC接口解决方案是用于现有的数据中心或企业级应用,则需要进行数据的迁移。
数据迁移应该确保数据的完整性和安全性,同时最小化对业务的影响。
可以利用数据迁移工具和技术来简化数据迁移过程。
5.测试和验证:在部署完毕后,需要对NC接口解决方案进行全面的测试和验证。
这包括功能测试、性能测试、安全性测试和故障恢复测试等。
通过测试和验证,可以确保NC接口解决方案的稳定性和可靠性。
6.管理和维护:一旦NC接口解决方案正式投入使用,需要对其进行管理和维护。
管理和维护包括监测系统状态、定期备份数据、进行安全修复和升级等。
此外,还可以利用监控工具来实时监测系统的性能和可用性。
二、NC接口解决方案的实施步骤1.确定需求:首先,明确组织或企业的需求,例如数据中心的扩展、提高IT运维效率、降低成本等。
2.设计架构:根据需求,设计NC接口解决方案的架构。
这包括选择合适的硬件设备、网络设备和软件工具,并确定其部署位置和连接方式。
3.购买设备和软件:根据架构设计,购买所需的硬件设备、网络设备和软件工具。
完整的接口解决方案说明书随着业务的不断扩展和用户的不断增加,各种软件系统也就越来越复杂,单一的功能已经不能满足用户需求。
为了满足用户的需求和提升软件系统的可维护性,很多企业开始寻找一种全面的接口解决方案。
这篇文章就是要给大家介绍一种完整的接口解决方案。
一、概述简单地说,一个接口解决方案就是一个软件系统提供的接口的统称。
这个解决方案的主要作用是将所有的接口封装起来,统一管理。
提供一个标准的、可靠的、高效的接口,以方便用户使用和维护。
二、接口解决方案的组成接口解决方案通常由以下四个组成部分:1. 接口集成器:负责将多个接口整合到一个系统中。
这个组件要处理各种不同格式的数据,并将它们转换为统一的格式,以便于系统统一管理和监控。
2. 接口管理器:主要负责接口的管理和监控。
接口管理器要监控接口的运行状态,在出现异常的情况下能够及时通知相关人员,并提供相应的接口日志和统计信息。
3. 接口开发工具:通常是一个IDE,用于开发、测试和部署接口。
4. 接口文档:包括接口规范、接口测试文档、接口示例程序等。
这些文档能够帮助用户熟悉接口的使用方法,同时还提供了开发接口的一些规范和标准。
三、接口解决方案的特点一个完整的接口解决方案应该具备以下的特点:1. 具有开放性和可扩展性。
一个好的接口解决方案应该是开放的,并可以扩展和定制。
它应该能够支持多种开放标准,支持多种数据格式,同时能兼容各种系统和平台。
2. 高效性。
接口的调用应该是高效的,能够满足高并发和大量请求的情况。
3. 健壮性和可靠性。
接口解决方案要具备健壮性和可靠性,以保证系统稳定运行。
此外,系统应该具备异常处理机制,可以快速定位和解决问题。
4. 易用性和易维护性。
接口解决方案应该易于使用和维护。
它应该提供友好的用户界面,方便用户管理和监控接口。
同时,它也应该具备良好的文档和培训资料,以帮助用户更好地使用和维护系统。
四、接口解决方案的应用场景一个完整的接口解决方案通常应用于以下几个方面:1. 企业内部系统集成。
中国移动短信网关SP端接口使用手册China Mobile Shot MessageGateway 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。
DESIGNWARE IP数据手册/designware 简介借助DesignWare® 嵌入式USB 2.0 (eUSB2) PHY、eUSB2中继器、USB数字控制器、验证IP和IP子系统方面的专业知识,新思科技为设计人员提供了适用于低功耗移动和消费类产品的USB 2.0 IP解决方案,例如采用业界最先进工艺节点设计的智能手机、平板电脑、笔记本电脑、游戏和 AR/VR,以及无线设备。
USB Type-C“Chip to World”“Chip to World”图1:eUSB2用例业内最先进的工艺节点不支持USB 2.0规范要求的3.3V信号和5V容限。
3.3V 信号最初在1994年的USB 1.0规范中定义,需要向后兼容。
eUSB2 规范为低功耗芯片间通信定义了新的更低电压的USB信号。
eUSB2中继器在标准USB 2.0和eUSB2信号电平之间转换,允许旧有USB 2.0设备与配有eUSB2 PHY的片上系统 (SoC) 连接。
DesignWare USB IP的设计依托客户多年来使用新思科技通过硅晶验证的USB PHY产品线取得的成功,而且该产品线已移植到180nm 到 5nm 的100多个工艺节点中。
通过与DesignWare主机、设备或双角色数字控制器结合使用,并使用新思科技的验证IP进行验证,DesignWare eUSB2 IP可为高级SoC设计提供完整的USB 2.0解决方案。
要点• 符合eUSB2 1.1规范• 可用于USB主机、设备和双角色应用中• eUSB2 PHY和eUSB2中继器支持 USB2.0 480Mbps(高速)、12Mbps(全速)和 1.5Mbps(低速)数据速率• eUSB2 PHY专为不支持3.3V信号和5V容限的最先进工艺节点而设计• eUSB2 PHY接口:UTMI+ 3级规范• eUSB2中继器专为支持3.3V信号和5V容限的成熟工艺节点而设计目标应用• 智能手机• 平板电脑• 轻薄型 PC 和混合型 PC• 笔记本和台式电脑• 游戏、AR/VR• 高级无线设备(5G调制解调器、WiFi 6)技术• eUSB2 PHY: 5nm, 7nm• USB2中继器:28nm eUSB2 IP解决方案eUSB2 PHY IP特性• 专为高级工艺节点(7nm及以下)设计• 最大限度地减少由于工艺、电压、温度、封装和板卡寄生参数的变化而产生的影响• 支持USB 2.0 480Mbps(高速)、12Mbps(全速)和1.5Mbps(低速)数据速率• 与新思科技的DesignWare USB 2.0、3.0、3.1和3.2主机、设备及双角色控制器连接• 最低功耗:对于用于eUSB2 芯片间通信的高级移动设备,可延长电池寿命Transceiver Common图2:eUSB2 PHY框图eUSB2中继器IP特性• 在eUSB2和USB 2.0信号电平间转换,使配有eUSB2 PHY的SoC能够与旧有USB 2.0产品连接• 专为成熟工艺节点而设计• 可集成到PMIC、音频、Wi-Fi、组合式无线芯片中,或作为独立(多端口)中继器芯片实施• 支持USB 2.0 480Mbps(高速)、12Mbps(全速)和1.5Mbps(低速)数据速率• 高级内置自检 (BIST)、可调性和诊断图3:eUSB2中继器框图2USB控制器IP特性• DesignWare USB 2.0、3.0、3.1和3.2数字控制器与DesignWare eUSB2 PHY兼容验证IP特性• 支持USB 3.2、3.1、3.0、2.0和 eUSB2• 100%原生SystemVerilog• 主机、设备和集线器仿真• 内置覆盖和验证计划• 全面的回调、消息处理和错误注入• 与Verdi Protocol Analyzer 3集成• 协议层–控制、中断和ISOC–数据突发–SuperSpeed批量数据流–LMP、SOF和ITP生成• 链路层–具有完全控制权的L TSSM可在任何状态启动–SuperSpeed电源管理–电缆连接和断开–速度增大和减小–测试模式• PHY层–SuperSpeed PIPE,与时钟恢复同步–USB 2.0 UTMI、ULPI接口IP子系统专业知识特性• 通过新思科技IP协议和SoC设计专家根据独特的SoC要求而配置和定制USB子系统,满足严格的项目进度要求• 通过专门针对SoC集成的子系统和验证测试,最大限度地减少子系统集成工作量同时使设计人员能够专注于发挥关键技能• 降低总体开发成本,©2021 Synopsys, Inc. All rights reserved. Synopsys is a trademark of Synopsys, Inc. in the United States and other countries. A list of Synopsys trademarksis available at /copyright.html . All other names mentioned herein are trademarks or registered trademarks of their respective owners.08/31/21.CS743817698 eUSB2 DS simplified chinese.。
接口类型设计要求1.取得一
致性
类似的情
况应该有
让使用者
有一致性
的操作。
在提示、
选单与说
明文件
中,应该
采用同样
的名词。
并且保持
命令的一
贯性。
2.提供有
意义的回
馈
接口在调
用过程
中,所返
回的返回
值的必须
是有意义
和易于处
理的。
3.容错性
所有接口
在设计过
程中,必
须考虑到
全部的可
能产生的
错误并对
这些错误
做出处理
并体现在
返回值中。
所有接口
必须对传
入参数的
有效性进
行检查,
并体现于
返回值
中.
4.友好性
所有的接口中,必须对属性和方法做出
<summary >注释,便于调用者查阅5.安全性所有的接口模块,不允许开启异步的多线程,避免因为异步而产生的意外错误.。
目录总纲 (2)Web Service 概述 (2)Web Service接口定义 (3)1.int upLoadRawData (3)2.int upLoadMediaFile (5)3.int delPTable (5)4.int insertPTable (6)5.int ChkPTable (6)6.RetString GetNextVVehID (7)7.RetCollection getInputorUser (7)8.RetCollection getAction (8)9.RetCollection getSpot (8)10.RetCollection getSource (9)11.RetCollection getDist (9)12.RetCollection getHpzl (10)13.RetCollection getConMode (10)14.RetCollection getCodePlace (10)15.RetCollection getDiverDir (11)16.RetCollection getCameraDir (11)17.RetCollection getCamera (12)18.RetCollection getLane (12)客户端调用Web Service示例 (13)接口调用流程 (18)1、准备工作 (18)2、违法上传过程 (19)3、数据重复性检查 (20)附录 (21)1、BASESPOTDB[设备组表] (21)2、系统提供的WebService列表 (21)3、违法代码 (22)4、车道类型列表 (25)5、返回值类型定义 (25)Web Service 接口说明总纲本文描述如何调用项目Web Service:1、Web Service 概述2、Web Service接口定义3、客户端调用Web ServiceWeb Service 概述Web Service是为实现“基于web无缝集成”的目标而提出的全新概念,希望通过Web Service能够实现不同的系统之间能够用“软件-软件对话”的方式相互调用,打破软件应用、网站和各种设备之间格格不入的状态。
HC-ICE10-M接口转换器使用说明书山东华辰泰尔科技发展有限公司Hctel Science &Technology Corporation, Ltd. 版本:1.0目次第1章概述 (1)第2章产品特点 (1)第3章技术指标 (2)3.12M接口 (2)3.2LAN接口 (2)3.3桥接性能 (2)3.4网管性能 (3)3.5结构尺寸: (3)3.6工作电源: (3)-48VDC(-36~-72VDC),220V(165~240V)交流任选 (3)3.7整机功耗:台式设备小于5W,机框式满配置小于30W (3)3.8环境温度:-5~+45℃ (3)第4章告警指示及结构说明 (3)4.1机框式设备 (4)4.2电源板(如图2) (4)4.3控制板(如图3) (5)4.4RJ45网桥插卡(如图4) (6)4.5台式设备 (7)第5章典型应用 (9)第6章系统安装说明 (10)第7章常见故障排除 (12)附: HC-ICE10-M网管系统使用说明书 (13)第1章概述1)HC-ICE10-M是一种网管型高性能、自学习式远程以太网网桥。
该设备完成以太网和E1之间的协议转换,从而使10BASE-T 信号可以通过2M传输链路进行传输。
HC-ICE10-M有台式和机框式两种。
一般在中心局端使用机框式设备,在用户端使用台式设备。
机框式设备采用19英寸标准3U结构,电源采用双电源热备份,一个机框最多可容纳16块HC-ICE10-M插卡。
设备网管系统(HCView-NB-110)可以实现对16个机框多达256对网桥设备的管理,包括网桥状态的实时监测,2M线路误码的在线测试,自环的设置等。
2)HC-ICE10-M 适用于组建远程局域网,也可用于INTERNET 接入。
目前该设备以其优良的性能价格比已被中国电信计费工程大量应用。
第2章产品特点(1)与IEEE 802.3完全兼容(2)过滤和转发速率达每秒15,000帧(3)256帧的缓冲器(4)10,000MAC地址局域网表(5)自动学习和更新功能(6)增强的TinyGram压缩格式(7)线路传输协议:HDLC(8)广域网2M 接口的电气特性符合ITU-G.703建议(9)网管操作界面直观,友好(10)网管系统提供实时的网桥状态监测, 2M线路误码的在线及自环测试(11)盒式设备-48V 直流供电与220V交流供电同时提供,用户可随意选择第3章技术指标3.12M接口1)速率:2048KB/S±50ppm2)码型:HDB33)阻抗:75/120Ω可选4)连接器:RJ45(台式、卡式)3.2LAN接口1)10BASE-T UTP接口2)连接器:RJ45,DTE接口3.3桥接性能1)过滤和转发速率达每秒15,000帧2)256帧的缓冲器3)10,000MAC地址局域网表4)自动学习和更新功能5)增强的TinyGram压缩格式6)广域网线路传输协议:HDLC7)桥接速率: 1984KB/S3.4网管性能1)管理协议:ENMP、并支持SNMP标准管理协议2)管理接口:RS232接口,物理接口为RJ453)数据格式:9600B/S、8位数据位、1位停止位4)网管信道:带内5)软件环境:Microsoft windows98/2000/NT6)功能:设备状态实时监测,线路误码的在线及自环测试等3.5结构尺寸:1)机框式设备采用19英寸3U标准结构2)台式设备:宽×高×深= 175×44×200(mm)3.6工作电源:-48VDC(-36~-72VDC),220V(165~240V)交流任选3.7整机功耗:台式设备小于5W,机框式满配置小于30W 3.8环境温度:-5~+45℃第4章告警指示及结构说明4.1机框式设备1、前面板(如图1)图1:前面板1)电源指示----48V----–48V 直流(或220V交流) 输入指示灯。
XXXXXX信息科技股份有限公司1引言1.1编写目的本文档为XX电信工程外部协作系统(以下简称外协系统)与电信工程施工单位内部系统(以下简称施工系统)接口技术解决方案,以此作为外协系统与施工系统实施接口的技术方案依据和项目设计标准。
1.2覆盖范围XX电信工程外部协作系统项目组施工系统接口开发技术组1.3预期读者与阅读建议XX电信企业信息化部XX电信工程建设部XXXX公司开发人员施工系统开发人员1.4文档约定粗体正文表示强调内容红色正文表示未完成或需要今后考虑的内容蓝色正文表示待讨论内容1.5术语与缩略语1.6参考文献(XXXX)2概述建设XX电信工程外部协作系统的目标,是在工程项目的管理、建设、使用和实施单位之间搭建起数据交换和协同工作的信息平台,延伸与拓展工程建设管理信息化的应用范围,实现通信工程建设过程的信息化管理,促进工程项目的管理部门、建设部门、实施部门和使用部门之间业务流程协调有序地开展,实现工程项目设计、施工、监理管理功能,将相关的设计、施工、监理单位纳入到工程建设管理中,完善工程项目建设过程管理体系,通过信息化推动管理的规范化,在信息化的应用过程中不断探索市场环境下工程建设管理的新思路和新方法。
根据工程部业务工作的实际情况,项目首先满足工程建设管理中应用最广泛、问题最突出的基本需求。
项目功能需求包括:➢建立工程外部协作系统与MSS等系统的接口;➢建立设计协作服务、监理协作服务、施工协作服务模块,为邮电设计院、电话监理公司和电信工程公司提供工程部所需的协作服务,保证工程建设实施流程的开展;➢在建立工程协作服务模块的基础上,建立工程外部协作系统与邮电设计院、电话监理公司、电信工程公司信息系统的接口,实现工程部与三家实施单位的信息交互与业务协作;本技术解决方案就是针对实现工程建设部与三家实施单位信息交互与业务协作接口中施工单位接口的技术解决方案的组成部分。
在接口的调用过程中,存在施工系统调用外协系统接口的情况,这时候,施工系统作为客户端,外协系统作为服务端;也存在外协系统调用施工系统的情况,这时候,外协系统作为客户端,施工系统作为服务端。
本方案中,除了特殊另外说明外,不考虑外协系统和施工系统角色换位的问题。
如果一方发起了调用,那么它就是客户端,另一方就是服务端。
反之亦然。
4 接口方式◆工程外协系统与施工系统之间的接口采用Web Service接口形式来进行业务数据的交互。
◆接口数据传输采用XML数据交换格式,utf-8编码。
◆在外协系统中提供Web Service的API接口。
提供由施工系统调用获得信息;并且提供施工系统提交信息的API接口。
◆同样,在施工系统中提供Web Service的API接口。
提供由外协系统提交信息的API接口。
◆考虑到工程外协中的数据信息不仅包括了XX电信工程公司的数据而且还包含了其他的施工单位的数据信息。
而这些单位也各有其各自工程应用系统。
这样,外协系统对各个施工单位系统所提供的接口API及其参数信息、格式均是统一的。
同时,也要求各个施工单位所提供的接口API及其参数、格式等也必须要求统一。
外协系统与施工系统属于一对多的关系。
◆外协系统要求能够有目的,信息有过滤的把业务信息通过接口正确的发送给相应施工系统接口。
非相关的信息不要发送给对应的施工系统。
◆施工系统建立用户映像对照表、字典对照表、单位对照表等数据映像,传递给外协的数据使用的是映像中转换后的外协系统能够识别数据;同时,接收到的数据也根据对照表转换成各自能够解释的数据格式。
◆数据初始化的时候,由施工系统主动调用外协系统的接口,以获得用户信息、字典信息、单位信息、项目信息等基础信息。
以后,一旦发生数据的变动,由外协系统主动往施工系统发送信息。
◆外协系统不主动请求施工系统获得数据,但是外协系统会主动请求施工系统发送数据。
◆施工系统主动请求外协系统获得数据,也会主动请求外协系统发送数据。
4接口安全4.1接口认证调用认证:虽然接口双方都是存在于电信内部网络中,但是,仍不能排除接口服务被攻击、恶意调用以及非法调用等。
所以,从接口调用上,必须考虑调用的认证安全问题。
◆本方案中的接口,在客户端调用服务端的时候,必须经过调用身份认证。
考虑施工系统的开发平台的多样性,但同时接口服务运行平台都是Windows的情况,本方案采用Windows安全身份认证的方式。
即在访问接口所在的服务的时候,都必须进行资格审查(使用Credentials发送认证信息)。
◆另外,接口采用SOAP协议,因此在接口配置上面需要屏蔽HTTP GET 和HTTP POST等其他协议。
◆在接口中审核并进行日志的记录。
◆使用最低权限的进程帐户运行 Web 服务(通过 Machine.config 中的 <processModel>元素来配置)。
◆接口不支持动态生成WSDL,因此作为服务端,应该禁止文档协议。
◆在服务端禁用跟踪,禁用调式编译业务用户认证:由于接口涉及电信工程中的各个不同的业务,有获取字典、获得项目信息、发送开工报告等,所以,建立一套业务的用户认证机制是必须的。
不同的用户,所具备有的授权不一样,所能执行的业务也不一样。
同时,业务用户认证中的用户信息也是记录接口日志中的重要组成部分。
本方案采用的是在接口信息中包含业务认证用户信息的方式来进行认证。
服务端在收到请求的时候,应先验证业务的授权用户,如果该业务用户没有执行当前业务的权限,应终止业务的执行,并给出非法用户的警告信息反馈回客户端。
一般情况下,业务认证的用户是系统中的用户。
业务认证其实就是应用系统认证的组成部分。
业务认证的用户信息经过加密之后包含在要发送的信息(XML体)中,即在发送的信息中包含业务用户的信息(参见下面的数据格式说明)。
4.2数据安全数据的安全表现为如何保证数据在网络传输过程中不会被截获并被解析其中的内容而引起信息泄露与如何保证数据在传输的过程中的数据的完整性两个方面。
Web Service采用XML数据格式来传输信息。
所以,无论是发送数据还是返回结果,都要求采用对XML数据加密之后来传输。
至于采用何种方式的加密技术,本方案为了保密,只能在开发的时候由开发人员口头告知。
涉及到加密技术就要涉及到加密的密钥问题。
目前,外协系统和施工系统接口上有很多种类型的业务,到底是每种类型的业务采用不同的密钥,还是按分组来采用同一种密钥的方式,还是所有的业务全部采用同一种的密钥的方式,按照需求各有不同的选择。
本方案采用的是最后一种的方式。
密钥的发布由作为服务方来发布,由客户端获取。
密钥的发布方式待定。
为了保证数据的完整性,首先:方案采用数据签名(SOAP Security Extensions: Digital Signature)。
利用XML的数字签名(XML Digital Signature syntax [XML-Signature])对SOAP进行扩展,在SOAP的头元素中定义签名属性(<SOAP-SEC:Signature>)来实现。
其次:限制并验证 Web 方法输入的类型、长度、格式和范围,验证对 XML 输入数据的验证是基于已协商的架构等。
5事务处理事务是一组相关的任务,作为独立于其他任务的独立单元成功(提交)或失败(中止)。
分布式事务是影响多个资源的事务。
要提交分布式事务,所有参与者都必须保证对数据的任何更改是永久的。
不论系统崩溃或是发生其他无法预料的事件,更改都必须是持久的。
即使只有一个参与者无法保证这一点,整个事务也将失败,在事务范围内对数据的任何更改均将回滚。
外协系统和施工系统是处于网络之上的两个分布式接口,使用的是分布式事务。
要启用分布式事务,可能需要通过网络启用 MS DTC(考虑外协平台和施工平台都是运行在Windows 上),以便在使用应用了最新的 Service Pack 的较新操作系统(例如 Windows XP 或Windows 2003)时使用分布式事务。
如果启用了 Windows 防火墙(Windows XP Service Pack 2 的默认设置),必须允许 MS DTC 服务使用网络或打开 MS DTC 端口。
接口中的服务端和客户端的环境事务始终相同,客户端创建的事务上下文并应用对于服务端的当前的事务,以便对于该事务上下文是当前的。
这样的事务会造成性能损失,因为可能需要继承原来的上下文,但是,这样的事务确保了在数据库操作的时候信息的完整性。
接口中事务的发起总是由客户端发起的,并负责事务的提交和回滚等控制。
6性能考虑在接口设计的时候就应该考虑性能上面的问题,不要在事后再加入性能。
同时,在项目的开发过程要反复进行测试,可以从机器的吞吐量和响应时间两个基本的指标来衡量接口的性能。
接口上面的性能考虑主要从下面几个方面来优化:◆使用一次连接,多次调用,优化连接资源。
◆对于并行的接口调用使用异步的调用方式。
◆优化线程池减少竞争。
◆考虑使用XML压缩。
◆如果不需要返回,考虑使用单工通讯的方式。
◆适当的设置(如果有代理)代理超时,页面超时,WebService超时。
◆设计"大块头"的接口减少往返。
◆基于消息的编程而不是远程过程调用(RPC) 。
◆使用XML字串作为参数。
◆尽量使用原始数据类型参数。
◆避免在调用之间维护服务器状态。
◆考虑为复杂的WebMethod提供输入校验。
◆考虑对WebMethod的结果使用缓存。
◆选择适用的大数据包传送方式。
◆避免调用本地的WebService。
7容错处理客户端向服务端发送数据,服务端解析数据,反馈信息给客户端,这中间的环节只要某一个环节出现问题,都会造成接口的失败。
按照失败产生的环节分类,我们可以从三个方面来处理接口的失败。
◆网络连接失败:在调用接口的时候,由于网络不通,造成数据不能正常传输。
这样,客户端应该能够记录发送的日志,按照一定的时间间隔重试发送。
本方案定为重试发送20次,每次时间间隔2小时。
如果一直发生网络不通的情况,该发送日志被保存下来,待后手工发送。
所以,客户端系统应该实现手工发送数据的功能。
◆反馈错误信息:服务端在解析数据包,执行数据包业务的时候,可能会发生异常。
所以,服务端应当能够捕捉异常信息,比如“非法XML格式”等,然后反馈给客户端。
客户端在接受到这类的错误信息之后,应当进行日志记录,能够自动或手工分析异常的信息。
◆网络连接正常,但是无信息反馈:这种情况下,一般是服务端出现了异常,但是又没有捕捉到的情况下发生。
这种情况下,客户端把这种错误当作“网络连接失败”来处理。
服务端应能够实现相同数据包重新发送过来的处理机制。
8数据格式在Web Service的调用过程中,无论是外协系统还是施工系统,都有发送数据和接收数据的要求,也即双方系统同时作为客户端又作为服务端。