集成 Power BI

与 Power BI 集成以跟踪 Citrix Workspace 中的重要报告和仪表板。

注意

我们提供两个 Power BI 集成模板供您使用。对于大多数用例,我们建议使用较新的 HTTP 集成。HTTP 集成提供了更多功能来配置缓存的数据结构。

使用以下过程启用 Power BI 集成。确保满足必备条件并提供连接详细信息。完成此过程后,您的现有审核日志记录级别将持续存在,包括使用 Citrix 微应用执行的任何操作。

有关现成的 Power BI 微应用的完整列表,请参阅使用 Power BI 微应用

检查必备项

你必须拥有一个 Power BI 服务帐户。有关更多信息,请转到https://powerbi.microsoft.com/en-us/landing/signin/。对于要通过 Citrix 微应用共享的任何报表,必须与 Power BI 服务帐户共享报表。

根据您的设置,可能需要两个帐户:

  • 有权在 Azure AD 中创建应用程序注册的帐户。此帐户可能有问题,具体取决于它首先与哪个订阅/租户关联。
  • 用于验证集成的服务帐户。

这些必备条件假定您管理组织的 Power BI 实例以设置集成。服务帐户必须使用类型分配以下 API 权限:委派

API/权限名称 类型 说明
Azure Active Directory 图表 (1) User.Read 委派 登录并读取用户配置文件。
Power BI Service (18) App.Read.All 委派 查看所有 Power BI 应用。
  Capacity.Read.All 委派 查看所有容量。
  Dashboard.Read.All 委派 查看所有控制板。
  Dataflow.Read.All 委派 查看所有数据流。
  Dataset.Read.All 委派 查看所有数据集。
  Gateway.Read.All 委派 查看所有网关。
  Report.Read.All 委派 查看所有报告。
  StorageAccount.Read.All 委派 查看所有存储帐户。
  Workspace.Read.All 委派 查看所有工作区

在 Power BI 中设置此集成后,您需要以下项目才能在 Citrix Workspace 微应用中添加集成:

  • 客户端 ID
  • 客户端密钥
  • OAuth 授权

注册您的申请

导航到 https://dev.powerbi.com/apps,并将应用程序注册到 Azure AD,以允许应用程序访问 Power BI REST API 并为应用程序设置资源权限。通过此注册过程,您可以创建您的客户端 ID 和客户端密码。

列出的第一个回调不会更改。第二个回调取决于目标应用程序,并且可以在创建集成时在 URL 地址栏中找到。{yourmicroappserverurl} 部分由租户部分、区域部分和环境部分组成:https://{tenantID}.{region(us/eu/ap-s)}.iws.cloud.com

您只能在第一个字段中注册一个 URL。在 服务器端 Web 应用程序 注册页面中输入一个 URL。然后转到 Azure 广告应用注册 以添加第二个 URL。

  1. 输入应用程序的名称。
  2. 选择服务器端 Web 应用程序
  3. 输入您的应用程序的主页 URL
  4. 输入以下 重定向 URL之一: https://{yourmicroappserverurl}/app/api/auth/serviceAction/callback https://{yourmicroappserverurl}/admin/api/gwsc/auth/serverContext

    注意:此字段中不允许使用

    两个 URL。转到 Azure 广告应用注册 以添加第二个 URL。

  5. 选中所有只读 API 复选框。
  6. 选择注册
  7. 导航到 Azure 应用注册 > 身份验证 ,然后输入第二个回调 URL。

    Azure 中的回调

将 HTTP 集成添加到 Citrix Workspace 微应用

将 Power BI HTTP 集成添加到 Citrix Workspace 微应用程序以连接到应用程序。这样可以提供现成的微应用,以及可以在 Workspace 内使用的预配置通知和操作。

