设置和使用新闻控件

项目
01/11/2024

备注

这描述了当前使用经典编辑器引入控件的过程。在恰当的时候，会进行迁移，以便可以在新型窗体编辑器中执行。

从有关您的客户、竞争对手和联系人的最新新闻中获得宝贵见解。通过向您显示有关客户和竞争对手的实时上下文信息掌握新闻动态，从而帮助您保持竞争优势。安装新闻 Power Apps component framework 控件，此控件传递来自必应资讯的相关新闻。

客户窗体中的新闻控件。

您可以自定义来支持其他新闻源、PCF 控件的外观和行为。有关详细信息，请参阅新闻控件 GitHub 存储库中的自述文件。

将公司新闻控件添加到客户主窗体

本文中的步骤将公司新闻控件添加到已经配置为查询从必应资讯收集的新闻主题的客户主窗体中。您可以使用相似的步骤向其他表（例如联系人和竞争对手）的主窗体添加控件。

获取必应资讯 API 密钥和 URL

新闻控件需要一个新闻 API URL、API 密钥和更多新闻 URL。对于必应资讯，此控件中已将更多新闻 URL 预先配置为使用 *https://www.bing.com/news/search*。对于新闻 API URL 和 API 密钥，您需要通过在您的 Azure 帐户下创建必应搜索 Azure 资源来提供。创建后，您将在密钥和终结点部分下获得 API 密钥和 API URL。

必应搜索服务 API 密钥和终结点。

导入公司新闻解决方案

转到新闻控件 GitHub 存储库。
下载 Solutions.zip。为此，打开 Solutions 文件夹，打开 Solutions.zip，然后选择下载。
登录到 Power Apps，然后在右上角选择您要安装公司新闻控件的环境。
在左窗格中选择解决方案，然后在命令栏中选择导入。如果项目不在侧面板窗格中，请选择 …更多，然后选择所需项目。
在“导入解决方案向导”中，选择选择文件，浏览并选择 Solutions.zip，然后选择打开。
选择下一步，然后再次选择下一步完成导入。

将控件添加到客户主窗体

在 Power Apps 中的右上角，选择设置（齿轮），然后选择高级设置。
转到设置 > 自定义 > 自定义系统。
在左侧导航树中，展开表 > 客户，选择窗体，然后打开客户主窗体。
在窗体编辑器中，添加两个新的文本列，它们将用于将密钥和基本 URL 传递到新闻组件。

a. 从右侧导航列资源管理器中选择新建列。

b. 对于显示名称和名称，输入 newsapikey。保留其他设置为默认值，然后选择保存并关闭。

c. 重复前两个步骤以创建其他文本列。对于显示名称和名称，输入 newsurl。保留其他设置为默认值，然后选择保存并关闭。
在窗体编辑器中，选择窗体上您需要公司新闻控件的位置，然后选择插入选项卡 > 部分 > 一列。
若要按客户名称显示新闻，请将客户名称列从右侧的列资源管理器窗格拖放到新创建的部分中。
选择部分，然后选择更改属性。为部分输入描述性的名称，如公司新闻。您可能需要选中在窗体上显示此部分的标签，为部分提供标题。选择确定。
选择新添加的客户名称列，然后在主页选项卡上选择更改属性。在列属性页面上，选择控件选项卡，选择添加控件，选择 companynews 控件，然后选择添加。
为 apikey 和 baseurl 列配置以下绑定。

a. 选择 APIKey 旁边的配置属性（铅笔图标）。

b. 从绑定到列上的值下拉列表中，选择 new_newsapikey (SingleLine.Text)，然后选择确定。

c. 选择 BaseURL 旁边的配置属性（铅笔图标）。

d. 从绑定到列上的值下拉列表中，选择 new_newsurl (SingleLine.Text)，然后选择确定。

e. 在列属性页面上，选择 Web、电话和平板电脑客户端选项。

f. 在列属性页面上，选择显示选项卡，清除在窗体上显示标签选项，然后选择确定。
若要提供 API 密钥和基础 URL 默认值，请使用业务规则。从窗体编辑器中选择业务规则，然后从右窗格底部选择新建业务规则。
在业务规则设计器中，在设计器画布上选择条件，将列设置为客户名称并将运算符设置为包含数据，然后选择应用。然后，选择组件选项卡，拖动设置列值操作，提供一个列值，其中列是 newsapikey，值是您从必应搜索属性中复制的密钥。创建另一个设置列值操作，其中列是 newsurl，值添加您从必应搜索属性复制的终结点。确保在新闻 URL 的末尾追加 /v7.0/news/search。最终的 URL 应类似于 https://api.bing.microsoft.com/v7.0/news/search。
保存并激活规则。关闭业务规则设计器。
确保将新添加的列（newsapikey 和 newsurl）添加到客户主窗体中。
对于添加了 newsapikey 和 newsurl 列的窗体选项卡属性，清除默认情况下可见。
在窗体设计器中，选择保存，然后选择发布。