power-query-expert

用途：帮助在 Microsoft Power Query（Power BI、Excel）中编写 M 代码，访问 Frappe 应用与报表数据。主要能力：一、简单 REST API 连接，用于直接读取文档和小规模列表（少于 1000 条记录），示例使用 BaseUrl 与 DocType 拼接 /api/resource/ 路径，配合 Json.Document 与 Table.FromRecords；二、Frappe 报表连接，通过 /api/method/frappe.desk.query_report.run 调用，适合小于 1000 行、30 秒内完成的小型快速报表；三、长耗时报表使用 report_long_polling API，异步在后台 worker 队列执行，分三步：创建 Prepared Report 任务、轮询状态、获取数据与列元数据；四、Power BI/Excel 集成步骤：获取数据→空白查询→高级编辑器粘贴 M 代码→配置 BaseUrl、ReportName、Filters→关闭并应用，首次连接时按提示配置身份验证；五、身份验证支持用户名/密码或 API Key/Token 两种方式，Excel/Power BI 使用 HTTP Basic 认证，建议生产环境使用 Frappe 生成的 API Key 与 Secret，并最小化权限、定期轮换、不要在 M 代码中写入凭据；六、列转换依据报表返回的列元数据自动映射类型（如 Int/Long Int→Int64.Type、Currency→Currency.Type、Date→Date.Type、Datetime→DateTime.Type、Check→Logical.Type、文本→type text），也可手动覆盖；七、缓存处理：Power Query 缓存较强，可附加时间戳参数强制刷新。常见场景包括 Power BI 仪表板、Excel 工作簿月度分析、计划刷新、跨系统报表整合。故障排查涵盖超时、连接错误、空结果、类型错误与数据陈旧等问题，详细方案见配套参考资料文件。使用限制：资料未提供具体定价、许可或平台版本要求；部分细节需查阅 references 下的示例与参考文件。