@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/20205_/350/247/222/350/211/262/345/220/214/346/255/245.md

@@ -0,0 +1,79 @@
+---
+name: 攻略-09-组织人员同步-章节05_角色同步
+description: 角色同步 — 美林平台 HR/ERP 组织和人员同步二开（webservice + RESTful）
+keywords: [组织同步, 人员同步, 资源同步, 角色同步, 权限同步, webservice, RESTful, HR集成, 角色同步]
+use-cases: [HR 系统对接, 组织架构导入, 人员批量同步, 权限同步]
+source-section: 无编号. 角色同步
+source-file: 应用开发平台-基础平台-使用攻略（九）：组织和人员同步.md
+---
+
+# 角色同步
+
+### 5.1 实现方式
+
+#### 5.1.1 webservice 实现 Demo
+
+- 适用于在第三方系统中实现同步功能时或在外部系统上实现同步功能时调用平台的 webService 服务。
+
+  | webService 地址                                     | 方法名   | 参数       | 返回值                               |
+  | --------------------------------------------------- | -------- | ---------- | ------------------------------------ |
+  | http://网关地址/应用名称/ws/syncRoleWebService?wsdl | syncRole | xml 字符串 | 全部成功返回“1”有数据无法同步返回“0” |
+
+- 以下是 webservice 实现的一个新增操作演示实例。
+
+  ```java
+  import org.apache.cxf.endpoint.Client;
+  import org.apache.cxf.jaxws.endpoint.dynamic.JaxWsDynamicClientFactory;
+
+  public class SyncRoleTest {
+      public static void main(String[] args) {
+          try {
+              JaxWsDynamicClientFactory dcf = JaxWsDynamicClientFactory.newInstance();
+              Client client = dcf.createClient("http://localhost:8081/cloud-system-manage/ws/syncRoleWebService?wsdl");
+              String parameterValues = "<ROOT>"
+                      + "<ROLE>"
+                      + "<ORG_CODE>syncOrg1</ORG_CODE>"
+                      + "<RY_ROLENAME>同步角色1</RY_ROLENAME>"
+                      + "<RY_ROLECODE>syncRole1</RY_ROLECODE>"
+                      + "</ROLE>"
+                      + "</ROOT>";
+              Object[] results = client.invoke("syncRole", parameterValues);
+              for (Object result : results) {
+                  System.out.println(result.toString());
+              }
+          } catch (Exception e) {
+              e.printStackTrace();
+          }
+      }
+  }
+  ```
+
+- 运行结果如下：
+  ![image](/imgs/组织人员同步/1-9.jpg)
+- 角色编码作为角色唯一性校验，如果编码存在则修改，不存在则新增
+
+#### 5.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/role
+- param 参数： roleInfo
+- 角色同步样例 xml：
+
+```xml
+<ROOT><ROLE><ORG_CODE>apiSyncOrg1</ORG_CODE><RY_ROLENAME>api同步角色1</RY_ROLENAME><RY_ROLECODE>apiSyncRole1</RY_ROLECODE></ROLE></ROOT>
+```
+
+- 执行结果如下：
+  ![image](./imgs/组织人员同步/1-19.jpg)
+  ![image](./imgs/组织人员同步/1-20.jpg)
+
+### 5.2 配置说明
+
+| 字段名称 | 默认 XML 标签名  | 说明                           | 是否必填 |
+| -------- | ---------------- | ------------------------------ | -------- |
+| 资源路径 | <ORG_CODE>       | 决定角色同步的机构，不能为部门 | 是       |
+| 角色名称 | <RY_ROLENAME>    | 角色名称                       | 是       |
+| 角色编码 | <RY_ROLECODE>    | 角色编码(做唯一性校验)         | 是       |
+| 租户ID   | <ROLE_TENANT_ID> | 角色同步租户ID                 | 是       |

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/20206_/350/265/204/346/272/220/346/235/203/351/231/220/345/220/214/346/255/245.md

