帮助>运动会管理系统>WEBSERVICE接口
简介
    运动会项目的组织管理有时会涉及多个不同厂商的设备,特别是一些大型运动会更是如此。比如成绩记分时,使用了不同厂家的智能电子设备,这些设备首先将成绩分值存储在自身存储器中,然后可以通过专用程序导入电脑系统。为了给第三方设备和软件提供数据交互的能力,本系统提供了WEB SERVICE接口,使得某些用户能依据自身需要集成不同系统。
启用接口
    当您在本系统中创建一个运动会项目时,WEB SERVICE接口缺省是禁用的。可通过参数设置来启用接口。
    通过项目菜单[设置与系统—项目维护—项目参数]进入参数设置界面,在左边树中选择[功能参数],按鼠标右键,弹出菜单中选择<更新>,界面显示如图:

    点击“启用”单选按钮,在下面一行输入用户名和密码,然后点击保存。
    注意:通过程序调用WEBSERVICE时,需要使用用户名和密码,该用户名不是登录名,而是在此处设置的用户名。系统在你输入的用户名前面自动加上了项目ID,如图,你在用户名右边输入框输入的字符是"ws",密码右边输入的字符是"111111",那么,要使用当前项目的WEBSERVICE,需要的用户名是"71_ws",需要的密码是"111111"。

接口方法
    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
    
    —>运动会管理系统