快捷導航

詳解Java如何實現(xiàn)企業(yè)微信審批流程

更新時間：2024年11月01日 11:44:05 作者：威哥愛編程

這篇文章主要使用了一個Java示例代碼,來向大家展示如何在企業(yè)微信中實現(xiàn)審批流程,文中的示例代碼簡潔易懂,有需要的小伙伴可以參考下

最近的一個項目中，用到企業(yè)微信的審批流程，整理出來分享給大家。在企業(yè)微信中實現(xiàn)審批流程可以通過調(diào)用企業(yè)微信的開放API完成，企業(yè)微信提供了審批應(yīng)用接口，用于創(chuàng)建審批模板、發(fā)起審批流程以及獲取審批實例詳情。下面 V 哥用一個Java示例代碼，來展示如何在企業(yè)微信中實現(xiàn)審批流程。

實現(xiàn)步驟

獲取企業(yè)微信Access Token：每次訪問企業(yè)微信API接口前需要先獲取Access Token。
創(chuàng)建審批模板（如已有模板則跳過此步驟）。
發(fā)起審批流程：通過指定的模板ID發(fā)起審批請求。
查詢審批結(jié)果：獲取審批的狀態(tài)和詳細信息。

以下代碼使用HttpClient發(fā)起HTTP請求來調(diào)用企業(yè)微信API接口。

代碼示例

import org.apache.http.client.methods.CloseableHttpResponse;
import org.apache.http.client.methods.HttpPost;
import org.apache.http.client.methods.HttpGet;
import org.apache.http.entity.StringEntity;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClients;
import org.apache.http.util.EntityUtils;
import com.fasterxml.jackson.databind.ObjectMapper;
import java.io.IOException;
import java.util.HashMap;
import java.util.Map;

public class WeChatApproval {
    //下面三個常量定義，需要用你自己的（企業(yè)微信開放平臺）
    private static final String CORP_ID = "你的corp_id";
    private static final String CORP_SECRET = "你的corp_secret";
    private static final String APPROVAL_TEMPLATE_ID = "你的template_id"; // 審批模板ID

    // 獲取 Access Token
    public static String getAccessToken() throws IOException {
        String url = "https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=" + CORP_ID + "&corpsecret=" + CORP_SECRET;
        try (CloseableHttpClient client = HttpClients.createDefault()) {
            HttpGet request = new HttpGet(url);
            try (CloseableHttpResponse response = client.execute(request)) {
                String responseBody = EntityUtils.toString(response.getEntity());
                Map<String, Object> map = new ObjectMapper().readValue(responseBody, Map.class);
                return map.get("access_token").toString();
            }
        }
    }

    // 發(fā)起審批流程
    public static String initiateApproval(String accessToken, Map<String, Object> approvalData) throws IOException {
        String url = "https://qyapi.weixin.qq.com/cgi-bin/oa/applyevent?access_token=" + accessToken;
        try (CloseableHttpClient client = HttpClients.createDefault()) {
            HttpPost post = new HttpPost(url);
            post.setHeader("Content-Type", "application/json");

            Map<String, Object> requestMap = new HashMap<>();
            requestMap.put("template_id", APPROVAL_TEMPLATE_ID);
            requestMap.put("use_template_approver", 1); // 使用模板中的審批人
            requestMap.put("approver", approvalData.get("approver"));
            requestMap.put("apply_data", approvalData.get("apply_data"));
            requestMap.put("summary_list", approvalData.get("summary_list"));

            String json = new ObjectMapper().writeValueAsString(requestMap);
            post.setEntity(new StringEntity(json, "UTF-8"));

            try (CloseableHttpResponse response = client.execute(post)) {
                String responseBody = EntityUtils.toString(response.getEntity());
                Map<String, Object> map = new ObjectMapper().readValue(responseBody, Map.class);
                return map.get("sp_no").toString(); // 返回審批單編號
            }
        }
    }

    // 查詢審批流程狀態(tài)
    public static Map<String, Object> getApprovalDetail(String accessToken, String spNo) throws IOException {
        String url = "https://qyapi.weixin.qq.com/cgi-bin/oa/getapprovaldetail?access_token=" + accessToken;
        try (CloseableHttpClient client = HttpClients.createDefault()) {
            HttpPost post = new HttpPost(url);
            post.setHeader("Content-Type", "application/json");

            Map<String, Object> requestMap = new HashMap<>();
            requestMap.put("sp_no", spNo);

            String json = new ObjectMapper().writeValueAsString(requestMap);
            post.setEntity(new StringEntity(json, "UTF-8"));

            try (CloseableHttpResponse response = client.execute(post)) {
                String responseBody = EntityUtils.toString(response.getEntity());
                return new ObjectMapper().readValue(responseBody, Map.class);
            }
        }
    }

    public static void main(String[] args) {
        try {
            // 1. 獲取Access Token
            String accessToken = getAccessToken();
            System.out.println("Access Token: " + accessToken);

            // 2. 發(fā)起審批流程
            Map<String, Object> approvalData = new HashMap<>();
            approvalData.put("approver", new Object[] { 
                Map.of("attr", 1, "userid", new String[] { "approver_userid" }) 
            });
            approvalData.put("apply_data", Map.of(
                "contents", new Object[] {
                    Map.of("control", "Text", "id", "Text-1", "value", Map.of("text", "請假事由")),
                    Map.of("control", "Date", "id", "Date-1", "value", Map.of("date", "2024-11-01"))
                }
            ));
            approvalData.put("summary_list", new Object[] {
                Map.of("summary_info", Map.of("text", "請假申請"))
            });
            String spNo = initiateApproval(accessToken, approvalData);
            System.out.println("審批單號: " + spNo);

            // 3. 查詢審批狀態(tài)
            Map<String, Object> approvalDetail = getApprovalDetail(accessToken, spNo);
            System.out.println("審批詳情: " + approvalDetail);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

代碼說明

獲取Access Token：通過getAccessToken方法獲取企業(yè)微信的access_token，用于后續(xù)接口調(diào)用。
發(fā)起審批流程：initiateApproval方法通過oa/applyevent接口發(fā)起審批流程，傳入審批模板ID和審批表單數(shù)據(jù)（如審批人、申請數(shù)據(jù)和摘要等）。
查詢審批流程狀態(tài)：getApprovalDetail方法通過oa/getapprovaldetail接口查詢審批詳情，包括審批狀態(tài)和各環(huán)節(jié)的處理結(jié)果。