分享时间 | 2023-06-26 17:52 |
最后更新 | 2023-07-07 13:00 |
修订版本 | 4 |
用户许可 | 可自己使用或修改,不可再分享 |
Quicker版本 | 1.38.23 |
动作大小 | 344.1 KB |
==========================================
这个动作是来源于:命名规范 的内测版,主要用扩展一些新特性的过渡版本,可以理解为预览版。
「命名规范」从一个简单的驼峰转换版本迭代到现在支持9种命名范式,功能算是能支持日常开发用途。但作者用着就发现,如果想嵌入一些新功能和新的命名范式,比较繁琐,比如最近比较火的ChatGPT,作者已经将这个功能嵌入到「命名规范」中,过程不难,就是比较繁琐。
所以,目前比较重要的是让「命名规范」具备扩展性。
作者尝试了全局 javascript 脚本,效果能实现,但是需要具备 javascript 基本开发常识,也比较麻烦的。
所以最近作者正在研究如何让「命名规范」有自己的插件功能,实现即插即用式扩展,目前已经初步完成数据来源和翻译的扩展。
下一步是根据大家的反馈来完善插件功能,后续「命名规范」将会移除AI模块和翻译模块,将这两个作为插件功能抽离出来。
目前插件开发进度:
「命名规范」的设置页面采用的是 quicker 的多表单字段组件,这个组件的特点就是静态数据,无法实现动态交互。所以在开发插件的时候,需要在先开启插件,在对应插槽选中指定插件,然后保存配置。
重新打开「命名规范」的设置以及执行「命名规范」都会调用插件完成对应操作,例如获取插件配置。
目前支持两个插槽,允许用户扩展。
插件示例:https://getquicker.net/Sharedaction?code=776d45b9-2a21-4a68-d708-08db6ef8c695
参数数据来源方向:「命名规范」 -------> 插件
通过 quicker 内置变量可以获取「命名规范」的传值参数:$${quicker_in_param}
配置参数:允许插件有自己的配置项,当执行「命名规范」动作设置的时候,会传一个参数给插件表示获取插件配置信息。
命名规范:init_handle
执行参数:在执行「命名规范」动作的时候时候,「命名规范」会将当前插槽的参数,以及插件的配置参数一同传给插件,格式如下:
命名规范:{ "text":"{文本}","setting":{插件配置}}
参数数据来源方向:插件 -------> 「命名规范」
插件配置
插件返回的配置比较复杂,建议使用 quicker 多字段表单组件来可视化配置规则。
返回格式示例:
{"setting": [{"FieldKey": "表单_数学运算结果","DictVarType": null,"Label": "数学运算结果","HelpText": "允许定义最终的显示文本结果","HelpLink": null,"InputMethod": 3,"SelectionItems": "保持不变|保持不变\r\n转换成数字|转换成数字\r\n","IsRequired": false,"MinValue": "","MaxValue": "","Pattern": "","InputWidth": null,"MaxLength": 0,"ImeState": null,"TextTools": "","VisibleExpression": "","DefaultValue": null,"Group": null}]}
插件返回的配置比较复杂,建议使用 quicker 多字段表单组件来可视化配置规则,以下是一个示例图片:
通过可视化复制的配置,可以直接使用,它就是一个完整的 json 格式的参数,例如:
[{"FieldKey": "表单_数学运算结果","DictVarType": null,"Label": "数学运算结果","HelpText": "允许定义最终的显示文本结果","HelpLink": null,"InputMethod": 3,"SelectionItems": "保持不变|保持不变\r\n转换成数字|转换成数字\r\n","IsRequired": false,"MinValue": "","MaxValue": "","Pattern": "","InputWidth": null,"MaxLength": 0,"ImeState": null,"TextTools": "","VisibleExpression": "","DefaultValue": null,"Group": null}]
插件执行结果
执行结果没有要求,直接返回即可。
最后,建议参考插件示例来开发,插件示例是一个完整的小示例。
插件示例:https://getquicker.net/Sharedaction?code=776d45b9-2a21-4a68-d708-08db6ef8c695
修订版本 | 更新时间 | 更新说明 |
---|---|---|
4 | 2023-07-07 13:00 | 1. 修复编码错误 |
3 | 2023-06-27 11:49 | 1. 支持插件配置 |
2 | 2023-06-26 19:00 | 1. 优化 |