软件文档写作实训报告苏博人力资源管理.docx
《软件文档写作实训报告苏博人力资源管理.docx》由会员分享，可在线阅读，更多相关《软件文档写作实训报告苏博人力资源管理.docx（23页珍藏版）》请在冰豆网上搜索。
软件文档写作实训报告苏博人力资源管理
辽宁工业大学
软件文档写作实训报告
题目：
人力资源管理系统软件文档
院（系）:
软件学院
专业班级：
软件技术081班
学号：
081404011
学生姓名：
安凯辰
指导教师：
王彦华
教师职称：
助教
起止时间：
2010.11.22-2010.12.6
实训任务及评语
院（系）：
软件学院教研室：
软件教研室
学号
081404011
学生姓名
安凯辰
专业班级
软件技术081
实训题目
人力资源管理系统软件文档
实训任务
实训任务及要求：
1、了解软件开发周期各阶段的文档。
2、掌握各文档阐述的内容及作用。
3、了解文档所采用的国际、国家等相关标准。
4、了解各文档所涉及的软件知识。
5、掌握各文档采用的描述工具。
6、具体编写出2个主要的软件文档。
实训过程中，要严格遵守实训的时间安排，听从指导教师的指导。
正确地完成上述内容，记录实习日记，规范完整地撰写出实训报告。
几个人为一组完成一个相对完整的软件系统开发文档，组内成员编写的文档不能重复，文档要严格按照所采用的标准编写，图表布局要合理规范。
指导教师评语及成绩
成绩：
指导教师签字：
年月日
目录
第1章实训目的与要求1
1.1实训目的1
1.2实训的实验环境1
1.3实训的预备知识1
1.4实训要求1
第2章软件文档及其组成2
2.1软件文档的作用及分类2
2.2软件文档所采用的标准3
2.2软件文档的主要内容4
第3章实例5
3.1详细设计实例5
3.2测试分析实例15
第4章实训日记17
第5章实训总结18
第1章实训目的与要求
1.1实训目的
本实训要求学生通过具体的实例，模仿软件开发过程中软件文档写作的具体方法和步骤，分组完成一套较为简单软件文档，具体要达到以下几点目的。
1、了解软件开发周期各阶段的文档。
2、掌握各文档阐述的内容及作用。
3、了解文档所采用的国际、国家等相关标准。
4、了解各文档所涉及的软件知识。
5、掌握各文档采用的描述工具。
6、具体编写出2个主要的软件文件。
1.2实训的实验环境
学校图书馆，互联网查询环境，具有软件图表制作软件的计算机。
1.3实训的预备知识
要求学生修完全部专科所有课程，具有较全面计算机软件知识和一定的文献检索能力及动手实践能力。
该实训应安排在毕业设计之前进行。
1.4实训要求
实训过程中，要严格遵守实训的时间安排，听从指导教师的指导。
正确地完成上述内容，记录实习日记，规范完整地撰写出实训报告。
第2章软件文档及其组成
2.1软件文档的作用及分类
软件文档（document）也称文件，通常指的是一些记录的数据和数据媒体，它具有固定不变的形式，可被人和计算机阅读。
它和计算机程序共同构成了能完成特定功能的计算机软件（有人把源程序也当作文档的一部分）。
我们知道，硬件产品和产品资料在整个生产过程中都是有形可见的，软件生产则有很大不同，文档本身就是软件产品。
没有文档的软件，不成其为软件，更谈不到软件产品。
软件文档的编制在软件开发工作中占有突出的地位和相当的工作量。
在软件的生产过程中，总是伴随着大量的信息要记录、要使用。
因此，软件文档在产品的开发生产过程中起着重要的作用：
1）.提高软件开发过程的能见度。
把开发过程中发生的事件以某种可阅读的形式记录在文档中。
管理人员可把这些记载下来的材料作为检查软件开发进度和开发质量的依据，实现对软件开发的工程管理。
2）提高开发效率。
软件文档的编制，使得开发人员对各个阶段的工作都进行周密思考、全盘权衡、从而减少返工。
并且可在开发早期发现错误和不一致性，便于及时加以纠正。
3）作为开发人员在一定阶段的工作成果和结束标志。
4）记录开发过程中的有关信息，便于协调以后的软件、开发、使用和维护。
5）提供对软件的运行、维护和培训的有关信息，便于管理人员、开发人员、操作人员、用户之间的协作、交流和了解。
使软件开发活动更科学、更有成效。
6）便于潜在用户了解软件的功能、性能等各项指标，为他们选购符合自己需要的软件提供依据。
文档在软件开发人员、软件管理人员、维护人员、用户以及计算机之间的多种桥梁作用。
软件开发人员在各个阶段中以文档作为前阶段工作成果的体现和后阶段工作的依据，这个作用是显而易见的。
我们称此为开发文档。
软件开发过程中软件开发人员需制定一些工作计划或工作报告，这些计划和报告都要提供给管理人员，并得到必要的支持。
管理人员则可通过这些文档了解软件开发项目安排、进度、资源使用和成果等。
我们称这些文档为管理文档。
软件开发人员需为用户了解软件的使用、操作和维护提供详细的资料，我们称此为用户文档。
以上三种文档构成了软件文档的主要部分。
详细构成如图2.1所示：
文档
用户文档
用户手册
操作手册
维护修改建议
软件需求（规格）说明书
开发文档
软件需求（规格）说明书
数据要求说明书
概要设计说明书
详细设计说明书
可行性研究报告
项目开发计划
管理文档
项目开发计划
测试计划
测试报告
开发进度月报
开发总结报告
图2.1详细构成图
2.2软件文档所采用的标准
参照其它工程领域对工程标准划分的方法，软件工程标准主要有两种划分方法：
按标准的类型划分和按标准的范围划分。
一、按标准的类型划分：
按标准的类型划分主要有过程标准、产品标准、行业标准、记法标准等。
过程标准与开发一个产品或从事一项服务的一系列活动或操作有关。
过程标准使用一组方法、工具和技术，给出“谁来做”、“做什么”、“如何做”、“何时做”、“何地做”及在软件工程活动中进行的不同层次工作的过程模型。
产品标准则涉及软件工程事务的格式和内容。
软件开发和维护活动文档化的结果就是软件产品，软件文档是软件工程活动进一步开展的基础。
软件开发作为一种行业，其行业标准涉及软件工程的所有方面，如职业认证、职业培训、产品许可等。
行业标准可以等同于行业行为规范。
记法标准规定了在软件工程行业范围内，以唯一的方式进行交流的方法，如术语、表示法、语言等。
它其实是一种语境规范。
二、按标准的范围划分：
按标准的范围划分主要是根据软件的任务功能和软件生存期进行比较、判定、评价和确定软件工程标准的范围和内容。
任务功能可以表示软件工程过程，可以划分为产品工程功能、验证与确认功能以及技术管理功能3个部分。
产品工程功能包括定义、生产和支持最终产品所必须的过程。
验证和确认功能是检查产品质量的活动。
技术管理功能是构造和控制产品工程的过程。
这3个部分并不集中在单个的软件生存周期里，而是并行进行的生产、检查和控制活动。
2.2软件文档的主要内容
我所做的软件文档是人力资源管理系统软件文档。
人力资源管理系统软件文档包括人力资源管理系统操作手册、人力资源管理系统测试计划、人力资源管理系统概要设计说明书、人力资源管理系统可行性分析报告、人力资源系统管理系统需求说明书、人力资源管理系统详细设计说明书、人力资源管理系统项目计划、人力资源管理系统项目总结报告、人力资源管理系统用户手册。
人力资源管理系统（HRM）分为以下六大模块：
人事管理、工资管理、职位变更管理、离职管理、培训管理、辅助系统，各模块的基本功能如下：
人事管理模块：
包括人员档案、个人档案和部门机构的维护（人员的新增、修改、查看功能；个人档案的修改、查看功能，以及部门机构的新增、删除、修改、查看功能）。
工资管理模块：
包括基本工资的设置；考勤、考核资料的导入；以及最终工资报表的查询和打印。
职位变更管理：
包括职位空缺的维护（新增、删除、修改、查看、审核），应聘人员的登记、面试安排和考评；员工推荐的登记和考评；人事和领导的审批；调职记录的维护（新增、删除、修改、查看）。
离职管理模块：
包括离职的申请、审批以及离职信息的维护。
培训管理模块：
包括培训课程、培训讲师档案的维护；培训需求的维护（收集、审核）；以及培训课程的安排、培训考核和培训反馈的维护。
辅助系统模块：
包括数据的备份、还原；员工的权限设置；个人密码修改；以及退出系统功能。
第3章实例
3.1详细设计实例
一、概述
1.编写目的：
本文挡提供给开发人员进行开发参考，以及测试人员编写单元测试所用。
2.项目背景：
系统名称：
人力资源管理系统
开发者：
苏博，王寿强，孙德福，姚坤
详细设计的原则和方法：
项目整体结构清晰，按照概要设计的结构来进行详细设计。
系统详细设计后容易扩展，降低对其他模块的耦合性。
详细设计要做到可操作性，使读者能清楚所要实现的功能，以及如果去实现。
粒度设计到方法。
不具体设计到方法内的伪代码。
3.术语和缩写：
术语描述性定义
Entity:
实体
DAL:
数据访问层
BLL：
业务逻辑层
UserProfile:
用户的详细信息
Reeducation:
再教育
ReferPeople:
家庭成员
JobHistory:
职位变更的历史记录
Recommendation:
推荐
二、软件模块标识，如表3.1所示：
编号
模块名称
模块标识
1
人事信息管理
1．1
基本信息管理
User
1．2
详细信息管理
UserProfile
1．3
教育信息管理
Education
1．4
再教育信息管理
ReEducation
1．5
工作经验信息管理
Experience
1．6
项目经验信息管理
Project
1．7
技能信息管理
Skill
1．8
家庭成员信息管理
ReferPeople
2
职位变更
2．1
职位空缺登记
Vacancy
2．2
简历信息
同人事信息管理各模块
2．3
面试相关信息
Interview
2．4
领导审批
Interview
2．5
录用情况
JobHistory
2．6
推荐信息
Recommendation
2．7
推荐考核信息
PositionScore
2．8
调职记录信息
JobHistory
3
系统管理
3．1
部门管理
Department
3．2
职位管理
Position
3．3
密码修改
User
表3.1软件模块标识
三、基本信息管理
（一）、表示层，如图3.1
图3.1基本信息管理表示层
（二）、业务逻辑层
功能描述：
对用户基本信息进行管理
模块编号：
1.1
模块功能：
对用户的基本信息的操作和维护，包括：
增加用户基本信息，修改用户的基本信息，查询用户的基本信息，删除用户
模块名称：
UserBiz
命名空间：
Microlink.HRM.UserBiz
处理：
对用户基本信息的增加，修改，查询用户或列表
属性
功能：
获取和设置User实体
名称：
User
方式：
Get&Set
返回值：
User
处理过程：
无
函数和过程
1、添加用户
过程功能：
添加一个系统用户
过程名称：
AddUser
参数说明：
无
返回值：
bool是否成功
处理过程：
首先读取配置的初始密码，如果没有配置初始密码，则赋给它“123456”。
然后通过数据层Insert记录。
2、删除用户
过程功能：
修改用户的状态为离职状态
过程名称：
DeleteUser
参数说明：
无
返回值：
bool是否成功
处理过程：
修改员工的状态为离职状态，调用ChangeUserInfo修改其状态。
3、修改用户
过程功能：
修改用户的信息
过程名称：
ChangeUserInfo
参数说明：
无
返回值：
bool是否成功
处理过程：
通过修改实体信息，再通过用户编号ID把实体信息Update到数据库中。
4、获取某一用户
过程功能：
通过ID获取某一用户
过程名称：
GetUser
参数说明：
longID用户编号
返回值：
User
处理过程：
以用户编号为参数，调用数据层的Load（ID）来获取用户实体，并返回用户实体
5、获取所有用户
过程功能：
获取所有用户
过程名称：
GetAllUsers
参数说明：
无
返回值：
DataTable包含所有用户的列表
处理过程：
通过数据层的LoadAll获取所有用户的数据集，提取其中的Users表。
6、用户登录
过程功能：
通过用户和密码登录系统
过程名称：
Login
参数说明：
stringuserName用户名
Stringpassword密码
SringlogIP登录IP
返回值：
bool看是否验证通过
处理过程：
对密码进行MD5加密，看是否和数据库数据匹配。
匹配通过后，加载用户信息，否则退出。
（三）、数据访问层
功能描述：
对用户基本信息进行管理
模块编号：
1.1
模块功能：
对用户的基本信息的操作和维护，包括：
增加用户基本信息，修改用户的基本信息，查询用户的基本信息，删除用户
模块名称：
UserDAL
命名空间：
Microlink.HRM.UserDAL
处理：
用户基本信息的增加，修改，查询用户或列表，以及验证用户等数据库操作
1、插入用户记录
过程功能：
插入一条用户记录
过程名称：
Insert
参数说明：
UseruserEntity用户实体
返回值：
bool是否操作成功
处理过程：
把实体的值赋给存储过程NewUser参数，操作存储过程完成
2、修改用户记录
过程功能：
修改一条用户记录
过程名称：
Update
参数说明：
UseruserEntity用户实体
返回值：
bool是否操作成功
处理过程：
从数据库提取的实体，经过修改后的提交到存储过程UpdateUser进行修改。
3、获取用户
过程功能：
获取一条用户记录
过程名称：
Load
参数说明：
longuserID
返回值：
User
处理过程：
通过编号作为参数来调用存储过程GetUser来获取单用户信息。
4、获取所有用户
过程功能：
获取所有用户记录
过程名称：
LoadAll
参数说明：
无
返回值：
DataSet
处理过程：
调用存储过程GetAllUser，通过查询语句返回所有用户表
5、获取所有用户的联系信息
过程功能：
获取所有用户记录的联系信息
过程名称：
LoadAddressList
参数说明：
无
返回值：
DataSet
处理过程：
通过GetAddressList的存储过程来查询所有用户的联系信息。
包括的联系信息有：
EmailAddress,MobilePhone,UserProfile.PhsPhone,OtherPhone
四、详细信息管理
（一）、表示层，如图3.2所示：
图3.2详细信息管理
（二）、业务逻辑层
功能描述：
对用户详细信息进行业务管理
模块编号：
1.2
模块功能：
对用户的详细信息的操作和维护，包括：
增加用户详细信息，修改用户的详细信息，查询用户的详细信息等
模块名称：
UserProfileBiz
命名空间：
Microlink.HRM.UserProfileBiz
处理：
用户详细信息的增加，修改，查询等操作
属性：
功能：
获取和设置UserProfile实体
名称：
UserProfile
方式：
Get&Set
返回值：
UserProfile
处理过程：
无
功能：
获取和设置员工的教育信息
名称：
Education
方式：
Get&Set
返回值：
DataTable
处理过程：
无
功能：
获取和设置家庭成员
名称：
ReferPeople
方式：
Get&Set
返回值：
DataTable
处理过程：
无
功能：
获取和设置工作经验
名称：
Experience
方式：
Get&Set
返回值：
DataTable
处理过程：
无
功能：
获取和设置项目经验
名称：
Project
方式：
Get&Set
返回值：
Project
处理过程：
无
功能：
获取和设置再教育信息
名称：
ReEducation
方式：
Get&Set
返回值：
DataTable
处理过程：
无
功能：
获取和设置员工的数据集，包括家庭成员，教育，再教育，项目经验，工作经验。
参考LoadUserInfo
名称：
UserInfo
方式：
Get&Set
返回值：
DataSet
处理过程：
无
函数和过程：
1、获取员工有关的列表信息
过程功能：
包括获取家庭成员，教育，再教育，项目经验，工作经验列表
过程名称：
LoadUserInfo
参数说明：
longuserID编号
返回值：
bool是否成功
处理过程：
如果userID为0则返回，否则通过DAL各自加载家庭成员，教育，再教育，项目经验，工作经验的DataTable到UserInfo的数据集中。
1、添加员工详细信息
过程功能：
添加UserProfile
过程名称：
AddUserProfile
参数说明：
无
返回值：
bool是否成功
处理过程：
通过数据层来insert实体UserProfile
2、修改员工详细信息
过程功能：
修改员工详细的信息
过程名称：
ChangeUserProfile
参数说明：
无
返回值：
bool是否成功
处理过程：
通过数据层来Update员工修改的详细信息
（三）、实体层，如图3.3所示：
图3.3实体层
（四）、数据访问层
功能描述：
对用户详细信息进行管理
模块编号：
1.2
模块功能：
对用户的详细信息的操作和维护，包括：
增加用户基本信息，修改用户的基本信息，查询用户的基本信息
模块名称：
UserProfileDAL
命名空间：
Microlink.HRM.UserProfileDAL
处理：
用户详细信息的增加，修改，查询用户操作
1、插入用户详细信息记录
过程功能：
插入一条用户详细信息记录
过程名称：
Insert
参数说明：
UserProfileuserProfileEntity用户实体
返回值：
bool是否操作成功
处理过程：
把实体的值赋给存储过程AddUserProfile参数，操作存储过程完成
2、修改用户记录
过程功能：
修改一条用户记录
过程名称：
Update
参数说明：
UserProfileuserProfileEntity用户实体
返回值：
bool是否操作成功
处理过程：
从数据库提取的实体，经过修改后的提交到存储过程SetUserProfile进行修改。
3、获取用户
过程功能：
获取一条用户记录
过程名称：
Load
参数说明：
longuserID
返回值：
UserProfile
处理过程：
通过编号作为参数来调用存储过程GetUserProfile来获取单用户信息。
3.2测试分析实例
一．概述
1．编写目的：
为了能以最少的人力和是发现潜在的各种错误和缺陷。
系统测试是保证系统质量和可靠性的关键步骤，是对系统开开过程的系统分析，系统设计和实施的最后检查。
2.项目背景：
系统名称：
人力资源管理系统
开发者：
苏博，王寿强，孙德福，姚坤
CPU：
pIV2.6G
硬盘：
80G
内存：
256M
操作系统：
windowsXP
软件开发环境：
VisualBasic6.0、sqlserver2000
其它辅助软件：
Microsoftoffice2000,Photoshop7.0等
测试环境：
与实际运行环境之间可能存在的差异以及这些差异对测试结果的影响。
二．测试概要：
1．系统登陆测试用例：
功能特性：
正确验证系统角色用户，正常进入系统进行操作
测试目的：
对输入的用户名、密码、验证码进行合法性检查。
预置条件：
注册用户名:
苏博
密码：
9999
角色：
苏博
如表3.4所示：
用例说明
输入数据
预期结果
实际结果
测试结果
不输入信息
输入为空,其它为预置条件
提示请输入用户名和密码或用户名密码无效
用户名密码无效
正确
随便输入一个用户名和密码
户名:
杨家华
密码：
19987
提示请输入用户名和密码或用户名密码无效
用户名密码无效
正确
只输入用户名
用户名:
苏博
它为预置条件
输入密码无效
输入密码无效
正确
只输入密码
密码:
9999
它为预置条件
输入用户名无效
输入用户名或密码无效
错误
输入用户名和密码
用户名:
苏博
密码：
9999
登录成功
登录成功
正确
表3.1
三.对软件功能的结论
功能（系统登陆测试）：
如用户名和密码输入不正确，会出现什么情况。
输入用户名和密码都正确，看是否能登陆。
第4章实训日记
时间
实训任务
第1天
自由分组，选择题目。
小组4个人选择的题目。
第2-7天
通过网络查寻大量关于人力资源管理系统软件工程文档的相关资料并且布置给每个组内成员相应的任务，分配了每个人设计文档说明书各部分，并且对每个文档要进行概要的设计和说明。
第8-13天
通过分组分配编写设计说明和软件测试文档，首相了解软件工程文档作用及分类并将了解到的内容整理到报告中，并加强对软件文档编写的理解，掌握软件文档编写所采用的标准及分类及格式，整理编写软件文档主要内容到报告中。
通过以上的学习接下来完成软件文档的编写，在编写过程中应该注意遵循标准的文档编写格式，使每一步都做到简明概要、一目了然，完成软件文档的编写。
理已经成型报告，补充不足、检查报告以及软件文档格式，整理文档，将软件文档以事例方式嵌入实训报告。
第14天
完成实训，提交文档与报告
第5章实训总结
人力资源管理系统能够使得管理者快速高效地完成企业日常事务中的人事工作，降低了人力资源管理成本，使管理者能集中精力在企业战略目标；另一方面，通过软件及时收集与整理分析大量的人力资源管理数据，为企业战略决策的生成与实施控制提供强有力的支持，以提高组织目标实现的可能性。
经过将近半个月的设计和研究，我们小组集体设计的《人力资源管理系统》已经设计完毕。
其功能基本符合用户需求，能够人力资源的基本功能。
并提供部分系统维护功能,对于数据的一致性的问题也通过程序进行了有效的解决。
但是由于毕业设计时间较短，所以该系统还有许多不尽如人意的地方，比如联机文档比较少，用户界面不够美观，出错处理不够等多方面问题。
这些都有待进一步改善。
总的来说，在这次课设中我们遇到了很多问题，经过我们集体的努力大部分问题都得到解决，只有少部分遗留的问题。
从中我们也吸取了很多经验教训，对所学的专业知识也得到了充分利用，在今后的发展中这都会成为我们的一种宝贵财富。
首先是开始基础没有打好，匆忙之中就定了个题目，刚开始接触设计程序特别盲目，也不知从何处入手，对于车队信息管理系统，我们也没机会亲身去考察，我们只能在网上找些客观资料来了解它。
然后就是调程序的问题，实在是给我们出了个大难题，面对偌大的一个程序，从中排错选优，对我们这些初学者的确是一件难事。
刚开始我们小心翼翼的调试，有时调了一上午程序的运行界面还是跑不出来，偶尔也会产生抱怨和不耐烦的情绪。
总之在我们集体努力的情况下，我们克服了一切困难，才完成这次课设。
参考文献
[1]王新颖《软件工程与文档编写》北京大学出版社2007.6
[2]吴洁明《软件工程基础实践教程》清华大学出版社
升级会员 