短信报表接口需求分析.doc

_____________需求分析说明书
编号：_________________
版本：_________________

调运系统短信报表接口

需求分析说明书

委托单位:
承办单位:

编写:(签名)_________________ 年 月 日
复查:(签名)_________________ 年 月 日
批准:(签名)_________________ 年 月 日

16

_____________需求分析说明书

修订历史记录

日期
版本
说明
作者
<日/月/年>
<x.x>
<详细信息>
<姓名>

目 录

1. 引言 2
1.1. 目的 2
1.2. 范围 2
1.3. 术语 2
1.4. 参考文献 2
2. 项目概述 3
2.1. 产品描述 3
2.2. 产品功能 3
2.3. 用户特点 3
2.4. 现实系统描述 3
2.5. 一般约束 3
2.6. 假设和依据 3
3. 具体需求 4
3.1. 功能需求 4
3.1.1. 定制短信报表 4
3.1.2. 生成短信报表 8
3.1.3. 发送短信报表 8
3.1.4. 短信用户管理 9
3.2. 外部接口需求 14
3.2.1. 用户接口 14
3.2.2. 硬件接口 14
3.2.3. 软件接口 14
3.2.4. 通信接口 14
3.3. 性能需求 14
3.4. 设计约束 14
3.4.1. 其它标准的约束 14
3.4.2. 硬件的限制 14
3.5. 属性 15
3.5.1. 可用性 15
3.5.2. 安全性 15
3.5.3. 可维护性 15
3.6. 其它需求 15
3.6.1. 数据库 15
3.6.2. 操作 15
3.6.3. 场合适应性 15

1. 引言
1.1. 目的
本需求说明书的目的是：
· 分析和描述本系统的具体业务需求
· 划分本系统各部分的功能
· 描述本系统和其它系统的接口规范
· 指导本系统以后的设计开发工作
本需求说明书预期的读者是：
项目领导、需求分析人员、系统设计人员、开发人员、测试人员、客户

1.2. 范围
本系统是中石油东北公司调运MIS系统的一个延伸，本系统范围仅限于短信报表的定制、生成和发送，以及对短信用户和群组的管理。
*******************************************************************
*******************************************************************
本需求到此为止还没有对调运系统的“通知通告”添加短信发送功能的描述；
本需求到此为止还没有描述关于用户通过用户界面发送自编辑短信的功能；
原因：没有想好关于通知通告的功能延伸在本片文档怎么描述；没有想好用户发送自编辑短信功能是否需要实现在本系统中，还是应该是现在短信发送平台？？？
*******************************************************************
*******************************************************************

1.3. 术语
调 运 系 统：中石油东北公司调运MIS系统。
系 统 用 户：简称用户，本系统的使用者，也就是调运系统中的“系统管理员”角色。
短 信 用 户：短信报表的接收者。短信用户应该都是调运系统中的相关业务人员。
调运系统用户：中石油东北公司调运MIS系统操作用户。
短信用户群组：简称群组，即一组短信用户，他们拥有同样的优先级。
手 机 短 信：或简称短信，英文缩写为SMS，是Short Message Service的缩写，也就是所谓的移动简讯服务。移动电话的功能，透过简短的讯息传送文字、图形或声音到他人的手机上。本文特指文字信息。
短 信 报 表：针对调运系统的业务，采用手机短信的方式，发送给短信用户的概括核心业务报表。
短信发送平台：本公司自主开发的手机短信发送和管理工具软件。

1.4. 参考文献
序号
文件名
文件编号
发表日期
出版单位
1
《中石油东北公司调运MIS系统需求分析说明书》
DBDY-MIS-V2.0_P_SRS_V1.0
2003-4-30
本公司内部资料

2. 项目概述
2.1. 产品描述
本系统是中石油东北公司调运MIS系统的一个延伸，为调运系统的客户提供延伸的服务——短信报表服务，将调运系统的核心业务报表概括成为简短的短信报表，通过手机短信的方式及时、准确的发送给相关用户。

2.2. 产品功能
1、 系统提供几个经典预设短信报表，用户可以直接进行使用，设置其生成及发送条件，发送给相关人员。
2、 用户可以根据短信报表模版自己定制短信报表，并设置其生成及发送条件，发送给相关人员。
3、 系统提供短信用户和群组的管理功能。
说明：
1、 本系统直接查询调运系统数据库中的动态业务数据，根据短信报表的生成条件生成短信报表。
2、 本系统可以提供多种短信报表发送方式：定时发送、条件发送、名令发送等。

