Ecode

https://e-cloudstore.com/doc.html
Admin
Ecode is a front-end development platform designed for non-intrusive customization and secondary...
Tokens:129,571
Snippets:903
Trust Score:6.3
Update:2 months ago
Show doc for...
Tokens:
Raw
### Java HTTP Interface Integration

Source: https://e-cloudstore.com/doc.html?appId=0d084e0145f044d3888b2e16b1875951

Example demonstrating how to call OA system interfaces from Java, including parameter setup and required configuration steps.

```java
  1.   2.   3.     import com.alibaba.fastjson.JSON;
  4.     import com.alibaba.fastjson.JSONObject;
  5.     import com.alibaba.fastjson.TypeReference;
  6.     import org.junit.Test;
  7.     import weaver.rsa.security.RSA;
  8.   9.     import java.io.*;
  10.     import java.net.HttpURLConnection;
  11.     import java.net.URL;
  12.     import java.security.KeyManagementException;
  13.     import java.security.NoSuchAlgorithmException;
  14.   15.     import java.util.Base64;
  16.     import java.util.HashMap;
  17.     import java.util.Map;
  18.   19.     /**
  20.      * 1、OA数据库插入
  21.      * INSERT INTO ECOLOGY_BIZ_EC(ID,APPID,NAME) VALUES('123456','5583bc0e-220e-4a44-8e14-d838d47ad9b6','上海泛微网络科技股份有限公司');
  22.      * id 主键保证表中唯一，appid和代码中传入和appid一致，name 名称
  23.      * <p>
  24.      * 2、刷新OAsql缓存
  25.      * chrome浏览器访问 OA地址/commcache/cacheMonitor.jsp界面，点击重启加载配置
  26.      * <p>
  27.      * 3、web.xml修改，将EMFilter添加在SessionFilter之前（已经有了不需要再做修改）
  28.      * <filter>
  29.      * <filter-name>EMFilter</filter-name>
  30.      * <filter-class>com.cloudstore.dev.api.service.EMFilter</filter-class>
  31.      * </filter>
  32.      * <filter-mapping>
  33.      * <filter-name>EMFilter</filter-name>
  34.      * <url-pattern>/*</url-pattern>
  35.      * </filter-mapping>
  36.      * <filter>
  37.      * <filter-name>SessionFilter</filter-name>
  38.      * <filter-class>com.cloudstore.dev.api.service.SessionFilter</filter-class>
  39.      * </filter>
  40.      * <filter-mapping>
  41.      * <filter-name>SessionFilter</filter-name>
  42.      * <url-pattern>/api/*</url-pattern>
  43.      * </filter-mapping>
  44.      * <filter-mapping>
  45.      * <filter-name>SessionFilter</filter-name>
  46.      * <url-pattern>/page/interfaces/*.jsp</url-pattern>
  47.      * </filter-mapping>
  48.      * <p>
  49.      * 4、在ecology系统代码目录中找到ecology/WEB-INF/lib/RSA-0.0.1-SNAPSHOT.jar文件引入到第三方系统项目资源目录下。
  50.      * <p>
  51.      * 以上步骤有所简化，详细对应OA版本的操作步骤请查看文档
  52.      */
  53.     public class MessageTest {
  54.   55.         public static void main(String[] args) {
  56.             try {
  57.                 testRestful("http://localhost:8080"); //OA地址
  58.             } catch (NoSuchAlgorithmException e) {
  59.                 e.printStackTrace();
  60.             } catch (KeyManagementException e) {
  61.   62.             }
  63.         }
  64.   65.         /**
  66.          * APPID 指定一个UUID （请记住是指定一个UUID，作为第三方系统的唯一标识）
  67.          */
  68.         private static final String APPID = "5583bc0e-220e-4a44-8e14-d838d47ad9b6";
  69.   70.   71.         /**
  72.          * 发送消息，参数封装
  73.          * @return
  74.          */
  75.         public static Map<String,String> sendCustomMessageSingle() {
  76.   77.             Map<String, String> map = new HashMap<>();
  78.   79.             map.put("code", "559"); // 消息来源,新建消息来源获取code 请查看文档第四大点补充
  80.             map.put("userIdList", "1,3"); // userIdList参数 userIdList 接收人OA系统id / loginIdList 接收人登录名 / workCodeList 接收人编号 / lastNameList 接收人姓名（任选一个填入即可，以逗号分隔）
  81.     //      map.put("loginIdList","zhangsan,wangwu" ); //接收人登录名
  82.     //        map.put("workCodeList","WS01640,WS01641" ); //接收人编号
  83.     //        map.put("lastNameList","张三,王五" ); //接收人姓名
  84.             map.put("creater", "1"); //creater的值 创建人OA系统id / 创建人登录名 / 创建人编号 / 创建人姓名（对应接收人所传入的形式）
  85.     //        map.put("creater","zhangsan");
  86.     //        map.put("creater","WS01640");
  87.     //        map.put("creater","张三");
  88.             map.put("title", "标题");
  89.             map.put("context", "内容");
  90.             map.put("linkUrl", "PC端链接");
  91.             map.put("linkMobileUrl", "移动端链接");
  92.   93.     //        map.put("targetId","559|id22"); //消息来源code +“|”+业务id  消息需要打上已处理标记
  94.     //        map.put("bizState","0"); //0 表示消息初始状态是待处理  消息需要打上已处理标记
  95.   96.             return map;
```

