Dynamics AX Blog - Dynamics AX 2012 - sysoperation-framework
RSS-Feed dieser Version
SysOperation-Framework: Stapelverarbeitung erzwingenWenn 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); } |
SysOperation-Framework: Eigene Nutzungsdaten pro MenuItemStellt 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; } |
Stapelverarbeitungsauftrag mit mehreren Aufgaben per Code erstellenDie nachstehenden Code-Snippets sollen zeigen, wir man mit Hilfe der BatchHeader-Klasse Stapelverarbeitungsaufträge erstellen kann. Beispiele für ein RunBaseBatch-Konstruktstatic 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(); } |
SysOperation-Framework: Einfachstes KlassenkonstruktDer 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. Serviceclass 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"); } |
SysOperation-Framework: Stapelverarbeitung standardmässig aktivierenWer 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. |
SysOperation-Framework: Markierte Datensätze einer temporären Tabelle übergebenIm folgenden Szenario sollen an ein SysOperation-Konstrukt alle Datensätze einer temporären Tabelle übergeben werden. Dafür brauchen wir:
Controllerclass TutorialSysOperationController extends SysOperationServiceController { } |
|
|
|
|
|
|
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: