帮助>运动会管理系统>WEBSERVICE接口 |
简介 |
运动会项目的组织管理有时会涉及多个不同厂商的设备,特别是一些大型运动会更是如此。比如成绩记分时,使用了不同厂家的智能电子设备,这些设备首先将成绩分值存储在自身存储器中,然后可以通过专用程序导入电脑系统。为了给第三方设备和软件提供数据交互的能力,本系统提供了WEB SERVICE接口,使得某些用户能依据自身需要集成不同系统。 |
启用接口 |
当您在本系统中创建一个运动会项目时,WEB
SERVICE接口缺省是禁用的。可通过参数设置来启用接口。 通过项目菜单[设置与系统—项目维护—项目参数]进入参数设置界面,在左边树中选择[功能参数],按鼠标右键,弹出菜单中选择<更新>,界面显示如图:
点击“启用”单选按钮,在下面一行输入用户名和密码,然后点击保存。 |
接口方法 |
WSDL:http://www.jvyee.com/mis/services/DataService?wsdl 实现语言:JAVA (实现语言与调用程序语言无关,WEBSERVICE是一种标准接口,不限定某一具体开发工具和程序语言) 访问URL:http://www.jvyee.com/mis/services/DataService 服务名:DataService 方法: 1,getFzs() ——获得项目分组设置。调用此方法可取得项目设置的所有分组(最底层节点)。 返回:WsUnit[] ——每一个WsUnit对象含义:id=分组ID,name=分组名称 2,getFz(int id) ——获得指定ID的分组。此方法通常用来获得(已知分组ID)分组名称。参数:id=分组ID 返回:WsUnit ——对象含义:id=分组ID(等于传入参数ID),name=分组名称 3,getFz(String name) ——获得指定名称的分组。此方法通常用来获得(已知分组名称)分组ID。参数:name=分组名称 返回:WsUnit ——对象含义:id=分组ID,name=分组名称 4,getItems() ——获得项目的项目设置。调用此方法可取得项目设置的所有竞赛项目。 返回:WsUnit[] ——每一个WsUnit对象含义:id=竞赛项目ID,name=竞赛项目名称 5,getItem(int id) ——获得指定ID的竞赛项目。此方法通常用来获得(已知竞赛项目ID)竞赛项目名称。参数:id=竞赛项目ID 返回:WsUnit ——对象含义:id=竞赛项目ID(等于传入参数ID),name=竞赛项目名称 6,getItem(String name) ——获得指定名称的竞赛项目。此方法通常用来获得(已知竞赛项目名称)竞赛项目ID。参数:name=竞赛项目名称 返回:WsUnit ——对象含义:id=竞赛项目ID,name=竞赛项目名称 7,getScore(int fzid,int itemid,int ydyid) ——获得某一运动员的成绩。参数:fzid=分组ID,itemid=竞赛项目ID,ydyid=运动员ID 返回:WsUnit[] ——每一个WsUnit对象含义:id=赛次ID,name=赛次名称,other=成绩 8,getFinalScore(int fzid,int itemid,int ydyid) ——获得某一运动员的决赛成绩。参数:fzid=分组ID,itemid=竞赛项目ID,ydyid=运动员ID 返回:WsUnit ——对象含义:id=赛次ID,name=赛次名称,other=成绩 9,getScore(String fzname,String itemname,String ydyname) ——获得某一运动员的成绩。参数:fzname=分组名称,itemname=竞赛项目名称,ydyname=运动员姓名 返回:WsUnit[] ——每一个WsUnit对象含义:id=赛次ID,name=赛次名称,other=成绩 10,getFinalScore(String fzname,String itemname,String ydyname) ——获得某一运动员的决赛成绩。参数:fzname=分组名称,itemname=竞赛项目名称,ydyname=运动员姓名 返回:WsUnit ——对象含义:id=赛次ID,name=赛次名称,other=成绩 11,getScores(int fzid,int itemid,int scid) ——获得某分组项目某赛次所有运动员的成绩。参数:fzid=分组ID,itemid=竞赛项目ID,scid=赛次ID。本方法也可用来获得某分组-项目-赛次的所有运动员,如果返回对象的other=""表示该运动员尚无或未录入成绩。 返回:WsUnit[] ——每一个WsUnit对象含义:id=运动员ID,name=运动员名称,other=成绩 12,getScores(String fzname,String itemname,String scname) ——获得某分组项目某赛次所有运动员的成绩。参数:fzname=分组名称,itemname=竞赛项目名称,scname=赛次名称。本方法也可用来获得某分组-项目-赛次的所有运动员,如果返回对象的other=""表示该运动员尚无或未录入成绩。 返回:WsUnit[] ——每一个WsUnit对象含义:id=运动员ID,name=运动员名称,other=成绩 13,getScs(int fzid,int itemid) ——获得某分组项目的所有赛次。参数:fzid=分组ID,itemid=竞赛项目ID 返回:WsUnit[] ——每一个WsUnit对象含义:id=赛次ID,name=赛次名称 14,getScs(String fzname,String itemname) ——获得某分组项目的所有赛次。参数:fzname=分组名称,itemname=竞赛项目名称 返回:WsUnit[] ——每一个WsUnit对象含义:id=赛次ID,name=赛次名称 15,setScore(int fzid,int itemid,int scid,int ydyid,String score) ——输入某运动员成绩。参数:fzid=分组ID,itemid=竞赛项目ID,scid=赛次ID,ydyid=运动员ID,score=成绩 返回:int ——成功修改的记录数。=1是成功,=0 表示未找到该运动员,=-1 表示更新失败 16,setScore(String fzname,String itemname,String scname,String ydyname,String score) ——输入某运动员成绩。参数:fzname=分组名称,itemname=竞赛项目名称,scname=赛次名称,ydyname=运动员名称,score=成绩 返回:int ——成功修改的记录数。=1是成功,=0 表示未找到该运动员,=-1 表示更新失败 17,setScores(int fzid,int itemid,int scid,WsUnit[] ydyid_scores) ——输入多个运动员成绩。参数:fzid=分组ID,itemid=竞赛项目ID,scid=赛次ID,ydyid_scores中每个对象含义:id=运动员ID、other=该运动员成绩 返回:int ——成功修改的记录数。=0 表示未找到任何匹配的运动员,=-1 表示更新失败 18,setScores(String fzname,String itemname,String scname,WsUnit[] ydyid_scores) ——输入多个运动员成绩。参数:fzname=分组名称,itemname=竞赛项目名称,scname=赛次名称,ydyid_scores中每个对象含义:name=运动员名称、other=该运动员成绩 返回:int ——成功修改的记录数。=0 表示未找到任何匹配的运动员,=-1 表示更新失败
|
其他说明 |
WsUnit是一种复杂参数类型。不同语言有不同的表现形式,请按照所用程序语言的说明,依据http://www.jvyee.com/mis/services/DataService?wsdl生成该数据类型或类文件。比如JAVA中用Axis生成WsUnit类文件的命令行为: c:\work\axis>java org.apache.axis.wsdl.WSDL2Java --verbose http://www.jvyee.com/mis/services/DataService?wsdl |
—>运动会管理系统 |