辽实手机版师讯通设计WHJ20160226

1、辽实手机版师讯通设计方案V0.3版（2016-02-26）北京灵泰克信息技术有限公司 2016年02月27日目 录一、手机移动办公平台设计需求41.1背景41.2需求故事51.2.1登录51.2.1首页面6二、设计约束72.1总体设计约束72.2安卓版设计要求：72.3苹果版设计要求：82.4后台接口测试：8三、 详细设计93.1平台提供的测试平台及平台地址。93.2设计原则103.3登录及用户状态11登陆设计（*）11版本升级设计12获取部门人员列表12获取教师状态：14下载自定义头像：15条件查找联系人：15群中增加人员：163.4处理短消息16获取未读短信息数量17获取短信息列表17更新

2、个人未读信息状态17发送新消息18发送文件193.5处理通知信息213.6通讯录功能，暂不用22公共通讯录部门表22公共通讯录，暂不用22个人通讯录，暂不用233.7办公功能25获取周程信息 此文件改为使用网页文件。263.7日程相关功能，暂不用26获取日程数量信息26获取日程列表信息，暂不用26获取日程详细信息，暂不用27变更日程状态，暂不用28提交日程信息，暂不用283.8常用语管理，暂不用293.9个人云盘设计：29个人文件夹29公共文件夹30文件上传30重命名30删除30复制31新建文件夹31接收文件夹32上传文件323.10错误日志上传，暂不用333.11家校交流33发布当天作业35

3、获取当天作业36四、安卓版师讯通目前存在的问题374.12014年12月22日星期日374.2增加扫一扫功能。37附录一：头像处设计原理：38五、苹果版师讯通目前存在的问题402015年6月7日星期日40六、安卓版2016年2月26日提交问题48一、 手机移动办公平台设计需求1.1背景北京灵泰克对平台主要是针对教育行业的一款综合性办公平台，为了提供更加灵活的办公模式，现增加安卓手机、苹果手机办公功能。辽宁实验学校（简称辽实）现提出制定自己的个性化移动版，包括苹果、安卓两个版本的师讯通和家校通客户端。1.2需求故事1.2.1登录设计要求：（1） 安装后第一次登录，填写服务器信息，如果已有设置信息

4、，则直接进入登录界面。（2）1.2.1首页面设计要求：（1） 前三个（实验新闻。）固定在上面，下面有信息滚动时，不跟着滚动。（2） 每个人有新信息时，图标右上角有一个数量提示。（3） 有最新信息的排上面，没有的排下面，（4）二、设计约束2.1总体设计约束（1）服务器端与辽实对接的所有JSP文件均放在/moals目录下。（2）原则上向客户端提交的数据均为JSON格式,UTF-8编码。（3）采取原型法设计，双方不要影响进度，由客户端开发团队提出需求、接口、美工实现，双方再实现设计。（4）分两阶段上线，让用户感知我们的进度。每期先实现师讯通，再实现家校通，实现联调、测试成功后进入下一期。（快速原型法

5、设计模式）（5）原则上采取第三方免费的插件库，如果包括本公司的，应有详细说明。（6）所有文档均以保存在群文件中的为准。代码、文档（尤其是每天工作日志）要求日提交。（7）必须考虑完整不同的情况和容错机制。（8）推送内容界定：a)聊天信息、提醒信息用于推送，通过消息内容解析实现具体的业务。b)向用户服务器推送采取两种方式：一是通过第三方转发给用户服务器，二是客户端直接发送给用户服务器。C）type:1表示聊天文字（图文）信息，2：聊天中的声音，3：聊天中的视频。4：文件，5：提醒消息。Description:内容描述。Serverurl：如果是声音文件等，此处是网址。师讯通会有一个产品ID，用于确