--------------------------------

### Synchronize Subcompany Response Example

Source: https://e-cloudstore.com/doc.html?appId=c373a4b01fb74d098b62e2b969081d2d

Example response returned after a subcompany synchronization request.

```json
{
  "result": {
    "test": { //分部编号
      "msg": "插入成功",
      "code": "1" 
    }
  },
  "code": "1" // 1 成功
}
```

--------------------------------

### Synchronize Subcompany Request Example

Source: https://e-cloudstore.com/doc.html?appId=c373a4b01fb74d098b62e2b969081d2d

Example payload for the /api/hrm/resful/synSubcompany endpoint to synchronize subcompany data.

```json
{
    "rule":{ // 非必须, 可以根据需求来增减
        "subcompnay":"subcompanycode", // 分部使用编码寻找数据，默认按照名称
        "department":"departmentcode", // 部门使用编码寻找数据，默认按照名称
        "resource":"workcode", // 人员使用编码寻找数据，默认按照名称
        "jobtitle":"jobtitlecode" // 岗位使用编码寻找数据，默认按照名称
    },
    "data":[
        {
            "@action":"add", 
            "code":"test",
            "shortname":"测试-分部简称",
            "fullname":"测试-分部全称",
            "parent_code":"上级分部编码",
            "order":"3",
            "custom_data":{
                "zdy2":"wmz分部",
                "zdy3":"测试人员1,yhm05"
            }
        }
    ]
}
```

--------------------------------

### License Registration Response Examples

Source: https://e-cloudstore.com/doc.html?appId=af09c25938714c26b9736f535ca20fc9

JSON responses for the license registration endpoint, including success and error scenarios.

```json
  1. {
  2.     "msg": "ok",
  3.     "errcode": "0",
  4.     "code": 0,
  5.     "msgShowType": "none",
  6.     "secrit": "e0ab4a73-e9c6-4ae5-9dac-f21a7807991a",
  7.     "errmsg": "ok",
  8.     "status": true,
  9.     "spk": "MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAmNIfHNjAvtvkSKtAj79mkHOk5/bDwrGVykRJ7saI1oLHPp8lEQjBP5Ae4Te5chzflLLEj4WP24JnY2ahzb8xnPU/HNt/lwhykjoxVPoczdlXL4jcdMuvgitgCQdrqPgtpzrKNOoKbTz9vagMl0LbzGlSzGPF4PAlGDw+OrgOMsiWXyG1EsQWOW5zfwnnGfvnPZlpSKfDKT3m+9oPL/cWQv6FU1A1kHO4ADT+Np8Q2n33mMJC1Sc+YiFjNIblGoB0AME7M0hb+Ln4b+n+23jsBBeZhfBdmRdLY31AALWIuJH1+8KZvaaMS0OwkBdCfZhF4chWYSRAV4yjCx19Ax/wBQIDAQAB"
  10. }
```

```json
  1. {
  2.     "msg": "ok",
  3.     "errcode": "1",
  4.     "code": -1,
  5.     "msgShowType": "none",
  6.     "errmsg": "passowrd error:null & sysadmin",
  7.     "status": false
  8. }
```

```json
  1. {
  2.     "msg": "ok",
  3.     "errcode": "1",
  4.     "code": 0,
  5.     "msgShowType": "none",
  6.     "errmsg": "注册失败没有在找到正确的APPID:EEAA5436-7577-4BE0-8C6C-89E9D888",
  7.     "status": false
  8. }
```

--------------------------------

### Personnel Information Request

Source: https://e-cloudstore.com/doc.html?appId=c373a4b01fb74d098b62e2b969081d2d

Example request body for retrieving personnel information.

```json
{
    "params":{
        "workcode" : "test1",
        "loginid":"zhangsan"
    }
}
```

--------------------------------

### Account Exception Error Response Example

Source: https://e-cloudstore.com/doc.html?appId=af09c25938714c26b9736f535ca20fc9

JSON response returned when the user account is frozen, missing credentials, or license limits are reached.

```json
  1. {"msg":"该账号存在异常,单点登录失败userid:782","code":-1,"msgShowType":"none","status":false}
```

--------------------------------

### Missing Login Information Error Response Example

Source: https://e-cloudstore.com/doc.html?appId=af09c25938714c26b9736f535ca20fc9

JSON response returned when required request header parameters are missing.

```json
  1. {"err":"未获取到登录信息"}
```

--------------------------------

### React Component Lifecycle and Communication Demo

Source: https://e-cloudstore.com/doc.html?appId=c1aa92bb812944ac862d2186f730d46e

A complete example demonstrating React component lifecycle hooks, state updates, and parent-child communication via props.

```javascript

  1. import React from 'react';
  2. import { render } from 'react-dom';
  3.   4.   5. class Child extends React.Component {
  6.   state = {
  7.     content: '这里是 Child 的内容',
  8.   }
  9.   10.   constructor(props) {
  11.     super(props);
  12.     console.log('init');
  13.   }
  14.   15.   componentWillMount() {
  16.     console.log('componentWillMount');
  17.   }
  18.   19.   componentDidMount() {
  20.     console.log('componentDidMount');
  21.   }
  22.   23.   componentWillReceiveProps(nextProps) {
  24.     console.log('componentWillReceiveProps: ', nextProps);
  25.   }
  26.   27.   shouldComponentUpdate(nextProps, nextState) {
  28.     console.log('shouldComponentUpdate: ', nextProps, nextState);
  29.     return true;
  30.   }
  31.   32.   componentDidUpdate(preProps, preState) {
  33.     console.log('componentDidUpdate', preProps, preState);
  34.   }
  35.   36.   componentWillUnmount() {
  37.     console.log('componentWillUnmount');
  38.   }
  39.   40.   onButton2Click = () => {
  41.     this.setState({ content: '点击了按钮2' });
  42.   }
  43.   44.   onButton3Click = () => {
  45.     const { onChange } = this.props;
  46.     if (typeof onChange === 'function') {
  47.       onChange('这是从 Child 回调过来的数据');
  48.     }
  49.   }
  50.   51.   render() {
  52.     console.log('render');
  53.     const { data } = this.props;
  54.     const { content } = this.state;
  55.     const arr = [
  56.       <p>1</p>,
  57.       <p>2</p>,
  58.     ];
  59.     const arr1 = [1,2];
  60.     return (
  61.       <div
  62.         id="child"
  63.         className={`child${arr1}`}
  64.         style={{ color: '#666' }}
  65.       >
  66.         标题
  67.         {arr}
  68.         {arr1.map(a => <p>{a}</p>)}
  69.         <p>{content}</p>
  70.         <button onClick={() => this.setState({ content: '点击了按钮1' })}>按钮1</button>
  71.         <button onClick={this.onButton2Click}>按钮2</button>
  72.         <button onClick={this.onButton3Click}>按钮3 点击修改父组件内容</button>
  73.         <p>
  74.           从 Parent 传输的 props.data: {data}
  75.         </p>
  76.       </div>
  77.     );
  78.   }
  79. }
  80.   81. class Parent extends React.Component {
  82.   state = {
  83.     content: '这里是 Parent 的内容',
  84.     childPropsData: '传个 Child 的内容',
  85.   }
  86.   render() {
  87.     const { content, childPropsData } = this.state;
  88.     return (
  89.       <div id="parent" className="parent" style={{ padding: 20 }}>
  90.         {content}
  91.         <div style={{ border: '1px solid #ccc', padding: 10 }}>
  92.           <Child
  93.             data={childPropsData}
  94.             onChange={(v) => this.setState({ content: v })}
  95.           />
  96.         </div>
  97.       </div>
  98.     );
  99.   }
  100. }
  101.   102. render(<Parent />, document.getElementById('container'));
```

--------------------------------

### API Response Output

Source: https://e-cloudstore.com/doc.html?appId=af09c25938714c26b9736f535ca20fc9

Example output logs from the registration, token retrieval, and RESTful API calls.

```text
1. testRegist()：{"msg":"ok","code":0,"msgShowType":"none","secrit":"c8b987ff-ce36-4fbe-bac5-98370b1d5c5a","secret":"c8b987ff-ce36-4fbe-bac5-98370b1d5c5a","status":true,"spk":"MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQCAbZETaIipqH7puERgJ6VVkBGKOCK+JOfr7+A+VfobRLGeXVkuCRzFj0RhlqlODzCjEff6rm0WDrcfAM6BxfjCciCKx2EXqjklfgZyY/gGf8PYfVmPG55k37edba4MpG+R1fcMtsB5qRHTpEVfoVBlr8ys1VhA/7dv+JLwg5B+FQIDAQAB"}
  2.   3. testGetoken()：{"msg":"获取成功!","code":0,"msgShowType":"none","status":true,"token":"7099a965-7ef4-4e2d-a1e2-a4d66a10e945"}
  4.   5. testRestful()：{"schema":"http","code":0,"port":80,"msgShowType":"none","ip":"10.10.10.40","host":"192.168.42.163","type":"1","url":"/spa/coms/static4mobile/index.html#/menu-preview?id=appPage_ooxtkh&checkAccess=1","status":true}
```

--------------------------------

### Get Sub-company List Response

Source: https://e-cloudstore.com/doc.html?appId=c373a4b01fb74d098b62e2b969081d2d

Example response structure for the sub-company list API.

```json
  1. {
  2.   "code": "1", // 1 成功 ，其他为失败
  3.   "data": {
  4.     "totalSize": 1, // 分页-总数
  5.     "dataList": [ // 数据集合
  6.       {
  7.         "subcompanydesc": "liul分部", // 分部全称
  8.         "canceled": "", // 封存标志，1 封存，其他为未封存
  9.         "subcompanycode": "", // 分部编码
  10.         "supsubcomid": "0", // 上级分部id, 0 或者 空为表示没有上级分部 
  11.         "created": "2020-01-13 17:59:28", // 创建时间戳
  12.         "modified": "2020-09-06 00:11:00", // 修改时间戳
  13.         "id": "11", // 分部id ，唯一标识id
  14.         "subcompanyname": "liul分部", // 分部简称
  15.         "url": "", // 废弃字段
  16.          "custom_data" : { // 自定义数据
  17.              "zdy2": "wmz分部" // 自定义数据，具体参考 【组织权限中心-自定义设置-分部字段定义】
  18.          },
  19.         "showorder": "0.0" // 排序
  20.       }
  21.     ],
  22.     "pageSize": 20, // 分页-单页条目数
  23.     "page": 1 // 分页-当前页数
  24.   }
  25. }
```

--------------------------------

### 删除服务器初始化文件

Source: https://e-cloudstore.com/doc.html?appId=f9a644cf305e400bb902b24ba530572b

在处理 ecode 发布导致的登录页接口异常时，通过删除指定的 init.js 文件来恢复系统访问。

```text
  1. ecology/cloudstore/dev/init.js
```

--------------------------------

### 修改Servlet启动加载顺序

Source: https://e-cloudstore.com/doc.html?appId=25fb364617c44ca3aa007581db3e4269

在web.xml中调整CloudStoreInit的启动顺序以解决初始化异常。

```xml
1. load-on-startup值由1改为3
```

--------------------------------

### 配置Resin远程调试参数

Source: https://e-cloudstore.com/doc.html?appId=c6a9ae6e47b74d4da04c935ed51d177a&maxImgWidth=800

在resin.properties中修改jvm_args以启用远程调试端口。

```text
    1. jvm_args  : -Xdebug -Xrunjdwp:transport=dt_socket,address=9081,server=y,suspend=n -Dcom.sun.management.jmxremote -Xloggc:/var/log/gc.log -Xmx1550m -Xms1550m -XX:ParallelGCThreads=20 -XX:+UseConcMarkSweepGC -XX:+UseParNewGC -XX:+DisableExplicitGC
    2. jvm_mode  : -server
```

--------------------------------

### ModeForm.getFieldCurViewAttr

Source: https://e-cloudstore.com/doc.html?appId=e783a1d75a784d9b97fbd40fdf569f7d

Gets the current runtime view attribute of a field.

```APIDOC
## ModeForm.getFieldCurViewAttr(fieldMark)

### Description
Retrieves the current runtime view attribute (1: read-only, 2: editable, 3: required) of a field.

### Parameters
- **fieldMark** (String) - Required - Field identifier, format: field${字段ID}_${明细行号}

### Example
ModeForm.getFieldCurViewAttr("field110_2");
```

--------------------------------

### 配置消息分表定时任务

Source: https://e-cloudstore.com/doc.html?appId=0430525e9b384715a08d4c64ad4fb404

在weaver.general.InitServer中配置消息分表与定时删除任务，支持单机与集群环境的逻辑判断。

```java
  1. import com.cloudstore.api.util.Util_Redis;
  2. import org.apache.commons.lang.StringUtils;
  3. //开启消息、消息日志分表和定时删除
  4.         if(SubMessageTableTimerSchedule.isSimpleMode()){//单机
  5.             SubMessageTableTimerSchedule.startSub();
  6.             log.info("单机节点启动定时任务");
  7.         }else {//集群
  8.             Util_Redis redis = Util_Redis.getIstance();
  9.             if(StringUtils.isBlank(redis.get("messagestimer"))){
  10.                 redis.set("messagestimer","using",3600);
  11.                 SubMessageTableTimerSchedule.startSub();
  12.                 log.info("集群环境某节点启动定时任务成功");
  13.             }else{
  14.                 log.info("集群环境某节点获取到redis字段，定时任务开启失败");
  15.             }
  16.         }
```

--------------------------------

### WfForm.getDetailRowCount

Source: https://e-cloudstore.com/doc.html?appId=98cb7a20fae34aa3a7e3a3381dd8764e

