frappe-tweaks-power-query-expert

用途：帮助在 Microsoft Power Query（Power BI、Excel）中编写 M 代码，连接 Frappe 应用及其报表数据。主要能力：一是通过简单 REST API 直接读取文档，适合小列表（少于 1000 条记录），示例从 /api/resource/ 拼接 DocType 与 fields；二是通过 /api/method/frappe.desk.query_report.run 读取简单报表，适合少于 1000 行、30 秒内执行完的报表；三是对重型报表使用 report_long_polling API 异步执行，按“创建 Prepared Report 任务、轮询状态、取回含列元数据的结果”三步流程避免超时。列元数据可自动做类型映射（如 Currency → Currency.Type、Date → Date.Type），也支持手动覆盖类型。使用方式：在 Power BI 或 Excel 中通过“获取数据→空白查询→高级编辑器”粘贴 M 代码，配置 BaseUrl、ReportName、Filters 等变量，然后 Close & Apply。认证由 Excel/Power BI 弹出的凭据窗口自动处理，走 HTTP Basic Auth，可选用户名加密码，或推荐生产环境用 API Key 作用户名、API Secret 作密码，无需在 M 代码里写 Authorization 头。限制与注意：Power Query 缓存较强，可加时间戳参数强制刷新；需注意超时、连接、空结果、类型与数据陈旧等问题。安全性上建议使用 API 密钥、最小权限、定期轮换，且不要将凭据写入 M 代码。资料未提供具体价格与收费信息。