微应用

集成 Power BI

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

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

有关开箱即用的 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) 用户。读 已委派 登录并读取用户配置文件。
电源 BI 服务 (18) App.Read.All 已委派 查看所有 Power BI 应用程序。
  容量。阅读。全部 已委派 查看所有容量。
  仪表板。Read。All 已委派 查看所有仪表板。
  数据流。Read .All 已委派 查看所有数据流。
  数据集。Read .All 已委派 查看所有数据集。
  Gateway.Read。All 已委派 查看所有网关。
  报告 .Read .All 已委派 查看所有报告。
  存储帐户。read.all 已委派 查看所有存储帐户。
  工作区。Read。All 已委派 查看所有工作区
  租户。Read.All 已委派 查看租户中的所有内容

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

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

注册你的应用

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

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

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

  1. 输入应用程序的名称。
  2. 选择 服务器端 Web 应用程序
  3. 输入应用程序的 主页 URL。此值必须是 Citrix 云租户的 URL(微应用服务器 URL)。例如,https://<customer_id>.us.iws.cloud.com。登录 Citrix 微应用程序后,您可以在 URL 栏中找到此微应用服务器 URL。
  4. 输入以下 重定向 URL之一: https://{yourmicroappserverurl}/app/api/auth/serviceAction/callback https://{yourmicroappserverurl}/admin/api/gwsc/auth/serverContext

    注意:

    此字段中不允许使用两个 URL。转到 Azure AD 应用注册 以添加第二个 URL。

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

    Azure 中的回调

将集成添加到 Citrix Workspace 微应用

将 Power BI 集成添加到 Citrix Workspace 微应用程序以连接到您的应用程序。这样可以提供带有预配置通知和操作的开箱即用的微应用程序,这些通知和操作可在工作区中使用

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

  1. 微应用集成 页面中,选择 添加新集成,然后 从 Citrix 提供的模板中添加新集成。
  2. 选择 Power BI 磁贴。
  3. 输入 集成的集成名称
  4. 输入 连接器参数
    • 输入实例 基本 URLhttps://api.powerbi.com/v1.0/myorg
    • 图标 库中选择一个用于集成的图标,或将其保留为默认的 ServiceNow 图标。
    • 如果要创建 本地连接,请启用本地实例 切换。有关更多信息,请参阅 本地实例
  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 连接器规格

使用 Power BI 微应用

现有的 Web/SaaS 集成随附开箱即用的微应用。从这些微应用开始,然后根据您的需求自定义它们。

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

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

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

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

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