新增部门更新接口

Deepseath
1 parent e17db05b
Showing 2 changed files with 121 additions and 3 deletions
src/Api/Department.php
src/Hris.php
+<?php
+/**
+ * Department.php
+ * 部门接口
+ * @author Deepseath
+ * @version $Id$
+ */
+namespace deepseath\hris\Api;
+
+class Department
+{
+    /**
+     * 基类服务对象
+     * @var \deepseath\hris\Hris
+     */
+    protected $service = null;
+
+    /**
+     * 畅移本地顶级部门（智慧零售部）的 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' => ''
+        ], $params);
+        if ($params['parentBranchNo'] === '') {
+            // 如果父级部门 id 不存在，则认为更新的是畅移的一级部门（在 hris 是属于“智慧零售事业部”下的二级部门）
+            // 使用虚拟的“智慧零售部” id 做为父级 id
+            $params['parentBranchNo'] = self::CY_TOP_ID;
+        }
+
+        $result = $this->service->apiRequest('post', 'branchAddOrUpdate', $params);
+
+        return $result;
+    }
+}
@@ -208,9 +208,22 @@ class Hris
                 return $this->apiRequest($method, $path, $data, true);
             }
             if (isset($result['msg']) && isset($result['code'])) {
-                throw new \Exception('hris SDK Error: ' . $result['msg'] . ':' . $result['code'] . '='. print_r($result, true), $result['code']);
+                throw new \Exception(json_encode([
+                    'url' => $url,
+                    'title' => 'hris SDK request error',
+                    'msg' => $result['msg'],
+                    'code' => $result['code'],
+                    'request' => $data,
+                    'result' => $result,
+                ], JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE), $result['code']);
             } else {
-                throw new \Exception('hris SDK Error: Result NULL.' .var_export($result, true) . var_export($body, true), 90001);
+                throw new \Exception(json_encode([
+                    'url' => $url,
+                    'title' => 'hris SDK response error',
+                    'msg' => $result,
+                    'result' => $result,
+                    'response' => $body,
+                ], JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE), 90001);
             }
         }
@@ -222,7 +235,7 @@ class Hris
      * 打印调试日志
      * @param mixed $info
      */
-    public function log($info, $title = '', $level = 'info')
+    public function log($info, $title = '', $level = 'hris')
     {
         if ($this->_debug) {
             $info = is_scalar($info) ? $info : json_encode($info, JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE);