Dynamics 365 Blog - best_practice

Ich hatte in der Vergangenheit immer wieder das Problem, daß die BP-Prüfung nicht alle zu erwartetenden Abweichungen gefunden hat oder sogar der folgende Fehler ausgegeben wurde:

[BPFrameworkFatalException]:A fatal exception occured in the Best Practices framework.

In all diesen Fällen hat es geholfen, die folgende Regel zu deaktivieren: BPCheckTableDimensionFields

Gefunden habe ich den entscheidenden Tip in der Dynamics 365 Community

Prinzipiell sollte jede Lösung in Dynamics 365 for Finance and Operations frei von Best-Practice-Abweichungen sein, dennoch gibt es ab und an die Notwendigkeit, sie unterdrücken zu müssen.

Ein solcher Fall sind beispielsweise Eventhandler, die ein vorgegebenes Paramterprofil aufweisen, im Falle eine Nicht-Verwendung eines dieser Parameter aber eine BP-Abweichung verursachen.

class MyFreeTextInvoiceHeaderFooterTmpEH
{
    [DataEventHandler(tableStr(FreeTextInvoiceHeaderFooterTmp), DataEventType::Inserting)]
    public static void FreeTextInvoiceHeaderFooterTmp_onInserting(Common sender, DataEventArgs e)
    {
        FreeTextInvoiceHeaderFooterTmp freeTextInvoiceHeaderFooterTmp;
    
        freeTextInvoiceHeaderFooterTmp = sender;
    
        if (freeTextInvoiceHeaderFooterTmp.CompanyBankAccount == "")
        {
            freeTextInvoiceHeaderFooterTmp.CompanyBankName = "Unknown";
        }
    }
}

Bei obigem EH würde folgende BP-Abweichung ausgegeben werden, da der Parameter e nicht verwendet wird:

BP Rule: [BPParameterNotUsed]:The parameter 'e' is not used.

Üblicherweise lässt man die Best-Practice-Prüfungen ja beim Build eines Projektes/einer Solution mitlaufen. Ab und an kann es aber recht praktisch ein, diese auch getrennt von einem Build zu starten.

Dafür bietet uns Microsoft das XppBp-Tool an, siehe https://docs.microsoft.com/en-us/dynamics365/unified-operations/dev-itpro/dev-tools/author-best-practice-rules (ganz unten).

Dieses Tool liegt im PackagesLocalDirectory\bin-Verzeichnis und kann exemplarisch wie folgt verwendet werden:

Xppbp.exe 
    -module:MyModel 
    -model:MyModel 
    -metadata:"C:\AOSService\PackagesLocalDirectory" 
    -all

Durch einen Kollegen bin ich auf den Dynamics Application Checker aufmerksam gemacht worden, der dazu verwendet werden kann, erweiterte Best-Practice-Prüfungen zu implementieren.

Die dafür verwendeten XQuery-Dateien können auf GitHub heruntergeladen werden. Wie man diese einsetzt, versuche ich hier zu beschreiben.

1. Installation von BaseX (und ggf. Java)
   https://docs.microsoft.com/en-us/dynamics365/fin-ops-core/dev-itpro/dev-tools/install-basex?tabs=admin
    
2. Herunterladen und Entpacken der Dateien von GitHub
   https://github.com/microsoft/Dynamics365FO-AppChecker
   Die Dateien müssen ins entsprechende Verzeichnis, z.B. C:\AOSService\PackagesLocalDirectory\Bin\AppCheckerRules, entpackt werden
    
3. Build des Models 
   In Visual Studio unter Dynamics 365 > Build models...  das gewünschte Model auswählen und die Option Run App Checks auswählen
    
4. Ergebnis prüfen
   Nun sollten in der ErrorList entsprechende Einträge auftauchen, soferne BP-Abweichungen festgestellt wurden.
   
   
   Zusätzlich wird im Packages-Verzeichnis eine Datei AppCheckerResult.xml abgelegt, auch dort können die erkannten Abweichungen eingesehen werden.