WeChat Enterprise Workflow Approval Guide

企业微信流程审批功能使用指南

Overview / 概述

WxJava SDK provides comprehensive support for WeChat Enterprise workflow approval (企业微信流程审批), including both traditional OA approval and the approval process engine.

WxJava SDK 提供全面的企业微信流程审批支持，包括传统OA审批和审批流程引擎。

Current Implementation Status / 当前实现状态

✅ Fully Implemented APIs / 已完整实现的API

Submit Approval Application / 提交审批申请
- Endpoint: /cgi-bin/oa/applyevent
- Documentation: 91853
- Implementation: WxCpOaService.apply(WxCpOaApplyEventRequest)
Get Approval Details / 获取审批申请详情
- Endpoint: /cgi-bin/oa/getapprovaldetail
- Implementation: WxCpOaService.getApprovalDetail(String spNo)
Batch Get Approval Numbers / 批量获取审批单号
- Endpoint: /cgi-bin/oa/getapprovalinfo
- Implementation: WxCpOaService.getApprovalInfo(...)
Approval Process Engine / 审批流程引擎
- Endpoint: /cgi-bin/corp/getopenapprovaldata
- Implementation: WxCpOaAgentService.getOpenApprovalData(String thirdNo)
Template Management / 模板管理
- Create: WxCpOaService.createOaApprovalTemplate(...)
- Update: WxCpOaService.updateOaApprovalTemplate(...)
- Get Details: WxCpOaService.getTemplateDetail(...)

Usage Examples / 使用示例

1. Submit Approval Application / 提交审批申请

// Create approval request
WxCpOaApplyEventRequest request = new WxCpOaApplyEventRequest()
    .setCreatorUserId("userId")
    .setTemplateId("templateId")
    .setUseTemplateApprover(0)
    .setApprovers(Arrays.asList(
        new WxCpOaApplyEventRequest.Approver()
            .setAttr(2)
            .setUserIds(new String[]{"approver1", "approver2"})
    ))
    .setNotifiers(new String[]{"notifier1", "notifier2"})
    .setNotifyType(1)
    .setApplyData(new WxCpOaApplyEventRequest.ApplyData()
        .setContents(Arrays.asList(
            new ApplyDataContent()
                .setControl("Text")
                .setId("Text-1234567890")
                .setValue(new ContentValue().setText("Approval content"))
        ))
    );

// Submit approval
String spNo = wxCpService.getOaService().apply(request);

2. Get Approval Details / 获取审批详情

// Get approval details by approval number
WxCpApprovalDetailResult result = wxCpService.getOaService()
    .getApprovalDetail("approval_number");

WxCpApprovalDetailResult.WxCpApprovalDetail detail = result.getInfo();
System.out.println("Approval Status: " + detail.getSpStatus());
System.out.println("Approval Name: " + detail.getSpName());

3. Batch Get Approval Information / 批量获取审批信息

// Get approval info with filters
Date startTime = new Date(System.currentTimeMillis() - 7 * 24 * 60 * 60 * 1000);
Date endTime = new Date();

WxCpApprovalInfo approvalInfo = wxCpService.getOaService()
    .getApprovalInfo(startTime, endTime, "0", 100, null);

List<String> spNumbers = approvalInfo.getSpNoList();

4. Third-Party Application Support / 第三方应用支持

// For third-party applications
WxCpTpOAService tpOaService = wxCpTpService.getOaService();

// Submit approval for specific corp
String spNo = tpOaService.apply(request, "corpId");

// Get approval details for specific corp
WxCpApprovalDetailResult detail = tpOaService.getApprovalDetail("spNo", "corpId");

Multi-Account Configuration / 多账号配置支持

WxJava supports multi-account configurations for enterprise scenarios:

// Spring Boot configuration example
@Autowired
private WxCpMultiServices wxCpMultiServices;

// Get service for specific corp
WxCpService wxCpService = wxCpMultiServices.getWxCpService("corpId");
WxCpOaService oaService = wxCpService.getOaService();

Available Data Models / 可用数据模型

WxCpOaApplyEventRequest - Approval application request
WxCpApprovalDetailResult - Approval details response
WxCpApprovalInfo - Batch approval information
WxCpXmlApprovalInfo - XML approval message handling
WxCpOaApprovalTemplate - Approval template management

Documentation References / 文档参考

Conclusion / 结论

WxJava already provides comprehensive support for WeChat Enterprise workflow approval. The "new version" (新版) approval functionality referenced in issue requests is already fully implemented and available for use.

WxJava 已经提供了企业微信流程审批的全面支持。问题中提到的"新版"流程审批功能已经完全实现并可使用。

For questions about specific usage, please refer to the test cases in WxCpOaServiceImplTest and the comprehensive API documentation.

有关具体使用问题，请参考 WxCpOaServiceImplTest 中的测试用例和全面的API文档。

5.2 KiB Raw Blame History Unescape Escape