练习 - 使用客户端脚本中的表数据

已完成

在本练习中,您可使用客户端脚本,实现基于相关表中的值在所需窗体上生成列的业务要求。 您可基于“质询”表中的列值,在“创新质询”示例应用的“想法”窗体上设置列的要求级别。 要完成本练习,您将使用 Xrm.WebAPI 方法检索相关数据。

重要提示

使用已预配 Microsoft Dataverse 并已启用示例应用的测试环境。 如无社区计划,您可以注册社区计划。

任务 - 准备解决方案

在本任务中,您可创建解决方案,将现有表添加到该解决方案,添加新列,并准备已添加到解决方案的表之一的主窗体。

  1. 导航到 Power Apps Maker Portal 并确保您处于已启用示例应用的正确环境中。

  2. 选择解决方案,然后选择 + 新建解决方案。

  3. 为显示名称输入创新质询 Web API,为发布者选择 CDS default publisher,然后单击创建。

  4. 您创建的创新质询 Web API 解决方案应打开。

  5. 选择 + 添加现有项,然后选择表。

  6. 在“搜索”文本框中输入想法,选择想法,然后选择下一步。

    注意

    如果您找不到想法表,则您的环境中可能没有示例应用。 选择另一个环境或创建一个安装了示例应用的新环境。

  7. 选择编辑对象按钮。

  8. 选择窗体选项卡,为信息窗体选择主要窗体类型,然后选择添加。

  9. 再次选择添加。

  10. 选择 + 添加现有项,然后再次选择表。

  11. 搜索质询,选择质询,然后选择下一步。

  12. 选择编辑对象按钮。

  13. 选择窗体选项卡,为信息窗体选择主要窗体类型,然后选择添加。

  14. 再次选择添加。

  15. 打开您刚刚添加到解决方案的质询表。

  16. 选择 + 新建,然后选择列。 您将添加两列,以指示为此质询创建的想法行所需的数据。

  17. 为显示名称输入需要投资,为数据类型选择选项 | 是/否,展开高级选项。 记下架构名称的前缀;您的前缀是不同的。 当您创建脚本,并引用您添加的字段时,需要这个前缀。

  18. 选择保存。

  19. 选择 + 新建,然后再次选择列。

  20. 为显示名称输入需要 ROI,为数据类型选择选项 | 是/否,然后选择保存。

  21. 展开左侧的质询表,然后选择窗体。

  22. 打开您添加到解决方案中的信息窗体。

  23. 选择表列选项卡。

  24. 将需要投资列添加到窗体。

  25. 将需要 ROI 添加到窗体。

  26. 现在,窗体应如下图所示。 选择保存并发布。 等待发布完成。

  27. 通过选择后退按钮返回到解决方案。

任务 - 创建客户端脚本