2.3. 用户特点
见《中石油东北公司调运MIS系统需求分析说明书》

2.4. 现实系统描述
见《中石油东北公司调运MIS系统需求分析说明书》

2.5. 一般约束
部分业务规则受限制于中石油东北公司调运MIS系统

2.6. 假设和依据
中石油东北公司调运MIS系统已经完善，并完全符合业务需求。

3. 具体需求
3.1. 功能需求
本系统分为四个相对完整的功能：
· 定制短信报表
· 生成短信报表
· 发送短信报表
· 短信用户管理
以及几个经典预设短信报表。
以下各节逐一描述。。。。。。。。。

3.1.1. 定制短信报表

3.1.1.1. 功能简述
本系统提供用户定制短信报表的标准模版，用户不能随意修改该模版中的任何内容项。
用户可以根据系统所提供的“定制操作向导”，定制短信报表的数据内容、查询条件以及手机屏幕显示格式，以及该短信报表的发送优先级和接收者或接收者群组。系统提供几个预设短信报表，用户可以直接使用或修改后使用。
（第一阶段，本系统考虑不实现“定制操作向导”的全部功能，只提供用户界面使得用户可以将“定制意向”提交到本系统，然后由本系统维护人员负责手工建立新的短信报表，就是所谓“半自动定制”的程度）

3.1.1.2. 短信报表模版数据项
为了以下各功能描述的清楚明确，首先将短信报表模版的数据项在本小节简单描述。
短信报表模版数据项如下：
§ 编号：每条短信的编号唯一
§ 短信报表名称：几个字的简短名称
§ 短信报表简介：语言描述该报表的意义和功能等信息
§ 数据内容描述：语言描述该报表的数据组成和查询条件等信息
§ 显示格式：模拟手机屏幕报表显示格式
§ 接收人/组：一个/几个短信用户，或一个/几个短信用户群组。
§ 生成条件：语言描述生成条件，生成条件可以为：某个特定时间、某种特定情况、用户命令。
§ 发送条件：发送时间限制？（是否有必要？）
§ 发送优先级：1-5级，系统根据本级别和短信用户优先级进行发送顺序排列，具体发送顺序的计算见后文“3.1.3发送短信报表”中描述。
§ 活动状态：有效/暂停，有效状态为可以正常生成和发送的短信报表；暂停状态为暂时不生成和发送该短信报表
说明：后文中凡是提到短信报表，无论是系统预设还是用户自己定制，其数据都完全符合短信报表模版的数据项。

3.1.1.3. 浏览系统预设短信报表列表
输入：无
处理：查询当前所有预设短信报表。
输出：显示所有预设短信报表的列表。列表数据显示内容如下表：
编号
短信报表名称
短信报表简介
操作

说明：以上表格中最后一列的“操作”为用户操作按钮或链接，不是数据显示。
“按钮或链接”指什么？链接详细内容？
备注：目前本系统只提供几个预设短信报表，如果有更多则系统提供分页浏览功能。系统暂时不提供查询功能。

3.1.1.4. 查看系统预设短信报表详细内容
输入：短信报表的编号(短信报表名称)
处理：查询该短信报表的详细信息。
输出：该短信报表的详细信息，数据显示内容包括短信报表的全部数据项，详细见“3.1.1.2短信报表模版数据项”。

3.1.1.5. 修改系统预设短信报表
输入：短信报表的编号、用户修改信息（可修改信息包括：短信报表名称、短信报表简介、数据内容描述、显示格式、接收人/组、产生条件、发送条件？？？？？系统预设短信报表能不能允许用户修改这么多信息还有待进一步讨论）
处理：将用户修改的内容保存到本系统，并自动修正该短信报表的生成及发送（第一阶段的做法是：通知本系统维护人员修改相关短信报表）
输出：修改成功/失败信息；修改后的短信报表详细信息

3.1.1.6. 设置系统预设短信报表的发送优先级
输入：短信报表的编号、优先级（1-5）
处理：系统将相关短信报表的发送优先级设置为用户指定的级别。
输出：设置成功/失败信息