6、认不同的应用；有一个USERID，确认不同的人；有一个组ID，用于群发；消息内容，分为图文、声音、视频、2.2安卓版设计要求：1.安卓运行环境基于4.0以上版本，开发环境基于17版本。2.产品包部署在用户环境中。通过扫描的方式下载，安装到本地。3.版本管理采取开发版本号的方式。从1、2、开始，每一个升级增加一个版本号。可能对外会有一个另一个版本说法。如3.0。4.安装版的安装包名称要求：ltksxtandlsX.apk,其中X代表上面的开发版本号。5.项目名称：SxtNewForAndLs，导出源代码包时，最后加一个X代表开发版本号。6.产品开ID：com.lingtek.sxtls2.3苹果

7、版设计要求：1.苹果版本兼容IOS 6.0版以上。2.产品包部署在用户环境中。通过扫描的方式下载，安装到本地。打包时，采取企业级帐号打包、分发的方式。3.版本管理采取开发版本号的方式。从1、2、开始，每一个升级增加一个版本号。可能对外会有一个另一个版本说法。如3.0。4.安装版的安装包名称要求：ltksxtioslsX.ipa,其中X代表上面的开发版本号。5.项目名称：SxtNewForIosLs，导出源代码包时，最后加一个X代表开发版本号。6.产品开ID：com.lingtek.sxtls2.4后台接口测试：pid:16688pidkey: 9B250CAF76870FBDDA4CF3631

8、00FF26A访问方式：其它能数根据需要填写如：三、 详细设计3.1平台提供的测试平台及平台地址。学校版开发测试服务器网址：测试环境：测试帐号：部门：三年级教研组，姓名：刘测试，帐号：lcs 密码：111111；部门：职能部门，姓名：魏总，帐号：whj 密码：111111；测试流程：交流测试：通过办公平台访问：，使用帐号登录后，进行消息管理：发消息时直接全选。发送的消息的接收的消息均可在办公平台看到。发送通知：whj帐号具有发通知权限，在选择人员处选择三年级教研处的刘测试即可。3.2设计原则1.此办公平台（师讯通）只针对教师人员。2.不同人员可能有不同的功能及权限，但这些操作都是在后台进行控制

9、，与手机端无关。3.所有服务器向客户端发送的主要有三类格式的数据，一是XML类数据，二是网页数据（HTML5），三是JSON格式数据。4.对于表单POST提交，不要使用字符集转换或进行十六进制转换，对于GET提交，则需要进行转换，以防止出现特殊字符，但转换后会出现字符集问题，原则上向服务器提交应使用post提交。5.所有返回到手机端的数据字符集为UTF-8。6.服务器端所有访问的文件均在/moals目录下。7.电脑与手机同时登录的情况处理，可以同时登录，信息双方同时获取，根据已阅读的标记，直接标记为已读，只是本地进行保存。8.输入的网址信息以IP或域名开头，可以加上端口和相对路径，如192.1

10、68.1.20:8080/sch1，此项在设置处进行管理。7.注：7、8条，暂不采取，采取9条方案。客户端采取定时查询机制，服务器端将根据用户的情况返回一个应该返回的列表，客户端再根据具体情况进行分别获取的机制。8.消息信息采取定时查询的方式，设计为5S向服务器查询一次。其中根据时间和反馈信息采取可变时长等的策略，最长为15S，最短为3S，在电脑上网且不是免打扰方式，则延长轮询时间。9.手机消息采取第三方推送方案。第三方信息：10.UI设计采取主流平台。（写出基本的几个要求：钟老师补充）。11.设计时采取原型迭代的方式，一是页面根据要求，设计完整的。功能实现可采取静态的方式，比如登录，可直接点

11、击确定，进入下一级页面。二是静态数据补充的补充要完整。12:所有JSP页面返回均为JSON格式数据，数据中应有一个resulttag标记，如果此标记不存在或大于0，则表示为成功，小于0为有问题。除登录外，-1：表示pid或pidkey值为空；-2：表示pidkey不是合法值。3.3登录及用户状态登陆设计（*）访问文件：/moals/sxt_login.jsp?loginname=XXX&password=XXX&code=XXX提交信息：帐号、密码、手机串号密码需要加密，加密文件见附件返回信息：name:姓名；pid:个人唯一码，整数；pidkey:具人识别码，其值包括了传送的