@@ -0,0 +1,116 @@
+---
+name: 攻略-09-组织人员同步-章节06_资源权限同步
+description: 资源权限同步 — 美林平台 HR/ERP 组织和人员同步二开（webservice + RESTful）
+keywords: [组织同步, 人员同步, 资源同步, 角色同步, 权限同步, webservice, RESTful, HR集成, 资源权限同步]
+use-cases: [HR 系统对接, 组织架构导入, 人员批量同步, 权限同步]
+source-section: 6. 资源权限同步
+source-file: 应用开发平台-基础平台-使用攻略（九）：组织和人员同步.md
+---
+
+# 6. 资源权限同步
+
+### 6.1 实现方式
+
+#### 6.1.1 wenservice 实现 Demo
+
+- 适用于在第三方系统中实现同步功能时或在外部系统上实现同步功能时调用平台的 webService 服务。
+
+  | webService 地址                                        | 方法名     | 参数       | 返回值                               |
+  | ------------------------------------------------------ | ---------- | ---------- | ------------------------------------ |
+  | http://网关地址/应用名称/ws/syncAssignWebService ?wsdl | syncAssign | xml 字符串 | 全部成功返回“1”有数据无法同步返回“0” |
+
+- 以下是 webservice 实现的一个新增操作演示实例
+
+- <font color="red"> RY_ROLECODE 输入角色/组织/人员维护列表中已有角色/组织/人员编码</font>
+
+- <font color="red"> RESOURCE_URL 输入资源维护列表中已有模块名称/菜单路由地址/组件编码/资源分组名称</font>   
+
+- <font color="red"> RESOURCE_TYPE 资源类型 输入0（模块），1（菜单），2（组件），4（资源分组）中的任意一个，非必填默认为1（菜单）</font>   
+
+- <font color="red"> ASSIGN_TYPE 授权类型  输入org（组织授权），role（角色授权），user（人员授权）中的任意一个，非必填默认为role（角色授权）</font>
+
+- <font color="red"> HAS_PROGENY 是否包含下级 按组织授权时生效，输入0（不包含下级），1（包含下级）中的任意一个，非必填默认为0（不包含下级）</font>
+
+  ```java
+  import org.apache.cxf.endpoint.Client;
+  import org.apache.cxf.jaxws.endpoint.dynamic.JaxWsDynamicClientFactory;
+  
+  public class SyncAssignTest {
+      public static void main(String[] args) {
+          try {
+              JaxWsDynamicClientFactory dcf = JaxWsDynamicClientFactory.newInstance();
+              Client client = dcf.createClient("http://localhost:8081/cloud-system-manage/ws/syncAssignWebService?wsdl");
+              String parameterValues = "<ROOT>"
+                      + "<Assign>"
+                      + "<RESOURCE_URL>/system-manage/test</RESOURCE_URL>"
+                      + "<RY_ROLECODE>syncRole1</RY_ROLECODE>"
+                   	+ "<RESOURCE_TYPE>1</RESOURCE_URL>"
+                      + "<ASSIGN_TYPE>role</ASSIGN_TYPE>"
+                      + "</Assign>"
+                      + "</ROOT>";
+              Object[] results = client.invoke("syncAssign", parameterValues);
+              for (Object result : results) {
+                  System.out.println(result.toString());
+              }
+          } catch (Exception e) {
+              e.printStackTrace();
+          }
+      }
+  }
+  ```
+
+- 同步资源菜单中的 RESOURCE_URL 为 resource 的 url，运行后会直接在给角色获取对应的资源权限。
+
+- 运行后结果如下：
+  ![image](./imgs/组织人员同步/1-8.jpg)
+
+#### 6.1.1 RESTful API 实现 Demo
+
+- 注意事项：
+  - app-token 的生效时间只有一分钟，超时后需要重新生成，在同步人员时重新生成 app-token，再将参数值粘贴进去;
+  - header 中的参数配置，参考 2.1.2 中组织机构 RESTful API 同步中的配置
+- 资源菜单权限同步 URL：http://localhost:8081/cloud-system-manage/webapi/ou/sync/assign
+- param 参数： assignInfo
+- 示例 xml 代码：
+  ```xml
+  <ROOT>
+  <ASSIGN>
+  <RESOURCE_TYPE>4</RESOURCE_TYPE>
+  <RESOURCE_URL>资源分组1,资源分组2</RESOURCE_URL>
+  <RY_ROLECODE>test001,dev001</RY_ROLECODE>
+  <ASSIGN_TYPE>user</ASSIGN_TYPE>
+  </ASSIGN>
+  <ASSIGN>
+  <RESOURCE_TYPE>0</RESOURCE_TYPE>
+  <RESOURCE_URL>模块1,模块2</RESOURCE_URL>
+  <RY_ROLECODE>test,dev</RY_ROLECODE>
+  <ASSIGN_TYPE>role</ASSIGN_TYPE>
+  </ASSIGN>
+  <ASSIGN>
+  <RESOURCE_TYPE>1</RESOURCE_TYPE>
+  <RESOURCE_URL>/test1,/test2</RESOURCE_URL>
+  <RY_ROLECODE>merit,bigData</RY_ROLECODE>
+  <ASSIGN_TYPE>org</ASSIGN_TYPE>
+  <HAS_PROGENY>1</HAS_PROGENY>
+  </ASSIGN>
+  <ASSIGN>
+  <RESOURCE_TYPE>2</RESOURCE_TYPE>
+  <RESOURCE_URL>cloud_zj1,cloud_zj2</RESOURCE_URL>
+  <RY_ROLECODE>test001,dev001</RY_ROLECODE>
+  <ASSIGN_TYPE>user</ASSIGN_TYPE>
+  </ASSIGN>
+  </ROOT>
+  ```
+- 执行结果如下图：
+  ![image](./imgs/组织人员同步/2-3.jpg)
+  ![image](./imgs/组织人员同步/2-4.jpg)
+
+### 6.2 配置说明
+
+| 字段名称      | 默认 XML 标签名 | 说明                                                         | 是否必填 |
+| ------------- | --------------- | ------------------------------------------------------------ | -------- |
+| 资源名称/路径 | <RESOURCE_URL>  | 资源名称/路径，通过设置名称/路径给组织/人员/角色赋予资源权限;模块：名称；菜单：路由地址；组件：组件编码；资源分组：分组名称 | 是       |
+| 编码          | <RY_ROLRCODE>   | 组织/人员/角色编码                                           | 是       |
+| 资源类型      | <RESOURCE_TYPE> | 0模块，1菜单，2组件，4资源分组，默认为1                      | 否       |
+| 授权类型      | <ASSIGN_TYPE>   | org组织授权，role角色授权，user人员授权，默认为role          | 否       |
+| 是否包含下级  | <HAS_PROGENY>   | 组织授权生效，0不包含，1包含，默认为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/20207_/347/273/204/347/273/207/345/220/214/346/255/245/351/205/215/347/275/256.md

