DataContract

[
    DataContractAttribute
    ,SysOperationContractProcessingAttribute(classStr(SysOperationTemplateUIBuilder))
]
internal final class SysOperationTemplateDC implements SysOperationValidatable
{
    private DimensionValue myDimensionValue;

    [
        DataMember,
        SysOperationLabelAttribute(literalStr("@SYS105870")), 
        SysOperationDisplayOrderAttribute('3')
    ]
    public DimensionValue parmMyDimensionValue(DimensionValue _dimensionValue = myDimensionValue)
    {
        myDimensionValue = _dimensionValue;
        return myDimensionValue;
    }

}

UI-Builder

internal final class SysOperationTemplateUIBuilder extends SysOperationAutomaticUIBuilder
{
    private DialogField myDimensionValueField;

    public void postBuild()
    {
        super();

        myDimensionValueField= this.bindInfo().getDialogField(
            this.dataContractObject(), 
            methodStr(SysOperationTemplateDC, parmMyDimensionValue));

        if (myDimensionValueField)
        {
            myDimensionValueField.lookupButton(FormLookupButton::Always);
        }
    }

    public void postRun()
    {
        super();
    
        // register overrides for form control events
        myDimensionValueField.registerOverrideMethod(
            methodStr(FormStringControl, lookup), 
            methodStr(SysOperationTemplateUIBuilder, lookupMyDimension), 
            this);
    }

    public void lookupMyDimension(FormStringControl _dimensionValueControl)
    {
        Name dimensionAttributeName = "CostCenter";

        if (_dimensionValueControl != null)
        {
            // Construct arguments for the custom lookup
            Args args = new Args();
            args.name(formStr(DimensionLookup));
            args.lookupValue(_dimensionValueControl.text());
            args.caller(_dimensionValueControl);

            DimensionAttribute dimensionAttribute = DimensionAttribute::findByLocalizedName(
                dimensionAttributeName, 
                false, 
                SystemParameters::find().SystemLanguageId);

            args.lookupField(dimensionAttribute.ValueAttribute);
            args.record(dimensionAttribute);

            // Do the lookup
            FormRun lookupFormRun = classFactory.formRunClass(args);
            lookupFormRun.init();

            _dimensionValueControl.performFormLookup(lookupFormRun);
        }
    }

}

.\SysTestConsole.exe /test:NameOfTestClass1,NameOfTestClass2 /database:axdb

Damit kann man Labelfiles voll automatisiert übersetzen lassen - sehr cool!

Details dazu sind hier zu finden.

Error during AOS start: Cannot create a file when that file already exists.

In meinem Fall hat ein Neustarten der auf Azure gehosteten Umgebung und Neustarten des Schrittes geholfen.

Infolog diagnostic message: 'Cannot create a record in Roles (LogisticsLocationRole). Role: F?hrendes Unternehmen, Head company. The record already exists.' on category 'Error'. 
Application configuration sync failed.   

Bzw.

Infolog diagnostic message: 'Cannot create a record in Roles (LogisticsLocationRole). Role: Stabile Organisation, Stable organization. The record already exists.' on category 'Error'. 08/20/2019 14:52:12: Application configuration sync failed.

Ursache waren zwei Datensätze in der Tabelle LogisticsLocationRole, die in der Quellumgebung (AX 2012 R2) über den Hotfix KB4048614 erstellt wurden. Dieser Hotfix ist interessanterweise genau jener, den man vor einem Upgrade von AX 2012 R2 auf D365 einspielen soll.

In meinem Szenario konnte ich über das nachstehende Statement die Datensätze löschen, und den Schritt 8 erfolgreich neu starten.

delete from LOGISTICSLOCATIONROLE
where type = 104 or type = 105

GlobalUpdate script for service model: AOSService on machine: D365Local
Sync AX database
The running command stopped because the preference variable "ErrorActionPreference" or common parameter is set to Stop: System.Management.Automation.RuntimeException: An exception of type System.Net.WebException occurred when making an http request to: http://127.0.0.1/ReportServer. Refer to the log file for more details.
The step failed
The step: 25 is in failed state, you can use rerunstep command to debug the step explicitly
   at Microsoft.Dynamics.AX.AXUpdateInstallerBase.RunbookExecutor.ExecuteRunbookStepList(RunbookData runbookData, String updatePackageFilePath, Boolean silent, String stepID, ExecuteStepMode executeStepMode, Boolean versionCheck, Parameters parameters)
   at Microsoft.Dynamics.AX.AXUpdateInstallerBase.AXUpdateInstallerBase.execute(String runbookID, Boolean silent, String updatePackageFilePath, IRunbookExecutor runbookExecutor, Boolean versionCheck, Parameters param)
   at Microsoft.Dynamics.AX.AXUpdateInstaller.Program.InstallUpdate(String[] args)
   at Microsoft.Dynamics.AX.AXUpdateInstaller.Program.Main(String[] args)

