D365 FO最佳实践BP(二）-特定情况下忽略BP

BP只是给出一些建议，这些建议在通常情况下是成立的，但是在某些特殊的场景下，这些BP可能并不适合。
同样一条BP，可能在其他场景下需要检查，这个时候就需要根据具体的代码去决定是否忽略BP，而不是整条BP规则全部忽略。
在AX2012及以前版本是通过在代码里添加注释 //BP deviation documented来告诉BP这段代码是有充足理由忽略BP的。
D365 FO显然 更完善了， 它提供了两种特定场景下忽略BP的方法。
对于某个方法想要忽略特定的BP规则，可以在方法体上通过SuppressBPWarning这个Atrribute来忽略BP。

 [SuppressBPWarning("BPCheckInsertMethodInLoop", "因为覆盖了表的insert方法，导致RecordInsertList降级，所以不采用此方法。")]
    public static void main(Args _args)
    {
        BulkInsertTest          bulkInsertTest;

        ttsbegin;
        for (int i = 0 ; i < 100; i++)
        {
            bulkInsertTest.ItemName = "品名" + int2Str(i);
            bulkInsertTest.insert();
        }
        ttscommit;
    }

SuppressBPWarning这个属性有两个变量，一个是要忽略的BP检查的名字，代码里如果有BP警告，会提示BP检查的名字，另一个是忽略的理由。
如果一个方法要忽略多个BP检查规则，多写几个。

[SuppressBPWarning("BPCheckInsertMethodInLoop",
        "因为覆盖了表的insert方法，导致RecordInsertList降级，所以不采用此方法。"),
        SuppressBPWarning("BPUpgradeCodeSystemDate", "Just For Test")]
    public static void main(Args _args)
    {
        BulkInsertTest          bulkInsertTest;

        TransDate transDate =  systemDateGet();

        ttsbegin;
        for (int i = 0 ; i < 100; i++)
        {
            
            bulkInsertTest.ItemName = "品名" + int2Str(i);
            bulkInsertTest.insert();
        }
        ttscommit;
    }

想在方法中忽略所有的BP检查，就直接属性SupressBPWarning，不带入参就可以了。
对于表的属性和窗体的属性的BP就没办法通过代码属性的办法忽略BP检查，D365 FO提供了通过XML设置的方式忽略BP检查。
对于新建的model，需要在model对应的文件夹中的子文件夹AxIgnoreDiagnosticList中创建一个[Model名字]_BPSuppressions.xml的文件，如下图所示：

 然后就可以在VS中的项目中点右键编辑了。

 针对不同的BPRule增加Diagnotic节点就可以了。

<?xml version="1.0" encoding="utf-8"?>
<IgnoreDiagnostics>
  <Name>ModelName_BPSuppressions</Name>
  <Items>
    <Diagnostic>e
      <DiagnosticType>BestPractices</DiagnosticType>
      <Severity>Warning</Severity>
      <Path>dynamics://Form/SomeForm/FormDesign/FormDesign/FormTabControl/FormTabControl/FormTabPageControl/FormTabPageControlTable111</Path>
      <Moniker>SomeBPRule</Moniker>
      <Message>BPRule Info</Message>
      <Justification></Justification>
    </Diagnostic>    
  </Items>
</IgnoreDiagnostics>

其中Path,Moniker和Message在BP警告里都可以找到，Justification写出自己忽略BP规则的理由。
其实这个Message没什么必要，只要知道Moniker就知道具体是哪个BP规则了，没必要再把Message拷贝过来了，AX自带的Supression.xml文件里有一些是不包含Message节点的。
我自己用的时候（版本10.0.0.10）发现添加了这个Message节点后，就没办法忽略BP规则了，去掉Message节点以后一切正常，所以还是不要再拷贝一次Message的信息了。