12、code加工后生成的一个值。Andsxtvercode：安卓版本版本号，是一个整数，每升级一个版号则加1；Applesxtvercode：苹果版本版本号，是一个整数，每升级一个版号则加1；返回信息说明：pid为一个唯一的数字-1，用户名、密码、手机串号为空。-2，用户名或密码错误。-3，手机串号不正确。-4，手机账号未开通。-5，平台手机版未开通。pidkey：当前用户密钥。设计要求：登录界面应该可以设置访问平台的网址、是否保存密码等选项。传递code，手机串号。退出登录：/moals/sxt_logout.jsp?pid=XXX&pidkey=YYY;强制退出登录后，系统应处理不运行

13、状态，并非处于后台运行状态。版本升级设计每一个客户端中均记录了一个本客户端的版本号，版本号是按1、2、3形式顺序递增的。安卓和苹果各自保留自己的版本号。客户端在获取服务器端版本信息后，向指定地方获取新的APP程序。版本升级是采取登录及定时检测是否有新版本的方式，并根据安卓和苹果的特点，进行相应的处理。返回版本有两个地方：（1） 登录返回处，会返回不同的APP的版本。Login.jspversioncode="7" andsxtvercode="7" andjxtvercode="2" applesxtvercode="1&q

14、uot; applejxtvercode="1"注：versioncode 新版本中已不使用。（2） 在获取人员状态处，会返回不同的APP的版本。师讯通：sxt_mobile_getteacherstate.jsp家校通：jxt_mobile_getpeoplestate.jsp在更新版本时，均要同步变更此版本。获取部门人员列表访问页面：/moals/sxt_mobile_getteacherlist.jsp传递参数：pid，人员编号pidkey，密钥返回信息：Deptid：部门标号；Deptname：部门名称；Fatherid：上级部门标号Peoplerecord：人员信

15、息表；Pid：人员PID；Name：姓名；Displaycode：优先显示码；Deptid：所属部门Id；State：在线状态；Headpicid：头像编号；Headcrc：头像文件CRC值；Mobilestate：手机登录状态；Deptrecords：二级部门信息；Deptid：部门编号；Deptname：部门名称；Fatherid：上级部门编号；Peoplerecord：人员信息。属性同上；Deptrecordt：三级部门信息，内容同上级部门信息。说明：deptrecordf：一级部门deptrecords：二级部门deptrecordt：三级部门fatherid：上级部门编号，顶级部门的

16、上级部门编号为0peoplerecord：人员信息标签，包括：deptid：部门编号deptname：部门名称pid：人员编号name：人员姓名在线交流功能displaycode:人员显示序号，人员排序按照是否在线，序号大的优先，同序号的按姓名的方式。头像更新实现原理：（1）如果教师张三登录后，获得用户列表，手机端程序根据获取的人员列表xml文件内容与本地的xml内容进行比对，如果headpid不同或者CRC值不同，则访问sxt_mobile_headimgdownload.jsp，下载或者更新本地的文件。单个文件更新。获取教师状态：师讯通在当前界面下，应定时获取服务器的教师在线信息，获取后重

17、新排序，将在线的教师显示在上面，不在线的显示在下面。对于特殊要求的，根据Displaycode优先显示。（1） 通过获取教师状态信息，及时了解师讯通版本的变化，如果有新版本，将自动升级。（2） 获取教师状态信息后，变更手机中产门的人员列表状态，并重新排序：排序原则，排序原则比较复杂。一、前面全部是在线、后面全部是不在线。二、在在线人员列表中，或者不在线人员列表中，先按displaycode由大到小进行排列，三、在displaycode相同的情况下，按姓名进行排列。（3）网页：/moals/ sxt_mobile_getteacherstate.jsp传递参数：pid：当前用户编号pidkey：

18、登录校验码返回信息：-1：提交参数传递不完整；-2：表示提交的headpid在表中不存在，或者没有自定义头像；-3：表示headpid对应的头像文件已不存在。头像文件描述：Pid:人员IdDisplaycode优先显示码；State：是否在线，1：在线，0：不在线；Mobilestate：手机是否在线下载自定义头像：网页：/moals/sxt_mobile_headimgdownload.jsp传递参数：pid：当前用户编号pidkey：登录校验码headpid：要获取头像的用户的编号。返回信息：-1：提交参数传递不完整；-2：表示提交的headpid在表中不存在，或者没有自定义头像；-3：表