3.1.1.7. 设置系统预设短信报表的状态
输入：短信报表的编号、状态（有效/暂停）
处理：系统将相关短信报表的活动状态设置用户指定的状态。
输出：设置成功/失败信息
修改/优先级/状态三项功能是否在察看列表或者详细内容中完成？
3.1.1.8. 系统提供的预设短信报表
一、调运处陆运日报
§ 编号：XXXXXX
§ 短信报表名称：调运处综合日报
§ 短信报表简介：每日将调运处业务数据概括… ...
§ 数据内容描述：… …
§ 显示格式： 接收计划 条
接收计划变更 条
接收计划撤销 条
生成调度令 条
下发调度令 条
变更调度令 条
撤销调度令 条
分公司完成 车
分公司完成 吨
§ 接收人/组：lichenggang … …
§ 生成条件：每日17：30
§ 发送条件：发送时间限制？（是否有必要？）
§ 发送优先级：4
§ 活动状态：有效

二、计划处综合日报
三、分公司综合日报
四、计划处业务提醒
五、调运处业务提醒
六、分公司业务提醒
？？？
… …
待定

3.1.1.9. 浏览用户自定制短信报表列表
输入：无
处理：查询当前所有自定制短信报表。
输出：显示所有自定制短信报表的列表。列表数据显示内容如下表：
编号
短信报表名称
短信报表简介
操作

说明：以上表格中最后一列的“操作”为用户操作按钮或链接，不是数据显示。
备注：如果系统中保存了多个用户自定制短信报表，则系统提供分页浏览功能。系统暂时不提供查询功能。

3.1.1.10. 查看用户自定制短信报表详细内容
输入：短信报表的编号
处理：查询该短信报表的详细信息。
输出：该短信报表的详细信息，数据显示内容包括短信报表的全部数据项，详细见“3.1.1.2短信报表模版数据项”。

3.1.1.11. 添加用户自定制短信报表
输入：短信报表名称、短信报表简介、数据内容描述、显示格式、接收人/组、产生条件、发送条件、发送优先级、活动状态
处理：第一步：用户填写短信报表名称、短信报表简介、数据内容描述、显示格式、接收人/组、产生条件、发送条件
第二步：用户设置其发送优先级
第三步：用户设置其活动状态
第四步：系统生成短信报表编号，将用户填写的各数据项内容保存，并自动建立一个新的用户自定制短信报表（第一阶段的做法是：通知本系统维护人员为用户建立一个新的自定制短信报表）
输出：添加成功/失败信息；新添加的短信报表详细信息

3.1.1.12. 修改用户自定制短信报表
输入：短信报表的编号、用户修改信息（可修改信息包括：短信报表名称、短信报表简介、数据内容描述、显示格式、接收人/组、产生条件、发送条件）
处理：将用户修改的内容保存到本系统数据库，并自动修正该短信报表的生成及发送（第一阶段的做法是：通知本系统维护人员修改相关短信报表）
输出：修改成功/失败信息；修改后的短信报表详细信息

3.1.1.13. 删除用户自定制短信报表
输入：短信报表的编号
处理：提示用户是否确认删除，用户确认后，系统删除该短信报表。并自动停止该短信报表的生成和发送。（第一阶段的做法是：通知本系统维护人员，停止该短信报表的生成和发送）
输出：删除成功/失败信息

3.1.1.14. 设置用户自定制短信报表的发送优先级
输入：短信报表的编号、优先级（1-5）
处理：系统将相关短信报表的发送优先级设置为用户指定的级别。
输出：设置成功/失败信息

3.1.1.15. 设置用户自定制短信报表的状态
输入：短信报表的编号、状态（有效/暂停）
处理：系统将相关短信报表的活动状态设置用户指定的状态。
输出：设置成功/失败信息
修改/优先级/状态三项功能是否在察看列表或者详细内容中完成？
3.1.2. 生成短信报表
输入：短信报表编号，生成短信报表触发条件，调运系统动态业务数据
处理：第一步：检查当前短信报表的活动状态
第二步：根据预先定义的数据内容描述，查询调运系统数据库中的动态业务数据
第三步：将查询数据结果根据预先定义的显示格式，生成短信报表数据内容。
输出：短信报表数据内容
说明：生成短信报表的触发条件可以有多种：时间、条件或用户指令

