华卫无线移动临床信息系统-客户端用例1.docx

客户端用例
1. 登录
1.1. 用例描述
前置条件：
客户端应用程序启动后，经检测，确认可以通过网络访问服务器并且服务器正常工作。
基本流程：
1、 在登录界面填写用户名与密码；
2、 点击登录按钮，进行登录；
3、 登录成功；
替代流程：
3A：登录验证失败：
1） 显示登录失败的提示对话框，等待用户确认；
2） 用户确认之后，用户重新执行1、的操作；
3B：中登录验证超时：
1） 显示“服务器无响应”对话框，等待用户确认；
2） 用户确认之后，可以重新执行1、的操作，或者结束应用程序；
特殊需求：
无
后置条件：
返回用户姓名、所在工作组(护理单元名及科室代码，可能多个)、用户角色与权限；将上述内容保存在客户端临时文件User.xml文件中；然后由上述条件，显示客户端对应操作界面首页。
1.2. 用户界面

图1.1 登录界面1 图1.2 登录界面2

图1.3 登录界面3 图1.4 登录界面4
1.3. 操作流程
1、 客户端程序启动后，与配置的服务器地址连接，连接成功之后，显示登录页面，如图1.1 登录界面1所示。其中（1）是账号输入框，用于输入用户的账号，该输入框为comboBox控件，可以通过键盘输入账号，也可以通过下拉列表从以往登录成功的账号中选择账号；（2）是密码输入框，用于输入相应的密码，显示的字符为“*”或者“●”；（3）为登录按钮；
2、 （1）账号输入框中，使用灰色字体，初始显示“请输入账号”，当用户点击（1）账号输入框时，清空（1）中的内容；
3、 （2）密码输入框中，使用灰色字体，初始显示“请输入密码”，当用户点击2）密码输入框时，清空（2）中的内容；
4、 用户在账户输入框中，通过键盘或者下拉列表的形式，输入账号，界面效果如图1.2 登录界面2所示；
5、 用户在密码输入框中输入密码；
6、 用户按下登录按钮，进行账号和密码的非空检测，如果账号或者密码为空，提示用户填入账号和密码，显示效果未绘图，请参考图1.4 登录界面4中的错误提示界面；
7、 用户按下确认后，界面显示回图1.1 登录界面1的效果；
8、 如账号和密码填写完整，用户按下登录按键，此时登录按键变为“禁用”状态，界面效果如图1.3 登录界面3所示；
9、 如果登录不成功，弹出对话框，提示“账号或者密码错误”，并等待用户确认；
10、 用户按下确认按钮后，登录按钮恢复“使能”，显示效果如图1.1 登录界面1所示，但是此时的（1）账号输入框中，使用灰色字体，初始显示之前填写的账号；当用户点击（1）账号输入框时，清空（1）中的内容；（2）密码输入框中，使用灰色字体，仍然填写之前的登录密码，显示为密码符，当用户点击2）密码输入框时，清空（2）中的内容；
11、 如果登录成功， 获取用户姓名、所在工作组(护理单元名及科室代码，可能多个)、用户角色与权限；将上述内容保存在客户端临时文件User.xml文件中；程序可以随时调用这几项内容，用于用户管理、数据提交时的用户确认等。
12、 根据User.xml内容，显示用户界面首页；
1.4. 交互流程

图1.5 客户端和服务器登录交互图

1、 客户端使用API接口，向服务发送登录数据；
2、 服务器端，选择“用户验证”核心业务处理程序进行用户验证；
3、 服务器将验证结果返回客户端；
1.5. 数据描述
1.5.1. 登录数据XML文件格式
1、XML文件内容
<?xml version="1.0" encoding="gb2312"?>
<LoginInfo>
<User>用户名</User>
<Pwd>密码</Pwd>
<App>程序名</App>
<Ver>版本号</Ver>
</LoginInfo>

2、注释