19、示headpid对应的头像文件已不存在。正确情况下：头像文件流。条件查找联系人：客户端提交不少于2个字的姓名关键字，用于搜索教师和学生。网页：/moals/sxt_mobile_searchpeople.jsp传递参数：pid：当前用户编号。pidkey：登录校验码。keyvalue：姓名关键字。peoplescopy:人员范围,1,仅限教师，2：仅限学生，为空表示师生均可。返回信息：-1：提交参数传递不完整；-2：表示提交的headpid在表中不存在，或者没有自定义头像；-3：运行出错。-4：提交关键字小于2个字符。群中增加人员：将某一批人员增加到一个群组中。网页：/moals/sxt_mo

20、bile_group_peopleadd.jsp传递参数：pid：当前用户编号。pidkey：登录校验码。groupid：组编号。pidstr:要增加人员pid，多人用逗号分隔。返回信息：-1：提交参数传递不完整；-2：表示提交的headpid在表中不存在，或者没有自定义头像；-3：运行出错。-4：pidstr或groupid有空值。3.4处理短消息消息推送方案，采取使用极光推送的方案，具体网址：http:/docs.jpush.io/设计方案：客户端不负责推送，只需要将消息发送服务端，由服务器端接收到消息后向极光接口推送。等完整实现功能后，测试客户端直接推送的可行性。客户端实现推送消息接收，

21、只包括消息类别（如短消息、提醒消息等）、消息条数。接收到推送消息后向服务器获取具体消息内容。curl -insecure -X POST -v -H "Content-Type: application/json" -u "1a1c8694e5d1b48f3adc2ffc" -d '"platform":"all","audience":"all","notification":"alert":"Hi,JPush !&

22、quot;,"android":"extras":"android-key1":"android-value1","ios":"sound":"sound.caf","badge":"+1","extras":"ios-key1":"ios-value1"' "platform": "all", "a

23、udience": “all”,"notification": "android": "alert": "师讯通提醒", "title": "Send to Android", "builder_id": 1, "extras": "newsid": 321 , "ios": "alert": "Hi, JPush!", "sound&q

24、uot;: "default", "badge": "+1", "extras": "newsid": 321 ,"message": "msg_content": "Hi,JPush", "content_type": "text", "title": "msg", "extras": "key": "va

25、lue" , "sms_message": "content":"sms msg content", "delay_time":3600 , "options": "time_to_live": 60, "apns_production": false 获取未读短信息数量访问网页：/moals/sxt_mobile_sms_unreadcount.jsp传递参数：pid=XX&pidkey=XX返回信息：Unreadcount:返回未读短

26、消息的数量，如：11，此信息用于告诉客户端还有多少条消息未读。获取短信息列表访问接口：/moals/sxt_mobile_sms_unreadlist.jsppid=XXX&pidkey=xxx传递参数：Page：当前页码，从1开始，目前统一设置为1；Authorname：发送人姓名；Authorpid：发送人PID，如果此ID是本人的ID，则说明是自己的电脑发送的信息。Sid：服务器上记录的短消息ID。Addtime：发送消息时间；State：手机是否已接收该消息，此标记暂不使用。importanttype：是一个数字，消息重要程度，一般或者重要，非常重要等；attachment：附

27、件信息，“;”分割附件名称和下载地址；“#”分割不同的附件。在设计时，获取消息后，则将这些消息提交到服务器上，以免服务器上重复发送。更新个人未读信息状态访问网页：/moals/sxt_mobile_sms_ready.jsp? pid=XX&pidkey=XX&smsidstr=XX，返回信息：将此人在平台中的未读信息更新成已读状态说明：为了防止重复提醒，此处的设计是如果服务器上已把消息传递给手机，则表示手机已经接收，则自动转为已读状态，引操作应在手机端获取消息列表后，立即处理。Smsidstr:所有消息的ID，通过逗号分隔。发送新消息一、点对点交流访问网页：/moals/ s

