集成电源BI

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

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

有关开箱即用的Power BI微应用程序的全面列表，请参见使用Power BI微应用．

审查先决条件

您必须拥有Power BI服务帐户。有关更多信息，请访问https://powerbi.microsoft.com/en-us/landing/signin/．对于任何通过Citrix Microapps共享的报告，必须与Power BI服务账户共享。

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

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

这些先决条件假设您管理组织的Power BI实例来设置集成。服务帐户必须具有以下分配的API权限类型:委托:

组	API/权限名称	类型	描述
Azure Active Directory图表（1）	用户阅读	委派	登录并读取用户配置文件。
电力BI服务（18）	App.Read.All	委派	查看所有Power BI应用程序。
	阅读能力	委派	查看所有容量。
	Dashboard.Read.All	委派	查看所有仪表盘。
	Dataflow.Read.All	委派	查看所有数据流。
	Dataset.Read.All	委派	查看所有数据集。
	Gateway.Read.All	委派	查看所有网关。
	报告，阅读，全部	委派	查看所有报告。
	StorageAccount.Read.All	委派	查看所有存储帐户。
	Workspace.Read.All	委派	查看所有工作区
	承租人，全部阅读	委派	查看租户中的所有内容

在Power BI中设置此集成后，您将需要以下工件来添加Citrix Workspace MicroApp中的集成：

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

注册你的申请

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

列出的第一个回调不会更改。第二个回调依赖于目标应用程序，在创建集成时可以在URL地址栏中找到。部分{yourmicroappserverurl}由租户部分、区域部分和环境部分组成：https:// {tenantID}。{地区(美国/欧盟/ ap-s)} .iws.cloud.com．

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

1. 输入应用程序的名称。
2. 选择服务器端web应用程序．
3. 输入您的应用程序的主页URL. 此值必须是Citrix云租户的URL（MicroApp服务器URL）。例如https://.us.iws.cloud.com. 登录Citrix MicroApp时，您可以在URL栏中找到此MicroApp服务器URL。

4. 输入下列任一项重定向URLs:https://{yourmoappserverurl}/app/api/auth/serviceAction/callbackhttps:// {yourmicroappserverurl} / admin / api / gwsc /认证/ serverContext

   注:

   此字段中不允许有两个URL。去Azure广告应用程序注册添加第二个URL。

5. 选择所有只读api复选框。
6. 选择登记．

7. 引导到Azure应用程序注册>身份验证然后输入第二个回调URL。

将集成添加到Citrix Workspace MicroApp

将Power BI集成添加到Citrix Workspace MicroApp以连接到您的应用程序。这提供了现成的MicroApp，带有预先配置的通知和操作，可以在您的工作区内使用。

遵循以下步骤：

1. 从Microapp集成第页，选择添加新的集成,从citrix提供的模板添加新的集成．
2. 选择Power BI贴图。
3. 输入集成名称为了整合。
4. 进来连接器参数．
   • 输入实例基本URL:https://api.powerbi.com/v1.0/myorg
   • 选择一个偶像从图标库进行集成，或将其保留为默认的ServiceNow图标。
   • 启用本地实例如果正在创建本地连接，则切换。有关更多信息，请参见本地实例．

5. 在下面服务认证选择OAuth2.0从认证方法菜单并完成身份验证细节。已预先选择身份验证选项。确保在完成流程时选择了这些选项。使用OAuth 2.0安全协议为委托访问生成请求/授权令牌。建议您始终使用OAuth 2.0作为您的服务身份验证方法。OAuth 2.0确保您的集成符合配置microapp的最大安全遵从性。

   1. 选择授权码从格兰特类型菜单这将授予客户端交换访问令牌的临时代码。代码是从授权服务器获得的，您可以在该服务器上查看客户端请求的信息。只有此授权类型才能启用安全的用户模拟。这将显示回调URL，注册应用程序时使用。
   2. 选择请求主体从令牌授权菜单。
   3. 这个授权URL已预先填充：https://login.microsoftonline.com/{tenantID}/oauth2/authorize
   4. 这个令牌URL已预先填充：https://login.microsoftonline.com/{tenantID}/oauth2/token
   5. 确保输入以下内容范围:承租人，全部阅读
   6. 输入您的客户端ID. 客户端ID是表示授权服务器特有的客户端注册信息的字符串。当您配置OAuth服务器时，您将收集此信息和机密。您需要添加回调URL您可以在集成配置页面上看到。
   7. 输入您的客户机密. 客户端密码是在设置目标应用程序集成时发出的唯一字符串。
   8. 在下面访问令牌参数，请确保为输入以下内容：名称:资源，及价值:https://analysis.windows.net/powerbi/api．

6. 在下面服务操作身份验证，启用在操作中使用单独的用户身份验证切换。服务操作身份验证在服务操作级别进行身份验证。已预先选择身份验证选项。确保在完成流程时选择了这些选项。

   1. 选择OAuth2.0从认证方法菜单并完成身份验证细节。
   2. 选择授权码从格兰特类型菜单。这授予客户端用来交换访问令牌的临时代码。代码是从授权服务器获得的，您可以在授权服务器中看到客户机正在请求的信息。只有此授权类型才能启用安全用户模拟。这将显示回调URL，注册应用程序时使用。
   3. 选择请求主体从令牌授权菜单。
   4. 这个授权URL已预先填充：https://login.microsoftonline.com/{tenantID}/oauth2/authorize
   5. 这个令牌URL已预先填充：https://login.microsoftonline.com/{tenantID}/oauth2/token
   6. 确保输入以下内容范围:承租人，全部阅读
   7. 输入您的客户端ID．客户端ID是表示授权服务器唯一的客户端注册信息的字符串。您在配置OAuth客户端时收集这些信息和秘密。你需要添加回调URL您可以在集成配置页面上看到。
   8. 输入您的客户机密. 客户端密码是在设置目标应用程序集成时发出的唯一字符串。
   9. 在下面访问令牌参数，请确保为输入以下内容：名称:资源，及价值:https://analysis.windows.net/powerbi/api．
7. （可选）如果要激活此集成的速率限制，请启用请求速率限制切换并设置请求数每时间间隔．

8. （可选）启用登录中切换以保持24小时的日志记录以供支持。

9. 选择保存继续。
10. 在下面OAuth授权选择批准使用您的服务帐户登录。此时会出现一个弹出窗口，其中显示Power BI登录屏幕。
    1. 输入您的服务帐户用户名和密码，然后选择登录．
    2. 选择接受．

这个Microapp集成页面打开您添加的集成和它的微应用程序。从这里，您可以添加另一个集成，继续设置您的开箱即用微应用程序，或为该集成创建一个新的微应用程序。

现在可以设置和运行第一次数据同步了。有关同步规则、不满足其调度和否决规则的同步的完整信息，请参见同步数据．

有关API端点和表实体的更多细节，请参见Power BI连接器规格．

使用Power BI微应用

现有的Web/SaaS集成伴随着开箱即用的微应用。从这些微应用开始，并根据您的需要定制它们。

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

仪表盘：查看Power BI仪表板的详细信息。仪表板列表是个性化的，因此您只能在Power BI中看到作为Citrix工作区一部分的仪表板。

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

报告：查看Power BI报告的详细信息。报告列表是个性化的，因此您只能在Power BI中看到作为Citrix工作区一部分的报告。

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