Gets the total number of rows in a detail table.

```APIDOC
## WfForm.getDetailRowCount(detailMark)

### Description
Returns the total count of rows in the specified detail table.

### Parameters
- **detailMark** (String) - Required - Detail table identifier.
```

--------------------------------

### WfForm.getDetailRowSerailNum

Source: https://e-cloudstore.com/doc.html?appId=98cb7a20fae34aa3a7e3a3381dd8764e

Gets the serial number (row index) of a detail row.

```APIDOC
## WfForm.getDetailRowSerailNum(mark, rowIndex)

### Description
Retrieves the display serial number for a specific row.

### Parameters
- **mark** (String) - Required - Detail table or field identifier.
- **rowIndex** (Int) - Required - Row index (required if mark is 'detail_${dindex}').
```

--------------------------------

### 跳过初始化出错的SQL语句

Source: https://e-cloudstore.com/doc.html?appId=25fb364617c44ca3aa007581db3e4269

当数据库初始化异常时，通过向cloudstore_sqlrun表插入记录来跳过导致错误的SQL语句。

```sql
1. insert into cloudstore_sqlrun (keyStr, appNo) values ('?', 'cloudstore');
2. --  ? 为上述记录的errKey
```

--------------------------------

### Perform HTTP Request and Map Conversion in Java

Source: https://e-cloudstore.com/doc.html?appId=792351d34181448daf1f79357b845696

Includes logic for setting up HTTP connections, handling POST/GET parameters, and a utility method to convert a Map into a query string.

```java
  255.                     conn.setRequestProperty(entry.getKey(), entry.getValue());
  256.   257.   258.             //设置是否向httpUrlConnection输出，设置是否从httpUrlConnection读入，此外发送post请求必须设置这两个
  259.             //最常用的Http请求无非是get和post，get请求可以获取静态页面，也可以把参数放在URL字串后面，传递给servlet，
  260.             //post与get的 不同之处在于post的参数不是放在URL字串里面，而是放在http请求的正文内。
  261.             conn.setDoOutput(true);
  262.             conn.setDoInput(true);
  263.             OutputStreamWriter out = new OutputStreamWriter(conn.getOutputStream(), "utf-8");
  264.   265.             if (params != null)
  266.                 out.write(mapToStr(params));
  267.             //缓冲数据
  268.             out.flush();
  269.   270.             out.close();
  271.   272.             //获取URLConnection对象对应的输入流
  273.             InputStream is = conn.getInputStream();
  274.             //构造一个字符流缓存
  275.             BufferedReader br = new BufferedReader(new InputStreamReader(is,"utf-8"));
  276.   277.             String result = "";
  278.             while ((str = br.readLine()) != null) {
  279.                 result = str;
  280.             }
  281.             //关闭流
  282.             is.close();
  283.             //断开连接，最好写上，disconnect是在底层tcp socket链接空闲时才切断。如果正在被其他线程使用就不切断。
  284.             //固定多线程的话，如果不disconnect，链接会增多，直到收发不出信息。写上disconnect后正常一些。
  285.             conn.disconnect();
  286.             return result;
  287.         } catch (Exception e) {
  288.             e.printStackTrace();
  289.         }
  290.         return null;
  291.     }
  292.   293.     /**
  294.      * 将Map转换成字符串参数，用于POST GET 请求
  295.      *
  296.      * @param map
  297.      * @return
  298.      */
  299.     public static String mapToStr(Map<String, String> map) {
  300.         StringBuilder stringBuilder = new StringBuilder();
  301.         if (map != null) {
  302.             for (Map.Entry<String, String> entry : map.entrySet()) {
  303.                 stringBuilder.append(entry.getKey());
  304.                 if (entry.getValue() != null)
  305.                     stringBuilder.append("=").append(entry.getValue());
  306.                 stringBuilder.append("&");
  307.             }
  308.         }
  309.         if (stringBuilder.length() > 0)
  310.             return stringBuilder.substring(0, stringBuilder.length() - 1);
  311.         return null;
  312.     }
  313. }
```

--------------------------------

### Initialize AbstractWeaTablePopedom

Source: https://e-cloudstore.com/doc.html?appId=7fdedcadd98b456394ac1979d6cb01e0

Constructors for setting up permission control logic for operation menus.

```java
  1.     public AbstractWeaTablePopedom() {
  2.     }
  3.   4.     public AbstractWeaTablePopedom(String transmethod, String otherpara, String column) {
  5.         this.transmethod = transmethod;
  6.         this.otherpara = otherpara;
  7.         this.column = column;
  8.     }
```

--------------------------------

### Get Signature Opinion

Source: https://e-cloudstore.com/doc.html?appId=98cb7a20fae34aa3a7e3a3381dd8764e

Retrieves the current content of the signature opinion field.

```javascript
WfForm.getSignRemark();  //获取签字意见内容
```

--------------------------------

### GET /api/portal/dev/element/docsearch/getsecid

Source: https://e-cloudstore.com/doc.html

Retrieves the document directory settings for a specific portal element.

```APIDOC
## GET /api/portal/dev/element/docsearch/getsecid

### Description
Retrieves the configured document directory data for a given portal element ID.

### Method
GET

### Endpoint
/api/portal/dev/element/docsearch/getsecid

### Parameters
#### Query Parameters
- **eid** (string) - Required - The element ID associated with the settings.
```

--------------------------------

### 移动端跳转打开表单

Source: https://e-cloudstore.com/doc.html?appId=98cb7a20fae34aa3a7e3a3381dd8764e

通过window.open跳转，需对returnUrl进行转码。

```javascript
window.open(viewUrl+"&returnUrl="+window.encodeURIComponent("/test.jsp?param1=test11&param2=test22"));
```

--------------------------------

### Get Department List Request

Source: https://e-cloudstore.com/doc.html?appId=c373a4b01fb74d098b62e2b969081d2d

Request payload for retrieving department information.

```json
    1. {
    2.     "params":
    3.     {
    4.         "departmentname":"部门", 
    5.         "departmentcode":"code1", 
    6.         "pagesize":20, 
    7.         "curpage":1 
    8.     }
    9. }
```

--------------------------------

### Department Information Response Structure

Source: https://e-cloudstore.com/doc.html?appId=c373a4b01fb74d098b62e2b969081d2d

Example JSON response for a department information query.

```json
{
  "code": "1", // 1 成功 ，其他为失败； 
  "data": {
    "totalSize": 1, // 分页-总数
    "dataList": [ // 数据集合
      {
        "canceled": "", // 封存标志，1 封存，其他为未封存
        "supdepid": "0", // 上级部门id
        "departmentmark": "yhm-主分部A-下级部门一", // 简称
        "departmentname": "yhm-主分部A-下级部门一", // 全称
        "created": "2019-08-28 10:44:12", // 创建时间戳
        "departmentcode": "", // 编码
        "modified": "2020-09-07 19:40:09", // 修改时间戳
        "id": "2", // 部门id
        "subcompanyid1": "5", // 分部id
        "custom_data": { // 自定义数据
          "xlk": "使用" // 
        },
        "showorder": "0.0" // 自定义数据，具体参考 【组织权限中心-自定义设置-部门字段定义】
      }
    ],
    "pageSize": 20, // 分页-单页条目数
    "page": 1 // 分页-当前页数
  } 
}
```

--------------------------------

### 初始化AbstractWeaTable

Source: https://e-cloudstore.com/doc.html?appId=7fdedcadd98b456394ac1979d6cb01e0

在init方法中设置默认的table属性，包括类型、排序、列集合、操作菜单以及唯一标识符。

```java
    1. public void init(){
    2.     3.         this.tableType = WeaTableTypeEnum.NONE; //tabletype为none，即默认Default
    4.     5.         this.openPrimaryKeyOrder = WeaBooleanEnum.FALSE; //默认不开启主键排序
    6.     7.         //this.mobileshowtype = WeaMobileShowTypeEnum.ListView;
    8.     9.         this.columns = new ArrayList(); //初始化字段集合
    10.     11.         this.operates = new DefaultWeaTableOperates(); //初始化操作菜单集合类
    12.     13.         this.checkboxpopedom = new DefaultWeaCheckboxPopedom(); //初始化多选框类
    14.     15.         this.checkboxList = new ArrayList(); //初始化多选框列表
    16.     17.         this.pageID = 'xxxxxx'; //pageId和pageUid使用一个写死的新生成的uuid，确保每个开发的table，这个id都要保持唯一
    18.     19.         this.pageUID = pageID;
    20.     21.     }
```

--------------------------------

### PC端打开表单

Source: https://e-cloudstore.com/doc.html?appId=98cb7a20fae34aa3a7e3a3381dd8764e

使用window.open方法在PC端打开新建或查看请求的页面。

```javascript
window.open("/workflow/request/CreateRequestForward.jsp?workflowid=747");
```

```javascript
window.open("/workflow/request/ViewRequestForwardSPA.jsp?requestid=5963690");
```

--------------------------------

### Get module ID

Source: https://e-cloudstore.com/doc.html?appId=e783a1d75a784d9b97fbd40fdf569f7d

Retrieves the module ID associated with the current query list.

```javascript

  1. var modeId = ModeList.getModeID();
  2.   3.  返回值说明d
  4. // 获取查询列表对应模块ID
  5.   6. // 例如：`66`


```

--------------------------------

### Get form ID

Source: https://e-cloudstore.com/doc.html?appId=e783a1d75a784d9b97fbd40fdf569f7d

Retrieves the form ID associated with the current query list.

```javascript

  1. var formId = ModeList.getFormID();
  2.   3.  返回值说明
  4.   5. //获取查询列表对应表单ID
  6.   7. // 例如：`-163`


```

--------------------------------

### Get custom list ID

Source: https://e-cloudstore.com/doc.html?appId=e783a1d75a784d9b97fbd40fdf569f7d

Retrieves the unique identifier for the current query list.

```javascript

  1. var customId = ModeList.getCustomID();
  2.   3. 返回值说明
  4.   5. // 获取查询列表Id
  6.   7. //例如：`163`


```

--------------------------------

### GET /api/workflow/index/updateWfConfig

Source: https://e-cloudstore.com/doc.html?appId=98cb7a20fae34aa3a7e3a3381dd8764e

Updates a specific workflow configuration setting. Requires sysadmin login.

```APIDOC
## GET /api/workflow/index/updateWfConfig

### Description
Updates a workflow configuration parameter. This endpoint is used for system-wide settings like default fonts, cache toggles, and UI behavior.

### Method
GET

### Endpoint
/api/workflow/index/updateWfConfig

### Parameters
#### Query Parameters
- **name** (String) - Required - The configuration key to update (e.g., signinput_default_fontfamily, signinput_default_fontsize, un_use_customize_browser_cache, show_duration_log, detail_locked_button_row, colRule_noRow_empty, handwrittensign_switch, mobile_show_radio)
- **value** (String) - Required - The value to set for the configuration key.

### Response
#### Success Response (200)
- **status** (String) - Indicates successful update of the configuration.
```

--------------------------------

### config_default.js文件说明

Source: https://e-cloudstore.com/doc.html?appId=e6f85c66d5514aa2aa9242a0cea303d7

描述config_default.js文件的加载特性。

```text
    1.   非前置加载
    2.   发布后默认不生效
```

--------------------------------

### Data Synchronization JSON Format

Source: https://e-cloudstore.com/doc.html?appId=c373a4b01fb74d098b62e2b969081d2d

Example of the JSON structure required for data synchronization operations.

```json
  1. {
  2.   "rule": {
  3.     "resource": "workcode"
  4.   },
  5.   "data": [
  6.     {
  7.       "@action": "add",
  8.       "code": "test",
  9.       "shortname": "测试-分部简称",
  10.       "fullname": "测试-分部全称",
  11.       "parent_code": "",
  12.       "canceled": "0",
  13.       "order": "3",
  14.       "custom_data": {
  15.         "fzr": "fw0001,fw0003"
  16.       }
  17.     }
  18.   ]
  19. }
```

--------------------------------

### 配置JAR包输出目录

Source: https://e-cloudstore.com/doc.html?appId=c6a9ae6e47b74d4da04c935ed51d177a&maxImgWidth=800

编译时将JAR包输出至Ecology的web-inf/lib目录。

```text
    1. ecology/web-inf/lib
```

--------------------------------

### Get unselected checkbox IDs

Source: https://e-cloudstore.com/doc.html?appId=e783a1d75a784d9b97fbd40fdf569f7d

Retrieves the main table data IDs of unselected checkboxes.

```javascript

  1. var ids = ModeList.getUnCheckedID();
  2.   3. 返回值说明
  4.   5. // 多个数据ID以英文半角逗号分开; 例如：`1,2,3,4 `


```

--------------------------------

### Get Sub-company List Request

Source: https://e-cloudstore.com/doc.html?appId=c373a4b01fb74d098b62e2b969081d2d

Request payload for retrieving sub-company information using application/json.

```json
  1. {
  2.     "params":{
  3.         "subcompanyname":"分部", 
  4.         "subcompanycode":"code1", 
  5.         "modified":"2020-11-08 00:00:00", 
  6.         "created":"2020-11-08 00:00:00", 
  7.         "canceled":"", 
  8.         "custom_data":"field1,field2", 
  9.         "id":"10", 
  10.         "pagesize":20, 
  11.         "curpage":1 
  12.     }
  13. }
```

--------------------------------

### config.js文件说明

Source: https://e-cloudstore.com/doc.html?appId=e6f85c66d5514aa2aa9242a0cea303d7

描述config.js文件的加载特性。

```text
    1.   前置加载
    2.   发布后默认生效
```

--------------------------------

### User Data Response Structure

Source: https://e-cloudstore.com/doc.html?appId=c373a4b01fb74d098b62e2b969081d2d

Example of the JSON response structure returned when querying user information.

```json
{
    "code":"1", // 1 成功，其他失败
    "data":{
        "totalSize":1, // 分页-总数
        "dataList":[ // 数据列表
            {
                "tempresidentnumber":"xxxx", // 暂住证号码
                "person_custom_data":{ // 个人自定义数据 
                    "field6":"2020-09-10"
                },
                "createdate":"2019-08-28", // 创建日期
                "language":"", // 系统语言
                "subcompanyid1":"5", // 分部id
                "subcompanyname":"yhm-主分部A", // 分部名称
                "joblevel":"0", // 职级
                "startdate":"", // 合同开始日期
                "password":"lK1l5Yaeg5csNkZvr/uaYnioLAv02khMFnUS9/pv8Tg=", // 密码 密文
                "subcompanycode":"", // 分部编码
                "jobactivitydesc":"xxxx", // 职责描述
                "bememberdate":"2010-08-08", // 入团日期
                "modified":"2020-09-09 19:46:40", // 修改时间
                "id":"3", // 人员id
                "mobilecall":"123456", // 其他电话
                "nativeplace":"湖北", // 籍贯
                "certificatenum":"1", // 身份证
                "height":"0", // 身高
                "loginid":"yhm01", // 登录名
                "created":"2019-08-28 10:44:12", // 创建日期(旧字段) 
                "degree":"xxx", // 学位
                "bepartydate":"2010-08-10", // 入党日期
                "weight":"110", // 体重
                "telephone":"123", // 办公电话
                "residentplace":"xxxx", // 户口
                "lastname":"yhm01tt", // 人员名称
                "healthinfo":"1", // 健康状况
                "enddate":"", // 合同结束日期
                "maritalstatus":"已婚", // 婚姻状况
                "departmentname":"yhm-主分部A-下级部门一", // 部门名称
                "folk":"汉", // 民族
                "status":"1", // 状态: 0 试用 1 正式 2 临时 3 试用延期 4 解聘 5 离职 6 退休 7 无效 
                "birthday":"2010-10-10", // 生日
                "accounttype":"0", // 主次账号标志：   1 次账号 , 其他 主账号
                "jobcall":"2", // 职称 
                "managerid":"0", // 上级人员id
                "assistantid":"0", // 助理人员id
                "departmentcode":"", // 部门编码
                "belongto":"", // 主账号id （当accounttype 为 1 有效）
                "email":"123123123@123.com", // 邮箱
                "seclevel":"10", // 安全级别
                "policy":"团员", // 政治面貌
                "jobtitle":"2", // 岗位id
                "workcode":"yhm01tt", // 编号
                "sex":"男",  // 性别
                "departmentid":"2", // 部门id
                "homeaddress":"xxxx", // 家庭联系方式
                "mobile":"123123123", // 移动电话
                "lastmoddate":"2020-09-09", // 最后修改日期
                "educationlevel":"3", // 学历
                "islabouunion":"0", // 工会会员
                "base_custom_data":{ // 基本信息自定义数据
                    "field1":"test_yhm01",
                    "field3":"liul部门1,liul部门2",
                    "field2":"测试人员1"
                },
                "locationid":"2", // 办公地点
                "regresidentplace":"武汉", // 户口
                "dsporder":"3.0" // 排序
            }
        ],
        "pageSize":20, // 分页-单页条目数
        "page":1 // 分页-当前页数
    }
}
```

--------------------------------

### Token Timeout Error Response Example

Source: https://e-cloudstore.com/doc.html?appId=af09c25938714c26b9736f535ca20fc9

JSON response returned when the provided token is invalid or has expired.

```json
  1. {
  2.     "msg": "token:不存在或者超时a25ed7ba-6027-424d-96ec-99daef56a51d",
  3.     "code": -1,
  4.     "msgShowType": "none",
  5.     "status": false
  6. }
```

--------------------------------

### 定义系统启动执行类

Source: https://e-cloudstore.com/doc.html?appId=3c55f3f5ef204af1a10a9abac1e950c5

在com.**.impl包下创建类并使用@WeaSysInitComponent注解，通过@WeaSysInit注解标记需要执行的方法。

```java
  1. package com.cloudstore.dev.service.impl;
  2. import com.weaverboot.frame.ioc.anno.classAnno.WeaSysInitComponent;
  3. import com.weaverboot.frame.ioc.anno.methodAnno.WeaSysInit;
  4.   5. @WeaSysInitComponent("启动类")
  6. public class InitServcieImpl {
  7.   8.     @WeaSysInit(order = 1 ,description = "执行方法1")
  9.     public void init(){
  10.         System.out.println("执行启动类方法1");
  11.     }
  12.   13.   14.     @WeaSysInit(order = 2 ,description = "执行方法2")
  15.     public void init2(){
  16.         System.out.println("执行启动类方法2");
  17.     }
  18. }
```

--------------------------------

### Successful API Response Example

Source: https://e-cloudstore.com/doc.html?appId=af09c25938714c26b9736f535ca20fc9

Standard JSON response structure returned when an API call is successful.

```json
  1. {
  2.     "msg": "ok",
  3.     "code": 0,
  4.     "msgShowType": "none",
  5.     "status": true
  6. }
```
Tokens:
Raw