# 电力查询专家使用 M 代码将 Microsoft Power Query（Power BI、Excel）连接到 Frappe 应用程序以访问报告数据。 ## 快速入门 ### 简单的 REST API 连接对于直接文档访问和小列表（< 1000 条记录）：让 BaseUrl =“https://your-site.frappe.cloud”，文档类型 = "项目", 字段 = "[""item_code"", ""item_name"", ""standard_rate""]", ApiUrl = BaseUrl & "/api/resource/" & DocType & "?fields=" & Uri.EscapeDataString(Fields), 响应 = Json.Document(Web.Contents(ApiUrl)), 表 = Table.FromRecords(响应[数据]) 在表 **用途：**直接文档读取、小型查询、实时数据有关包含过滤器、排序和分页的完整 REST API 示例，请参阅 [references/rest-api-power-query-example.md]()。 ### 简单的 Frappe 报告连接对于不会超时的快速报告：让 BaseUrl =“https://your-site.frappe.cloud”， ReportName = "简单报告", ApiUrl = BaseUrl & "/api/method/frappe.desk.query_report.run?report_name=" & Uri.EscapeDataString(ReportName), 响应 = Json.Document(Web.Contents(ApiUrl)), 数据 = 响应[消息][结果], 表 = Table.FromRecords(数据) 在表 **用途：** 小而快速的报告（< 1000 行，< 30 秒执行） ### 使用report_long_polling 生成长时间运行的报告对于大量报告，请使用 **report_long_polling API** 来防止超时。此 API 在 Frappe 的后台工作队列中异步执行报告。 **三步工作流程：** 1. **开始作业** \- 创建准备好的报告作业 2. **投票状态** \- 等待完成 3. **获取结果** \- 使用列元数据检索数据有关 API 端点详细信息，请参阅 [references/long-polling-api-reference.md]()。 ## Power BI/Excel 集成 **1\.获取数据 → 空白查询** **2\.高级编辑器** \- 从 [references/long-polling-power-query-example.md]() 粘贴 M 代码 **3\.配置：** BaseUrl =“https://your-site.frappe.cloud” 报告名称 =“商品价格” Filters = [] // 根据需要添加过滤器 **4\.关闭并应用** **5\.出现提示时配置身份验证**： * Excel/Power BI 将在首次连接时提示输入凭据 * **选项 1 - 用户名/密码**：输入您的 Frappe 用户名和密码 * **选项 2 - API 密钥/令牌**：输入 API 密钥作为用户名，API 密钥作为密码 * 身份验证通过 HTTP Basic Auth 自动处理 * 无需在M代码中添加Authorization headers ## 身份验证 Excel 和 Power BI 通过其内置的身份验证表单自动处理身份验证。您有两个选择： ### 选项 1：用户名/密码 * 使用您的Frappe帐户用户名和密码 * Excel/Power BI 使用 HTTP 基本身份验证 * 标头格式：`授权：基本 base64(用户名:密码)` ### 选项 2：API 密钥/令牌（推荐用于生产） 1. **在 Frappe 中创建 API 密钥** : 用户 → API 访问 → 生成密钥 2. **复制API密钥和秘密** 3. **在 Excel/Power BI 身份验证提示中**： * 用户名：输入您的 API 密钥 * 密码：输入您的 API 密码 4. Excel/Power BI 使用 HTTP 基本身份验证 5. 标头格式：`授权：基本base64(api_key:api_secret)` **注意：** Excel/Power BI 使用 HTTP 基本身份验证，而不是 Frappe 的“令牌”格式。 Frappe 的 API 接受这两种格式，因此身份验证可以无缝进行。 ### 安全最佳实践 * 使用 API 密钥代替密码进行自动刷新 * 为API用户授予最低权限 * 定期轮换钥匙 * 切勿在 M 代码中包含凭证 ## 列转换 report_long_polling API 返回支持自动转换的列元数据： {“fieldname”：“item_code”，“label”：“商品代码”，“fieldtype”：“链接”} **自动类型映射：** * Int/Long Int → Int64.Type * 货币 → 货币.类型 * 日期 → 日期.类型 * 日期时间 → 日期时间.类型 * 检查 → 逻辑.类型 * 文本类型 → 输入文本 **手动超控：** 手动类型映射 = [ Rate =Currency.Type, // 强制货币 #"Stock Qty" = Int64.Type // 强制整数 ] 有关完整类型映射表，请参阅 [references/long-polling-api-reference.md]()。 ## 缓存清除 Power Query 积极缓存。添加时间戳以强制新请求：时间戳 = Text.From(Number.Round( Duration.TotalSeconds(DateTime.LocalNow() - #datetime(1970, 1, 1, 0, 0, 0)) * 1000 ））， UrlWithCacheBuster = BaseUrl & "&_ts=" & 时间戳 ## 常见用例 * **Power BI 仪表板**：实时销售、库存、财务报告 * **Excel 工作簿**：使用数据透视表进行每月分析 * **计划刷新**：每日/每小时数据集更新 * **跨系统报告**：将 Frappe 数据与外部来源相结合 ## 故障排除有关详细解决方案，请参阅 [references/troubleshooting.md]()。 **快速修复：** * **超时错误** ：增加 maxAttempts，验证工作线程正在运行 * **连接错误** ：检查 BaseUrl、身份验证、权限 * **空结果** ：验证过滤器，检查准备好的报告状态 * **类型错误** ：使用手动类型覆盖，检查空值 * **过时数据** ：添加缓存清除时间戳，清除缓存 ## 资源 * **REST API 示例** : [references/rest-api-power-query-example.md]() * **长轮询 M 代码** : [references/long-polling-power-query-example.md]() * **API详细信息**：[references/long-polling-api-reference.md]() * **故障排除**：[references/troubleshooting.md]()

Frappe 调整 Power Query Expert

包含技能