练习 - 使用客户端脚本中的表数据
在本练习中,您可使用客户端脚本,实现基于相关表中的值在所需窗体上生成列的业务要求。 您可基于“质询”表中的列值,在“创新质询”示例应用的“想法”窗体上设置列的要求级别。 要完成本练习,您将使用 Xrm.WebAPI 方法检索相关数据。
重要提示
使用已预配 Microsoft Dataverse 并已启用示例应用的测试环境。 如无社区计划,您可以注册社区计划。
任务 - 准备解决方案
在本任务中,您可创建解决方案,将现有表添加到该解决方案,添加新列,并准备已添加到解决方案的表之一的主窗体。
导航到 Power Apps Maker Portal 并确保您处于已启用示例应用的正确环境中。
选择解决方案,然后选择 + 新建解决方案。
为显示名称输入创新质询 Web API,为发布者选择 CDS default publisher,然后单击创建。
您创建的创新质询 Web API 解决方案应打开。
选择 + 添加现有项,然后选择表。
在“搜索”文本框中输入想法,选择想法,然后选择下一步。
注意
如果您找不到想法表,则您的环境中可能没有示例应用。 选择另一个环境或创建一个安装了示例应用的新环境。
选择编辑对象按钮。
选择窗体选项卡,为信息窗体选择主要窗体类型,然后选择添加。
再次选择添加。
选择 + 添加现有项,然后再次选择表。
搜索质询,选择质询,然后选择下一步。
选择编辑对象按钮。
选择窗体选项卡,为信息窗体选择主要窗体类型,然后选择添加。
再次选择添加。
打开您刚刚添加到解决方案的质询表。
选择 + 新建,然后选择列。 您将添加两列,以指示为此质询创建的想法行所需的数据。
为显示名称输入需要投资,为数据类型选择选项 | 是/否,展开高级选项。 记下架构名称的前缀;您的前缀是不同的。 当您创建脚本,并引用您添加的字段时,需要这个前缀。
选择保存。
选择 + 新建,然后再次选择列。
为显示名称输入需要 ROI,为数据类型选择选项 | 是/否,然后选择保存。
展开左侧的质询表,然后选择窗体。
打开您添加到解决方案中的信息窗体。
选择表列选项卡。
将需要投资列添加到窗体。
将需要 ROI 添加到窗体。
现在,窗体应如下图所示。 选择保存并发布。 等待发布完成。
通过选择后退按钮返回到解决方案。
任务 - 创建客户端脚本
在本任务中,您会创建一个脚本,该脚本将基于“质询”表列值在“想法”表上设置列的所需级别。
启动 Visual Studio Code 的新实例或使用您最喜欢的代码编辑器。 您可以下载并安装 Visual Studio Code。
选择打开文件夹。
在文档文件夹中创建文件夹并将其命名为 ClientScriptLab。
选择您创建的 ClientScriptLab 文件夹,然后选择选择文件夹按钮。
将鼠标悬停在 CLIENTSCRIPTLAB 文件夹上,然后选择新建文件。
将文件命名为 IdeaForm.js。
将下面的函数添加到 IdeaForm.js。 您的函数应具有唯一名称或使用命名空间以确保唯一性。
function LearnLab_handleIdeaOnLoad(executionContext) { } function LearnLab_handleChallengeOnChange(executionContext) { }将此脚本添加到 OnLoad 函数。 本脚本将注册 OnChange 事件处理程序,如果相关质询发生更改,您需要处理 OnChange。
var formContext = executionContext.getFormContext(); formContext.getAttribute('sample_originatingchallengeid').addOnChange(LearnLab_handleChallengeOnChange);将此脚本添加到 OnChange 函数。 本代码仅获取 formContext。
var formContext = executionContext.getFormContext();将此函数添加到 IdeaForm 文件。 本函数会从 OnLoad 和 OnChange 函数中调用,formContext 会作为参数传递。 这是您实现业务逻辑以设置要求级别的位置。
function LearnLab_setRequiredFields(formContext) { }您首先要获取质询查找值。 将此脚本添加到 setRequiredFields 函数中。 我们已在解决方案资源管理器中从列的属性中获取了
sample_originatingchallengeid。var challenge = formContext.getAttribute('sample_originatingchallengeid').getValue();然后,您可检查质询值是否为 null。 将此脚本添加到 setRequiredFields 函数中。
if (challenge != null) { } else{ }如果质询为 null,则这些列是非必需的。 在 else 中添加此脚本。 这样可确保如果未选择质询,则不需要这些列。
formContext.getAttribute("sample_investmentrequired").setRequiredLevel('none'); formContext.getAttribute("sample_timetoroimonths").setRequiredLevel('none');现在,您的 IdeaForm 应如下图所示。
如果质询不为 null,您可获得相关质询的 ID。 在 if 语句中添加此脚本。
var challengeId = challenge[0].id;现在,您可使用 WebAPI 检索质询行,并且仅选择您感兴趣的两个列:InvestmentRequired 和 ROIRequired。 在 if 语句中添加脚本。
注意
将 crc8c 替换为任务 1 中的前缀。
Xrm.WebApi.retrieveRecord("sample_challenge", challengeId, "?$select=crc8c_investmentrequired,crc8c_roirequired").then( function success(result) { }, function (error) { } );如果 retrieveRecord 成功,您可首先创建两个变量来保存两列的要求值,并将其初始值设置为非必需。 之后,您可检查这些列是否是必需的,并相应地设置要求变量。 最后,将列要求设置为您创建的变量的值。 在 success 函数中添加此脚本。 用您创建的列的前缀替换 cr07c_investmentrequired 和 cr07c_roirequired 的前缀 cr07c_。
注意
将 crc8c 替换为任务 1 中的前缀。
var investmentRequired = 'none'; var roiRequired = 'none'; if (result.cr07c_investmentrequired) { investmentRequired = 'required'; } if (result.cr07c_roirequired) { roiRequired = 'required'; } formContext.getAttribute("sample_investmentrequired").setRequiredLevel(investmentRequired); formContext.getAttribute("sample_timetoroimonths").setRequiredLevel(roiRequired);如果 retrieveRecord 导致错误,请记录错误消息。 在 error 函数中添加此脚本。 您还可以使用 Xrm.Navigation 中的方法,以向用户显示具有适当选项的对话框(如有必要)。
console.log(error.message);现在,LearnLab_setRequiredFileds 函数应如下图所示。
您可从 OnLoad 和 OnChange 函数中调用 LearnLab_setRequiredFileds。 将此脚本添加到 OnLoad 和 OnChange 函数。
LearnLab_setRequiredFields(formContext)现在,您的 IdeaForm 应如下图所示。
选择文件和全部保存。
任务 - 上传脚本
在本任务中,您要将创建的脚本加载到您的环境中。
导航到 Power Apps Maker Portal 并确保处于正确的环境中。
选择解决方案,然后打开 Innovation Challenge Web API 解决方案。
选择 + 新建,然后选择更多 | Web 资源。
为名称输入 IdeaForm.js,为显示名称输入 IdeaForm.js,为类型选择 JavaScript (JS),然后选择选择文件。
选择您之前创建的 IdeaForm.js 文件,然后选择打开。
选择保存。
您的解决方案现在应具有质询表、想法表和 IdeaForm.js Web 资源。
请勿导航离开本页面。
任务 - 编辑窗体
在本任务中,您将 JavaScript 库添加到“想法”主窗体,并为“加载时”事件添加事件处理程序。
确保您仍在使用创新质询 Web API 解决方案。
展开想法表,并选择窗体。
打开主信息窗体。
选择窗体库选项卡。
选择 + 添加库。
在搜索文本框中输入想法并按 Enter。 选择 IdeaForm.js,然后选择添加。
从右侧选择事件选项卡。
展开 On Load 部分,然后选择 + 事件处理程序。
为函数输入 LearnLab_handleIdeaOnLoad,选中将执行上下文作为第一个参数传递复选框,然后选择完成。
选择保存并发布,然后等待发布完成。
选择后退按钮。
选择全部。
选择发布所有自定义,然后等待发布完成。
任务 - 测试
在本任务中,您可测试脚本。
导航到 Power Apps Maker Portal 并确保处于正确的环境中。
选择应用,然后启动 Innovation Challenge 应用程序。
选择质询并打开一个质询行。
需要投资和需要 ROI 应该为空。 选择相关并选择想法。
打开一个想法。
清除需要投资和 ROI 时间(月) 列值。
由于“质询”表上的要求列为空,因此这些列不是必需的。 选择后退按钮。
选择“详细信息”选项卡并为需要投资和需要 ROI 选择“是”。
选择想法选项卡,然后打开上次选择的同一想法。
现在,这两个列应该是必需的。