JScript Web资源 - 芒果文档

📌 相关文章

📜 JScript Web资源

📅 最后修改于: 2020-11-20 06:01:25 🧑 作者: Mango

JScript Web资源可能是将与Microsoft Dynamics CRM一起使用的最重要的Web资源类型。

JavaScript在CRM中的应用

表单事件编程

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

网络资源

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

使用唯一的URL打开表单，视图和对话框。
使用OData和SOAP端点与Web服务进行交互。
在其他Web资源(例如HTML Web资源)中引用JavaScript代码。

在这种情况下，您将编写JavaScript代码(使用Xrm.Page模型)并将其添加为CRM中的JScript Web资源，然后可以在任何地方使用唯一的URI进行引用。

功能区自定义

最后，JavaScript的另一种常用用法是处理功能区自定义，例如-

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

为了处理这种情况，您将编写JavaScript逻辑(使用Xrm.Page模型)，然后将其添加为JScript Web资源。然后，可以在功能区按钮的XML中引用此Web资源，并且我们可以指定在哪个JScript文件中调用哪个方法来检查是否应该显示/隐藏或启用/禁用功能区按钮或处理单击事件。

Xrm.Page对象模型

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

XRM页面对象模型

命名空间

Sr.No	Object & Description
1	Context Provides methods to retrieve context-specific information such as organization details, logged-in user details, or parameters that were passed to the form in a query string.
2	Data Provides access to the entity data and methods to manage the data in the form as well as in the business process flow control.
3	UI Contains methods to retrieve information about the user interface, in addition to collections for several sub-components of the form.

Sr.No

Object & Description

Context

Provides methods to retrieve context-specific information such as organization details, logged-in user details, or parameters that were passed to the form in a query string.

Data

Provides access to the entity data and methods to manage the data in the form as well as in the business process flow control.

Contains methods to retrieve information about the user interface, in addition to collections for several sub-components of the form.

对象

Sr.No	Object & Description
1	Entity Provides method to − Retrieve record information Save method Collection attributes
2	Process Methods to retrieve properties of business process flow.
3	Navigation Provides access to navigation items using items collection.
4	FormSelector Uses Items collection to access available forms to the user. Also uses the navigation method to close and open forms.
5	Stages Each process has a collection of stages that can be accessed using getStages method of process.
6	Steps Each stage comprises of various steps that can be accessed using getSteps method of stage.

馆藏

Sr.No	Collections & Description
1	Attributes Provides access to entity attributes available on the form.
2	Controls ui.controls − Provides access to each control present on the form. attribute.controls − Provides access to all the controls within an attribute. section.controls − Provides access to all the controls within a section.
3	Items Provides access to all the navigation items on a form.
4	Tabs Provides access to all the tabs on a form.
5	Sections Provides access to all the sections on a form.

表单编程中支持的事件

使用Xrm.Page模型进行表单编程可让您处理以下表单事件-

负载
onSave
onChange
TabStateChange
OnReadyStateComplete
预搜索
业务流程控制事件

表格程式设计范例

在此示例中，我们将基于用户选择的PreferredMethodofCommunication在Contact表单上进行一些验证。因此，如果用户选择他/她的首选方法作为“电子邮件”，则“电子邮件”字段应成为必填字段，并且对于“电话”和“传真”的其他字段也应类似。

步骤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-单击表单属性。

表格编程表格属性