@@ -0,0 +1,173 @@
+---
+name: 攻略-09-组织人员同步-章节07_组织同步配置
+description: 组织同步配置 — 美林平台 HR/ERP 组织和人员同步二开（webservice + RESTful）
+keywords: [组织同步, 人员同步, 资源同步, 角色同步, 权限同步, webservice, RESTful, HR集成, 组织同步配置]
+use-cases: [HR 系统对接, 组织架构导入, 人员批量同步, 权限同步]
+source-section: 7. 组织同步配置
+source-file: 应用开发平台-基础平台-使用攻略（九）：组织和人员同步.md
+---
+
+# 7. 组织同步配置
+
+- 组织同步、人员同步、资源同步、权限同步都需要一定的规则，根据这些定义的配置规则，将数据转换成 xml 字符串。
+- 组织同步配置说明：
+  - “固定编码值”字段是最终存入数据库中的值，修改时注意与系统中相对应数据字典的字典值的编码保持一致。
+  - 若“固定编码值”字段为空则“XPath 或值”字段内为 XPath，不为空则“XPath 或值”字段为值。如下图：
+
+* “XPath 或值”为 XPath 时，如人员性别 XPath 为 RY_SEX，人员的性别信息标签为<RY_SEX></RY_SEX>，如传入的字符串“性别”标签为<SEX>与 RY_SEX 不对应，可以修改 XPath 与之对应，将“性别”的 XPath 改为 SEX 即可(注意区分大小写，可支持中文)。如下图：
+
+  <XPath 或值>为值时
+
+  ```xml
+  <ROOT>
+    <ORG>
+      <ORG_CODE>jy2</ORG_CODE>
+      <ORG_PARENT_CODE>merit</ORG_PARENT_CODE>
+      <ORG_NAME>技研成2</ORG_NAME>
+      <ORG_SIMPLENAME>技研2</ORG_SIMPLENAME>
+      <ORG_SYNC_STATUS>1</ORG_SYNC_STATUS>
+      <ORG_DLEVEL>2</ORG_DLEVEL>
+      <ORG_IS_ABLE>1</ORG_IS_ABLE>
+      <ORG_SORT>1</ORG_SORT>
+      <ORG_REMARK>备注说明</ORG_REMARK>
+    </ORG>
+  </ROOT>
+  ```
+
+* 如机构中<XPath 或值>的值为”机构、部门、班组、小班”。那么传过来的 xml 中的值也应该为“机构、部门、班组、小班”如"<ORG_DLEVEL>部门</ORG_DLEVEL>":，如果<XPath 或值>中的值为“1、2、3、4”则 xml 中的值为“1、2、3、4”。
+
+* 根据 XPath 字段值，<ORG_DLEVEL>标签内可填的值有 1、2、3、4
+
+## 附录 A：常见问题
+
+- 1.  同一个 main 方法中同时调用多个 webservice 方法，执行时抛出异常：
+
+  - 错误调用方法代码示例：
+
+  ```java
+  public static void main(String[] args){
+    try {
+      JaxWsDynamicClientFactory dcf = JaxWsDynamicClientFactory.newInstance();
+      Client clientA = dcf.createClient("http://192.168.1.66:8080/groupClass/ws/getSayHelloService?wsdl");
+      Object[] resultA = clientA.invoke("sayHello", "Joker");
+      System.out.println("resultA===>" + resultA[0]);
+    dcf = JaxWsDynamicClientFactory.newInstance();
+      Client clientB = dcf.createClient("http://192.168.1.66:8080/groupClass/ws/getSayGoodByeService?wsdl");
+      Object[] resultB = clientB.invoke("sayGoodBye", "Joker");
+      System.out.println("resultB===>" + resultB[0]);
+    } catch (Exception e) {
+      e.printStackTrace();
+    }
+  }
+  ```
+  
+- 异常信息：
+  
+```
+  [INFO ] [08:43:33] org.apache.cxf.endpoint.dynamic.DynamicClientFactory - Created classes: gc.web.ws.ObjectFactory, gc.web.ws.SayHello, gc.web.ws.SayHelloResponse
+    resultA===>Hello:Joker
+  [INFO ] [08:43:35] org.apache.cxf.endpoint.dynamic.DynamicClientFactory - Created classes: gc.web.ws.ObjectFactory, gc.web.ws.SayGoodBye, gc.web.ws.SayGoodByeResponse
+    [WARN ] [08:43:35] org.apache.cxf.phase.PhaseInterceptorChain - Interceptor for {http://ws.web.gc/}SayGoodByeImplService#{http://ws.web.gc/}sayGoodBye has thrown exception, unwinding now
+    org.apache.cxf.interceptor.Fault: Marshalling Error: gc.web.ws.SayGoodBye is not known to this context
+    at org.apache.cxf.jaxb.JAXBEncoderDecoder.marshall(JAXBEncoderDecoder.java:266)
+    at org.apache.cxf.jaxb.io.DataWriterImpl.write(DataWriterImpl.java:237)
+    at org.apache.cxf.interceptor.AbstractOutDatabindingInterceptor.writeParts(AbstractOutDatabindingInterceptor.java:117)
+    at org.apache.cxf.wsdl.interceptors.BareOutInterceptor.handleMessage(BareOutInterceptor.java:68)
+    at org.apache.cxf.phase.PhaseInterceptorChain.doIntercept(PhaseInterceptorChain.java:308)
+    at org.apache.cxf.endpoint.ClientImpl.doInvoke(ClientImpl.java:514)
+    at org.apache.cxf.endpoint.ClientImpl.invoke(ClientImpl.java:423)
+    at org.apache.cxf.endpoint.ClientImpl.invoke(ClientImpl.java:324)
+    at org.apache.cxf.endpoint.ClientImpl.invoke(ClientImpl.java:277)
+    at org.apache.cxf.endpoint.ClientImpl.invoke(ClientImpl.java:297)
+    at org.apache.cxf.endpoint.ClientImpl.invoke(ClientImpl.java:283)
+    at cms.web.util.ConnectWebService.main(ConnectWebService.java:129)
+  Caused by: javax.xml.bind.MarshalException
+  - with linked exception:
+  [com.sun.istack.SAXException2: gc.web.ws.SayGoodBye is not known to this context
+  javax.xml.bind.JAXBException: gc.web.ws.SayGoodBye is not known to this context]
+    at com.sun.xml.bind.v2.runtime.MarshallerImpl.write(MarshallerImpl.java:326)
+    at com.sun.xml.bind.v2.runtime.MarshallerImpl.marshal(MarshallerImpl.java:251)
+    at javax.xml.bind.helpers.AbstractMarshallerImpl.marshal(AbstractMarshallerImpl.java:95)
+    at org.apache.cxf.jaxb.JAXBEncoderDecoder.writeObject(JAXBEncoderDecoder.java:617)
+    at org.apache.cxf.jaxb.JAXBEncoderDecoder.marshall(JAXBEncoderDecoder.java:241)
+    ... 11 more
+  Caused by: com.sun.istack.SAXException2: gc.web.ws.SayGoodBye is not known to this context
+  javax.xml.bind.JAXBException: gc.web.ws.SayGoodBye is not known to this context
+    at com.sun.xml.bind.v2.runtime.XMLSerializer.reportError(XMLSerializer.java:247)
+    at com.sun.xml.bind.v2.runtime.XMLSerializer.reportError(XMLSerializer.java:262)
+    at com.sun.xml.bind.v2.runtime.ElementBeanInfoImpl$1.serializeBody(ElementBeanInfoImpl.java:147)
+    at com.sun.xml.bind.v2.runtime.ElementBeanInfoImpl$1.serializeBody(ElementBeanInfoImpl.java:130)
+    at com.sun.xml.bind.v2.runtime.ElementBeanInfoImpl.serializeBody(ElementBeanInfoImpl.java:332)
+    at com.sun.xml.bind.v2.runtime.ElementBeanInfoImpl.serializeRoot(ElementBeanInfoImpl.java:339)
+    at com.sun.xml.bind.v2.runtime.ElementBeanInfoImpl.serializeRoot(ElementBeanInfoImpl.java:75)
+    at com.sun.xml.bind.v2.runtime.XMLSerializer.childAsRoot(XMLSerializer.java:494)
+    at com.sun.xml.bind.v2.runtime.MarshallerImpl.write(MarshallerImpl.java:323)
+    ... 15 more
+  Caused by: javax.xml.bind.JAXBException: gc.web.ws.SayGoodBye is not known to this context
+    at com.sun.xml.bind.v2.runtime.JAXBContextImpl.getBeanInfo(JAXBContextImpl.java:613)
+    at com.sun.xml.bind.v2.runtime.ElementBeanInfoImpl$1.serializeBody(ElementBeanInfoImpl.java:144)
+    ... 21 more
+  org.apache.cxf.interceptor.Fault: Marshalling Error: gc.web.ws.SayGoodBye is not known to this context
+    at org.apache.cxf.jaxb.JAXBEncoderDecoder.marshall(JAXBEncoderDecoder.java:266)
+    at org.apache.cxf.jaxb.io.DataWriterImpl.write(DataWriterImpl.java:237)
+    at org.apache.cxf.interceptor.AbstractOutDatabindingInterceptor.writeParts(AbstractOutDatabindingInterceptor.java:117)
+    at org.apache.cxf.wsdl.interceptors.BareOutInterceptor.handleMessage(BareOutInterceptor.java:68)
+    at org.apache.cxf.phase.PhaseInterceptorChain.doIntercept(PhaseInterceptorChain.java:308)
+    at org.apache.cxf.endpoint.ClientImpl.doInvoke(ClientImpl.java:514)
+    at org.apache.cxf.endpoint.ClientImpl.invoke(ClientImpl.java:423)
+    at org.apache.cxf.endpoint.ClientImpl.invoke(ClientImpl.java:324)
+    at org.apache.cxf.endpoint.ClientImpl.invoke(ClientImpl.java:277)
+    at org.apache.cxf.endpoint.ClientImpl.invoke(ClientImpl.java:297)
+    at org.apache.cxf.endpoint.ClientImpl.invoke(ClientImpl.java:283)
+    at cms.web.util.ConnectWebService.main(ConnectWebService.java:129)
+  Caused by: javax.xml.bind.MarshalException
+  - with linked exception:
+  [com.sun.istack.SAXException2: gc.web.ws.SayGoodBye is not known to this context
+  javax.xml.bind.JAXBException: gc.web.ws.SayGoodBye is not known to this context]
+    at com.sun.xml.bind.v2.runtime.MarshallerImpl.write(MarshallerImpl.java:326)
+    at com.sun.xml.bind.v2.runtime.MarshallerImpl.marshal(MarshallerImpl.java:251)
+    at javax.xml.bind.helpers.AbstractMarshallerImpl.marshal(AbstractMarshallerImpl.java:95)
+    at org.apache.cxf.jaxb.JAXBEncoderDecoder.writeObject(JAXBEncoderDecoder.java:617)
+    at org.apache.cxf.jaxb.JAXBEncoderDecoder.marshall(JAXBEncoderDecoder.java:241)
+    ... 11 more
+  Caused by: com.sun.istack.SAXException2: gc.web.ws.SayGoodBye is not known to this context
+  javax.xml.bind.JAXBException: gc.web.ws.SayGoodBye is not known to this context
+    at com.sun.xml.bind.v2.runtime.XMLSerializer.reportError(XMLSerializer.java:247)
+    at com.sun.xml.bind.v2.runtime.XMLSerializer.reportError(XMLSerializer.java:262)
+    at com.sun.xml.bind.v2.runtime.ElementBeanInfoImpl$1.serializeBody(ElementBeanInfoImpl.java:147)
+    at com.sun.xml.bind.v2.runtime.ElementBeanInfoImpl$1.serializeBody(ElementBeanInfoImpl.java:130)
+    at com.sun.xml.bind.v2.runtime.ElementBeanInfoImpl.serializeBody(ElementBeanInfoImpl.java:332)
+    at com.sun.xml.bind.v2.runtime.ElementBeanInfoImpl.serializeRoot(ElementBeanInfoImpl.java:339)
+    at com.sun.xml.bind.v2.runtime.ElementBeanInfoImpl.serializeRoot(ElementBeanInfoImpl.java:75)
+    at com.sun.xml.bind.v2.runtime.XMLSerializer.childAsRoot(XMLSerializer.java:494)
+    at com.sun.xml.bind.v2.runtime.MarshallerImpl.write(MarshallerImpl.java:323)
+    ... 15 more
+  Caused by: javax.xml.bind.JAXBException: gc.web.ws.SayGoodBye is not known to this context
+    at com.sun.xml.bind.v2.runtime.JAXBContextImpl.getBeanInfo(JAXBContextImpl.java:613)
+    at com.sun.xml.bind.v2.runtime.ElementBeanInfoImpl$1.serializeBody(ElementBeanInfoImpl.java:144)
+    ... 21 more
+```
+
+- 此类问题的解决方式有两种：
+    （1）直接在方法中一次只调用一个 webservice 同步接口；
+    （2）改造 main 方法，使每次调用前重置上下文
+  
+  ```java
+    public static void main(String[] args){
+      try {
+        //在一个方法中连续调用多次WebService接口,每次调用前需要重置上下文
+        ClassLoader cl = Thread.currentThread().getContextClassLoader();
+      JaxWsDynamicClientFactory dcf = JaxWsDynamicClientFactory.newInstance();
+      Client clientA = dcf.createClient("http://192.168.1.66:8080/groupClass/ws/getSayHelloService?wsdl");
+        Object[] resultA = clientA.invoke("sayHello", "Joker");
+        System.out.println("resultA===>" + resultA[0]);
+        Thread.currentThread().setContextClassLoader(cl);
+      dcf = JaxWsDynamicClientFactory.newInstance();
+      Client clientB = dcf.createClient("http://192.168.1.66:8080/groupClass/ws/getSayGoodByeService?wsdl");
+      Object[] resultB = clientB.invoke("sayGoodBye", "Joker");
+      System.out.println("resultB===>" + resultB[0]);
+      } catch (Exception e) {
+        e.printStackTrace();
+      }
+    }
+  ```

