总结

组织管理应用程序编程接口(API)支持多种信息的查看:

•成本中心
•部门

在这个指南有什么新鲜事?

在本节中,我们将宣布任何新的修正组织管理
应用程序编程接口(API)和本指南。

2022年7月

• 初始创建的文档

2022年12月

• 组织-成本中心统一资源标识符(URI)更新
• 组织单位统一资源标识符(URI),更新
• 组织单位——数据字典更新
• 组织单位——Github例子更新

用例描述

这个用例有助于得到所有成本中心的细节。

(不包括iHCM问——问成本中心的列表请使用组织单位API)

API的使用

方法	统一资源标识符(URI)	描述	GitHub样本Respnse载荷
得到	/ / v1 / organization-cost-centers核心	返回数据的所有成本中心

OData查询

美元的过滤器可以用来过滤成本中心。
例如:?$过滤器= organizationCostCenters / costCenterCode shortName情商的销售

应用范围

规范化URI相应的组织管理API需要添加的
使用者应用程序注册表(汽车)订阅后用户可以访问
API,使成功的API调用。

以下规范需要添加到您的应用范围,使这个用例:

/ / organizationManagement / organizationInformationManagement核心/ organizationCost
CenterManagement / organizationCostCenter.read

序列的交互

以下是之前的图中所示的步骤:

1。消费者应用程序请求ADP API端点的组织188bet金宝搏app
管理API。

2。ADP 188bet金宝搏appAPI端点响应消费者应用程序与处理结果。

数据字典

成本中心的具体组织管理API公开GET方法。的
下面是响应负载的模式。

Cannonical领域	iHCM领域	描述	笔记
organizationCostCentres / costCentreCode / codeValue	代码	成本中心代码
organizationCostCentres / costCentreCode /短	短名称	成本中心名称	描述
organizationCostCentres / activeIndicator	活动/活动	不活跃的Indicatorr	当活动= F是的

反应

你可能会遇到异常外常见的成功场景。你必须考虑
这些异常在你最初的发展。
有关更多信息,请参见API常见异常和技巧处理。

响应代码	反应条件	Github样本Rsponse载荷
200好了	返回一个列表的成本中心	人力资源管理-组织- costcenters - http - 200 response.json
200好了	返回一个空列表的成本中心。	空的身体

支持事件通知

您的应用程序应该订阅和处理以下事件更改通知
同步数据在ADP数据变化的事件系统。188bet金宝搏app中描述的更改
下表触发事件通知消息请假请求API。

触发时	应用范围	eventNameCode	GitHub样本Respnse载荷
一个成本中心 添加	/核心/ organizationManagement /组织 InformationManagement / organizationCostC enterManagement / organizationCostCenter.a dd.read	organizationCostCen ter.add	时间待定
一个成本中心 改变了	/核心/ organizationManagement /组织 InformationManagement / organizationCostC enterManagement / organizationCostCenter.c hange.read	organizationCostCen ter.change	时间待定
一个成本中心 删除	/核心/ organizationManagement /组织 InformationManagement / organizationCostC enterManagement / organizationCostCenter.r emove.read	organizationCostCen ter.remove	时间待定

用例描述

组织单元API用于检索组织单元的详细信息。

API的使用

方法	统一资源标识符 (URI)	描述	GitHub样本 响应负载
得到	/核心/ v2 /组织单位	返回列表的所有可用的组织单位授权请求者的观点。

应用范围

相对应的标准URI API需要添加在消费应用程序注册表(汽车)订阅后用户可以访问这个API,使成功的API调用。

以下规范需要添加到您的应用范围,使这个用例:

/核心/ organizationManagement / organizationInformationManagement / organizationalUnitManagement / organizationalUnit.read

支持OData查询选项

不支持OData参数。

数据字典

词典提供的数据模式资源应用程序用户界面字段映射。

模式位置	字段名	笔记
/ organizationalUnits unitID	相关组织单位的唯一标识符	这不是视觉的UI
organizationalUnits /单位的名字	组织单位或公司的名称
organizationalUnits nameCode /代码	的代码相关的实体
organizationalUnits nameCode /的名字	相关的描述代码作为编码的名称
organizationalUnits typeCode /的名字	组织层面的描述	这将证实它是一个部门/部门/单位成本中心等。
organizationalUnits / legalName	法律组织单元的名称
organizationalUnits / parentOrganizationalUnitID	父组织单元的唯一标识符,e。g divsion、部门、业务单位
organizationalUnits / effectiveDatePeriod / startDate可以	使用ISO-8601:2000日期值的字符串表示形式。支持完整的日期YYYY-MM-DD或部分,例如YYYY或MM-DD

反应

你可能会遇到异常外常见的成功场景。你必须考虑这些异常在你最初的发展。有关更多信息,请参见API常见异常和技巧处理。

响应代码	反应条件	Github样本Rsponse载荷
200好了	返回一个列表的组织单位	人力资源管理-组织-单元- http - 200 response.json
200好了	返回一个空列表的组织单位	空的身体