28、xt_mobile_sms_add.jsp传递参数：使用POSTpid，人员编号pidkey，密钥description：消息内容pidstr：收信人id串，使用“,”分割，如：10001,10002msg参数：-1：传递参数不完整-2：用户验证失败-3：发送失败1：发送成功二、组发信息：指在一个组中发送信息，具体发送的内容与点对点发信息相同，但要增加一个组号参数。接口文件：sxt_mobile_sms_group_add.jsp传递参数：使用POSTpid，人员编号pidkey，密钥description：消息内容groupid：组编号，为一个数字返回参数：-1：传递参数不完整-2：用户验证

29、失败-3：发送失败1：发送成功三、部门发信息：指在一个部门中发送信息，具体发送的内容与点对点发信息相同，但要增加一个组号参数。接口文件：sxt_mobile_sms_dept_add.jsp传递参数：使用POSTpid，人员编号pidkey，密钥description：消息内容deptid：组编号，为一个数字返回参数：-1：传递参数不完整-2：用户验证失败-3：发送失败1：发送成功发送文件一、点对点发送文件访问网页：/moals/sxt_mobile_sms_sendfile.jsp传递参数：pid，人员编号pidkey，密钥description：消息内容pidstr：收信人id串，使用“,

30、”分割，如：10001,10002还有附件文件。返回信息：-1：传递参数不完整-2：用户验证失败-3：发送失败1：发送成功二、组发送文件访问网页：/moals/sxt_mobile_sms_group_sendfile.jsp传递参数：pid，人员编号pidkey，密钥description：消息内容groupid：组编号，为一个数字还有附件文件。返回信息：-1：传递参数不完整-2：用户验证失败-3：发送失败1：发送成功三、部门发送文件访问网页：/moals/sxt_mobile_sms_deptid_sendfile.jsp传递参数：pid，人员编号pidkey，密钥description：

31、消息内容deptid：组编号，为一个数字还有附件文件。返回信息：-1：传递参数不完整-2：用户验证失败-3：发送失败1：发送成功3.5处理通知信息3.5.1获取接收通知列表（1）手机端定期接收（1分钟）通知信息，如果师讯通不是当前运行状态，则给出提示“收到师讯通发送通知消息”；并将接收信息保存在数据库中。获取未读通知消息：/moals/sxt_mobile_announce_unreadcount.jsp?pid=XXX&pidkey=YYY通过先读取是否有新通知，一是减少数据流量，二是便于师讯通提醒。（2）如果是运行状态，则在通知处显示接收列表（从数据库中读取）；（3）点击某个具体的

32、通知，则显示通知的详细内容，当点击某一个内容时，服务器会自动标记为已读。客户端也需要进行此处理。访问文件：/moals/sxt_mobile_announceset_list.jsp ?page=XX&pagerows=XX& pid=XX&pidkey=XX&isread=XX传递参数：<xml><ltkmoa count=”记录条数” page=”页码”><announce authorname=”XXX” pid=”XXX” did=”XXX” addtime=”yyyy-MM-dd HH:mm:ss” status=”XXX

33、” title=” 标题”>通知内容，是通过BASE64编码的</ announce ></ltkmoa>获取接收通知的列表。通知按照阅读状态和发布时间排序。未读、已读，时间倒序。authorname：发布通知的人姓名。pid：发布通知人员的pid。did：通知编号，唯一标识码。addtime：发布通知的时间。status：阅读状态（是否阅读）。title：完整标题。列表的标题可以返回截取固定长度的内容，鼠标悬浮，显示完整标题。点击【阅读】，访问网页：sxt_mobile_announceset_detail.jsp？pid=xx&pidkey=xx&am

34、p;id=XX传递参数：id：列表的did项，used：阅读状态。<xml><ltkmoa><announcedetail authorname=”XXX” pid=”XXX” did=”XXX” addtime=”yyyy-MM-dd HH:mm:ss” status=”XXX” title=” 标题” description=“通知内容”attachment=“附件列表”> </ announcedetail ></ltkmoa>附件信息保存在通知内容中，通知内容是HTML格式，手机端需要转换，显示成html格式。如果通知中有附件