package/skills/meritdata-dev-docs-file-finder/references/dev-docs//346/224/273/347/225/245-10-/345/256/232/346/227/266/350/260/203/345/272/246-00_/346/200/273/350/247/210.md

@@ -0,0 +1,49 @@
+---
+name: 攻略-10-定时调度-00_总览
+description: 美林平台 XXL-JOB 定时调度任务开发（JobHandler + Cron + API）
+keywords: [XXL-JOB, 定时任务, 调度, JobHandler, Cron, API]
+use-cases: [定时任务开发, JobHandler 编写, 调度 API 调用]
+related: [IJobApi / cloud-system-job / 14_四业务组件-4.3定时任务IJobApi.md]
+source: 应用开发平台-基础平台-使用攻略（十）：定时调度任务.md
+---
+
+# 微服务使用攻略（十）：定时调度任务 — 总览
+
+**摘要**：美林平台 XXL-JOB 定时调度任务开发（JobHandler + Cron + API）
+
+**关联**：IJobApi / cloud-system-job / 14_四业务组件-4.3定时任务IJobApi.md
+
+## 章节索引
+
+01. [使用背景](攻略-10-定时调度-章节01_使用背景.md)
+02. [更新记录](攻略-10-定时调度-章节02_更新记录.md)
+03. [调度相关应用包](攻略-10-定时调度-章节03_调度相关应用包.md) (原 1)
+04. [配置项相关](攻略-10-定时调度-章节04_配置项相关.md) (原 2)
+05. [调度功能使用](攻略-10-定时调度-章节05_调度功能使用.md) (原 3)
+06. [调度任务 API 接口](攻略-10-定时调度-章节06_调度任务_API_接口.md) (原 4)
+07. [对外调度任务 API 接口](攻略-10-定时调度-章节07_对外调度任务_API_接口.md) (原 5)
+
+
+## 📑 API 速查
+
+本攻略共 **1 个 API**（按章节排序）：
+
+| 章节 | API | 方法 | 路径/签名 | 类型 | 描述 |
+|------|------|------|----------|------|------|
+| 章节05_调度功能使用 | `JobHandler` | - | `class JobHandler` | java | XXL-JOB JobHandler 实现（@JobHandler 注解） |
+
+### JSON Schema 完整索引
+
+```json
+[
+  {
+    "chapter": "章节05_调度功能使用",
+    "apiName": "JobHandler",
+    "method": "",
+    "urlPattern": "",
+    "type": "java",
+    "signature": "class JobHandler",
+    "functionDesc": "XXL-JOB JobHandler 实现（@JobHandler 注解）"
+  }
+]
+```

