首页 > 代码库 > Dynamic CRM 2013学习笔记(五)禁止修改审批通过后的单据

Dynamic CRM 2013学习笔记(五)禁止修改审批通过后的单据

Dynamic CRM 2013学习笔记(一)插件输入实体参数解析

Dynamic CRM 2013学习笔记(二)插件基本用法及调试

Dynamic CRM 2013学习笔记(三)快速创建实体 EntityCreater

Dynamic CRM 2013学习笔记(四)单据编号及插件批量注册工具

 

 

审批通过后的单据,一般要对其进行控制,不能修改,不能添加,删除等,下面分别介绍下如何实现:

 

一、 禁止修改:

1. 主表控制,如果页面上审批状态为审批中或审批通过,就把整个页面都disable掉

  1: function controlReadonly() {
  2:     var status = Xrm.Page.data.entity.attributes.get("new_approval_status").getValue();
  3:     if (status == 2 || status == 3)//审批中或者审批通过
  4:     {
  5:         var controls = Xrm.Page.ui.controls.get();
  6:         for (var i in controls) {
  7:             var control = controls[i];
  8:             control.setDisabled(true);
  9:         }
 10:     }
 11: }

         

          2. 子表控制, 如果有子表,也要让其不能修改

          首先查找主表的approval status,如果是审批中或审批通过就disable整个子表

  1: function disableSubForm() {
  2:     var marketingPlan = Xrm.Page.getAttribute("new_marketing_planid").getValue();
  3:     if (marketingPlan != null) {
  4:         var filter = "new_marketing_planSet?$select=new_approval_status&$filter=new_marketing_planId eq guid‘" + marketingPlan[0].id + "";
  5:         var status = Query_ent(filter);
  6:         if (status != null && status.new_approval_status != null) {
  7:             if (status.new_approval_status.Value =http://www.mamicode.com/= 3 || status.new_approval_status.Value == 2) {>
  8:                 controlReadOnly();
  9:             }
 10:         }
 11:     }
 12: }

二、禁止添加及删除子表记录

通过上面的js控制,页面上的所有字段确实被disable了,但子表的subgrid及子表页面上的添加及删除按钮没有被控制住。所以决定写一个通用的插件来控制添加及删除。
1. 下图显示了如何在主表上注册这个通用插件
image_thumb 

这里 message为Delete,是对delete的控制;如果是Create,就要设置成post-operation,才能对添加进行控制。

重点是右边的Unsecure Configuration的配置:

  • 传入的条件

<filter type="or">
  <condition attribute="new_approval_status" operator="eq" value="http://www.mamicode.com/2" />
  <condition attribute="new_approval_status" operator="eq" value="http://www.mamicode.com/3" />
</filter>

  • 如果满足这个条件就报这个error

<check error="Cannot delete when approval status is approving or approved !">

 

2. 子表上注册

子表上没有approval status这个字段,这个字段只在主表上有,但又要依赖这个字段来控制子表,怎么办?

这时就要指定进行如下的配置了:

  1: <check error="Cannot delete sub-form when main form is approving or approved!">    
  2:  <link-entity name="new_marketing_plan" to="new_marketing_planid">        
  3:   <filter type="or">            
  4:    <condition attribute="new_approval_status" operator="eq" value="http://www.mamicode.com/2" />            
  5:    <condition attribute="new_approval_status" operator="eq" value="http://www.mamicode.com/3" />        
  6:   </filter>    
  7:  </link-entity>
  8: </check>
简单介绍下这里的配置,跟主表的配置相比,只是多了个link-entity:
<link-entity name="new_marketing_plan" to="new_marketing_planid">   
name指的是主表的实体, to指的是子表中link到主表实体的字段
 

三、 技术实现

1. 通过一个参数的构造函数来读取unsecure configuration里的配置
  1: public EntityCheck(string unsecure)
  2: {
  3:     m_Config = unsecure;
  4: }
Microsoft Dynamics CRM 平台支持可选的插件构造函数,该函数接受一个或两个字符串参数。如果编写此类构造函数,则可以在运行时向插件传递任何信息字符串。
以下示例显示构造函数的格式。在此示例中,插件类名为 SamplePlugin。
public SamplePlugin()public SamplePlugin(string unsecure)public SamplePlugin(string unsecure, string secure)

构造函数的第一个字符串参数包含公共(不安全)信息。第二个字符串参数包含非公共(安全)信息。在这里,安全是指加密的值,而不安全是指未加密的值。如果使用带脱机访问功能的 Microsoft Dynamics CRM for Microsoft Office Outlook,则 CRM for Outlook 脱机时安全字符串不会传递到执行的插件。

在这些字符串中传递到插件构造函数的信息是在 Microsoft Dynamics CRM 中注册插件时指定的。使用插件注册工具注册插件时,可以在“注册新步骤”窗体提供的“安全配置”和“不安全配置”字段中输入安全信息和不安全信息。使用 Microsoft Dynamics CRM SDK 以编程方式注册插件时,SdkMessageProcessingStep.Configuration 包含不安全的值,SdkMessageProcessingStep.SecureConfigId 引用包含安全值的 SdkMessageProcessingStepSecureConfig 记录。

 
2. 读取link-entity
  1: XmlNodeList linkEntityNodeList = linkEntityNode.SelectNodes("link-entity");
  2: if (linkEntityNodeList != null)
  3: {
  4:     foreach (XmlNode subLinkEntityNode in linkEntityNodeList)
  5:     {
  6:         LinkEntity subLe = GetLinkEntity(subLinkEntityNode);
  7:         le.LinkEntities.Add(subLe);
  8:     }
  9: }
 
3. 从config里读取filter
  1: XmlNodeList filterNodeList = linkEntityNode.SelectNodes("filter");
  2: if (filterNodeList != null)
  3: {
  4:     foreach (XmlNode filterNode in filterNodeList)
  5:     {
  6:         FilterExpression filter = this.GetFilter(filterNode);
  7: 
  8:         le.LinkCriteria.AddFilter(filter);
  9:     }
 10: }
 
4. 从config里读取condition
  1: XmlNodeList conditionNodeList = linkEntityNode.SelectNodes("condition");
  2: if (conditionNodeList != null)
  3: {
  4:     foreach (XmlNode conditionNode in conditionNodeList)
  5:     {
  6:         ConditionExpression condition = this.GetCondition(conditionNode);
  7: 
  8:         le.LinkCriteria.AddCondition(condition);
  9:     }
 10: }
 
5. 最后合成一个QueryExpression对象,传入到RetrieveMultiple方法,进行查询,如果有记录存在,就抛出error:
  1: EntityCollection ec = AdminService.RetrieveMultiple(config.Query);
  2: if (ec != null && ec.Entities.Count > 0)
  3: {
  4:     throw new InvalidPluginExecutionException(config.Error);
  5: }

Dynamic CRM 2013学习笔记(五)禁止修改审批通过后的单据