在本任务中,您会创建一个脚本,该脚本将基于“质询”表列值在“想法”表上设置列的所需级别。

  1. 启动 Visual Studio Code 的新实例或使用您最喜欢的代码编辑器。 您可以下载并安装 Visual Studio Code。

  2. 选择打开文件夹。

  3. 在文档文件夹中创建文件夹并将其命名为 ClientScriptLab。

  4. 选择您创建的 ClientScriptLab 文件夹,然后选择选择文件夹按钮。

  5. 将鼠标悬停在 CLIENTSCRIPTLAB 文件夹上,然后选择新建文件。

  6. 将文件命名为 IdeaForm.js。

  7. 将下面的函数添加到 IdeaForm.js。 您的函数应具有唯一名称或使用命名空间以确保唯一性。

    function LearnLab_handleIdeaOnLoad(executionContext) {
    }
    function LearnLab_handleChallengeOnChange(executionContext) {
    }
    
  8. 将此脚本添加到 OnLoad 函数。 本脚本将注册 OnChange 事件处理程序,如果相关质询发生更改,您需要处理 OnChange。

    var formContext = executionContext.getFormContext();
    formContext.getAttribute('sample_originatingchallengeid').addOnChange(LearnLab_handleChallengeOnChange);
    
  9. 将此脚本添加到 OnChange 函数。 本代码仅获取 formContext。

    var formContext = executionContext.getFormContext();
    
  10. 将此函数添加到 IdeaForm 文件。 本函数会从 OnLoad 和 OnChange 函数中调用,formContext 会作为参数传递。 这是您实现业务逻辑以设置要求级别的位置。

    function LearnLab_setRequiredFields(formContext) {
    }
    
  11. 您首先要获取质询查找值。 将此脚本添加到 setRequiredFields 函数中。 我们已在解决方案资源管理器中从列的属性中获取了 sample_originatingchallengeid。

    var challenge = formContext.getAttribute('sample_originatingchallengeid').getValue();
    
  12. 然后,您可检查质询值是否为 null。 将此脚本添加到 setRequiredFields 函数中。

    if (challenge != null) {
        }
        else{
        }
    
  13. 如果质询为 null,则这些列是非必需的。 在 else 中添加此脚本。 这样可确保如果未选择质询,则不需要这些列。

    formContext.getAttribute("sample_investmentrequired").setRequiredLevel('none');
    formContext.getAttribute("sample_timetoroimonths").setRequiredLevel('none');
    
  14. 现在,您的 IdeaForm 应如下图所示。

  15. 如果质询不为 null,您可获得相关质询的 ID。 在 if 语句中添加此脚本。

    var challengeId = challenge[0].id;
    
  16. 现在,您可使用 WebAPI 检索质询行,并且仅选择您感兴趣的两个列:InvestmentRequired 和 ROIRequired。 在 if 语句中添加脚本。

    注意

    将 crc8c 替换为任务 1 中的前缀。

    Xrm.WebApi.retrieveRecord("sample_challenge", challengeId, "?$select=crc8c_investmentrequired,crc8c_roirequired").then(
                function success(result) {
                },
                function (error) {
                }
            );
    
  17. 如果 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);
    
  18. 如果 retrieveRecord 导致错误,请记录错误消息。 在 error 函数中添加此脚本。 您还可以使用 Xrm.Navigation 中的方法,以向用户显示具有适当选项的对话框(如有必要)。

    console.log(error.message);
    
  19. 现在,LearnLab_setRequiredFileds 函数应如下图所示。

  20. 您可从 OnLoad 和 OnChange 函数中调用 LearnLab_setRequiredFileds。 将此脚本添加到 OnLoad 和 OnChange 函数。

    LearnLab_setRequiredFields(formContext)
    
  21. 现在,您的 IdeaForm 应如下图所示。

  22. 选择文件和全部保存。

任务 - 上传脚本

在本任务中,您要将创建的脚本加载到您的环境中。

  1. 导航到 Power Apps Maker Portal 并确保处于正确的环境中。

  2. 选择解决方案,然后打开 Innovation Challenge Web API 解决方案。

  3. 选择 + 新建,然后选择更多 | Web 资源。

  4. 为名称输入 IdeaForm.js,为显示名称输入 IdeaForm.js,为类型选择 JavaScript (JS),然后选择选择文件。

  5. 选择您之前创建的 IdeaForm.js 文件,然后选择打开。

  6. 选择保存。

  7. 您的解决方案现在应具有质询表、想法表和 IdeaForm.js Web 资源。

  8. 请勿导航离开本页面。

任务 - 编辑窗体

在本任务中,您将 JavaScript 库添加到“想法”主窗体,并为“加载时”事件添加事件处理程序。

  1. 确保您仍在使用创新质询 Web API 解决方案。

  2. 展开想法表,并选择窗体。

  3. 打开主信息窗体。

  4. 选择窗体库选项卡。

  5. 选择 + 添加库。

  6. 在搜索文本框中输入想法并按 Enter。 选择 IdeaForm.js,然后选择添加。

  7. 从右侧选择事件选项卡。

  8. 展开 On Load 部分,然后选择 + 事件处理程序。

  9. 为函数输入 LearnLab_handleIdeaOnLoad,选中将执行上下文作为第一个参数传递复选框,然后选择完成。

  10. 选择保存并发布,然后等待发布完成。

  11. 选择后退按钮。

  12. 选择全部。

  13. 选择发布所有自定义,然后等待发布完成。

任务 - 测试

在本任务中,您可测试脚本。

  1. 导航到 Power Apps Maker Portal 并确保处于正确的环境中。

  2. 选择应用,然后启动 Innovation Challenge 应用程序。

  3. 选择质询并打开一个质询行。

  4. 需要投资和需要 ROI 应该为空。 选择相关并选择想法。

  5. 打开一个想法。

  6. 清除需要投资和 ROI 时间(月) 列值。

  7. 由于“质询”表上的要求列为空,因此这些列不是必需的。 选择后退按钮。

  8. 选择“详细信息”选项卡并为需要投资和需要 ROI 选择“是”。

  9. 选择想法选项卡,然后打开上次选择的同一想法。

  10. 现在,这两个列应该是必需的。