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

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

 1  [SuppressBPWarning("BPCheckInsertMethodInLoop", "因为覆盖了表的insert方法，导致RecordInsertList降级，所以不采用此方法。")]
 2     public static void main(Args _args)
 3     {
 4         BulkInsertTest          bulkInsertTest;
 5 
 6         ttsbegin;
 7         for (int i = 0 ; i < 100; i++)
 8         {
 9             bulkInsertTest.ItemName = "品名" + int2Str(i);
10             bulkInsertTest.insert();
11         }
12         ttscommit;
13     }

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

 1 [SuppressBPWarning("BPCheckInsertMethodInLoop",
 2         "因为覆盖了表的insert方法，导致RecordInsertList降级，所以不采用此方法。"),
 3         SuppressBPWarning("BPUpgradeCodeSystemDate", "Just For Test")]
 4     public static void main(Args _args)
 5     {
 6         BulkInsertTest          bulkInsertTest;
 7 
 8         TransDate transDate =  systemDateGet();
 9 
10         ttsbegin;
11         for (int i = 0 ; i < 100; i++)
12         {
13             
14             bulkInsertTest.ItemName = "品名" + int2Str(i);
15             bulkInsertTest.insert();
16         }
17         ttscommit;
18     }

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

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

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

 1 <?xml version="1.0" encoding="utf-8"?>
 2 <IgnoreDiagnostics>
 3   <Name>ModelName_BPSuppressions</Name>
 4   <Items>
 5     <Diagnostic>e
 6       <DiagnosticType>BestPractices</DiagnosticType>
 7       <Severity>Warning</Severity>
 8       <Path>dynamics://Form/SomeForm/FormDesign/FormDesign/FormTabControl/FormTabControl/FormTabPageControl/FormTabPageControlTable111</Path>
 9       <Moniker>SomeBPRule</Moniker>
10       <Message>BPRule Info</Message>
11       <Justification></Justification>
12     </Diagnostic>    
13   </Items>
14 </IgnoreDiagnostics>

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