3.1.3. 发送短信报表
输入：短信报表数据内容、短信用户名、短信用户群组编号
输入：短信报表数据内容，报表名称，用户ID,发送时间（短信用户群组是否设置优先级？，会与用户优先级冲突）
处理：第一步：根据短信用户名或短信用户群组编号检查当前短信用户或短信用户群组的活动状态。
第二步：根据短信用户名或短信用户群组编号查询出需要发送的所有手机号码。
第三步：根据短信用户的优先级或短信用户群组的优先级与当前短信报表的优先级进行运算，得到最终的发送优先级。
第三步：将短信报表数据内容、手机号码（1个或多个）、发送优先级，组织成“短信发送平台”所要求的接口数据格式送出，或存储在相应的存储空间等候读取。（如果本系统提供订时发送功能，则本步骤还需要根据发送时间条件锁定尚不到发送时间的短信报表）
输出：短信报表数据、手机号码、最终的发送优先级
说明：本系统可以提供多种短信报表发送方式：定时发送、条件发送、命令发送等

3.1.4. 短信用户管理

第一部分：短信用户

3.1.4.1. 功能简述
首先，请参看“1.3术语”小节中关于“短信用户”的定义，区别于本文档其它章节所提到的“系统用户”或“用户”。
本系统提供对短信用户档案的管理功能，以及短信用户群组的管理功能，具体见下面章节所述。

3.1.4.2. 短信用户档案的数据信息
为了以下短信用户的相关各功能操作描述能够清楚明确，首先将用户档案的数据项在本小节简单描述。
短信用户档案数据项如下：
· 短信用户名：可以是姓名或其他代号
· 手机号码：中国移动或中国联通手机号码
· 短信用户优先级：1-5级，系统根据本级别和短信报表优先级进行发送顺序排列，具体发送顺序的计算见后文“3.1.3发送短信报表”中描述。
· 活动状态：有效/暂停，有效状态为系统正常发送短信报表给该短信用户；暂停状态为系统暂停发送短信报表给该短信用户。
· 备注：关于短信用户的其他说明。
· 调运系统ID：如果短信用户同时也是调运系统的用户，则根据此ID的关联可以从调运系统得到该短信用户的姓名、单位/部门、职位等信息。

3.1.4.3. 浏览短信用户档案列表
输入：无
处理：查询当前所有短信用户档案。
输出：显示所有短信用户档案的列表。列表数据显示内容如下表：
短信用户名
手机号码
优先级
状态
备注
调运系统ID
操作

说明：1、以上表格中最后一列的“操作”为用户操作按钮或链接，不是数据显示。
2、以上表格中倒数第二猎的“调运系统ID”列，不但显示短信用户的调运系统ID信息，而且可以通过该信息关联得到调运系统中的用户信息，具体见下文“3.1.4.4显示调运系统用户信息”小节描述。
备注：如果系统中保存了多个短信用户档案，则系统提供分页浏览功能。系统暂时不提供查询功能。

3.1.4.4. 显示调运系统用户信息
输入：短信用户的调运系统ID
处理：系统到调运系统数据库中查询该用户相关信息。
输出：调运系统用户信息，具体如下：
· 用户名称
· 真实姓名
· 性别
· 部门
· 用户类别

3.1.4.5. 添加短信用户档案
输入：短信用户名、手机号码、短信用户优先级、活动状态、备注、调运系统ID
处理：第一步：用户填写短信用户名、手机号码、备注、调运系统ID
第二步：用户设置短信用户优先级
第三步：用户设置短信用户活动状态
第四步：系统将用户填写的各数据项内容保存，并自动建立一个新的短信用户，可以随时为其提供短信报表服务。
输出：添加成功/失败信息；新添加的短信用户档案详细信息

3.1.4.6. 修改短信用户档案
输入：短信用户名、用户修改信息（可修改信息包括：手机号码、备注、调运系统ID）
处理：将用户修改的内容保存到本系统数据库。
输出：修改成功/失败信息；修改后的短信用户档案详细信息

3.1.4.7. 删除短信用户档案
输入：短信用户名
处理：提示用户是否确认删除，用户确认后，系统删除该短信用户档案。并自动停止对该短信用户发送短信报表的服务。
输出：删除成功/失败信息

3.1.4.8. 设置短信用户优先级别
输入：短信用户名、优先级（1-5）
处理：系统将相关短信用户的优先级设置为用户指定的级别。
输出：设置成功/失败信息

3.1.4.9. 设置短信用户状态
输入：短信用户名、状态（有效/暂停）
处理：系统将相关短信用户的活动状态设置用户指定的状态。
输出：设置成功/失败信息

第二部分：短信用户群组

