@alanwang-merit/meritdata-platform-skill-package 1.0.0

package/skills/meritdata-dev-docs-file-finder/references/dev-docs//346/224/273/347/225/245-09-/347/273/204/347/273/207/344/272/272/345/221/230/345/220/214/346/255/245-/347/253/240/350/212/20202_/347/273/204/347/273/207/345/220/214/346/255/245.md

@@ -0,0 +1,318 @@
+---
+name: 攻略-09-组织人员同步-章节02_组织同步
+description: 组织同步 — 美林平台 HR/ERP 组织和人员同步二开（webservice + RESTful）
+keywords: [组织同步, 人员同步, 资源同步, 角色同步, 权限同步, webservice, RESTful, HR集成, 组织同步]
+use-cases: [HR 系统对接, 组织架构导入, 人员批量同步, 权限同步]
+source-section: 2. 组织同步
+source-file: 应用开发平台-基础平台-使用攻略（九）：组织和人员同步.md
+---
+
+# 2. 组织同步
+
+## 📋 API 契约（机器可读）
+
+```json
+{
+  "apiName": "syncOrg",
+  "type": "http",
+  "method": "POST",
+  "urlPattern": "/api/ou/sync/syncOrg",
+  "functionDesc": "同步组织（WebService + RESTful 双通道）",
+  "module": "platform",
+  "requestBody": "application/json",
+  "responseType": "ResultBody<Object>",
+  "returnFields": [
+    "timestamp",
+    "status",
+    "message",
+    "data",
+    "success"
+  ],
+  "exceptionList": [
+    "HttpClientErrorException",
+    "HttpServerErrorException"
+  ],
+  "bestPractice": "捕获异常并通过 log.error 记录"
+}
+```
+
+组织同步有两种实现方式：webservice 同步方式、调用 RESTful API 同步，在该文档中会对这两种实现方式做出详细的介绍。依据文档《应用开发平台使用攻（一）：系统环境搭建》搭建一个简单的后端工程，在 pom 文件的< dependencies></ dependencies>中添加如下依赖
+
+```xml
+<!-- webservice方式实现所需依赖 -->
+<dependency>
+    <groupId>org.apache.cxf</groupId>
+    <artifactId>cxf-spring-boot-starter-jaxws</artifactId>
+    <version>3.2.4</version>
+    <exclusions>
+        <exclusion>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-tomcat</artifactId>
+        </exclusion>
+    </exclusions>
+</dependency>
+<!--导入RSAUTils所需jar包 RESTfulAPI实现所需依赖-->
+<dependency>
+    <groupId>commons-codec</groupId>
+    <artifactId>commons-codec</artifactId>
+    <version>1.11</version>
+</dependency>
+<dependency>
+  <groupId>org.apache.cxf</groupId>
+  <artifactId>cxf-rt-frontend-jaxws</artifactId>
+  <version>3.5.9</version>
+</dependency>
+<dependency>
+  <groupId>org.apache.cxf</groupId>
+  <artifactId>cxf-rt-transports-http</artifactId>
+  <version>3.5.9</version>
+</dependency>
+```
+
+使用6.13.2版本需要使用如下依赖
+
+```xml
+<dependency>
+  <groupId>org.apache.cxf</groupId>
+  <artifactId>cxf-rt-frontend-jaxws</artifactId>
+  <version>4.1.1</version>
+</dependency>
+<dependency>
+  <groupId>org.apache.cxf</groupId>
+  <artifactId>cxf-rt-transports-http</artifactId>
+  <version>4.1.1</version>
+</dependency>
+```
+
+### 2.1 实现方式
+
+#### 2.1.1 webservice 实现 Demo
+
+适用于在第三方系统中实现同步功能时或在外部系统上实现同步功能时调用平台的 webService 服务。
+
+| webService 地址                                    | 方法名  | 参数       | 返回值                               |
+| -------------------------------------------------- | ------- | ---------- | ------------------------------------ |
+| http://网关地址/应用名称/ws/syncOrgWebService?wsdl | syncOrg | xml 字符串 | 全部成功返回“1”有数据无法同步返回“0” |
+
+##### 2.1.1.1 批量同步（推荐）
+
+**应用开发平台支持单独同步组织和批量同步组织，为减少同步组织时出现组织层级出现错乱和内存溢出等问题，平台推荐大家使用批量同步操作，使用批量同步操作时，按照以下代码案例进行组织层级的封装即可，例如：需要同步的第一级组织为同步机构，第二级为同步机构_子机构，在xml中，第一级ORG_CODE为syncCode，父级ORG_PARENT_CODE为merit(根据现场实际填写，必填项，下文组织同步的配置说明中有各个字段的定义和是否必填说明)；第二级机构ORG_CODE为syncCode_sub，父级ORG_PARENT_CODE为syncCode（上级的code），并且注意组装xml时上级机构必须在下级机构前面。**
+
+**将下面代码直接复制到项目的 Java 包中（注意修改父部门编码）**
+
+案例代码：
+
+```java
+public static void main(String[] args) {
+        JaxWsDynamicClientFactory dcf=JaxWsDynamicClientFactory.newInstance();
+        Client client = dcf.createClient("http://localhost:8081/cloud-system-manage/ws/syncOrgWebService?wsdl");
+        String parameterValues="<ROOT>"
+                + "<ORG>"
+                + "<ORG_CODE>syncOrg</ORG_CODE>"
+                + "<ORG_PARENT_CODE>merit</ORG_PARENT_CODE>"
+                + "<ORG_NAME>同步机构</ORG_NAME>"
+                + "<ORG_SIMPLENAME>同步</ORG_SIMPLENAME>"
+                + "<ORG_DLEVEL>1</ORG_DLEVEL>"
+                + "<ORG_IS_ABLE>1</ORG_IS_ABLE>"
+                + "<ORG_SORT>1</ORG_SORT>"
+                + "<ORG_REMARK>备注说明</ORG_REMARK>"
+                + "</ORG>"
+                +"<ORG>"
+                + "<ORG_CODE>syncOrg_sub</ORG_CODE>"
+                + "<ORG_PARENT_CODE>syncOrg</ORG_PARENT_CODE>"
+                + "<ORG_NAME>同步机构_子机构</ORG_NAME>"
+                + "<ORG_SIMPLENAME>同步2</ORG_SIMPLENAME>"
+                + "<ORG_DLEVEL>1</ORG_DLEVEL>"
+                + "<ORG_IS_ABLE>1</ORG_IS_ABLE>"
+                + "<ORG_SORT>1</ORG_SORT>"
+                + "<ORG_REMARK>备注说明</ORG_REMARK>"
+                + "</ORG>"+
+                "</ROOT>";
+        Object[] results = new Object[0];
+        try {
+            results = client.invoke("syncOrg", parameterValues);
+        } catch (Exception e) {
+            throw new RuntimeException(e);
+        }
+        for (Object result : results) {
+            System.out.println(result.toString());
+        }
+
+    }
+```
+
+##### 2.1.1.2单独同步
+
+```java
+public static void main(String[] args) {
+        JaxWsDynamicClientFactory dcf=JaxWsDynamicClientFactory.newInstance();
+        Client client = dcf.createClient("http://localhost:8081/cloud-system-manage/ws/syncOrgWebService?wsdl");
+        String parameterValues="<ROOT>"
+                + "<ORG>"
+                + "<ORG_CODE>syncOrg</ORG_CODE>"
+                + "<ORG_PARENT_CODE>merit</ORG_PARENT_CODE>"
+                + "<ORG_NAME>同步机构</ORG_NAME>"
+                + "<ORG_SIMPLENAME>同步</ORG_SIMPLENAME>"
+                + "<ORG_DLEVEL>1</ORG_DLEVEL>"
+                + "<ORG_IS_ABLE>1</ORG_IS_ABLE>"
+                + "<ORG_SORT>1</ORG_SORT>"
+                + "<ORG_REMARK>备注说明</ORG_REMARK>"
+                + "</ORG>"
+                +"<ORG>"
+                + "<ORG_CODE>syncOrg_sub</ORG_CODE>"
+                + "<ORG_PARENT_CODE>syncOrg</ORG_PARENT_CODE>"
+                + "<ORG_NAME>同步机构_子机构</ORG_NAME>"
+                + "<ORG_SIMPLENAME>同步2</ORG_SIMPLENAME>"
+                + "<ORG_DLEVEL>1</ORG_DLEVEL>"
+                + "<ORG_IS_ABLE>1</ORG_IS_ABLE>"
+                + "<ORG_SORT>1</ORG_SORT>"
+                + "<ORG_REMARK>备注说明</ORG_REMARK>"
+                + "</ORG>"+
+                "</ROOT>";
+        Object[] results = new Object[0];
+        try {
+            results = client.invoke("syncOrg", parameterValues);
+        } catch (Exception e) {
+            throw new RuntimeException(e);
+        }
+        for (Object result : results) {
+            System.out.println(result.toString());
+        }
+
+    }
+```
+
+- 运行后结果如下：
+  ![image](/imgs/组织人员同步/1-1.jpg)
+  ![image](/imgs/组织人员同步/1-2.jpg)
+  
+- 以下是 webservice 实现的一个修改操作演示示例（将同步机构 1 名称替换为“技术研发部”）。
+
+  ```java
+  import org.apache.cxf.endpoint.Client;
+  import org.apache.cxf.jaxws.endpoint.dynamic.JaxWsDynamicClientFactory;
+  
+  public class UpdateSyncOrgTest {
+      public static void main(String[] args) {
+          try {
+              JaxWsDynamicClientFactory dcf = JaxWsDynamicClientFactory.newInstance();
+              Client client = dcf.createClient("http://localhost:8081/cloud-system-manage/ws/syncOrgWebService?wsdl");
+              String parameterValues="<ROOT>"
+                      + "<ORG>"
+                      + "<ORG_CODE>syncOrg</ORG_CODE>"
+                      + "<ORG_NAME>技术研发部</ORG_NAME>"
+                      + "</ORG>"+
+                      "</ROOT>";
+              Object[] results = client.invoke("syncOrg", parameterValues);
+              for (Object result : results) {
+                  System.out.println(result.toString());
+              }
+          }
+          catch (Exception e) {
+              e.printStackTrace();
+          }
+      }
+  }
+  ```
+  
+- 修改只需将编码和所需修改的字段传入即可。运行后"同步机构"修改为"技术研发部"。
+  ![image](/imgs/组织人员同步/1-3.jpg)
+
+#### 2.1.2 RESTful API 实现 Demo
+
+- 在通过 RESTful 接口同步之前，需要先进行环境准备工作：
+
+  - 在通过《系统环境搭建》文档搭建的工程中，粘贴如下代码
+
+    ```java
+    import org.apache.commons.codec.binary.Base64;
+    
+    import javax.crypto.Cipher;
+    import java.io.File;
+    import java.io.FileInputStream;
+    import java.io.ObjectInputStream;
+    import java.security.Key;
+    
+    public class RSAUtils {
+        private static String ALGORITHM = "RSA";
+        public static int KEYSIZE = 1024;
+        public static String ENCODE = "UTF-8";
+        public static String encrypt(String source, String path) throws Exception {
+            ObjectInputStream ois = new ObjectInputStream(new FileInputStream(path + File.separator +"public.pem"));
+            Key key = (Key) ois.readObject();
+            ois.close();
+            Cipher cipher = Cipher.getInstance(ALGORITHM);
+            cipher.init(1, key);
+            byte[] b = source.getBytes();
+            byte[] b1 = cipher.doFinal(b);
+            return new String(Base64.encodeBase64(b1), ENCODE);
+        }
+    }
+    ```
+
+    ```java
+    public class Main {
+    public static void main(String[] args) throws Exception {
+            //修改public.pem的文件存储路径(公钥地址)
+            String cloudHome = "C:\\Users\\merit\\Desktop";
+            /**
+             * 证书Secret:a6267d4217474727829bf591b172b2c7
+             * 分隔符号：-
+            */
+            String token= RSAUtils.encrypt("a6267d4217474727829bf591b172b2c7-" + System.currentTimeMillis(),cloudHome);
+            System.out.println(token);
+        }
+    }
+    ```
+
+这两段代码的作用是生成在调用 RESTful API 需要的 app-token,RSAUtils 类是用来对内容进行加密，Main 类作用是生成 app-token，其中<font color="red">证书 Secret</font>内容是在登录应用开发平台后，在服务管理中的证书管理中获取，如图所示：
+![image](./imgs/组织人员同步/1-10.jpg)
+
+- 使用类似 Postman 接口测试工具，在地址栏中输入http://localhost:8081/cloud-system-manage/webapi/+同步服务接口，接口URL在服务管理中的接口管理中查看
+  ![image](/imgs/组织人员同步/1-11.jpg)
+  
+- 通过接口同步时，请求 Header 中需要携带三个参数，Content-Type、app-key、app-token
+  Content-Type: application/x-www-form-urlencoded
+  app-key: 在证书管理页面中获取
+  app-token: 在工程中手动创建(app-token 生效时间 1 分钟，超时后需要重新生成)
+  ![image](/imgs/组织人员同步/1-12.jpg)
+  
+  ##### 2.1.2.1批量同步（推荐）
+  
+- 组织机构同步 URL:http://localhost:8081/cloud-system-manage/webapi/ou/sync/org
+
+- param 中参数：orgInfo
+
+- xml 示例代码如下：与webService的xml同理：需要注意在xml中先组装父级，后组装子级，且子级机构的父级编码必须为父级的编码
+  ```xml
+  <ROOT><ORG><ORG_CODE>apiSyncOrg</ORG_CODE><ORG_PARENT_CODE>merit</ORG_PARENT_CODE><ORG_NAME>接口同步机构——父级</ORG_NAME><ORG_SIMPLENAME>接口同步</ORG_SIMPLENAME><ORG_DLEVEL>1</ORG_DLEVEL><ORG_IS_ABLE>1</ORG_IS_ABLE><ORG_SORT>1</ORG_SORT><ORG_REMARK>使RESTful API同步的机构-子级</ORG_REMARK></ORG><ORG><ORG_CODE>apiSyncOrg_sub</ORG_CODE><ORG_PARENT_CODE>apiSyncOrg</ORG_PARENT_CODE><ORG_NAME>接口同步机构3</ORG_NAME><ORG_SIMPLENAME>接口同步</ORG_SIMPLENAME><ORG_DLEVEL>1</ORG_DLEVEL><ORG_IS_ABLE>1</ORG_IS_ABLE><ORG_SORT>1</ORG_SORT><ORG_REMARK>使RESTful API同步的机构</ORG_REMARK></ORG></ROOT>
+  ```
+
+- Postman 中填写如下图所示：
+  ![image](/imgs/组织人员同步/1-13.jpg)
+  ![image](/imgs/组织人员同步/1-14.jpg)
+  
+- 运行结果如下：
+  ![image](/imgs/组织人员同步/1-15.jpg)
+  ![image](/imgs/组织人员同步/1-16.jpg)
+
+#### 2.1.3 注意事项
+
+- 无编码的部门不做任何操作，视为同步失败（失败之前的正确的组织数据会成功插入数据库，运行就此终止，之后的数据不会被运行）。
+  如果组织找不到父级部门信息，视为同步失败。
+  同步组织时，先通过组织编码查找组织信息，如果已经存在，则更新，如果不存在则新增。
+
+### 2.2 配置说明
+
+- 所传入的数据需按照组织同步配置中的规则，转化为 xml 字符串；默认规则如下：
+
+  | 字段名称     | 默认 XML 标签名(XPath) | 说明                                                         | 是否必填 |
+  | ------------ | ---------------------- | ------------------------------------------------------------ | -------- |
+  | 组织名称     | <ORG_NAME>             | 所添加组织的名称                                             | 是       |
+  | 组织编码     | <ORG_CODE>             | 所添加组织的编码，有唯一性校验                               | 是       |
+  | 父级组织编码 | <ORG_PARENT_CODE>      | 所添加组织的父级组织编码，为空时，默认为根节点编码           | 是       |
+  | 组织名称简称 | <ORG_SIMPLENAME>       | 所添加组织的简称                                             | 是       |
+  | 组织级别     | <ORG_DLEVEL>           | (0机构、1 部门)机构中无法维护人员信息，部门中无法维护角色信息，所以修改此字段时需特别注意 | 是       |
+  | 是否启用     | <ORG_IS_ABLE>          | 默认 1 为启用 0 为禁用                                       | 是       |
+  | 排序号       | <ORG_SORT>             | 根据排序号排列                                               | 是       |
+  | 备注         | <ORG_REMARK>           | 组织机构信息备注                                             | 否       |

