练习 - 创建即时插件

8 分钟

在本练习中，您将构建一个即时插件来计算债务比。该插件可从 Power Apps 或 Power Automate 重复使用，并且不绑定到任何 Dataverse 表行。您还将构建一个即时插件，执行相同的计算，但使用 Dataverse 行中的数据。

重要提示

使用已预配 Microsoft Dataverse 且具有示例应用的测试环境。如果没有此环境，您可以注册 Power Apps 开发人员计划。

任务 - 准备环境

要准备环境，请按照以下步骤操作：

转到 Power Apps Maker Portal。
选择正确的环境，然后选择解决方案。
选择新建解决方案。
在显示名称中输入 Learn Low Code Plugins，在名称中输入 LearnLowCodePlugins，然后选择 + 新建发布服务器按钮。
在显示名称中输入 Contoso，在名称中输入 Contoso，在前缀中输入 contoso，然后选择保存。
选择您创建的 Contoso 发布服务器，然后选择创建。

构建一个计算债务比的插件

转到 Power Apps Maker Portal。
选择正确的环境，然后选择应用。
选择全部选项卡，选择 Dataverse Accelerator App，然后选择播放按钮。
选择创建即时插件。
输入 Calculate Debt Ratio 作为显示名称，然后选择 + 新建输入参数。
输入 Income 作为标签，选择小数作为数据类型，然后选择 + 新建输入参数。
输入 HousingDebt 作为标签，选择小数作为数据类型，然后选择 + 新建输入参数。
输入 OtherDebt 作为标签，然后选择小数作为数据类型。
您现在应有三个输入参数。选择 + 新建输出参数。
输入 TotalDebtRatio 作为标签，选择小数作为数据类型，然后选择 + 新建输出参数。
输入 HousingDebtRatio 作为标签，然后选择小数作为数据类型。

您的输入和输出参数应类似于下图。
以下公式用于计算住房负债率和总负债率。将以下 Power Fx 公式粘贴到表达式字段中，然后展开高级选项部分。
```
 {TotalDebtRatio: ((HousingDebt + OtherDebt)/Income) * 100, HousingDebtRatio: (HousingDebt/Income) * 100};
```
在解决方案中选择您创建的 LearnLowCodePlugins 解决方案，然后选择全局。
选择保存，然后等待插件保存完毕。
选择在 API 操场中测试按钮。插件成功保存后，测试按钮会出现在屏幕右上角。
输入 12000 作为 Income，输入 4000 作为 HousingDebt，输入 4000 作为 OtherDebt，然后选择发送。
您应该会收到一个成功回复，其中包含计算得出的 TotalDebtRatio 和 HousingDebtRatio。

注意

如果遇到错误，可能是因为您的系统在后台插入 1,000 千位分隔符。导航回以在 Dataverse Accelerator App 中编辑 Calculate Debt Ratio。然后，将输入参数从小数类型更改为字符串类型，并将表达式替换为以下代码。然后更新并再次尝试您的测试。
```
{TotalDebtRatio: ((Value(HousingDebt) + Value(OtherDebt))/Value(Income)) * 100, HousingDebtRatio: (Value(HousingDebt)/Value(Income)) * 100};
```
您可以关闭 Dataverse Accelerator App 浏览器窗口或选项卡。

任务 - 生成计算联系人债务比的插件

导航到 Power Apps Maker Portal。
选择正确的环境，然后选择解决方案。
打开您创建的 Learn Low Code Plugins 解决方案。
选择添加现有项，然后选择表
选择 Contact 表，然后选择下一步。
选择包括所有对象按钮，然后选择添加以将“Contact”表添加到您的解决方案。
返回到您的解决方案，打开您刚刚添加到解决方案的 Contact 表。
选择新建，然后选择列。
在“显示名称”中输入 Housing Debt，“数据类型”选择 Currency，然后选择保存。
选择 + 新建，然后再次选择列。
输入 Other Debt 作为显示名称，选择货币作为数据类型，然后选择保存。
筛选表以显示数据类型为货币的表。您添加的列应如下图所示。选择窗体。（如果您已将其他货币列添加到“Contact”表中，则可能会看到其他列。）选择返回以返回到“Contact”表设置。
选择窗体，然后打开主联系人窗体。
从左侧的表列窗格中，通过单击每个列将 Annual income、Housing debt 和 Other debt 列添加到窗体的底部。
选择保存并发布，然后等待发布完成。
选择 <- 后退按钮。
选择 Contact 表以返回到联系人表的主设置。
在联系人列和数据部分中选择编辑按钮。
选择新建行按钮旁边的 V 形按钮，然后选择使用窗体新建行。
选择名为联系人的视图以匹配下面的屏幕截图。（根据您如何设置窗体，它可能会为您显示不同的视图。）
输入 John 作为“First name”，输入 Doe 作为“Last name”，然后输入 120000 作为“Annual income”，输入 40000 作为“Housing debt”，输入 40000 作为“Other debt”。选择保存，但不要关闭屏幕。
保存后，URL 将更改为包含联系人 ID。从 URL 复制联系人 ID 并将其保存在记事本中。您将使用本 ID 测试插件。该 ID 是 URL 末尾的 GUID，“ID=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”。
选择保存并关闭。
选择完成。
选择后退按钮。
从左侧导航栏中选择返回到解决方案（向左键）按钮。
选择应用，然后选择全部选项卡，通过选择播放（省略号中的向右键）启动 Dataverse Accelerator App。
选择创建即时插件。
输入 Calculate Contact Debt Ratio 作为“显示名称”，然后选择新建输入参数。
输入 ThisRecord 作为“标签”，选择 EntityReference 作为“数据类型”，然后查找/选择该表的 Contact 表。
选择新建输出参数。
输入 HousingDebtRatio 作为“标签”，然后选择小数作为“数据类型”。
再次选择新建输出参数。
输入 TotalDebtRatio 作为“标签”，然后选择小数作为“数据类型”。

在表达式字段中粘贴以下表达式。如果总债务收入比高于 40%，此表达式会显示一个错误。

 {TotalDebtRatio: ((ThisRecord.'Housing Debt' + ThisRecord.'Other Debt')/ThisRecord.'Annual Income') * 100, HousingDebtRatio: (ThisRecord.'Other Debt'/ThisRecord.'Annual Income') * 100}

展开高级选项部分。
针对“解决方案”选择 LearnLowCodePlugins。
选择实体的范围，然后从下拉列表中选择 Contact 表。
选择保存，然后等待插件完成保存。
在应用成功保存后，选择屏幕右上角显示的在 API 操场中测试按钮。
粘贴您之前复制的联系人 ID，然后选择发送。
您应该会收到一个成功回复，其中包含计算得出的“total debt”和“housing debt”值。

反馈

此页面是否有帮助？