自建插件FAQ

1. 插件代码如何在本地进行调试开发?

由于插件代码本身只是方法体， 所以需要在外层进行代码包裹后， 再进行调用调试。

本地调试通过后，可将插件部分代码拷贝到简道云里面，点击插件调试进行实际运行环境下的调试。

2. 插件适用的场景?

插件通过定义输入输出的格式，实现一些定制化的业务需求。

但是并不适合常驻类型的操作，目前插件本身的超时时间为 60 s，但是不同使用场景本身也有自己的超时时间，比如前端事件的 20 s。

3. 如何处理各集成平台的Access Token?

简道云目前已实现了刷新 Token 的逻辑，使企业微信、钉钉、飞书的自建应用以及微信公众号能够在 Token 即将过期时自动获取新的有效 Token，并且由简道云进行保存。

对于固定的 Token，可以让用户在安装插件时进行设置，这一类是能够完美支持的。

4. 目前插件支持base64库吗？

base64 为 python 内置库，可直接调用。

5. 为什么返回的图片地址无法访问？

简道云目前的链接是有有效期限的，如果返回后过了有效期再处理，则会显示错误。

6. 关于时间，同样的代码在本地和在插件中获取的时间怎么不一致？

插件所在服务器为 UTC 时区，本地代码依据开发者本地服务器所在时区而定。由于服务器所在时区差异，可能会出现同样的代码在本地和插件中执行所得到的实际时间不同。

7. 为什么返回的图片不能直接回写到图片字段中？

目前插件在前端事件触发场景中，暂不支持将图片直接回写至图片字段，只能通过返回图片 url 至文本字段来实现。

出于风险因素考虑，短期内暂无计划支持回写图片/附件字段。

8. 为什么插件的可选通用参数不配置或配置后清空，插件会报错？

通用参数不配置时，初始值为 Null 不为空，需定义通用参数不填时默认空值。

9. 插件的IP是不固定的吗？

服务器 IP 地址不固定，动态更新。如果遇到需要给插件服务器 IP 地址加白授权的场景，暂无法支持。

此问题平台已知，正在研究解决方案，预计 2023 年 Q3 可解决。

10. 插件无法定时重复触发吗？

目前自建插件支持定时触发，但最小颗粒度为 1 天触发一次。

如果希望能够实时或更小颗粒度的定时自动触发，目前暂不支持。

但可以通过后续计划上线的按钮功能，来实现用户侧无需打开数据详情页仅通过按钮来进行重复触发。

11. 部分接口无法接收url格式的图片，如何处理？

可以先下载图片，将图片 URL 解析为 base64 格式的字符串后发送。

更多常见问题答案，持续更新中... ...