...kann es möglicherweise helfen, die Reporting Services über den Reporting Services Configuration Manager for SQL Server 2016 manuell zu starten und danach den Updatevorgang beim betroffenen Schritt fortzusetzen.

public void displayOption(Common _record, FormRowDisplayOption _options)
{
    MyTable myTable = _record as MyTable;
            
    super(_record, _options);
            
    _options.fontBold(false);
            
    if (true)  
    {
        _options.fontBold(true);
    }
}

Zugriff verweigert: SysOperationController

Ein MenuItem für einen SysOperationController sollte in der Regel wie folgt aussehen:

[SysClientCacheDataMethodAttribute(true)]
public display container displayOnHoldImage()
{
    if (trueContition)
    {
        return ImageReference::constructForSymbol(ImageReferenceSymbol::Pause).pack();
    }
    return connull();
}

GlobalUpdate script for service model: RetailSelfService on machine: D365Local
Update Retail self service.
UpdateRetailSelfService.ps1 failed.
The step failed
The step: 52 is in failed state, you can use rerunstep command to debug the step explicitly
   at Microsoft.Dynamics.AX.AXUpdateInstallerBase.RunbookExecutor.ExecuteRunbookStepList(RunbookData runbookData, String updatePackageFilePath, Boolean silent, String stepID, ExecuteStepMode executeStepMode, Boolean versionCheck, Parameters parameters)
   at Microsoft.Dynamics.AX.AXUpdateInstaller.Program.InstallUpdate(String[] args)
   at Microsoft.Dynamics.AX.AXUpdateInstaller.Program.Main(String[] args)

...kann es möglicherweise helfen, den Azure Storage Emulator zu starten und danach den Updatevorgang beim betroffenen Schritt fortzusetzen.

• C:\AOSService\PackagesLocalDirectory\MyModel\MyModel\AxLabelFile
• C:\AOSService\PackagesLocalDirectory\MyModel\Resources (inkl. Unterverzeichnisse je Sprache)

System.Diagnostics.Stopwatch watch = new System.Diagnostics.Stopwatch();
watch.Start();
// ... do something
watch.Stop();
info(strFmt("%1ms", watch.ElapsedMilliseconds));

