# 数据准备
HOS门户系统要正常使用，需要基础数据的支持，其数据来源如下：
| 数据名称 | 数据来源 | 数据获取方式 |
|---|---|---|
| 基础字典数据 | 生产要素管理平台 | 服务总线订阅推送 |
| 组织人员 | 生产要素管理平台 | 服务总线订阅推送 |
| DTS业务数据 | DTS系统 | 服务总线订阅推送 |
| 资源排班数据 | 资源计划系统 | 登录时通过接口获取 |
| 登录帐号数据 | HOS统一用户系统 | 服务总线订阅推送 |
# 基础字典、组织人员数据获取
基础字典、组织人员数据由生产要素管理平台提供，如无生产要素平台，请查看本文3.5.2生产要素管理平台，联系对应产品组搭建环境，准备数据。
# 数据详情
生产要素平台提供的数据详情如下：
# 基础字典
| 详细说明 | 是否必须 | 字段明细 |
|---|---|---|
| 人员状态 | 是 | 必填字段：编码、名称、是否启用； 非必填字段：开始日期、结束日期、拼音码、五笔码、排序、备注； |
| 工作状态字典 | 是 | 必填字段：编码、名称、是否启用； 非必填字段：开始日期、结束日期、拼音码、五笔码、排序、备注； |
| 性别字典 | 否 | 必填字段：编码、名称、是否启用； 非必填字段：来源、开始日期、结束日期、拼音码、五笔码、排序、备注； |
| 国家地区字典 | 否 | 必填字段：数字代码、中文简称、是否启用； 非必填字段：英文简称、中文全称、英文全称、罗马2字符代码、罗马3字符代码、排序、拼音码、五笔码、开始日期、结束日期、备注； |
| 行政区划-省级 | 否 | 必填字段：编码、名称、国家、是否启用； 非必填字段：开始日期、结束日期、拼音码、五笔码、排序、备注； |
| 行政区划-市级 | 否 | 必填字段：编码、名称、省级、国家、是否启用； 非必填字段：开始日期、结束日期、拼音码、五笔码、排序、备注； |
| 行政区划-县区级 | 否 | 必填字段：编码、名称、市级、国家、是否启用； 非必填字段：开始日期、结束日期、拼音码、五笔码、排序、备注； |
| 婚姻状况字典 | 否 | 必填字段：编码、名称、是否启用； 非必填字段：开始日期、结束日期、拼音码、五笔码、排序、备注； |
| 学位字典 | 否 | 必填字段：编码、名称、是否启用； 非必填字段：开始日期、结束日期、拼音码、五笔码、排序、备注； |
| 学历字典 | 否 | 必填字段：编码、名称、是否启用； 非必填字段：开始日期、结束日期、拼音码、五笔码、排序、备注； |
| 民族字典 | 否 | 必填字段：编码、名称、是否启用； 非必填字段：开始日期、结束日期、拼音码、五笔码、排序、备注； |
| 证件类型 | 否 | 必填字段：编码、名称、是否启用； 非必填字段：开始日期、结束日期、拼音码、五笔码、排序、备注； |
| 职业大类 | 是 | 必填字段：编码、名称、是否启用； 非必填字段：开始日期、结束日期、拼音码、五笔码、排序、备注； |
| 职业序列 | 是 | 必填字段：编码、名称、职业大类、是否启用； 非必填字段：开始日期、结束日期、拼音码、五笔码、排序、备注； |
| 宗教信仰字典 | 否 | 必填字段：编码、名称、是否启用； 非必填字段：开始日期、结束日期、拼音码、五笔码、排序、备注； |
# 组织机构
| 详细说明 | 是否必须 | 字段明细 |
|---|---|---|
| 机构大类 | 否 | 必填字段：编码、名称、是否启用； 非必填字段：开始日期、结束日期、拼音码、五笔码、排序、备注 |
| 机构子类 | 否 | 必填字段：编码、名称、机构大类、是否启用； 非必填字段：开始日期、结束日期、拼音码、五笔码、排序、备注； |
| 机构小类 | 否 | 必填字段：编码、名称、机构子类、是否启用； 非必填字段：开始日期、结束日期、拼音码、五笔码、排序、备注； |
| 组织机构 | 是 | 必填字段：编码、名称、是否启用； 非必填字段：上级机构、简称、统一社会信用编码、负责人、电话、法人、机构分类、创建日期、注销日期、官网、邮箱、传真、邮编、地址、简介、开始日期、结束日期、拼音码、五笔码、排序、备注； |
# 组织部门
| 详细说明 | 是否必须 | 字段明细 |
|---|---|---|
| 组织行政属性 | 否 | 必填字段：编码、名称、国家、是否启用； 非必填字段：开始日期、结束日期、拼音码、五笔码、排序、备注； |
| 组织部门 | 是 | 必填字段：编码、名称、所属机构、是否启用； 非必填字段：简称、简介、上级部门、行政属性、电话、邮箱、传真、开始日期、结束日期、拼音码、五笔码、排序、备注； |
# 医疗机构
| 详细说明 | 是否必须 | 字段明细 |
|---|---|---|
| 医院等级 | 否 | 必填字段：编码、名称、医院级别、是否启用； 非必填字段：医院子级、来源、排序、开始日期、结束日期、拼音码、五笔码、备注； |
| 医疗机构 | 否 | 必填字段：机构名称、职业许可证号、是否启用； 非必填字段：许可证生效日期、许可证失效日期、编制床位数、医院等级、物价标准、医保代码、开始日期、结束日期、拼音码、五笔码、排序、备注 |
# 职务数据
| 详细说明 | 是否必须 | 字段明细 |
|---|---|---|
| 职务等级 | 否 | 必填字段：编码、名称、是否启用； 非必填字段：等级、排序、开始日期、结束日期、拼音码、五笔码、备注 |
| 职务字典 | 否 | 必填字段：编码、名称、职务分类、是否启用， 非必填字段：职务等级、排序、开始日期、结束日期、拼音码、五笔码、备注； |
| 组织职务 | 否 | 必填字段：编码、名称、所属部门、职务字典、是否启用； 非必填字段：额定人数、排序、开始日期、结束日期、拼音码、五笔码、备注； |
# 职位数据
| 详细说明 | 是否必须 | 字段明细 |
|---|---|---|
| 职位字典 | 是 | 必填字段：编码、名称、职务分类、是否启用； 非必填字段：职务等级、排序、开始日期、结束日期、拼音码、五笔码、备注； |
| 组织职位 | 是 | 必填字段：编码、名称、所属部门、职位字典、是否启用； 非必填字段：额定人数、拼音码、五笔码、开始日期、结束日期、排序、备注； |
# 人员数据
| 详细说明 | 是否必须 | 字段明细 |
|---|---|---|
| 人员基本信息 | 是 | 必填字段：人员唯一标识、姓名、人员状态、是否启用； 非必填字段：曾用名、手机号码、邮箱、证件类型、证件号码、宗教信仰、职业、籍贯、国籍、现住址、性别、年龄、民族、婚姻状况、学历、学位、出生日期、排序号、开始日期、结束日期、拼音码、五笔码、备注； |
| 人员机构信息 | 是 | 必填字段为：机构名称、工号、在岗状态、是否启用； 非必填字段为：入职日期、离职日期、开始日期、结束日期、排序号； |
| 人员部门职位 | 是 | 必填字段为：部门名称、组织职位名称、是否在职、是否启用、是否行政部门； 非必填字段为：任职日期、免职日期、开始日期、结束日期、排序号； |
| 人员部门职务 | 否 | 必填字段为：部门名称、组织职务名称、是否在职、是否启用； 非必填字段为：聘用日期、解聘日期、开始日期、结束日期、排序号； |
# 对象数据
| 详细说明 | 是否必须 | 字段明细 |
|---|---|---|
| 对象分类 | 否 | 必填字段:编码、名称、是否启用； 非必填字段:上级对象、拼音码、五笔码、开始日期、结束日期、排序、备注； |
# 载体数据
| 详细说明 | 是否必须 | 字段明细 |
|---|---|---|
| 载体分类 | 否 | 必填字段:编码、名称、是否启用； 非必填字段:拼音码、五笔码、上级载体分类、开始日期、结束日期、排序、备注； |
# 工作区域
| 详细说明 | 是否必须 | 字段明细 |
|---|---|---|
| 工作区域 | 否 | 必填字段:编码、名称、是否启用、所属机构； 非必填字段:拼音码、五笔码、开始日期、结束日期、排序、备注； |
# 组织单元
| 详细说明 | 是否必须 | 字段明细 |
|---|---|---|
| 组织单元 | 是 | 必填字段：编码、名称、是否组织机构、是否末级、是否启用， 非必填字段:、IT名称、级次、父组织单元、学名、别名、部门主管、服务类型、关联业务域、关联事项域、关联载体、关联对象、职能属性、开始日期、结束日期、拼音码、五笔码、排序、备注； |
| 组织单元设置OO、OP人员 | 是 | 必填字段:人员唯一标识、组织单元、OO/OP类型、是否启用； 非必填字段：开始日期、结束日期、拼音码、五笔码、排序、备注； |
# 数据获取
# DTS业务数据获取
DTS业务数据由DTS系统提供，如无DTS系统，请查看本文3.5.3DTS系统，联系对应产品组搭建环境，准备数据。
# 数据详情
DTS系统提供的数据如下：
| 详细说明 | 是否必须 | 字段明细 |
|---|---|---|
| 业务域 | 是 | 必填字段：编码、名称、层级、是否启用； 非必填字段：上级业务域、销售属性、开始日期、结束日期、拼音码、五笔码、排序、载体、对象、输出物、备注； |
| 事项域 | 是 | 必填字段：编码、名称、业务域、是否启用； 非必填字段：排序、劳动类型、服务等级、开始日期、结束日期、拼音码、五笔码、载体、对象、输出物、前序事项域、接序事项域、备注； |
| 工作事项 | 是 | 必填字段:编码、名称、业务域、是否启用； 非必填字段：岗位类型、职业、职位、职务、事项域、工作事项、劳动类型、服务类型、工作地点、运行时间、开始日期、结束日期、拼音码、五笔码、排序、备注； |
| 岗位 | 是 | 必填字段：编码、名称、是否启用、关联事项域（包含业务域属性）； 非必填字段：关联职业、关联业务功能属性、岗位类型、关联服务等级、关联劳动类型、开始日期、结束日期、拼音码、五笔码、排序、备注； |
| 业务岗位 | 是 | 必填字段：编码、名称、是否启用、关联事项域（包含业务域属性）、岗位； 非必填字段：关联职业、关联业务功能属性、岗位类型、关联服务等级、关联劳动类型、关联岗位要求、开始日期、结束日期、拼音码、五笔码、排序、备注； |
| 流程岗位 | 是 | 必填字段：编码、名称、是否启用、关联工作事项（包含业务域属性、事项域属性）、岗位； 非必填字段：关联职业、关联业务功能属性、岗位类型、关联服务等级、关联劳动类型、关联岗位要求、开始日期、结束日期、拼音码、五笔码、排序、备注； |
| 设置业务单元和业务岗位的关联关系 | 是 | 必填字段：关联名称、业务单元、业务岗位、是否启用； 非必填字段：开始日期、结束日期、拼音码、五笔码、排序、备注； |
| 服务等级 | 否 | 必填字段：编码、名称、服务等级分类、色值、是否启用； 非必填字段：开始日期、结束日期、拼音码、五笔码、排序、备注； |
| 劳动类型 | 否 | 必填字段：编码、名称、劳动类型分类、业务域、是否启用； 非必填字段：开始日期、结束日期、拼音码、五笔码、排序、备注； |
| 业务单元 | 是 | 必填字段：编码、名称、关联工作事项、是否启用； 非必填字段：工作区域、关联业务功能属性、关联业务功能区、关联职业、关联对象、关联输出物、关联运行时间、关联服务等级、关联OOOP、开始日期、结束日期、拼音码、五笔码、排序、备注； |
| 输出物 | 否 | |
| 岗位要求字典 | 否 | 必填字段：编码、名称、比较值类型； 非必填字段：开始日期、结束日期、拼音码、五笔码、排序、备注； |
| 作业 | 否 | 必填字段：编码、名称、关联业务岗位、业务域、是否启用； 非必填字段：作业类型、执行主体、服务等级、孪生属性、作业人方式、作业内容、作业支撑类型、服务类型、开始日期、结束日期、拼音码、五笔码、排序、备注； |
# 数据获取
# 资源排班数据获取
HOS系统登录需要有岗位单元数据，即人员的资源排班数据，这些数据是HOS平台登录时，调用资源计划系统接口获取。 资源排班数据由资源计划系统提供，如无资源计划系统，请查看本文3.5.4资源计划系统，联系对应产品组搭建环境，准备数据。
# 数据详情
资源计划系统提供的数据详情如下：
# 排班数据
| 来源数据 | 详细说明 | 是否必须 | 字段明细 |
|---|---|---|---|
| 人员定岗 | 为人员设置所属的业务单元和业务岗位 | 是 | 必填字段：人员唯一标识、业务单元与业务岗位关联关系、是否启用、开始日期、结束日期； 非必填字段：上岗日期、下岗日期、拼音码、五笔码、排序、备注； |
| 排班岗位 | 排班岗位 | 是 | 必填字段：编码、名称、业务单元、业务岗位、是否启用； 非必填字段：业务功能区、开始日期、结束日期、拼音码、五笔码、排序、备注； |
| 岗位单元 | 岗位单元 | 是 | 必填字段：编码、名称、业务单元、关联排班岗位、是否启用； 非必填字段：开始日期、结束日期、拼音码、五笔码、排序、备注； |
| 人员排班 | 为人员按照日期排列排班岗位 | 是 | |
| 岗位授权 | 人员授权排班岗位 | 是 | 必填字段：人员唯一标识、排班岗位、是否启用、开始日期、结束日期、； 非必填字段：排序、备注； |
# 业务功能区
| 详细说明 | 是否必须 | 字段明细 |
|---|---|---|
| 业务功能属性 | 否 | 必填字段：编码、名称、是否启用； 非必填字段：上级业务功能属性、开始日期、结束日期、拼音码、五笔码、排序、备注； |
| 业务功能区 | 否 | 必填字段：编码、名称、业务功能属性、业务域、物理工作地点、是否启用； 非必填字段：开始日期、结束日期、拼音码、五笔码、排序、备注； |
# 业务运行时间
| 详细说明 | 是否必须 | 字段明细 |
|---|---|---|
| 节日字典 | 否 | 必填字段：编码、名称、节日类型（杂节气、节气、节假日）、所属机构、是否启用； 非必填字段：开始日期、结束日期、拼音码、五笔码、排序、备注； |
| 时段设置 | 否 | 必填字段：名称、业务域、所属机构、时段信息、是否启用； 非必填字段：开始日期、结束日期、拼音码、五笔码、排序、备注； |
| 机构运营时间 | 否 | 必填字段：业务类型、所属业务（业务域或者事项域或者工作事项）、时段、日历类型、日历段、所属机构、是否启用； 非必填字段：日历名称、开始日期、结束日期、拼音码、五笔码、排序、备注； |
| 公休假日日历配置 | 否 | 必填字段：日期、年份、类型、日期对应编码、机构、是否启用， 非必填字段：开始日期、结束日期、拼音码、五笔码、排序、备注 |
| 节气日历配置 | 否 | 必填字段：日期、年份、类型、日期类型、编码、节气日期、节气开始日期、节气结束日期、机构、是否启用； 非必填字段:开始日期、结束日期、拼音码、五笔码、排序、备注 |
# 资源排班接口配置
在HOS门户系统中进入【系统参数】页面，找到【登录排班数据接口地址】配置项，如下图所示：
点击编辑，进入表单页面，根据项目实际的资源排班系统ip和端口（其他不需要改），更改配置，如下图所示：
# 登录帐号数据获取
登录帐号数据由HOS统一用户系统提供，HOS统一用户系统会与门户系统同时部署，如无登录帐号数据，请联系HOS技术支持，准备数据。
# 数据详情
HOS统一用户提供的数据详情如下：
| 详细说明 | 是否必须 | 字段明细 |
|---|---|---|
| 登录帐号 | 是 | 必填字段：人员唯一标识、登录名、姓名、是否启用； 非必填字段：开始日期、结束日期、拼音码、五笔码、排序、备注； |
# 数据准备
该步骤目的是通过已经准备好的人员数据，生成帐号数据，并推送给门户引擎系统，如第三方系统也需要帐号数据，同样也可以推送帐号数据给第三方系统。
注意
- 统一用户帐号数据准备之前，生产要素和DTS系统必须推送完成，否则会生成失败。
- 统一用户是单点登录的前提，各个系统的帐号数据保持一致才能实现单点。
- 所有系统的帐号、岗位角色、角色、各种权限（菜单、数据、接口）数据由统一用户平台进行统一管理，并由统一用户平台分发给其他下有系统。
- 统一用户中账号资源池的数据根据人员数据进行自动生成或手动创建。
名词解释
- 应用系统：指的是在统一用户系统中维护的第三方系统，属于统一用户系统下抽象的实体。
- 第三方系统：指的是统一用户外的其他系统，如OA系统在统一用户系统注册了系统应用，那对于统一用户系统来说，OA系统就是第三方系统。
- 分配帐号：从帐号资源池分配帐号到应用系统下
- 推送帐号：从统一用户系统的应用系统下，推送该应用系统下的帐号到第三方系统。
# 应用设置
如应用系统需要自动分配帐号或者自动推送帐号，则需要在账号资源池中的帐号生成前进行应用设置。
如第三方系统也需要进行自动分配帐号或推送帐号，也可以一起设置，注册应用请参考7.2.1.1注册应用。
注意
- 门户系统比较特殊，需要使用账号资源池中的全量帐号，所以需要自动分配全量帐号，并推送全量帐号到门户系统中。
# 自动分配帐号
(1)自动分配账号资源池中的全量帐号
打开帐号新增和帐号变更的开关，并保存。
(2)按照规则分配部门帐号
在步骤（1）打开开关的基础上，设置分配规则，并保存。
(3)同步历史数据
如打开自动分配帐号的开关时，账号资源池中已经存在帐号，可以手动点击同步吧按钮，同步历史数据。
# 自动推送帐号
(1)打开自动推送帐号的开关，其他的数据根据项目需要自行打开即可。
(2)可以配置同步账号时需要同步哪些数据，配置同步的方式。
(3)推送是否成功，可以涨应用系统下的表格中查看，也可以在门户系统中查看。
# 资源账号池管理
该步骤目的为在【账号资源池-账号池管理】中增加账号，该账号池包括囊括医院各个系统全部的帐号，是依据人员而来。
统一用户平台创建账号包含两种方式，分别为自动模式和手动模式，具体可在统一用户系统【系统管理-系统参数】中进行配置，配置项为【资源池账号生成模式】。
# 自动模式
当统一用户平台接收到生产要素同步的人员数据（人员基础数据、人员机构数据、人员职位数据）之后会自动创建账号，账号登录名根据【系统管理-系统参数】中的【账号登录名生成类型】来决定，支持工号、手机号、证件号、拼音码；账号的默认密码按照【统一认证-密码策略】中配置的默认密码生成。
# 手动模式
可以在【账号资源池-账号池管理】中手动为人员创建账号，支持为单个人员或批量人员创建账号，同时自动创建的账号也可以在此处查看。
# 为应用系统分配新账号
该步骤目的为统一用户下的应用系统分配帐号，为应用分配帐号有以下两个目的：
(1)该系统可以使用统一认证登录系统
如给OA系统分配了张三（1001），且OA系统对接了统一认证，则张三可以通过统一认证的登录界面，登录OA系统。
(2)门户系统单点登录页面会显示该系统
如张三（工号1001）登录门户，想在首页看到oa这个系统，则需要保证统一用户【应用管理】的oa系统中，分配了张三这个账号，分配了账号，即意味着，给张三分配了登录oa的权限。
为应用分配帐号有自动分配和手动分配两种，如果该应用帐号分配规则比较简单（全部需要分配，或者按照科室分配）可使用自动分配，其他可使用手动分配。
注意
- 门户系统需要保证门户应用下的帐号与帐号资源池保持一致，且能实施推送到门户系统。
# 手动分配
点击【基础信息】--》【账号管理】--》【新增】按钮
从账号资源池中选择需要的账号，选择完成之后，点击【保存】按钮。
# 自动分配（按科室、院区分配）
# 处理应用系统存量账号
# 整理各应用系统存量账号
第三方系统如果含有存量账号，则需要整理存量账号数据（整理登录账号即可）；同时在统一用户平台【账号资源池-账号池管理】中把统一维护的账号导出到excel中，并且维护好各应用系统的存量账号与资源池导出的账号的关联关系。
# 添加存量账号
第三方系统如果含有存量账号，并且在上一步整理好资源池账号与应用系统自身账号的对照关系之后，需要把存量账号添加到统一用户平台，添加包含2种方式：
(1)可以在【应用中心-应用管理-基础信息-账号管理】中通过excel导入的方式导入存量数据。
(2)也可以在【应用中心-应用管理-基础信息-账号管理】菜单中，选择已添加的应用账号直接编辑业务登录名（业务登录名就是应用系统本身的账号）即可。
# 应用系统帐号推送
统一用户系统将应用系统下的账号信息推送到服务总线，如果第三方系统需要接受帐号信息，需要根据统一用户的接口文档提供接收接口，并在服务总线订阅服务即可。
第三方系统对接用户推送功能接口文档路径：03项目沟通资料\统一用户对接\东华医为HOS统一用户平台接口文档V2.0.2.pdf。
注意
- 如需退送建议设置自动推送，自动推送配置见6.3.1.2自动推送帐号
- 门户必须进行账号数据同步操作，且要同步成功，否则将无法登录门户系统。
- 门户系统已经内置接收接口，只需在服务总线订阅账号推送服务即可。
- 如其他系统也需要同步账号，可根据文档提供接口，在服务总线订阅即可。
也可以根据情况选择手动推送数据
# 数据获取
具体流程可参考本文6.5服务总线订阅数据
# 服务总线订阅数据
服务总线推送步骤为：
- 数据提供系统在服务总线注册
- 数据接收系统在服务总线订阅数据
- 数据提化系统推送数据给服务总线
- 服务总线分发数据给已订阅的系统
- 数据接收系统查看数据是否推送成功
# 服务总线注册接口
HOS门户和统一用户系统已经内置接收基础字典、组织人员和DTS数据的接口，只需要将该接口注册到服务总线即可。
该接口信息在HOS项目资料压缩包中，文档路径：03项目沟通资料\统一用户对接\服务总线配置清单.xlsx。
# 接收基础字典、组织人员和DTS业务数据接口注册
接收基础字典、组织人员和DTS业务数据接口如下：
在服务总线注册门户接口需要提供如下信息：
- 1.系统名称
- 2.系统appid（门户和统一用户的appid,可在统一用户的应用管理中查看，参考查看产品密钥）
- 3.系统地址 （门户和统一用户地址；提供登录地址即可）
- 4.接口信息（接收数据的接口，参考上图第27个接口）
注意
- 如项目实施不会注册服务总线接口，请联系服务总线组注册
- HOS系统使用这一个接口分类接收生产要素系统和DTS系统的各种数据
- HOS门户和统一用户系统都需要接收基础字典、组织人员和DTS业务数据，所以需要注册两个系统的接口
# 账号推送接口注册
帐号推送由HOS统一用户系统发起，推送帐号数据给服务总线，接口如下：
在服务总线注册统一用户接口需要提供如下信息：
- 1.系统名称
- 2.系统appid（统一用户的appid,可在统一用户的应用管理中查看，参考查看产品密钥）
- 3.系统地址 （统一用户地址；提供登录地址即可）
- 4.接口信息（接收数据的接口，参考上图第1个接口）
# 接收帐号接口注册
HOS门户系统需要从服务总线订阅帐号数据，接口如下：
在服务总线注册门户接口需要提供如下信息：
- 1.系统名称
- 2.系统appid（门户的appid,可在统一用户的应用管理中查看，参考查看产品密钥）
- 3.系统地址 （门户地址；提供登录地址即可）
- 4.接口信息（接收数据的接口，参考上图第19个接口）
# 数据推送
登录生产要素平台（DTS系统或者统一用户系统），准备相关数据，并进行数据推送。
# 日志查看
生产要素推送了数据之后，可以在HOS门户系统/统一用户平台系统查看日志，进入【API日志】页面查看，如下图：
# 数据查看
生产要素推送了数据之后，可以去HOS门户系统/统一用户平台系统的对应页面查看数据是否推送正确，如下图：