package/skills/meritdata-dev-docs-file-finder/references/dev-docs//346/224/273/347/225/245-09-/347/273/204/347/273/207/344/272/272/345/221/230/345/220/214/346/255/245-/347/253/240/350/212/20203_/344/272/272/345/221/230/345/220/214/346/255/245.md

@@ -0,0 +1,187 @@
+---
+name: 攻略-09-组织人员同步-章节03_人员同步
+description: 人员同步 — 美林平台 HR/ERP 组织和人员同步二开（webservice + RESTful）
+keywords: [组织同步, 人员同步, 资源同步, 角色同步, 权限同步, webservice, RESTful, HR集成, 人员同步]
+use-cases: [HR 系统对接, 组织架构导入, 人员批量同步, 权限同步]
+source-section: 3. 人员同步
+source-file: 应用开发平台-基础平台-使用攻略（九）：组织和人员同步.md
+---
+
+# 3. 人员同步
+
+## 📋 API 契约（机器可读）
+
+```json
+{
+  "apiName": "syncUser",
+  "type": "http",
+  "method": "POST",
+  "urlPattern": "/api/ou/sync/syncUser",
+  "functionDesc": "同步人员（含 userId + token）",
+  "module": "platform",
+  "requestBody": "application/json",
+  "responseType": "ResultBody<Object>",
+  "returnFields": [
+    "timestamp",
+    "status",
+    "message",
+    "data",
+    "success"
+  ],
+  "exceptionList": [
+    "HttpClientErrorException",
+    "HttpServerErrorException"
+  ],
+  "bestPractice": "捕获异常并通过 log.error 记录"
+}
+```
+
+### 3.1 实现方式
+
+#### 3.1.1 webservice 实现 Demo
+
+- 适用于在第三方系统中实现同步功能时或在外部系统上实现同步功能时调用平台的 webService 服务。
+
+  | webService 地址                                     | 方法名   | 参数       | 返回值                               |
+  | --------------------------------------------------- | -------- | ---------- | ------------------------------------ |
+  | http://网关地址/应用名称/ws/syncUserWebService?wsdl | syncUser | xml 字符串 | 全部成功返回“1”有数据无法同步返回“0” |
+
+- 以下是 webservice 实现的一个新增操作演示实例。
+
+  ```java
+  import org.apache.cxf.endpoint.Client;
+  import org.apache.cxf.jaxws.endpoint.dynamic.JaxWsDynamicClientFactory;
+  
+  public class SyncUserTest {
+      public static void main(String[] args) {
+          try {
+              JaxWsDynamicClientFactory dcf = JaxWsDynamicClientFactory.newInstance();
+              Client client = dcf.createClient("http://localhost:8081/cloud-system-manage/ws/syncUserWebService?wsdl");
+              String parameterValues = "<LIST>"
+                      + "<USER>"
+                      + "<RY_STAFFNAME>同步人员1</RY_STAFFNAME>"
+                      + "<RY_STAFFCODE>sync1</RY_STAFFCODE>"
+                      + "<RY_ISSEAL_V>1</RY_ISSEAL_V>"
+                      + "<RY_SEX>1</RY_SEX>"
+                      + "<RY_DEPARTMENTCODE>merit</RY_DEPARTMENTCODE>"
+                      + "<RY_WORKPHONE>02983145678</RY_WORKPHONE>"
+                      + "<RY_MOVEPHONE>13572943980</RY_MOVEPHONE>"
+                      + "<RY_EDUCATIONBG>本科</RY_EDUCATIONBG>"
+                      + "<ORG_SIMPLENAME>同步</ORG_SIMPLENAME>"
+                      + "<RY_PART_TIME_DEPARTMENTCODE>tempo,dmm,dam</RY_PART_TIME_DEPARTMENTCODE>"
+                  	+ "<RY_EMAIL>merit@merit.com</RY_EMAIL>"
+                      + "<RY_ORDER>1</RY_ORDER>"
+                      + "<RY_BIRTHDAY>2001-11-09</RY_BIRTHDAY>"
+                      + "<RY_SAFE_LEVEL>2</RY_SAFE_LEVEL>"
+                      + "<RY_ROLECODE></RY_ROLECODE>"
+                      + "</USER>"
+                      + "<USER>"
+                      + "<RY_STAFFNAME>同步人员2</RY_STAFFNAME>"
+                      + "<RY_STAFFCODE>sync2</RY_STAFFCODE>"
+                      + "<RY_ISSEAL_V>1</RY_ISSEAL_V>"
+                      + "<RY_SEX>1</RY_SEX>"
+                      + "<RY_DEPARTMENTCODE>merit</RY_DEPARTMENTCODE>"
+                      + "<ORG_SIMPLENAME>同步</ORG_SIMPLENAME>"
+                      + "<RY_PART_TIME_DEPARTMENTCODE>tempo,dmm,dam</RY_PART_TIME_DEPARTMENTCODE>"
+                  	+ "<RY_EMAIL>merit@merit.com</RY_EMAIL>"
+                      + "<RY_WORKPHONE>02988888888</RY_WORKPHONE>"
+                      + "<RY_MOVEPHONE>13389262116</RY_MOVEPHONE>"
+                      + "<RY_EDUCATIONBG>本科</RY_EDUCATIONBG>"
+                      + "<RY_ORDER>1</RY_ORDER>"         
+                      + "<RY_BIRTHDAY>2001-11-09</RY_BIRTHDAY>"
+                      + "<RY_SAFE_LEVEL>1</RY_SAFE_LEVEL>"
+                      + "</USER>"
+                      + "</LIST>";
+              Object[] results = client.invoke("syncUser", parameterValues);
+              for (Object result : results) {
+                  System.out.println(result.toString());
+              }
+          } catch (Exception e) {
+              e.printStackTrace();
+          }
+      }
+  }
+  
+  ```
+  
+- 运行后在“技研中心”部门新增“同步人员 1”，“同步人员 2”的信息。
+  ![image](/imgs/组织人员同步/1-4.jpg)
+
+- 与组织同步一样，如果人员编码在系统中已经存在，则更新人员，如果不存在，则为新增操作，若需要修改某人员信息，把它的编码和需要修改的项写成 xml 字符串传入即可。
+  以下是 webservice 实现的一个修改操作演示实例。
+
+  ```java
+  import org.apache.cxf.endpoint.Client;
+  import org.apache.cxf.jaxws.endpoint.dynamic.JaxWsDynamicClientFactory;
+  
+  public class UpdateSyncUserTest {
+      public static void main(String[] args) {
+          try {
+              JaxWsDynamicClientFactory dcf = JaxWsDynamicClientFactory.newInstance();
+              Client client = dcf.createClient("http://localhost:8081/cloud-system-manage/ws/syncUserWebService?wsdl");
+              String orgInfo = "<LIST>"
+                      + "<USER>"
+                      + "<RY_STAFFNAME>新用户</RY_STAFFNAME>"
+                      + "<RY_STAFFCODE>sync1</RY_STAFFCODE>"
+                      + "<RY_DEPARTMENTCODE>merit</RY_DEPARTMENTCODE>"
+                      + "</USER>" +
+                      "</LIST>";
+              Object[] results = client.invoke("syncUser", orgInfo);
+              for (Object result : results) {
+                  System.out.println(result.toString());
+              }
+          } catch (Exception e) {
+              e.printStackTrace();
+          }
+      }
+  }
+  ```
+
+- 运行后,将“同步人员 1”姓名修改为“新用户”
+  ![image](/imgs/组织人员同步/1-5.jpg)
+
+#### 3.1.2 RESTful API 实现 Demo
+
+- 注意事项：
+  - app-token 的生效时间只有一分钟，超时后需要重新生成，在同步人员时重新生成 app-token，再将参数值粘贴进去;
+  - header 中的参数配置，参考 2.1.2 中组织机构 RESTful API 同步中的配置
+- 人员同步 URL：http://localhost:8081/cloud-system-manage/webapi/ou/sync/user
+- param 参数：userInfo
+- 参数 xml 代码如下：
+  ```xml
+  <LIST><USER><RY_STAFFNAME>同步人员1</RY_STAFFNAME><RY_STAFFCODE>sync1</RY_STAFFCODE><ORG_SIMPLENAME>同步</ORG_SIMPLENAME><RY_PART_TIME_DEPARTMENTCODE>nengyuan,zhizao,chanpin</RY_PART_TIME_DEPARTMENTCODE><RY_EMAIL>merit@merit.com</RY_EMAIL><RY_ISSEAL_V>1</RY_ISSEAL_V><RY_SEX>1</RY_SEX><RY_DEPARTMENTCODE>merit</RY_DEPARTMENTCODE><RY_WORKPHONE>02988888888</RY_WORKPHONE><RY_MOVEPHONE>13389262116</RY_MOVEPHONE><RY_EDUCATIONBG>本科</RY_EDUCATIONBG><RY_ORDER>1</RY_ORDER><RY_BIRTHDAY>2001-11-09</RY_BIRTHDAY><RY_SAFE_LEVEL>1</RY_SAFE_LEVEL></USER></LIST>
+  ```
+- 执行结果如下
+  ![image](/imgs/组织人员同步/1-17.jpg)
+  ![image](/imgs/组织人员同步/1-18.jpg)
+
+#### 3.1.3 注意事项
+
+- 如果人员没有编码，不做任何操作，视为同步失败（失败之前的正确的组织数据会成功插入数据库，运行就此终止，之后的数据不会被运行）。
+  如果人员所属部门不存在，视为同步失败。
+  人员有禁用的标识为：
+
+- 如上图所示：user_status_flag 对应的 XPath 值为 1，这个值可以配置为任意值，当传递过来的启用禁用状态值与配置的该值相等时，则把该人员设置为禁用状态，比如，现在“人员禁用标志”是 1，外部传入值也是 1，人员即被设置为禁用状态。
+
+### 3.2 配置说明
+
+- 所传入的数据需按照组织同步配置中的规则，转化为 xml 字符串；默认规则如下：
+
+  | 字段名称      | 默认 XML 标签名               | 说明                                                         | 是否必填 |
+  | ------------- | ----------------------------- | ------------------------------------------------------------ | -------- |
+  | 名称          | <RY_STAFFNAME>                | 人员名称                                                     | 是       |
+  | 编码          | <RY_STAFFCODE>                | 人员编码，有唯一性校验                                       | 是       |
+  | 启用禁用状态  | <RY_ISSEAL_V>                 | 默认 0 为禁用、1 为启用                                      | 是       |
+  | 所在部门 code | <RY_DEPARTMENTCODE>           | 所在部门编码，如部门不存在则操作失败                         | 是       |
+  | 工作电话      | <RY_WORKPHONE>                | 电话                                                         | 否       |
+  | 性别          | <RY_SEX>                      | 默认 1 为男性 0 为女性                                       | 否       |
+  | 出生日期      | <RY_BIRTHDAY>                 | 此字段为字符串类型                                           | 否       |
+  | 移动电话      | <RY_MOVEPHONE>                | 移动电话                                                     | 否       |
+  | 学历          | <RY_EDUCATIONBG>              | 默认为小学、初中、高中、大学、中专、高职、本科、专科、博士、研究生、硕士研究生 | 否       |
+  | 兼职部门      | <RY_PART_TIME_DEPARTMENTCODE> | 兼职部门编码                                                 |          |
+  | 邮箱          | <RY_EMAIL>                    | 邮箱                                                         |          |
+  | 职务编码      | <RY_DUTYCODE>                 | 职务编码                                                     |          |
+  | 密码          | <RY_PASSWORD>                 | 此项为空的话则默认为 123456                                  | 否       |
+  | 排序号        | <RY_ORDER>                    | 以此排序                                                     | 是       |
+  | 角色编码      | <RY_ROLECODE>                 | 角色编码，可以在同步人员时赋予角色，此项为空时默认设置为“系统普通人员” | 否       |
+  | 人员密级      | <RY_SAFE_LEVEL>               | 人员密级分类，4（核心涉密人员）、3（重要涉密人员）、2（一般涉密人员）、1（非密人员） | 否       |