1.5.2. 验证结果XML文件格式
1、XML文件内容
<?xml version="1.0" encoding="gb2312"?>
<LoginResult>
<Result>登录结果</Result>
<User>用户名</User>
<UserName>用户姓名</UserName>
<Group>
<Department>科室</ Department ><Dept_code>科室代码</ Dept_code >
<Department>科室</ Department ><Dept_code>科室代码</ Dept_code >
<Department>科室</ Department ><Dept_code>科室代码</ Dept_code >
</ Group >
<Capability>用户权限</Capability>
</LoginResult>
<LoginResult>标签的值是fail或者ok，fail表示登录失败，ok表示登录成功。
2、注释
登录结果：0为失败，1为成功，2为超时；
用户名为用户ID，在数据修改提交数据库时需用到；用户姓名用于界面使用提醒；
Group用户组中至少含一个科室，也可能存在多个科室；
用户权限则用于判断应用程序中可使用的功能。
1.6. 程序处理
1.6.1. 客户端程序
1、 客户端应该使用XML文件，记录最近曾经成功登录的5个账号，以便使用comboBox下拉列表进行选择，降低用户使用时频繁输入用户名的工作强度。
2、 客户端发送的登录数据使用XML文件封装，其数据格式见1.5.1节
3、 客户端发送登录数据时，使用ClientSDK.SynSentFrame_Dll函数，可以使用同步操作功能；
4、 ClientSDK.SynSentFrame_Dll函数返回值为true时，表示服务器有返回，为false时，表示服务器超时无响应；
5、 ClientSDK.SynSentFrame_Dll函数返回值为true是，可以获得服务器返回的验证结果，验证结果数据使用XML格式封装，其数据格式见1.5.2节
1.6.2. 服务器核心业务处理程序
1、 服务器端使用核心业务号进行核心业务处理程序的选择；
2、 服务器端账号验证的处理程序抽取登录数据的XML文件中的用户名和密码，并使用数据库连接池进行SQL语句查询；
3、 验证的结果返回给客户端，验证结果数据使用XML格式封装，其数据格式见1.5.2节
1.6.3. 对应数据库
1.6.3.1. 移动用户MOBILE_USERS
字段中文名称
字段名
类型
长度
说明
用户名
USER
C
16
本系统为每个最终用户在移动查房管理系统级建立一个用户，用户名在整个系统中唯一
用户姓名
USER_NAME
C
10
用户姓名
用户密码
pwd
varchar2(20)
加密存储的用户口令
用户状态
Ability
number(1)
确定用户是否有效
建立日期
CREATE_DATE
D

建立本用户的日期
主键：USER, pwd
注释：描述本系统移动查房用户的各种属性，通过用户管理机制对用户访问本系统数据库进行控制。本表的记录由本系统设置的用户控制子系统建立和修改。
1.6.3.2. 移动用户权限MOBILE_USERS_GRANTS
字段中文名称
字段名
类型
长度
说明
用户名
USER
C
16
本系统为每个最终用户在移动查房管理系统级建立一个用户，用户名在整个系统中唯一
应用程序
APP
C
20

应用程序权限
CAPABILITY
C
1
与移动应用程序相对应
主键： USER, APP
注释：描述本系统移动查房用户的各种属性，通过用户管理机制对用户访问本系统数据库进行控制。本表的记录由本系统设置的用户控制子系统建立和修改。
1.6.3.3. 移动用户工作组MOBILE_USERS_GROUP
字段中文名称
字段名
类型
长度
说明
用户名
USER
C
16
本系统为每个最终用户在移动查房管理系统级建立一个用户，用户名在整个系统中唯一
科室
DEPARTMENT
C
12
科室简称，以便PDA显示
科室代码
DEPT_CODE
C
8

对应身份
IDENTITY
C
10
护士、护士长、医生、主任等
主键： USER, DEPT_CODE
注释：描述本系统移动查房用户的各种属性，通过用户管理机制对用户访问本系统数据库进行控制。本表的记录由本系统设置的用户控制子系统建立和修改。
1.6.3.4. 移动应用程序名MOBILE_APP
字段中文名称
字段名
类型
长度
说明
应用程序
APP
C
20

应用程序
APP_NAME
C
40
包括移动护士工作站，移动医生工作站，移动药品工作站、移动检查、检验等
主键： APP
注释：描述本系统移动查房用户的各种属性，通过用户管理机制对用户访问本系统数据库进行控制。本表的记录由本系统设置的用户控制子系统建立和修改。