请按照以下步骤进行操作:

  1. 微应用集成页面中,选择添加新集成,然后选择从 Citrix 提供的模板添加新集成
  2. 选择 Power BI 磁贴。
  3. 输入集成的集成名称
  4. 输入连接器参数
    • 输入实例 基本 URL
    • 从图标库中选择集成的图标,或将其保留为默认 ServiceNow 图标。

    ServiceNow HTTP 参数

    • 如果要创建本地连接,请启用本地实例开关。有关详细信息,请参阅本地实例
  5. 服务身份验证下,从身份验证方法菜单中选择 OAuth 2.0,然后填写身份验证详细信息。身份验证选项已预先选择。确保在完成此过程时选择了这些选项。使用 OAuth 2.0 安全协议为委派访问生成请求/授权令牌。建议您始终使用 OAuth 2.0 作为服务身份验证方法(如果可用)。OAuth 2.0 可确保您的集成符合您配置的微应用的最大安全合规性。

    1. 授权类型菜单中选择授权代码。这将授予客户端交换访问令牌的临时代码。代码从授权服务器获取,您可以在其中查看客户端请求的信息。只有此授权类型才能启用安全用户模拟。这将显示您在注册应用程序时使用的 回调 URL
    2. 令牌授权菜单中选择请求正文
    3. 授权 URL 已预填充: https://login.microsoftonline.com/{tenantID}/oauth2/authorize
    4. 令牌 URL 已预填充: https://login.microsoftonline.com/{tenantID}/oauth2/token
    5. 确保为范围输入以下内容:Tenant.Read.All
    6. 输入您的客户端 ID。客户端 ID 是表示授权服务器唯一的客户端注册信息的字符串。在配置 OAuth 服务器时,您将收集这些信息和密码。您需要添加集成配置页面上看到的回调 URL
    7. 输入您的客户端密码。客户端密钥是设置目标应用程序集成时发出的唯一字符串。
    8. 访问令牌参数下,确保为名称:资源输入以下内容:https://analysis.windows.net/powerbi/api
  6. 服务操作身份验证下,启用在操作中使用单独用户身份验证开关。服务操作身份验证在服务操作级别进行身份验证。身份验证选项已预先选择。确保在完成此过程时选择了这些选项。

    1. 从“身份验证方法”菜单中选择“OAuth 2.0”,然后完成身份验证详细信息。
    2. 授权类型菜单中选择授权代码。这将授予客户端交换访问令牌的临时代码。代码从授权服务器获取,您可以在其中查看客户端请求的信息。只有此授权类型才能启用安全用户模拟。这将显示您在注册应用程序时使用的回调 URL
    3. 令牌授权菜单中选择请求正文
    4. 授权 URL 已预填充: https://login.microsoftonline.com/{tenantID}/oauth2/authorize
    5. 令牌 URL 已预填充: https://login.microsoftonline.com/{tenantID}/oauth2/token
    6. 确保为范围输入以下内容:Tenant.Read.All
    7. 输入您的客户端 ID。客户端 ID 是表示授权服务器唯一的客户端注册信息的字符串。您在配置 OAuth 客户端时收集此信息和密码。您需要添加集成配置页面上看到的回调 URL
    8. 输入您的客户端密码。客户端密钥是设置目标应用程序集成时发出的唯一字符串。
    9. 访问令牌参数下,确保为名称:资源输入以下内容:https://analysis.windows.net/powerbi/api
  7. (可选)如果要激活此集成的速率限制,请启用请求速率限制开关并设置每个时间间隔请求数
  8. (可选)启用日志记录开关以保留 24 小时的日志记录以供支持。

    速率限制和记录切换

  9. 选择 保存 以继续。
  10. OAuth 授权下,选择 授权 以使用您的服务帐户登录。出现一个弹出窗口,其中包含 Power BI 登录屏幕
    1. 输入您的服务帐户用户名和密码,然后选择“登录”。
    2. 选择“接受”。 服务身份验证

微应用集成页面将打开,其中包含您添加的集成及其微应用。在这里,您可以添加另一个集成,继续设置现成的微应用,或者为此集成创建一个新的微应用。

现在,您可以设置和运行第一个数据同步。有关同步规则、不符合其计划的同步以及否决规则的完整信息,请参阅 同步数据

有关 API 端点和表实体的更多详细信息,请参阅Power BI HTTP 连接器规格

使用 Power BI 微应用

现有的 Web /SaaS 集成带有现成的微应用。从这些微应用开始,并根据您的需求定制它们。

我们的 Power BI 集成模板附带以下预配置的开箱即用微应用:

控制板: 查看 Power BI 控制板的详细信息。仪表板列表是个性化的,因此您只能在 Power BI 中看到属于 Citrix Workspace 一部分的仪表板。