package/skills/meritdata-dev-docs-file-finder/references/dev-docs//346/224/273/347/225/245-10-/345/256/232/346/227/266/350/260/203/345/272/246-/347/253/240/350/212/20201_/344/275/277/347/224/250/350/203/214/346/231/257.md

@@ -0,0 +1,12 @@
+---
+name: 攻略-10-定时调度-章节01_使用背景
+description: 使用背景 — 美林平台 XXL-JOB 定时调度任务开发（JobHandler + Cron + API）
+keywords: [XXL-JOB, 定时任务, 调度, JobHandler, Cron, API, 使用背景]
+use-cases: [定时任务开发, JobHandler 编写, 调度 API 调用]
+source-section: 无编号. 使用背景
+source-file: 应用开发平台-基础平台-使用攻略（十）：定时调度任务.md
+---
+
+# 使用背景
+
+​		很多的业务场景需要我们在某一个特定的时刻去做某件任务，比如特定时间对数据统计，数据同步，对账，导出业务数据。使用分布式调度任务, 整体操作都在页面中，可视化效果好。之前我们用的单体调度，系统中一个集群中只有一个节点运行调度进程，该节点执行所有调度任务，但是一旦出现故障，则所有的都进行不下去，扩展性比较低，因此，我们引入了分布式调度。