35、可以下载附件（单个文件下载和打包下载）。3.6通讯录功能，暂不用公共通讯录部门表访问页面：/moals/ addressset_dept.jsp传递参数：pid，当前登陆用户唯一标识码； pidkey：登陆密钥。返回信息<ltkmoa><addressdept id="XX" deptname="XX"/></ltkmoa>返回信息为两层嵌套：ID，部门编号，deptname：部门名称公共通讯录，暂不用访问页面：/moals/ addressset.jsp传递参数：pid，当前登陆用户唯一标识码； pidkey：登陆密

36、钥。id：部门编号；返回信息<ltkmoa><addressinfo name="X" workphone="XX" mobile="XX" homephone="XX" email="XX"/></ltkmoa>返回信息联系人信息：name：姓名；workphone：单位电话；mobile：手机号homephone：家庭电话email电子邮箱个人通讯录，暂不用访问页面：/moals/ addressset_per.jsp传递参数：pid，当前登陆用户唯一标识

37、码； pidkey：登陆密钥。page：页码，pagerows：每页显示条数。返回信息<ltkmoa page=” count=”><addressinfo name="X" workphone="XX" mobile="XX" homephone="XX" email="XX" unitname=”/></ltkmoa>page：第几页，count：总的记录数name：姓名；workphone：单位电话；mobile：手机号homephone：家庭电话ema

38、il电子邮箱unitname：单位名称3.7办公功能获取周程信息 此文件改为使用网页文件。周程信息是一个JSON数据，按显示效果显示出来即可。访问页面：/moals/sxt_mobile_weekplan.jsp传递参数：pid，当前登陆用户唯一标识码； pidkey：登陆密钥，date：当前日期，如果不填，默认为当天3.7日程相关功能，暂不用获取日程数量信息访问页面：/moals/schedule_num.jsp传递参数：pid，当前登陆用户唯一标识码； pidkey：登陆密钥，month：当前月份，如果不填，默认为当前日期所在月份，格式MM；year：当前年份，格式yyyy，可选。返回信息

39、<ltkmoa ><schedulenum dateinfo=”XX” daycount=”XX” /></ltkmoa>说明：dateinfo：日期，格式为yyyy-MM-dddaycount：对应日期的日程条数。获取日程列表信息，暂不用访问页面：/moals/schedule_list.jsp传递参数：pid，当前登陆用户唯一标识码； pidkey：登陆密钥，daytime：日期，格式yyyy-MM-dd，可选；month：月份，格式yyyy-MM-dd，可选。如果有month参数，则返回该月的所有日程信息。如果有daytime参数，则返回该天的所有日程

40、信息。如果两个参数都没有，返回当前日期的所有日程信息。page：页码pagerows：每页行数返回信息<ltkmoa page=” count=”><scheduleinfo id="XX" title=”XX” importanttype=” starttime=” endtime=” status=” process=”><!CDATAdescription> </scheduleinfo></ltkmoa>返回信息说明：id：日程唯一编号。title：标题importanttype：重要等级starttime

41、：开始时间，yyyy-MM-dd HH：mmendtime：结束时间，同上status：状态，process：进度，百分比。description：描述信息获取日程详细信息，暂不用访问页面：/moals/schedule_detail.jsp传递参数：pid，当前登陆用户唯一标识码； pidkey：登陆密钥；id：日程编号。返回信息<ltkmoa><scheduleinfo id="22" title="午餐时间到" importanttype="一般" starttime="2014-02-24 12:0

42、0" endtime="2014-02-24 12:30" status="进行中" process="2%" scopetype="个人"><!CDATA日程描述><!CDATA进度描述></scheduleinfo></ltkmoa>说明：id：日程唯一编号。title：标题importanttype：重要等级starttime：开始时间，yyyy-MM-dd HH：mmendtime：结束时间，同上status：状态，process：进度，百分比

43、。description：描述信息scopetype：日程类别，个人或工作。进度描述：当前进度的描述信息变更日程状态，暂不用访问页面：/moals/ addressset_dept.jsp传递参数：pid，当前登陆用户唯一标识码； pidkey：登陆密钥。返回信息<ltkmoa><addressdept id="XX" deptname="XX"/></ltkmoa>返回信息为两层嵌套：ID，部门编号，deptname：部门名称提交日程信息，暂不用访问页面：/moals/传递参数：pid，当前登陆用户唯一标识码； pi

44、dkey：登陆密钥。返回信息<ltkmoa><addressdept id="XX" deptname="XX"/></ltkmoa>返回信息为两层嵌套：ID，部门编号，deptname：部门名称3.8常用语管理，暂不用访问网页：/moals/ oa_commonusewords.jsp传递参数：pid，当前登陆用户唯一标识码； pidkey：登陆密钥。返回信息：<ltkmoa><commonusewords id="XX" content="XX"/>&

45、lt;/ltkmoa>3.9个人云盘设计：个人云盘包括：个人文件夹、公共文件夹、接收文件夹、部门文件夹。不同的文件夹具有不同的权限：个人文件夹：具有下载、上传、移动、改名、删除、转发权限等权限；公共文件夹：具有下载权限；接收文件夹：具有下载权限。个人文件夹访问网页：moa/sxt_mobile_ netdisk_per.jsp传递参数：pid，pidkey，path（可选参数，不选为根目录）返回信息：filetype：文件类型，1文件夹，2文件filename：文件名称（或文件夹名称）modifytime：修改时间size：文件大小（如果是文件夹，为0）url：如果是文件，则是下载地址，

46、如果是文件夹，没有意义newpathfilename：新文件路径，打开下一级文件夹使用；如：打开我的网盘，里面有一个aaa的文件夹，如果要访问这个文件夹，则访问：moa/sxt_mobile_ netdisk_per.jsp?pid=ss&pidkey=88&path= newpathfilename公共文件夹访问网页：moa/sxt_mobile_ netdisk_common.jsp文件上传访问网页：sxt_mobile_ netdisk_upload.jsp参数：pid，pidkey，path返回：1成功，0失败重命名访问网页：/moals/sxt_mobile_ net

47、disk_rename.jsp传递参数：path：当前所处路径，使用sToHexS方法加密；filetype：文件类型，1文件夹，2文件。newfilename：要重命名的文件的新名称（如果是文件要包含后缀），使用sToHexS方法加密；oldfilename：要重命名的文件的旧名称（如果是文件要包含后缀），使用sToHexS方法加密；pid和pidkey。返回内容：-1：path、newfilename、oldfilename、filetype有空参数；-2：系统错误，重命名失败；-3：新的文件名在此目录下已经存在；1：重命名成功；删除访问网页：/moals/sxt_mobile_ netd

48、isk_delete.jsp传递参数：path：当前所处路径，使用sToHexS方法加密；filename：要删除的文件名（包含后缀），使用sToHexS方法加密；filetype：文件类型，1文件夹，2文件。pid和pidkey。返回内容：说明：返回值分别代表不同的含义-1：path、filename、filetype有空参数；-2：系统错误；1：删除文件夹成功；2：删除文件成功；复制访问网页：/moals/sxt_mobile_ netdisk_copy.jsp传递参数：path：当前所处路径，使用sToHexS方法加密；oldpath：复制前文件所在目录，使用sToHexS方法加密；ol

49、dfilename：复制前文件的名字，使用sToHexS方法加密；deletetag：可选参数，删除标记，是否删除源文件，1删除，为空或其他，不删除。返回内容：说明：返回值分别代表不同的含义-1：path、oldfilename、oldpath有空参数；-2：系统错误；-3：不能复制目录到其子目录中；-4：目录名：复件_旧目录名已经存在-5：文件大小超过了200M，单个文件只能复制200M以下的文件；-6：文件名已存在；1：复制成功。新建文件夹新建文件夹：访问网页：/moals/sxt_mobile_ netdisk_add.jsp传递参数：path：当前所处路径，使用sToHexS方法加密；