package/skills/meritdata-dev-docs-file-finder/references/dev-docs//346/224/273/347/225/245-09-/347/273/204/347/273/207/344/272/272/345/221/230/345/220/214/346/255/245-/347/253/240/350/212/20204_/350/265/204/346/272/220/350/217/234/345/215/225/345/220/214/346/255/245.md

@@ -0,0 +1,124 @@
+---
+name: 攻略-09-组织人员同步-章节04_资源菜单同步
+description: 资源菜单同步 — 美林平台 HR/ERP 组织和人员同步二开（webservice + RESTful）
+keywords: [组织同步, 人员同步, 资源同步, 角色同步, 权限同步, webservice, RESTful, HR集成, 资源菜单同步]
+use-cases: [HR 系统对接, 组织架构导入, 人员批量同步, 权限同步]
+source-section: 4. 资源菜单同步
+source-file: 应用开发平台-基础平台-使用攻略（九）：组织和人员同步.md
+---
+
+# 4. 资源菜单同步
+
+### 4.1 实现方式
+
+#### 4.1.1 webservice 实现方式
+
+- 适用于在第三方系统中实现同步功能时或在外部系统上实现同步功能时调用平台的 webService 服务。
+
+  | webService 地址                                         | 方法名       | 参数       | 返回值                               |
+  | ------------------------------------------------------- | ------------ | ---------- | ------------------------------------ |
+  | http://网关地址/应用名称/ws/syncResourceWebService?wsdl | syncResource | xml 字符串 | 全部成功返回“1”有数据无法同步返回“0” |
+
+- 以下是 webservice 实现的一个新增操作演示实例。
+
+  ```java
+  import org.apache.cxf.endpoint.Client;
+  import org.apache.cxf.jaxws.endpoint.dynamic.JaxWsDynamicClientFactory;
+  
+  public class SyncResourceTest {
+      public static void main(String[] args) {
+          try {
+              JaxWsDynamicClientFactory dcf = JaxWsDynamicClientFactory.newInstance();
+              Client client = dcf.createClient("http://localhost:8081/cloud-system-manage/ws/syncResourceWebService?wsdl");
+              String parameterValues = "<ROOT>"
+                      + "<RESOURCE>"
+                      + "<RESOURCE_URL>/system-manage/test</RESOURCE_URL>"
+                      + "<RESOURCE_EMBED_URL>/system-manage/test.html</RESOURCE_EMBED_URL>"
+                      + "<RESOURCE_CODE>test</RESOURCE_CODE>"
+                      + "<RESOURCE_PARENT_CODE>-1</RESOURCE_PARENT_CODE>"
+                      + "<RESOURCE_NAME>测试资源菜单</RESOURCE_NAME>"
+                      + "<RESOURCE_SIMPLENAME>测试菜单</RESOURCE_SIMPLENAME>"
+                      + "<RESOURCE_TYPE>1</RESOURCE_TYPE>"
+                      + "<RESOURCE_SORT>1</RESOURCE_SORT>"
+                      + "<RESOURCE_APPLICATION_NAME>cloud-system-test</RESOURCE_APPLICATION_NAME>"
+                      + "<RESOURCE_REMARK>备注说明</RESOURCE_REMARK>"
+                      + "</RESOURCE>"
+                      + "</ROOT>";
+              Object[] results = client.invoke("syncResource", parameterValues);
+              for (Object result : results) {
+                  System.out.println(result.toString());
+              }
+          }
+          catch (Exception e) {
+              e.printStackTrace();
+          }
+      }
+  }
+  ```
+  
+- 运行后结果如下：
+  ![image](/imgs/组织人员同步/1-6.jpg)
+
+#### 4.1.2 RESTful API 实现 Demo
+
+- 注意事项：
+  - app-token 的生效时间只有一分钟，超时后需要重新生成，在同步人员时重新生成 app-token，再将参数值粘贴进去;
+  - header 中的参数配置，参考 2.1.2 中组织机构 RESTful API 同步中的配置
+  
+- 资源菜单同步 URL：http://localhost:8081/cloud-system-manage/webapi/ou/sync/resource
+
+- param 参数： resourceInfo
+
+- 菜单同步示例 xml 代码如下：
+  ```xml
+  <ROOT><RESOURCE><RESOURCE_URL>/system-manage/resource/test</RESOURCE_URL><RESOURCE_CODE>resourceTest</RESOURCE_CODE><RESOURCE_PARENT_CODE>-1</RESOURCE_PARENT_CODE><RESOURCE_NAME>
+  api同步资源菜单</RESOURCE_NAME><RESOURCE_SIMPLENAME>同步菜单</RESOURCE_SIMPLENAME><RESOURCE_IS_ABLE>1</RESOURCE_IS_ABLE><RESOURCE_TYPE>1</RESOURCE_TYPE>
+  <RESOURCE_APPLICATION_NAME>cloud-system-test</RESOURCE_APPLICATION_NAME><RESOURCE_REMARK>RESTful API方式同步的资源菜单</RESOURCE_REMARK></RESOURCE></ROOT>
+  ```
+  
+- 组件同步示例xml代码如下：
+  
+  ```xml
+  <ROOT><RESOURCE>
+  <RESOURCE_PARENT_CODE>1108ba7727cd4aed9c56607974ca1935</RESOURCE_PARENT_CODE>
+  <RESOURCE_NAME>234</RESOURCE_NAME>
+  <RESOURCE_CODE>sf</RESOURCE_CODE>
+  <RESOURCE_TYPE>2</RESOURCE_TYPE><RESOURCE_REMARK>测试</RESOURCE_REMARK>
+  </RESOURCE></ROOT>
+  ```
+  
+- 分组同步示例xml代码如下：
+  
+  ```xml
+  <ROOT><RESOURCE>
+  <RESOURCE_NAME>556</RESOURCE_NAME><GROUP_SORT>12</GROUP_SORT><RESOURCE_TYPE>4</RESOURCE_TYPE>
+  </RESOURCE></ROOT>
+  ```
+  
+- 模块同步示例xml代码如下：
+  
+  ```xml
+  <ROOT><RESOURCE>
+  <RESOURCE_NAME>104</RESOURCE_NAME><RESOURCE_PARENT_CODE>3f28830696aedfaa0196aee08e1d0000</RESOURCE_PARENT_CODE><RESOURCE_TYPE>0</RESOURCE_TYPE>
+  </RESOURCE></ROOT>
+  ```
+  
+- 运行结果如下图：
+  ![image](/imgs/组织人员同步/2-1.jpg)
+  ![image](/imgs/组织人员同步/2-2.jpg)
+
+### 4.2 配置说明
+
+| 字段名称     | 默认 XML 标签名             | 说明                                       | 是否必填 |
+| ------------ | --------------------------- | ------------------------------------------ | -------- |
+| 名称         | <RESOURCE_NAME>             | 资源名称                                   | 是       |
+| 编码         | <RESOURCE_CODE>             | 资源编码，有唯一性校验                     | 是       |
+| 资源父级编码 | <RESOURCE_PARENT_CODE>      | 添加的资源菜单父级菜单，必填项，置空时报错 | 是       |
+| 类型         | <RESOURCE_TYPE >            | 资源类型，0 模块 1 菜单                    | 是       |
+| 资源路由地址 | <RESOURCE_URL>              | 通过资源路由访问资源                       | 是       |
+| 备注         | <RESOURCE_REMARK>           | 资源描述                                   | 否       |
+| 实际菜单地址 | <RESOURCE_EMBED_URL>        | 资源实际菜单地址(前后端分离适用)           | 是       |
+| 所属应用名   | <RESOURCE_APPLICATION_NAME> | 不能为空，否则菜单不显示                   | 是       |
+| 所属产品名   | <RESOURCE_PRODUCT_NAME>     |                                            | 是       |
+| 排序号       | <RESOURCE_SORT>             | 用于菜单顺序排列                           | 是       |
+| 分组排序号   | <GROUP_SORT>                | 分组排序号                                 | 是       |