通知或页面 用例工作流
控制板页面 提供可用控制板列表,其中包含详细信息页面的链接。
控制板详细信息页面 提供控制板的只读详细视图,其中包含指向目标记录源的链接,以获得更详细的视图。

报表: 查看 Power BI 报表的详细信息。报告列表是个性化的,因此您只能在 Power BI 中看到属于 Citrix Workspace 的一部分的报表。

通知或页面 用例工作流
报告详细信息页面 提供报告的只读详细视图。
“报告”页 提供可用报告列表,其中包含指向页面的链接,其中包含指向目标记录源的链接,以获得更详细的视图。

旧模板

请按照以下步骤设置旧版集成。先决条件是一样的。

注册您的申请

导航到 https://dev.powerbi.com/apps,并将应用程序注册到 Azure AD,以允许应用程序访问 Power BI REST API 并为应用程序设置资源权限。通过此注册过程,您可以创建您的客户端 ID 和客户端密码。

列出的第一个回调不会更改。第二个回调取决于目标应用程序,并且可以在创建集成时在 URL 地址栏中找到。{yourmicroappserverurl} 部分由租户部分、区域部分和环境部分组成:https://{tenantID}.{region(us/eu/ap-s)}.iws.cloud.com

您只能在第一个字段中注册一个 URL。在 服务器端 Web 应用程序 注册页面中输入一个 URL。然后转到 Azure 广告应用注册 以添加第二个 URL。

  1. 输入应用程序的名称。
  2. 选择服务器端 Web 应用程序
  3. 输入您的应用程序的主页 URL
  4. 输入以下 重定向 URL之一: https://{yourmicroappserverurl}/app/api/auth/serviceAction/callback https://{yourmicroappserverurl}/admin/api/external-services/com.sapho.services.powerbi.PowerBiService/auth/serverContext

    注意:此字段中不允许使用

    两个 URL。转到 Azure 广告应用注册 以添加第二个 URL。

  5. 选中所有只读 API 复选框。
  6. 选择注册
  7. 导航到 Azure 应用注册 > 身份验证 ,然后输入第二个回调 URL。

    Azure 中的回调

将集成添加到 Citrix Workspace 微应用

将 Power BI 集成添加到 Citrix Workspace 微应用以连接到您的应用程序。这样可以提供现成的微应用,以及可以在 Workspace 内使用的预配置通知和操作。

请按照以下步骤进行操作:

  1. 从概览页面中,选择开始

    此时将打开“管理集成”页面。

  2. 选择添加新集成,然后选择从 Citrix 提供的模板中添加新集成
  3. 选择 Power BI 磁贴。
  4. 输入集成的名称。

    Power BI 连接器参数、客户端 ID、客户端密钥、租户、OAuth 授权

  5. 输入您在之前的过程中收集的连接器参数
    • 输入您的客户端 ID客户端密码
    • 输入您的 Office 365 租户 ID
  6. 选择使用 Power BI 帐户登录以启用 OAuth 授权。Power BI 登录页面将在新选项卡中打开。系统将提示您输入帐户名称、输入密码并接受请求的权限。

  7. 选择添加

微应用集成页面将打开,其中包含您添加的集成及其微应用。在这里,您可以添加另一个集成,继续设置开箱即用的微应用程序,或者为此集成创建一个微应用程序。

使用旧版 Power BI 微应用

现有的 Web /SaaS 集成带有现成的微应用。从这些微应用开始,并根据您的需求定制它们。

我们的 Power BI 集成模板附带以下预配置的开箱即用微应用:

控制板: 查看 Power BI 控制板的详细信息。

通知或页面 用例工作流
控制板页面 提供可用控制板列表,其中包含详细信息页面的链接。
控制板详细信息页面 提供控制板的只读详细视图,其中包含指向目标记录源的链接,以获得更详细的视图。

报表: 查看 Power BI 报表的详细信息。

通知或页面 用例工作流
新报告已添加通知 将新报告添加到帐户时,订阅者会收到通知。
报告详细信息页面 提供报告的只读详细视图。
“报告”页 提供可用报告列表,其中包含指向页面的链接,其中包含指向目标记录源的链接,以获得更详细的视图。
集成 Power BI