50、newfilename：要新建的文件夹名，使用sToHexS方法加密；pid和pidkey。返回参数：-1：path、newfilename有空参数；-2：系统错误；1：创建成功；接收文件夹访问网页：/moals/sxt_mobile_ netdisk_recv.jsp传递参数：filename：要检索的文件名，使用sToHexS方法加密；可以没有此参数。pid和pidkey。返回参数：id：唯一编号frompid；发送人，（返回的是姓名）；filename：文件名称；addtime：创建时间；downurl：下载路径删除接收文件接口：访问网页：/moals/sxt_mobile_ netdi

51、sk_recv_delete.jsp传递参数：id：要删除的接收文件的id编号。pid和pidkey。result:11. 1：删除成功；2. -2：失败；上传文件访问网页：/moals/sxt_mobile_ netdisk_send.jsp传递参数：filename：要发送的文件名，使用sToHexS方法加密，必填。pidstr：接收人标号字符串，如：20797,20824, 使用英文逗号分隔。description：描述，使用sToHexS方法加密，可选pid和pidkey。返回参数：-1：参数不完整1：成功；-2：失败；3.10错误日志上传，暂不用访问网页：/moals/error_u

52、pload.jsp传递参数：pid和pidkey。错误日志文件。返回参数：-1： 1：成功；-3：上传失败；3.11家校交流家校交流主要有教师（含学校教师和班主任）与家长点对点交流，群发消息，留作业等功能。（1）获取所教班级、家长、学生列表设计描述：在目前的界面最后面增加“家校”项，点击后列出所有所教班级、如果只教一个班，则直接显示该班的学生及家长。显示效果同通讯录，第一级是班级，二级是该班学生及家长。点击家长后进入聊天界面，同教师间交流，接收消息的pidstr对应的是家长的pid。访问页面：/moals/sxt_mobile_getteachclass.jsp传递参数：pid，当前登陆用户唯

53、一标识码； pidkey：登陆密钥. 返回信息<ltkmoa><teachinfo classid="2" classname="八年级一班"><studentinfo spid=”10002” sname=”张小明” ppid=”55555” pname=”张三”/></teachinfo></ltkmoa>说明：classid：班级编号，唯一编码；classname：班级全称；ismaster：是否是该班的班主任，0：否，1：是；subjectid：可能为空，学科编号;学科名称；多个学科使用

54、#分隔，如1;语文#2;数学。解析的时候，要分开存储。分成subjectid和subjectname。特殊说明：可能存在一种情况，一个教师既是A班的班主任，又是学科教师。spid：学生PID。sName:学生姓名ppid:家长pid,panme:家长姓名访问结果如下图所示：（2）群发消息设计描述：在家校界面，在右上角增加一个“群发”按钮，点击后，选择该班的所有家长列表，然后可以选择，选择后发送消息，此功能基本上教师的群发消息相同。搜索条缩短，右侧增加群发消息按钮。发送方法同师讯通群发消息功能，只是选择接收人员的地方改成提取所教的班级家长（/moals/sxt_mobile_getteachcl

55、ass.jsp）信息，可多选。发送接口内容。群发消息接口：/moals/sxt_mobile_sms_add.jsp群发文件/moals/sxt_mobile_sms_sendfile.jsp发布当天作业发布作业接口：有教学学科的教师才能够发布作业（即subjectid不为空的班级），如果老师只教授该班一个学科，则直接进入输入界面，如果以前已留过，应先读取以前的作业，再输入作业内容，点击提交即可。如果老师教授该班多个学科，需要让老师在发布作业的时候必须选择一个学科，然后才能提交。接口文件：/moals/sxt_mobile_jxt_homeworkadd.jsp传递参数：pid：教师的pid编号；pidkey：教师的校验码；subjectid：学科编号；classid：班级编号；content：作业内容。返回信息：1：发送成功-1：传递参数不完整-2：用户验证失败-3：发送错误获取当天作业接口文件：/moals/sxt_mobile_jxt_homeworkget.jsp传递参数：pid，当前登陆用户唯一