企微-接入配置

设置企业微信参数

5大参数说明

• corpId 企业id 企业唯一id
• corpSecret 应用的密钥
• agentId 应用的唯一id
• tokenId 用于生成签名,校验回调强求的合法性. (事件回调服务需要用到 官方说明: https://developer.work.weixin.qq.com/document/path/90930)
• aesKey 回调消息加密参数,是AES密钥的Base64编码,用于解密回调消息内容对应的密码. (事件回调服务需要用到 官方说明: https://developer.work.weixin.qq.com/document/path/90930)

参数获取

• corpId 获取
  
  

• corpSecret 获取
  
  
  

• agentId 获取
  
  

• tokenId/aesKey
  
  

企业微信工具简单使用

1. 选择绑定的机构
2. 填写agentId

3. 编写事件代码

   • 获取access_Token

     btn.getPage().components.WeComTools1.getAccessToken(function (accessToken, err) {
       if (Common.isEmpty(err)) {
           console.info(accessToken);
       } else {
           console.info(err);
       }
     })  

   • 获取人员信息

     function Button1_onClickScript(cxt: ScriptContext, btn: Button) {
       btn.getPage().components.WeComTools1.getDeparts(null, function (data, err) {
           if (Common.isEmpty(err)) {
              console.info(JSON.stringify(data));
           } else {
               console.info(err);
           }
       })
     }

   • 获取部门信息

     btn.getPage().components.WeComTools1.getUserByDeptId(1,true,0, function (data, err) {
       if (Common.isEmpty(err)) {
           console.info(JSON.stringify(data));
       } else {
           console.info(err);
       }
     })

   • 获取打卡信息

     function Button2_onClickScript(cxt: ScriptContext, btn: Button) {
       var checkinType= btn.getPage().components.cmbCheckinType.getValue();
       var start= btn.getPage().components.dtpStart.getValue();
       var end= btn.getPage().components.dtpEnd.getValue();
       var userlist= btn.getPage().components.cmbCheckinUsers.getValues();
       btn.getPage().components.WeComTools1.getCheckinData(checkinType, start, end, userlist,
           function (data, err) {
               if (Common.isEmpty(err)) {
                    console.info(JSON.stringify(data));
               } else {
                    console.info(err);
               }
           })
     }

   • 发送消息给指定的用户

     function Button1_onClickScript(cxt: ScriptContext, btn: Button) {
     
       let userids=['userid'];
       let content='只是一条测试消息';
       btn.getPage().components.WeComTools2.sendMessageToUser(userids,content,        
           function (result, err) {
               if (Common.isEmpty(err)) {
                   console.info(JSON.stringify(result));
               } else {
                   console.info(err);
               }
           })
     }

企业微信工具封装的ajax函数获取数据

1. 通过企业微信官方文档 查询到想要获取的数据api后,前端组件的ajax函数拼装api所需的参数发起请求.得到所需的数据做业务处理

2. 代码实例:

   通过查询API文档地址: https://developer.work.weixin.qq.com/document/path/90262 得知api地址如下图:
   

    WeComTools1.ajax('https://qyapi.weixin.qq.com/cgi-bin/checkin/getcheckindata', 'POST', {
        opencheckindatatype: 3,
        starttime: '1648779622',
        endtime: '1651285222',
        useridlist: ['FengPingXinJing']
    }, true, function (res, err) {
        if (Common.isEmpty(err)) {
            //返回的结果参考官方的api地址
            console.info(JSON.stringify(res));
        } else {
            console.info(err);
        }
    })

   注意事项

• 打卡的数据只能是<<打卡应用>>agentId才能获取.否则会出现{“errcode”:48002….}权限不足的错误,因此在平台设置里面必须有<<打卡应用>>的agentId
• 请假单的数据只能是<<审批应用>>agentId才能获取.否则会出现{“errcode”:48002….}权限不足的错误 ,因此在平台设置里面必须有<<审批应用>>的agentId
• 一个机构可以设置多个应用agentId的参数;一个WeComTools组件只能对应一个agentId设置的参数

参考

• 企业微信官方文档