package/skills/meritdata-dev-docs-file-finder/references/dev-docs//346/224/273/347/225/245-10-/345/256/232/346/227/266/350/260/203/345/272/246-/347/253/240/350/212/20202_/346/233/264/346/226/260/350/256/260/345/275/225.md

@@ -0,0 +1,14 @@
+---
+name: 攻略-10-定时调度-章节02_更新记录
+description: 更新记录 — 美林平台 XXL-JOB 定时调度任务开发（JobHandler + Cron + API）
+keywords: [XXL-JOB, 定时任务, 调度, JobHandler, Cron, API, 更新记录]
+use-cases: [定时任务开发, JobHandler 编写, 调度 API 调用]
+source-section: 无编号. 更新记录
+source-file: 应用开发平台-基础平台-使用攻略（十）：定时调度任务.md
+---
+
+# 更新记录
+
+| 版本   | 时间       | 更新内容     |
+| ------ | ---------- | ------------ |
+| 6.13.2 | 2025-05-27 | 定时调度任务 |

package/skills/meritdata-dev-docs-file-finder/references/dev-docs//346/224/273/347/225/245-10-/345/256/232/346/227/266/350/260/203/345/272/246-/347/253/240/350/212/20203_/350/260/203/345/272/246/347/233/270/345/205/263/345/272/224/347/224/250/345/214/205.md

