在 Power BI 中构建您自己的仪表板

Power BI 是 Microsoft 的报表工具。Kaam360 为您的组织提供专属的数据源供 Power BI 读取，让您可以用项目、任务、工时、财务、销售和支持数据构建任何想要的仪表板。数据源是只读的：它永远不能更改 Kaam360 中的任何内容。此功能属于商业版套餐。

如何保证安全

• Power BI 从不连接 Kaam360 的数据库。它通过安全的 https 地址向 Kaam360 请求数据，Kaam360 只返回您自己组织的数据。
• 每个数据源密钥只读取您勾选的部分，并可随时撤销。Kaam360 只保存密钥的加密摘要，任何人都无法再读出密钥。
• 除非您为该密钥允许，否则不包含电子邮件地址和电话号码。

第 1 步：创建数据源密钥（管理员）

拥有管理集成权限的人员可以执行此操作。

1. 打开设置，选择 Power BI。
2. 在创建数据源密钥下，为密钥填写名称，例如“管理层仪表板”。
3. 在可以读取的内容下，勾选报表需要的数据。按全选勾选所有内容，或按全部清除重新开始。
4. 只有报表需要时，才勾选包含电子邮件地址和电话号码。
5. 按创建密钥。
6. 按新密钥旁的复制，并将其保存在安全的地方。它只显示一次。如果丢失，请创建新密钥并撤销旧密钥。

第 2 步：连接 Power BI Desktop

1. 在 Power BI 页面上，按数据源地址旁的复制。它类似于：https://your-kaam360-address/odata/。
2. 打开 Power BI Desktop。在主页（Home）选项卡上选择获取数据（Get data），然后选择 OData 源（OData feed）。如果看不到，请选择更多...，然后选择其他，再选择 OData 源。
3. 保持窗口顶部的基本（Basic）选中，将数据源地址粘贴到 URL 中，然后按确定。
4. Power BI 会询问如何登录。在左侧选择基本（Basic）。在用户名中输入 powerbi，在密码中粘贴您的数据源密钥。在设置应用级别中选择数据源地址。按连接。
5. 导航器列出您的密钥可以读取的表，例如 Projects、Tasks 和 Invoices。勾选您需要的表。单击某个表可查看预览。
6. 按加载。Power BI 会读取所有行。大型表以每页 1,000 行的方式传输；Power BI 会自动获取后续页面。

第 3 步：构建报表

1. 打开模型视图。Power BI 可能已经关联了一些表。请对照下方示例报表中列出的关系检查，并将一列拖到另一列上以添加缺少的关系。
2. 回到报表视图。选择一个视觉对象，例如条形图，并将字段拖入其中：例如 Projects › Name 和 Tasks › LoggedHours。
3. 使用 Health、Status 或 CompanyId 作为切片器来筛选整个页面。
4. 保存文件。

第 4 步：发布并按计划刷新

1. 在 Power BI Desktop 的主页选项卡上选择发布，并选择 Power BI 服务中的一个工作区。
2. 打开 Power BI 服务（app.powerbi.com），进入该工作区，找到与报表同名的语义模型（数据集）。
3. 打开其设置。在数据源凭据下，选择 OData 地址旁的编辑凭据。
4. 将身份验证方法选为基本（Basic）。在用户名中输入 powerbi，在密码中粘贴数据源密钥。选择一个隐私级别（例如组织），然后按登录。
5. 打开计划刷新，将其开启，选择频率和时间，然后按应用。

不需要网关：Power BI 服务直接通过互联网读取数据源。

示例报表

一个简单的项目仪表板使用以下表和关系（每个关系将前面的 id 列与后面那个表的 Id 关联）：

• Tasks：ProjectId 关联 Projects，OwnerId 关联 Users，PhaseId 关联 Phases。
• TimeLogs：ProjectId 关联 Projects，TaskId 关联 Tasks，UserId 关联 Users。
• Projects：CustomerId 关联 Customers，CompanyId 关联 Companies。
• Invoices：CustomerId 关联 Customers，ProjectId 关联 Projects。InvoiceLines：InvoiceId 关联 Invoices。
• Payments：ProjectId 关联 Projects。Deals：CustomerId 关联 Customers。Contacts：CustomerId 关联 Customers。Tickets：CustomerId 关联 Customers。

适合入门的视觉对象：一个包含 Health、PercentDone、TasksOverdue 和 EndDate 的 Projects 表；按 Users › Team 显示 TimeLogs › Hours 的条形图；按 IssueDate 月份显示 Invoices › Total 的柱形图；按 Stage 显示 Deals › Amount 的漏斗图。

须知

• 日期是纯日期（例如 2026-10-31）。时间为 UTC。
• 金额始终与其 Currency 一起提供。发票、报价单和费用还包含 ExchangeRate：在单据日期，单据货币的一个单位相当于您的主货币多少单位。乘以它即可将不同货币的金额相加。
• 如果您有多家公司，CompanyId 表示项目或单据属于您自己的哪家公司（参见设置 › 公司）。
• Projects › Health 的计算方式与仪表板完全相同：On track、At risk、Off track 或 Not planned。已归档、已完成和已取消的项目此项为空。
• 每个表都有 ModifiedAt。对于大型组织，如只需刷新最近的更改，请在 Power BI Desktop 中基于 ModifiedAt 设置增量刷新。
• 每个密钥每分钟最多可发出 300 个请求。如果刷新需要更多，Power BI 会等待并自动重试。
• 要更改密钥可以读取的内容，请按其旁边的更改。密钥保持不变，因此 Power BI 会继续工作，并在下次刷新时读取新的选择。
• 按撤销（按两次）可停用密钥。使用它的报表将停止刷新。
• 活动日志（设置 › 活动日志）显示每个密钥的创建、更改和撤销时间，并为其每个使用日记录一行。
• 其他可读取 OData 源的报表工具，例如 Excel（数据 › 获取数据 › 自其他源 › 从 OData 源），也可以使用相同的地址和密钥。

如果出现问题

• “无法使用提供的凭据进行身份验证”：请检查您是否选择了基本（Basic），是否将完整密钥粘贴为密码，以及密钥是否已被撤销。要在 Power BI Desktop 中重新输入密钥，请选择文件 › 选项和设置 › 数据源设置，选择该地址并按编辑权限。
• “禁止访问该资源”：该密钥不能读取此表。请在 Power BI 页面的更改中勾选它。
• 设置中没有 Power BI：您的套餐可能不包含它（它属于商业版），或您的角色没有管理集成权限。