【功能介绍】

   s-HR 支持行政组织、职位、员工基本信息、银行卡实体上的自定义字段同步至云星空

【适用版本】

  s-HR Cloud 2021H1及以上版本支持自定义字段同步星空（2021H1版本需安装集成补丁PT162000或者安装该领域的最新补丁）

  星空版本：星空企业版V7.3以上

【操作步骤】

1、创建DEP扩展方案

1.1创建扩展方案

预设用户（user）登录客户端，进入动态扩展平台高级版，动态扩展方案管理 -----> 新增，创建一个新的扩展方案，也可以沿用已有方案，如下图

1.2新建扩展单元

选择扩展方案右键，扩展单元 -----> 新建，创建扩展单元，扩展单元的名称自定义

2、实体增加自定义字段

2.1    导入实体

选中实体，右键导入实体

示例：

搜索“行政组织单元扩展”即可找到我们所需的行政组织单元扩展和行政组织扩展历史两个实体，然后分别导入、

2.2    确认实体导入成功

2.3    实体增加自定义字段

【行政组织单元扩展】、【行政组织扩展历史】实体，在两个实体上增加一模一样的字段，并保存。

2.4    视图配置自定义字段

找到【行政组织信息form】表单视图，将扩展的字段配置在视图中，请注意，配置的字段需要满足name="adminorgext_字段名称"，且dataType必须设置，例如配置zfc字段：

  <field name="adminorgext_zfc" label="字符串" dataType="String" />

常用类型的字段的dataType对应如下：

字符串：dataType="String"

对象：  dataType="F7"

枚举：  dataType="Enum"

布尔：  dataType="boolean"

日期：  dataType="date"

3、业务数据源新增自定义字段

3.1导入业务数据源

选择业务数据源然后点右键会弹出“导入业务数据源”，双击“导入业务数据源”

示例：导入同步星空行政组织数据源

按F7，搜索“com.kingdee.shr.cloud_inte.app.AdminOrgCollForWebApiQuery”，选择并导入

PS：以下是同步星空对应业务数据源

1)     同步星空员工基本信息Query

com.kingdee.shr.cloud_inte.app.PersonCollForWebApiQuery

2)     同步星空职位信息Query

com.kingdee.shr.cloud_inte.app.PositionCollForWebApiQuery

3)     同步星空行政组织Query

com.kingdee.shr.cloud_inte.app.AdminOrgCollForWebApiQuery

4)     同步星空银行卡Query

 com.kingdee.shr.cloud_inte.app.BankInfoInteCloudQuery

5）同步星空员工变动记录Query

com.kingdee.shr.cloud_inte.app.EmpOrgRelationInteCloudQuery（仅8612版本PT167386补丁支持）

3.2业务数据源新增自定义字段

1、业务数据源导入实体上的自定义字段

2、Query增加字段，命名需遵循以下规则：

1)     字段名称（即星空字段标识），不能和星空已有的字段重复

2)     字段名称F开头且一二个字母要大写

3)     字段名称3位以上

4)     如若需要同步星空已有的基础资料字段，需按照固定格式同步（'{"FNumber": "' || #0 || '"}'），参照示例2

示例1：

字段名称：FBloodType1

示例2：

同步星空已有的基础资料

4、启用DEP扩展方案

选中新建的扩展方案，然后点启用，新建方案便出现在侧边栏，即启用扩展方案成功

5、在星空对应单据添加接收数据的控件

若在s-HR的组织单据中增加了三个标识为FUU/FVV/FXX的文本控件，标识为FDate3的日期控件，标识为FBoolean3控件，那就按照下图新增三个文本控件，一个日期控件，一个复选框控件

【注意事项】

1、同步s-HR的枚举字段时，目前是取枚举别名发给星空的，而不是数据库存的枚举值