@@ -0,0 +1,15 @@
+---
+name: 攻略-10-定时调度-章节03_调度相关应用包
+description: 调度相关应用包 — 美林平台 XXL-JOB 定时调度任务开发（JobHandler + Cron + API）
+keywords: [XXL-JOB, 定时任务, 调度, JobHandler, Cron, API, 调度相关应用包]
+use-cases: [定时任务开发, JobHandler 编写, 调度 API 调用]
+source-section: 1. 调度相关应用包
+source-file: 应用开发平台-基础平台-使用攻略（十）：定时调度任务.md
+---
+
+# 1.调度相关应用包
+
+| 应用/依赖包       | 备注                 |
+| ----------------- | -------------------- |
+| cloud-system-job  | 调度任务服务端       |
+| cloud-starter-job | 调度任务客户端依赖包 |

package/skills/meritdata-dev-docs-file-finder/references/dev-docs//346/224/273/347/225/245-10-/345/256/232/346/227/266/350/260/203/345/272/246-/347/253/240/350/212/20204_/351/205/215/347/275/256/351/241/271/347/233/270/345/205/263.md

@@ -0,0 +1,23 @@
+---
+name: 攻略-10-定时调度-章节04_配置项相关
+description: 配置项相关 — 美林平台 XXL-JOB 定时调度任务开发（JobHandler + Cron + API）
+keywords: [XXL-JOB, 定时任务, 调度, JobHandler, Cron, API, 配置项相关]
+use-cases: [定时任务开发, JobHandler 编写, 调度 API 调用]
+source-section: 2. 配置项相关
+source-file: 应用开发平台-基础平台-使用攻略（十）：定时调度任务.md
+---
+
+# 2.配置项相关
+
+调度任务配置为 nacos 中的 common-cloud-system-job.properties 文件
+
+```properties
+#job执行器可以使用的端口,用于创建客户端netty服务 默认从8000,65535端口轮询，填一个值，端口作为起始端口
+meritdata.cloud.job.executor.port=8000,9000
+#job config 日志清理天数
+meritdata.cloud.job.logretentiondays=-1
+#i18n (default empty as chinese, "en" as english)
+meritdata.cloud.job.i18n=
+#系统日志文件路径
+meritdata.cloud.job.executor.port=
+```

package/skills/meritdata-dev-docs-file-finder/references/dev-docs//346/224/273/347/225/245-10-/345/256/232/346/227/266/350/260/203/345/272/246-/347/253/240/350/212/20205_/350/260/203/345/272/246/345/212/237/350/203/275/344/275/277/347/224/250.md

