Dynamics AX Blog - Dynamics AX 2012 - sysoperation-framework - Microsoft Dynamics AX (Axapta)

Wenn man in einem SysOperation-Konstrukt den SysOperationExecutionMode und/oder die auszuführende Servermethode über das MenuItem steuern möchte, kann man dies über die Eigenschaften des MenuItems steuern.

Szenario: Ohne eigenen Controller

Die folgenden beiden MenuItems zeigen, wie man dafür die Eigenschaften setzen kann:

Dieses MenuItem ruft die Methode runService() einer Serviceklasse auf und setzt den SysOperationExecutionMode auf Synchronous:

Wenn man sicherstellen möchte, daß eine Funktion die über das SysOperation-Framework umgesetzt wurde, immer über die Stapelverarbeitung ausgeführt wird, kann man den SysOperationExecutionMode auf ScheduledBatch setzen (beispielsweise über das MenuItem des Controllers - siehe hier).

Handelt es sich dabei um eine Funktion, die einen Benutzerdialog erfordert, hat man allerdings das Problem, daß standardmässig der Register "Stapel" eingeblendet wird und dort aber beispielsweise das Kontrollkästchen Stapel nicht aktiviert ist. 

Natürlich kann man dieses Kontrollkästchen nun aktivieren, in dem man einen Aufruf von parmBatchExecute() im UIBuilder integriert:

public void build()
{
    super();

    this.controller().batchInfo().parmBatchExecute(this.controller().parmExecutionMode() == SysOperationExecutionMode::ScheduledBatch);
}

Stellt euch vor, ihr habt eine über das SysOperation-Framework abgebildete Funktion die an unterschiedlichen Stellen über im System aufgerufen werden kann, und ihr wollt sicherstellen, daß sich diese Aufrufe nicht die gleichen Nutzungsdaten teilen.

In einem solchen Fall könnte man zwei (oder mehrere) MenuItems erstellen und die Methode lastValueDesignName() des Controllers wie folgt übersteuern. Dadurch werden je MenuItem eigene Nutzungdaten abgelegt.

protected IdentifierName lastValueDesignName()
{
    IdentifierName ret;

    ret = super();

    if (this.parmArgs() && this.parmArgs().menuItemName())
    {
        ret = this.parmArgs().menuItemName();   
    }

    return ret;
}

Die nachstehenden Code-Snippets sollen zeigen, wir man mit Hilfe der BatchHeader-Klasse Stapelverarbeitungsaufträge erstellen kann.

Beispiele für ein RunBaseBatch-Konstrukt

static void createBatchWithMultipletasks(Args _args)
{
    BatchHeader batchHeader;
    Tutorial_RunbaseBatch batchTask1, batchTask2, batchTask3;

    //create batch header
    batchHeader = BatchHeader::construct();
    batchHeader.parmCaption("Example of a batch job with multiple tasks");

    //create instances of the classes to use as batch tasks
    batchTask1 = Tutorial_RunbaseBatch::construct();
    batchTask2 = Tutorial_RunbaseBatch::construct();
    batchTask3 = Tutorial_RunbaseBatch::construct();

    //add the batch tasks to the batch header
    batchHeader.addTask(batchTask1);
    batchHeader.addTask(batchTask2);
    batchHeader.addTask(batchTask3);

    //save the batch
    batchHeader.save();
}

Der nachstehende Code stellt die einfachste Möglichkeit dar, wie man eine Funktion über das SysOperation-Framework umsetzt. Ganz ohne DataController, Dataprovider und UIBuilder. Nur über eine Service-Klasse und ein MenuItem.

Service

class TutorialSysOperationSimpleService extends SysOperationServiceBase
{
}

Die Methode runService() ist die eigentliche Service-Methode. Über das Attribute SysEntryPointAttribute steuern wir hier, daß keine weiteren Berechtigungsprüfungen notwendig sind.

[SysEntryPointAttribute(false)]
public void runService()
{
    info("Done");
}

Wer bei einer über das SysOperation-Framework umgesetzten Funktion standardmässig die Stapelverarbeitung aktivieren möchte, kann dies wie in folgendem Beispiel über einen Eingriff in den UI-Builder umsetzen.

public void build()
{
    super();
    
    this.controller().batchInfo().parmBatchExecute(NoYes::Yes);
}

Durch den Code wird das Kennzeichen Stapelverarbeitung im Register Stapel aktiviert.

Im folgenden Szenario sollen an ein SysOperation-Konstrukt alle Datensätze einer temporären Tabelle übergeben werden.

Dafür brauchen wir:

• Im DataContract eine Zugriffsmethode (parm-Methode), die einen Container aufnimmt
• Im Controller eine Logik, welche die Datensätze einer aufrufenden Datenquelle iteriert und in einen Container packt, und diesen über die obige Methode an das Service übergibt
• In der Service-Klasse Logik, welche den übergebenen Container auspackt und verarbeitet

Controller

class TutorialSysOperationController extends SysOperationServiceController
{
}