反馈已提交

网络繁忙

当前为10.0版本文档,只有最新版本的文档支持在线编辑修改,如果想创建/编辑文档,请移步至 最新版帮助文档

微信钉钉调试工具

  • 文档创建者:jiangsr
  • 历史版本:11
  • 最近更新:April陶 于 2023-08-04
  • 1. 概述

    1.1 版本

    报表服务器版本
    10.0

    注:微信管理插件与 JAR 包版本需要对应,具体请参考 微信、钉钉、H5、服务器、JAR 之间的依赖关系

    1.2 应用场景

    解决微信集成过程中遇到的各种问题,大大提高工作效率。如:网络不通没法访问微信服务、同步不到通讯录、推送收不到消息等等。

    1.3 功能简介

    提供微信/钉钉调试工具,开启调试模式,能够显示日志调试内容。

    2. 调试界面说明

    微信调试页面

    在平台地址后加上/url/weixin/start/debugger 进入微信调试页面。

    钉钉调试页面

    在平台地址后加上/url/dingtalk/start/debugger进入钉钉调试页面。

    3. 微信调试

    3.1 进入调试界面

    1)进入微信调试界面:http://secure.finedevelop.com:63778/webroot/decision/url/weixin/start/debugger,页面显示如下图所示:

    1619589777432679.jpg

    可调试的内容为:基本属性、单点登录、推送消息、检测请求耗时。如下图所示:

    1619589850314162.jpg

    注:请填写合乎规范的信息,每项参数不可为空。

    注:支持测试不在应用列表中的 corpid&secret 组,进行基本属性调试,可以正确输出 Token 、部门、服务器地址,可信域名提示「微信应用暂未添加,可信域名为空」。

    3.2 基本属性

    3.2.1 操作步骤

    使用「微信管理」添加微信应用时用到的参数来测试,点击开始检测,正常配置下现象如下图所示:

    image2021-4-23_10-49-6.png

    3.2.2 检测作用

    检测点:查看用户信息获取情况。

    作用:确认参数,网络,对应微信应用配置是否正确。

    3.2.3 检测异常

    异常现象 1 :若token没有获取到,会给出对应报错提示

    可能的原因 1 :网络异常,用户环境可能无法访问微信服务器。解决方案:需要排查网络情况;

    可能的原因 2 :使用的微信参数不正确,包括但不限于:① id 和 secret 不匹配;② 对应的 secret 被重置导致原来的 secret 不能用;③ 对应 secret 应用被删/被停用了。

    异常现象 2 :若获取的部门用户列表是空

    可能是原因 1 :是对应应用没有设置可见范围;

    可能是原因 2 :可见范围设置的是单个用户(正常应该选择部门或者标签),但我们目前不支持可见范围只选择用户来获取用户信息。

    3.3 单点登录

    3.3.1 操作步骤

    切换调试内容为单点登录,多出微信用户主页/菜单链接两个参数,输入相应的信息,点击开始检测,显示出检测结果信息: Token、报表用户信息。正常情况下调试页面如下图所示:

    image2021-4-23_16-26-39.png

    3.3.2 检测作用

    查看用户的匹配是否正确,用户单点链接是否正确。

    3.3.3 检测异常

    若调试结果不对,则需要检查参数填写是否有问题,匹配是否没有配置好,或者url生成的不对,可信域名配置不正确等,具体参照企业微信集成配置的文档。

    3.4 推送消息

    3.4.1 操作步骤

    切换调试内容为推送消息,多出推送用户参数,点击开始检测,输入相应的信息,正常情况下调试页面如下:

    image2021-4-23_16-31-38.png

    每每检测一次,都会由该微信应用发送一条测试消息至微信,如下图所示:

    222

    3.4.2 检测异常

    若收不到测试消息,可能是微信应用那边的问题,比如手机没有开启消息接收,微信后台有请求拦截等。

    3.5 检测请求耗时

    3.5.1 操作步骤

    调试内容选择「检测请求耗时」并点击「开始检测」。如下图所示:

    企业微信截图_16191660893947.png

    3.5.2 检测作用

    有些访问比较慢的客户场景,可以用检测工具查看一下再客户环境上的请求耗时,用来判断是否是网络影响了实际使用。

    4. 钉钉调试

    4.1 进入调试界面

    1)进入钉钉调试界面:http://secure.finedevelop.com:63778/webroot/decision/url/dingtalk/start/debugger,页面显示如下图所示:

    2021-04-28_14-57-09.jpg


    可调试的内容为:获取access_token、检查ip白名单、检测请求耗时。如下图所示:

    2021-04-28_15-02-27.jpg


    注:请填写合乎规范的信息,每项参数不可为空。

    注:使用钉钉管理添加钉钉应用时用到的参数来测试,详情参见文档:钉钉管理插件

    4.2 获取access_token

    4.2.1 操作步骤

    使用钉钉管理添加钉钉应用时用到的参数来测试,正常配置下现象如下图所示:

    4.2.2 检查作用

    确认网络是否正常。

    4.2.3 检查异常

    若 token 没有获取到,大概率是网络异常,用户环境可能无法访问钉钉服务器,需要排查网络情况。

    4.3 检查ip白名单

    4.3.1 操作步骤

    使用钉钉参数检查钉钉的 IP 白名单,若当前测试服务器的出口 IP 已经加在了钉钉应用的配置信息里,则显示如下图所示:


    4.3.2 检查作用

    作用:检查 ip 是否在白名单中

    相关场景:钉钉应用添加的时候会校验白名单 IP ,若钉钉管理后台没有配置这个 IP ,则应用添加不成功,但是应该填写具体什么IP,往往这个出口 IP 不知道怎么获取。

    使用这个功能可以在用户添加钉钉应用之前先检查一下白名单配置,若 IP 不在白名单内,则检测结果中会把对应的 IP 打印出来,这样直接把这个 IP 复制到钉钉后台应用那边即可正常添加。

    4.4 检测请求耗时

    与微信操作步骤相同。详情参见本文 3.5 节。

    附件列表


    主题: 移动端应用
    • 有帮助
    • 没帮助
    • 只是浏览

    售前咨询电话

    400-811-8890转1

    在线技术支持

    请前往「服务平台」,选择「在线支持」

    热线电话:400-811-8890转2

    总裁办24H投诉

    热线电话:173-1278-1526