[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

DimensionDisplayValue displayValue = 
LedgerDimensionFacade::getDisplayValueForLedgerDimension(ledgerJournalTrans.LedgerDimension);

public static void setFormViewOption(
    FormRun _formRun,
    FormViewOption _formViewOption = FormViewOption::Details
    )
{
    if (_formRun
        && _formRun.viewOptionHelper())
    {
        _formRun.viewOptionHelper().setViewOption(_formViewOption);
    }
}

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.

GlobalUpdate script for service model: AOSService on machine: D365Local
Sync AX database
The running command stopped because the preference variable "ErrorActionPreference" or common parameter is set to Stop: System.Management.Automation.RuntimeException: An exception of type System.Net.WebException occurred when making an http request to: http://127.0.0.1/ReportServer. Refer to the log file for more details.
The step failed

Die Ursache für diesen Fehler war rasch gefunden - nach dem Download des VPC aus LCS wurde der Name des virtuellen Computers geändert, dieser aber nicht überall nachgezogen. Dadurch hatten die SQL Reporting Services ein Problem, hier musste eine neue Database eingetragen werden. Wie dies geht, und was man noch alles beim Umbenennen eines VPCs berücksichtigen muss steht übrigens hier.

Executing step: 19
GlobalUpdate script for service model: AOSService on machine: D365FOSHLocal
Sync AX database
The running command stopped because the preference variable "ErrorActionPreference" or common parameter is set to Stop: System.Management.Automation.RuntimeException: An exception of type System.Net.WebException occurred when making an http request to: http://127.0.0.1/ReportServer. Refer to the log file for more details.
The step failed
The step: 19 is in failed state, you can use rerunstep command to debug the step explicitly
   at Microsoft.Dynamics.AX.AXUpdateInstallerBase.RunbookExecutor.ExecuteRunbookStepList(RunbookData runbookData, String updatePackageFilePath, Boolean silent, String stepID, ExecuteStepMode executeStepMode, Boolean versionCheck, Parameters parameters)
   at Microsoft.Dynamics.AX.AXUpdateInstallerBase.AXUpdateInstallerBase.execute(String runbookID, Boolean silent, String updatePackageFilePath, IRunbookExecutor runbookExecutor, Boolean versionCheck, Parameters param)
   at Microsoft.Dynamics.AX.AXUpdateInstaller.Program.InstallUpdate(String[] args)
   at Microsoft.Dynamics.AX.AXUpdateInstaller.Program.Main(String[] args)

...kann die Ursache sein, daß der Computername des VPCs geändert wurde, und dabei aber nicht alle von Microsoft empfohlenen Schritte durchgeführt wurden.

Welche das sind, ist hier zu finden: https://docs.microsoft.com/en-us/dynamics365/fin-ops-core/dev-itpro/migration-upgrade/vso-machine-renaming

Argument für Methode getFieldValue liegt außerhalb des zulässigen Bereichs.

Beim Debuggen stelte sich heraus, daß in der Methode DimensionDynamicAccountDataEntityResolver.getEnumValue() ein Feldname nicht ermittelt werden konnte. Allerdings ist die verantwortliche Methode DictDataEntityField.dynamicDimensionEnumartionField() nicht einsehbar.

1. Neue Foreign-Key-Relation zur Tabelle DimensionAttributeValueCombination erstellen
2. Als Index dieser Relation RecId auswählen
   Dadurch wird nun ein neues Feld in der Tabelle generiert und die Relation zu diesem Feld erstellt
3. Die Eigenschaft Extends dieses neuen Feldes sollte nun auf DimensionDynamicAccount geändert werden
   Das Feld kann nun ggf. umbenannt werden, z.B. LedgerDimension
4. Nun muss ein weiteres neues Feld eingefügt werden, daß von BaseEnum LedgerJournalACType ableitet

Um ein solches Feld nun auch in einem (eigenen) Formular anzuzeigen, sind folgende Schritte notwendig:

1. Per Drag & Drop beide erstellten Felder im Design platzieren
2. Dabei wird für das Feld, das die Dimension aufnehmen soll (z.B. LedgerDimension), ein Segmented Entry Control erstellt
3. In den Eigenschaften dieses Controls sind nun folgende Eigenschaften anzupassen
   • Controller Class: DimensionDynamicAccountController
   • Account type field: Hier muss jenes Feld eingetragen werden, das von LedgerJournalACType abgeleitet wurde

Abhängig von der Klasse die man am Segmented Entry Control in der Eigenschaft Controller Class hinterlegt, sind noch ggf. weitere Einstellungen vorzunehmen, wobei nicht alle immer zulässig sein. Mehr dazu unter https://docs.microsoft.com/de-at/dynamics365/unified-operations/dev-itpro/financial/segmented-entry-control-metadata-specification

Executing step: 42
GlobalUpdate script for service model: MROneBox on machine: localhost
Update the financial reporting database
Job AutoGlobalUpdateMR job failed
The step failed
The step: 42 is in failed state, you can use rerunstep command to debug the step explicitly
   at Microsoft.Dynamics.AX.AXUpdateInstallerBase.RunbookExecutor.ExecuteRunbookStepList(RunbookData runbookData, String updatePackageFilePath, Boolean silent, String stepID, ExecuteStepMode executeStepMode, Boolean versionCheck, Parameters parameters)
   at Microsoft.Dynamics.AX.AXUpdateInstaller.Program.InstallUpdate(String[] args)
   at Microsoft.Dynamics.AX.AXUpdateInstaller.Program.Main(String[] args)

...kann die Ursache sein, daß der Computername des VPCs geändert wurde, und dabei aber nicht alle von Microsoft empfohlenen Schritte durchgeführt wurden.

Welche das sind, ist hier zu finden: https://docs.microsoft.com/en-us/dynamics365/fin-ops-core/dev-itpro/migration-upgrade/vso-machine-renaming

[Control("ComboBox")]
class LedgerJournalTypeCB
{
    public void enter()
    {
        super(); 

        this.delete(enum2str(LedgerJournalACType::Vend));
        this.delete(enum2str(LedgerJournalACType::Cust));
    }
}

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