JScript 网页资源

---

---

JScript 网页资源可能是您在使用 Microsoft Dynamics CRM 时最常使用的一类网页资源。

JavaScript 在 CRM 中的应用

表单事件编程

表单事件编程用于处理客户端行为，例如用户打开表单、更改某些数据、在选项卡之间移动等时发生的情况。为了实现这种客户端交互，您需要编写 JavaScript 代码并将其作为 JScript 网页资源添加到 CRM 中。但是，您编写的 JavaScript 代码必须使用 Dynamic CRM 的 Xrm.Page 模型，而不是标准的 JavaScript DOM。使用 Xrm.Page 模型是 Microsoft 的编码方式，它确保使用此模型编写的任何代码都与 CRM 的任何未来版本兼容。

网页资源

除了用于表单事件编程之外，JavaScript 还用于 CRM 的其他应用程序，例如：

• 使用唯一的 URL 打开表单、视图和对话框。

• 使用 OData 和 SOAP 端点与 Web 服务交互。

• 在其他网页资源（如 HTML 网页资源）中引用 JavaScript 代码。

在这种情况下，您将编写 JavaScript 代码（使用 Xrm.Page 模型）并将其作为 JScript 网页资源添加到 CRM 中，然后可以通过唯一的 URI 在任何地方引用它。

功能区自定义

最后，JavaScript 的另一个常见用途是处理功能区自定义，例如：

• 根据某些逻辑显示/隐藏功能区按钮
• 根据某些逻辑启用/禁用功能区按钮
• 处理单击特定功能区按钮时发生的情况

为了处理此类场景，您将编写 JavaScript 逻辑（使用 Xrm.Page 模型），然后将其作为 JScript 网页资源添加。然后可以在功能区按钮的 XML 中引用此网页资源，并指定要调用的 JScript 文件中的哪个方法来检查是否应显示/隐藏或启用/禁用功能区按钮或处理单击事件。

Xrm.Page 对象模型

以下是 Xrm.Page 对象的层次结构，显示了可用的命名空间、对象及其集合。在编写 JScript 代码时，您将使用这些属性。

命名空间

对象

集合

表单编程中支持的事件

使用 Xrm.Page 模型的表单编程允许您处理以下表单事件：

• onLoad
• onSave
• onChange
• TabStateChange
• OnReadyStateComplete
• PreSearch
• 业务流程流控制事件

表单编程示例

在此示例中，我们将根据用户选择的 PreferredMethodofCommunication 对联系人表单进行一些验证。因此，如果用户选择电子邮件作为首选方法，则电子邮件字段将变为必填字段，电话和传真字段也类似。

步骤 1 - 创建一个名为 contacts.js 的 JavaScript 文件，并复制以下代码。

function validatePreferredMethodOfCommunication() { 

   //get the value of Preffered Method of Communication code 
   var prefferedContactMethodCode = 
      Xrm.Page.getAttribute('preferredcontactmetho dcode').getValue();  
   
   //if Preferred Method = Any, make all fields as non-mandatory 
   
   //else if Preferred Method = Phone, make Mobile Phone field mandatory 
   //and all other fields as non-mandatory 
   
   //else if Preferred Method = Fax, make Fax field mandatory 
   //and all other fields as non-mandatory 
   
   if(prefferedContactMethodCode == 1) { 
      clearAllMandatoryFields(); 
   }  
   if(prefferedContactMethodCode == 2) { 
      clearAllMandatoryFields(); 
      Xrm.Page.getAttribute('emailaddress1').setRequiredLevel('required'); 
   } else if(prefferedContactMethodCode == 3) { 
      clearAllMandatoryFields(); 
      Xrm.Page.getAttribute('mobilephone').setRequiredLevel('required'); 
   } else if(prefferedContactMethodCode == 4) { 
      clearAllMandatoryFields(); 
      Xrm.Page.getAttribute('fax').setRequiredLevel('required'); 
   } 
} 
function clearAllMandatoryFields() { 
   
   //clear all mandatory fields 
   Xrm.Page.getAttribute('emailaddress1').setRequiredLevel('none'); 
   Xrm.Page.getAttribute('mobilephone').setRequiredLevel('none'); 
   Xrm.Page.getAttribute('fax').setRequiredLevel('none'); 
}

步骤 2 - 通过导航到设置→自定义→自定义系统→联系人实体→表单→主表单打开联系人实体表单。

步骤 3 - 单击表单属性。

步骤 4 - 在表单属性窗口中，单击添加。

步骤 5 - 在下一个查找网页资源记录窗口中，单击新建，因为我们正在创建新的网页资源。

步骤 6 - 在新建网页资源窗口中，输入以下详细信息：

名称 - new_contacts.js

显示名称 - contacts.js

类型 - JScript

上传文件 - 从本地计算机上传您创建的 JavaScript 文件。

步骤 7 - 单击保存，然后单击发布。之后关闭窗口，您将返回到查找网页资源记录窗口。

步骤 8 - 在这里，您现在可以看到 new_contacts.js 网页资源。选择它并单击添加。您现在已成功添加新的网页资源并在表单上注册了它。

步骤 9 - 现在，我们将添加一个事件处理程序来处理首选通信方式字段的更改。此事件处理程序将调用我们刚刚编写的 JavaScript 函数。从事件处理程序部分选择以下选项。

控件 - 首选通信方式

事件 - OnChange

然后，单击添加按钮，如下面的屏幕截图所示。

步骤 10 - 在处理程序属性的下一个窗口中，我们将指定更改事件发生时要调用的方法。

选择库为 new_contacts.js，函数为 validatePreferredMethodOfCommunication。单击确定。

步骤 11 - 您现在将能够看到表单库（网页资源）和在其上注册的事件。单击确定。

步骤 12 - 单击保存，然后单击发布。

步骤 13 - 现在打开任何联系人表单并将首选通信方式设置为电话。这将使手机字段变为必填字段。如果您现在尝试在不输入任何手机号码的情况下保存此联系人，它将显示一条错误消息，提示“您必须为手机提供值”。

结论

在本章中，我们首先了解了 JavaScript 在 CRM 中的三个重要应用。之后，我们探讨了 Xrm.Page 模型并使用它来学习表单编程以及一个示例。