3.1.4.10. 短信用户群组数据信息
为了以下短信用户群组的相关各功能描述能够清楚明确，首先将用户群组的数据项在本小节简单描述。
短信用户群组数据项如下：
· 群组编号：短信用户群组的一个编号代码
· 群组名称：几个文字的简短名称
· 群组简介：文字描述的简介
· 短信用户：该群组包含哪些短信用户
· 群组优先级：1-5级，选择群组发送时，组中所有用户均使用该群组的优先级别
· 活动状态：有效/暂停，有效状态为系统正常发送短信报表给该短信用户群组；暂停状态为系统暂停发送短信报表给该短信用户群组。注意：如果某群组状态为无效，并不影响组中单个短信用户的活动状态。
· 备注：关于短信用户群组的其他说明。

3.1.4.11. 浏览短信用户群组列表
输入：无
处理：查询当前所有短信用户群组。
输出：显示所有短信用户群组的列表。列表数据显示内容如下表：
群组编号
群组名称
群组简介
优先级
状态
备注
操作

说明：以上表格中最后一列的“操作”为用户操作按钮或链接，不是数据显示。
备注：如果系统中保存了多个短信用户群组，则系统提供分页浏览功能。系统暂时不提供查询功能。

3.1.4.12. 查看群组包含的短信用户
输入：短信用户群组编号
处理：查询出该群组包含的所有短信用户
显示：该群组所包含得短信用户的信息，同于短信用户档案列表，具体见“3.1.4.3浏览短信用户档案列表”小节。

3.1.4.13. 添加短信用户群组
输入：群组编号、群组名称、群组简介、包含短信用户、群组优先级、活动状态、备注
处理：第一步：用户填写群组编号、群组名称、群组简介、备注
第二步：用户添加属于该群组的短信用户
第三步：用户设置群组优先级
第四步：用户设置群组活动状态
第五步：系统将用户填写的各数据项内容保存，并自动建立一个新的短信用户，可以随时为其提供短信报表服务。
输出：添加成功/失败信息；新添加的短信用户档案详细信息

3.1.4.14. 修改短信用户群组
输入：短信用户群组编号、用户修改信息（可修改信息包括：群组名称、群组简介、备注）
处理：将用户修改的内容保存到本系统数据库。
输出：修改成功/失败信息；修改后的短信用户群组详细信息

3.1.4.15. 删除短信用户群组
输入：短信用户群组编号
处理：提示用户是否确认删除，用户确认后，系统删除该短信用户群组。并自动停止对该短信用户群组发送短信报表的服务。注意：删除群组并不删除该群组中的任何短信用户，并且不影响群组中的任何短信用户的活动状态。
输出：删除成功/失败信息

3.1.4.16. 添加群组中的短信用户
输入：短信用户群组编号、短信用户名
处理：系统将用户填写的短信用户名（一个或多个）加入该群组中，以后对该群组发送短信报表时，已加入该群组的短信用户可以正常接收短信报表服务。
输出：添加成功/失败信息

3.1.4.17. 设置短信用户群组优先级
输入：短信用户群组编号、优先级（1-5）
处理：系统将相关短信用户群组的优先级设置为用户指定的级别。注意：群组的优先级和单个短信用户的优先级可以不同，发送时如果选择对群组发送则以群组的优先级为准，如果选择对若干单个短信用户发送，则以单个短信用户的优先级为准。
输出：设置成功/失败信息

3.1.4.18. 设置短信用户群组活动状态
输入：短信用户群组编号、状态（有效/暂停）
处理：系统将相关短信用户群组的活动状态设置用户指定的状态。注意：群组的活动状态和单个短信用户的活动状态可以不同，发送时如果选择对群组发送则以群组的活动状态为准（但群组中个人状态为“暂停”的短信用户无法接收短信报表服务），如果选择对若干单个短信用户发送，则以单个短信用户的活动状态为准。
输出：设置成功/失败信息

3.2. 外部接口需求
3.2.1. 用户接口
略

3.2.2. 硬件接口
无

3.2.3. 软件接口
本系统和调运系统的接口：
调运系统对本系统完全开放，本系统可以直接查询调运系统的数据库。
本系统和短信发送平台的接口数据格式：
短信报表数据内容、手机号码（一个或多个）、发送优先级

3.2.4. 通信接口
无

3.3. 性能需求
生成和发送短信报表及时、准确！

3.4. 设计约束
3.4.1. 其它标准的约束
业务规则受调运系统约束。

3.4.2. 硬件的限制
无

3.5. 属性
3.5.1. 可用性
3.5.2. 安全性
3.5.3. 可维护性

3.6. 其它需求
3.6.1. 数据库
3.6.2. 操作
3.6.3. 场合适应性