职员 OpenApi文档

[TOC] ## 概述：职员OpenAPI接口说明 通过web端打开EAS，以管理员Administrator身份登录，可以在应用-》集成平台-》接口服务-》OpenApi-》OpenApi管理-》职员 找到基础数据接口列表  ### 建议下载附件保存 ### 适用版本：EAS861版本 861版本需更新补丁 PTM158682 ### 模块：职员 #### 提交人员到EAS的接口 ### ``` 请求body { "api": "方法number", "data": [参数1,参数2…] " } ``` ##### 接口名称：ImportPersonFacade-importPersonData ##### 输入参数： | 参数名称 | 必须 | 空 | 说明 | | ----------- | ---- | ---- | ------------------------------------------------------------ | | **xmlData** | 是 | 否 | 对应body的 参数1 ，参数值是一段xml字符串，入参示例如下所示： | ##### 职员接口特殊： - 启用s-HR无法调用此接口； - op传参：新增人员传4，修改人员传0； - 有些属性为必填项，则每次上传必须附带，非必填项见说明； - 一次只能添加一个职位属性，循环多次添加，请确认是否开启编码规则（开启编码规则，入库职员编码和传参编码会不一致）导致number找不到； - 新增职员信息后，若要继续给职员添加职位，请按职员真实编码传参且属性op需要传参为0。 - 修改职员信息，没有传入的字段会被清空，比如cell，如果没有传入cell值，会被认为是清空cell。 如下是具体的 xml 中元素的含义： | 参数名称 | 参数类型 | 参数大小 | 是否必填 | 说明（未特殊说明关联字段均为编码） | | :------------------------: | :-------: | :------: | :------: | :----------------------------------------------------------: | | **bostype** | String | | **必填** | 职员实体的 bostype，一般是**80EF7DED** | | **属性 op** | String | | **必填** | 标识当前操作是新增、修改、启用、停用（0=修改，3=保存，4=提交）
（修改为传0，新增传4） | | **creator** | Object | | 见说明 | EAS 中的用户编码（**op为3或4必填**） | | **CU** | Object | | 见说明 | 控制单元（**op为3或4必填**） | | **name** | String | | 见说明 | 名称（**op为3或4必填**） | | **number** | String | | **必填** | 编码（如果启用了编码规则，新增最终结果以编码规则生成编码为准） | | createTime | timestamp | | | 创建时间（不填则自动创建当前时间） | | bloodType | Enum | | | 血型 | | **employeeType** | Object | | 见说明 | 员工状态（**op为3或4必填**） | | **hrOrgUnit** | Object | | 见说明 | HR组织（**op为3或4必填**） | | **gender** | Enum | | 见说明 | 性别（**op为3或4必填**） | | idCardNO | String | | | 身份证号码 | | homePhone | String | | | 家庭电话 | | state | Enum | | | 审核状态（0：未审核；1：已审核） | | deletedStatus | Enum | | | 禁用状态（1：启用；2：禁用；不填/其他：启用） | | officePhone | String | | | 办公室电话 | | nativePlace | String | | | 籍贯 | | birthday | Date | | | 出生日期 | | cell | String | | | 手机号码 | | ****email**** | String | | | 电子邮件 | | **NOPOSITION_PERSON_SAVE** | String | | **必填** | 是无职位人员保存
（0：在职；1：无职位） | | **gkadmin** | String | | 见说明 | 挂靠部门
（**NOPOSITION_PERSON_SAVE**值为1需要填写，为0不需要） | | **position** | String | | 见说明 | 职位
（**NOPOSITION_PERSON_SAVE**值为0需要填写，为1不需要） | | **adminOrgUnit** | String | | 见说明 | 职位所属行政组织
（**NOPOSITION_PERSON_SAVE**值为0需要填写，为1不需要） | | **isPrimary** | String | | 见说明 | 是否是主职位（0：兼职；1：主职）
（**NOPOSITION_PERSON_SAVE**值为0需要填写，为1不需要） | ##### 输出参数： json参数： | 参数名称 | 参数说明 | | ------------- | ------------------------------------------------ | | **errorCode** | 调用openapi标识，0：成功；1：失败 | | **errMsg** | 记录调用openapi操作信息 | | **data** | 是一段xml信息，存储业务操作记录，xml信息如下表： | xml参数： | 参数名称 | 参数说明 | | ---------------- | ------------------------------ | | **retstatus** | 业务返回标示，0：成功；1：失败 | | **errorMessage** | 记录业务操作失败信息 | ##### 调用示例： ``` String ip = "172.17.6.176"; int port = 8080; String userName = "zj003"; String password = ""; String dcName = "EAS860NEW"; String language = "l2"; String xmlData = "<DataInfo bostype=\"80EF7DED\" op=\"4\"> <DataHead> <creator>administrator</creator> <CU>KB</CU> <name>YouTub</name>