导入组织单元openApi接口说明原创
云社区用户7WMr3508
10人赞赏了该文章
183次浏览
编辑于2023年11月15日 17:52:56
1、接口说明
本接口用于导入EAS组织单元，包括支持组织单元的新增、修改、提交等操作。是通过EAS框架中OpenApi的方式调用。具体调用请参考OpenApi用户手册。
2、接口管理
OpenApi接口管理包括修改，启用、停用等，通过web端打开EAS，以管理员Administrator身份登录，可以在应用-》集成平台-》接口服务-》OpenApi-》OpenApi管理-》组织架构（页面左树节点）
3、接口调用
1、openApi采用统一调用方式，请参考OpenApi用户手册。
2、请求body 基本结构：{ "api": "方法number", "data": [参数1,参数2…] " }
4、接口输入参数说明
| 参数名称 | 必须 | 空 | 说明 |
| api | 是 | 否 | 本接口的名称编码：ImportFullOrgFacade-importFullOrgData |
| data | 是 | 否 | 组织架构的数据,内容是xml格式 |
{
"api": "ImportFullOrgFacade-importFullOrgData",
"data": [
"<DataInfo bostype=\"CCE7AED4\" op=\"0\">
<DataHead>
<creator>administrator</creator>
<name>test001Name</name>
<number>test001</number>
<parent>333</parent>
<CU>01</CU>
<versionNumber>003</versionNumber>
<englishName>111</englishName>
<code>102</code>
<simpleName>simpleName</simpleName>
<description>description1</description>
</DataHead>
</DataInfo>"
]
}如下是data具体中XML中元素的含义
| 参数名称 | 参数类型 | 参数大小 | 是否必填 | 说明 |
| bostype | String | 必填 | 组织的 bostype一般是:CCE7AED4 | |
| op | String | String | 标识当前操作是新增、修改、提交（0=修改，3=保存（新增），4=提交（新增并提交）） | |
| creator | String | String | EAS 中的用户编码 | |
| CU | String | String | 组织单元的所属管理单元编码 | |
| number | String | String | 组织编码 | |
| name | String | String | 组织名称 | |
| parent | String | String | 上级组织的组织编码 | |
| versionNumber | String | String | 版本号（修改时必填） | |
| englishName | String | 英文名称 | ||
| code | String | 助记码 | ||
| simpleName | String | 简称 | ||
| description | String | 描述 |
5、接口输出参数说明
1、接口返回的JSON格式的文本，例如如下返回JSON内容：
{
"errCode": 0,
"errMsg":" 执行成功",
"data":{
"<Result>
<retstatus>0</retstatus>
<errorMessages>
<errorMessage number=”group01”>
如：编码重复；
</errorMessage>
</errorMessages>
</Result>"
}
} 2、返回的JSON文本内容元素说明：
| 元素名称 | 元素说明 |
| errorCode | 调用openApi标识：0：成功，1：失败 |
| errMsg | 记录调用openApi操作信息 |
| data | 是xml格式的文本，业务处理的返回信息，xml内容说明如下表格 |
xml内容的元素说明
| retstatus | 业务返回标识：0：成功，1：失败 |
| errorMessage | 记录业务操作失败的信息。 |
推荐阅读