@@ -0,0 +1,132 @@
+---
+name: 攻略-10-定时调度-章节05_调度功能使用
+description: 调度功能使用 — 美林平台 XXL-JOB 定时调度任务开发（JobHandler + Cron + API）
+keywords: [XXL-JOB, 定时任务, 调度, JobHandler, Cron, API, 调度功能使用]
+use-cases: [定时任务开发, JobHandler 编写, 调度 API 调用]
+source-section: 3. 调度功能使用
+source-file: 应用开发平台-基础平台-使用攻略（十）：定时调度任务.md
+---
+
+# 3.调度功能使用
+
+## 📋 API 契约（机器可读）
+
+```json
+{
+  "apiName": "JobHandler",
+  "type": "java",
+  "signature": "class JobHandler",
+  "functionDesc": "XXL-JOB JobHandler 实现（@JobHandler 注解）",
+  "module": "platform",
+  "methods": [
+    "execute()"
+  ],
+  "bestPractice": "确保方法抛出的异常已被 Service 层 catch 或全局异常处理器处理"
+}
+```
+
+完成系统环境搭建
+启动完后可访问 job 管理页面 ,8080 端口为前端应用 nginx 的启动端口
+http://ip地址:8080/portal
+
+### 3.1. 调度任务客户端注册
+
+新建一个 project-business-sso 执行器客户端样例服务，参考《微服务使用攻略（一）：系统环境搭建》后端工程创建，添加依赖包至客户端应用的 pom.xml 的 dependencies 节点
+
+```xml
+<dependency>
+    <groupId>com.meritdata.cloud</groupId>
+    <artifactId>cloud-starter-job</artifactId>
+    <version>${meritdata-cloud.version}</version>
+</dependency>
+```
+
+同时需要在工程下的bootstrap.properties中找到spring.profiles.include并添加cloud-system-job，如下图：
+
+![image](/imgs/定时调度任务/2-4.png)
+
+
+
+执行器客户端服务启动完后，访问执行器管理页面可在页面发现该客户端已注册
+
+![image](/imgs/定时调度任务/1-1.png)
+
+### 3.2. 客户端应用内新增调度任务
+
+```java
+import com.xxl.job.core.biz.model.ReturnT;
+import com.xxl.job.core.handler.IJobHandler;
+import com.xxl.job.core.handler.annotation.JobHandler;
+import com.xxl.job.core.log.XxlJobLogger;
+import org.springframework.stereotype.Component;
+/**
+ 任务 Handler 示例（Bean 模式）
+ 开发步骤：
+ 1、继承"IJobHandler"：“com.xxl.job.core.handler.IJobHandler”；
+ 2、注册到 Spring 容器：添加“@Component”注解，被 Spring 容器扫描为 Bean 实例；
+ 3、注册到执行器工厂：添加“@JobHandler(value="自定义 jobhandler 名称")”注解，注解 value 值对应的是调度中心新建任务的 JobHandler 属性的值。
+ 4、执行日志：需要通过 "XxlJobLogger.log" 打印执行日志；
+*/
+@Component(value="demoJobHandler")
+@JobHandler(value="demoJobHandler")
+public class HelloWorldJob extends IJobHandler {
+    @Override
+    public ReturnT<String> execute(String param) throws Exception {
+    System.out.println("demoJobHandler");
+    XxlJobLogger.log("demoJobHandler");
+    return SUCCESS;
+    }
+}
+
+```
+
+### 3.3. 调度任务管理页面新增调度任务
+
+新增中的 JobHandler 值为@JobHandler 注解的 Value 值，参考样例如下图：
+
+- 调度任务管理界面如下：
+  ![image](/imgs/定时调度任务/1-2.png)
+  
+- 调度任务维护界面如下：
+  ![image](/imgs/定时调度任务/1-2-1.png)
+  
+- 新增调度任务
+
+  - 执行器：服务名称
+
+  - 路由策略：执行器集群部署时提供的路由策略
+
+    - 第一个：固定选择第一个机器
+    - 最后一个： 固定选择最后一个机器
+    - 轮询：负载均衡+故障转移（根据jobId和路由地址数量求余，进行轮询，超过24小时，清零，从头开始）
+    - 随机：随机选择一个在线机器
+    - 一致性hash：主要解决集群增加或者减少节点
+    - 最不经常使用：
+    - 最近最久未使用：
+    - 故障转移：按照顺序依次进行心跳检测，第一个心跳检测成功的机器选为目标执行器并发起调度
+    - 忙碌转移：广播出发对应机器中所有机器执行一次任务，同时系统自动传递分片参数；可以根据分片参数开发分片任务
+
+  - cron表达式：是一个字符串，字符串以5或6个空格隔开，分为6或7个域，每一个域代表一个含义  
+  参见附录1 cron表达式
+
+
+
+  - JobHandler：这里填的是后端编写的调度任务JobHandler中注解名称
+
+  - 阻塞处理策略：
+
+    - 单机串行：以队列的形式，顺序执行
+    - 丢弃后续调度：如果有运行的调度任务，则新加入的直接返回失败。
+    - 覆盖之前调度：如果有运行的调度任务，则停止现有的调度任务，执行最新的调度任务。
+
+  - 子任务ID
+
+  - 任务超时时间
+
+  - 失败重试次数
+
+  - 负责人
+
+  - 报警邮件
+
+  - 任务参数

package/skills/meritdata-dev-docs-file-finder/references/dev-docs//346/224/273/347/225/245-10-/345/256/232/346/227/266/350/260/203/345/272/246-/347/253/240/350/212/20206_/350/260/203/345/272/246/344/273/273/345/212/241_API_/346/216/245/345/217/243.md

@@ -0,0 +1,14 @@
+---
+name: 攻略-10-定时调度-章节06_调度任务_API_接口
+description: 调度任务 API 接口 — 美林平台 XXL-JOB 定时调度任务开发（JobHandler + Cron + API）
+keywords: [XXL-JOB, 定时任务, 调度, JobHandler, Cron, API, 调度任务 API 接口]
+use-cases: [定时任务开发, JobHandler 编写, 调度 API 调用]
+source-section: 4. 调度任务 API 接口
+source-file: 应用开发平台-基础平台-使用攻略（十）：定时调度任务.md
+---
+
+# 4. 调度任务 API 接口
+
+平台提供调度任务接口供维护调度任务数据，接口详情访问 http://ip:8080/gateway/swagger-ui.html
+
+![image](/imgs/定时调度任务/1-3.png)