Department.php
4.42 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
<?php
/**
* Department.php
* 部门接口
* @author Deepseath
* @version $Id$
*/
namespace deepseath\hris\Api;
class Department
{
/**
* 基类服务对象
* @var \deepseath\hris\Hris
*/
protected $service = null;
/**
* 部门删除状态：正常（未删除）
* @var integer
*/
const DELETE_NO = 1;
/**
* 部门删除状态：已删除
* @var integer
*/
const DELETE_YES = 2;
/**
* 畅移本地顶级部门（智慧零售部）的 id
* md5('2022-04-27 17:00:01') —— 该值没具体意义主要就是一个在hris识别“智慧零售事业部”的标识<br>
* 该值的来源是，首次导给 hris 全量部门数据时，以当时时间md5做顶级部门标识，方便 hris 导入处理
* @var string
*/
const CY_TOP_ID = '6e691aaf7d16f7b5199cce086e781368';
public function __construct(\deepseath\hris\Hris $service)
{
$this->service = $service;
}
/**
* 获取部门信息
* @desc 查询HRIS中的部门基础信息
* @param array $params
* <pre>
* orgUnitZH String 一级部门(中文)
* buFunctionZH String 二级部门(中文)
* departmentZH String 三级部门(中文)
* teamZH String 四级部门(中文)
* </pre>
* @return array
* <strong>map</strong>
* <pre>
* orgUnitId string 一级部门id
* orgUnitZH string 一级部门名称中文
* orgUnitEN string 一级部门名称英文
* buFunctionId string 二级部门id
* buFunctionZH string 二级部门名称中文
* buFunctionEN string 二级部门名称英文
* departmentId string 三级部门id
* departmentZH string 三级部门名称中文
* departmentEN string 三级部门名称英文
* teamId string 四级部门id
* teamZH string 四级部门名称中文
* teamEN string 四级部门名称英文
* </pre>
*/
public function branchList(array $params) : array
{
$params = array_merge([
'orgUnitZH' => '',
'buFunctionZH' => '',
'departmentZH' => '',
'teamZH' => ''
], $params);
$result = $this->service->apiRequest('get', 'branchList', $params);
return isset($result['branchList']) ? $result['branchList'] : (isset($result['data']) ? $result['data'] : []);
}
/**
* 新增OR更新部门
* @desc 新增OR更新HRIS中的部门
* @param array $params
* <pre>
* branchNo String 畅移部门ID
* parentBranchNo String 畅移上级部门ID
* nameZH String 部门名称(中文)
* nameEN String 部门名称(英文)
* </pre>
* @return array
* <pre>
* affectRow string 受影响的行数
* branchId string hris中的部门ID
* </pre>
*/
public function branchAddOrUpdate(array $params) : array
{
$params = array_merge([
'branchNo' => '',
'parentBranchNo' => '',
'nameZH' => '',
'nameEN' => '',
'deleted' => self::DELETE_NO
], $params);
if ($params['parentBranchNo'] === '') {
// 如果父级部门 id 不存在，则认为更新的是畅移的一级部门（在 hris 是属于“智慧零售事业部”下的二级部门）
// 使用虚拟的“智慧零售部” id 做为父级 id
$params['parentBranchNo'] = self::CY_TOP_ID;
}
$result = $this->service->apiRequest('post', 'branchAddOrUpdate', $params);
return $result;
}
/**
* 删除部门
* @desc 删除HRIS中的部门
* @param array $params
* <pre>
* branchNo String 畅移部门ID
* parentBranchNo String 畅移上级部门ID
* nameZH String 部门名称(中文)
* nameEN String 部门名称(英文)
* </pre>
* @return array
* <pre>
* affectRow string 受影响的行数
* branchId string hris中的部门ID
* </pre>
*/
public function branchDelete(array $params) : array
{
$params = array_merge([
'branchNo' => '',
'parentBranchNo' => '',
'nameZH' => '',
'nameEN' => '',
'deleted' => self::DELETE_YES
], $params);
return $this->branchAddOrUpdate($params);
}
}