Ist man angemeldet, kann über die Methode execute() ein DLE Aufruf erfolgen.
| Typ Parameter | Pflicht | Beschreibung |
|---|---|---|
| String folder | J | Welcher Folder soll aufgerufen werden. Der Folder wird in der Form Paket:FolderName angegeben. |
| String brickName | N | Wird nicht mehr verwendet. |
| Locale locale | N | Die Sprach/Landeinstellung die verwendet werden soll, in der Form SPRACHE_land, z.B.: DE_de. Der Wert null verwendet die Defaultsprache des Systems. |
| Sring searchDate | N | Das Datum für die Bricksuche. Mit diesem Datum wird die passende Brickversion gesucht. Datum ist im internen DLE Format (z.B. 2007-06-21). Der Wert null verwendet das aktuelle Tagesdatum. |
| String infoText | N | Ein optionaler Text, der übergeben werden kann. Dieser ist in der Konsole sichtbar. |
| List filters | N | Eine optionale Liste von String Objekten, die angeben welche Objekte in das Resultat übernommen werden sollen. Wird der Wert null verwendet, wird kein Filter angewendet. |
| List variables | N | Eine Liste mit DLEPair Objekten, die Namen und Wert einer Variablen enthalten. |
| List dataObjects | N | Eine Liste von Map Objekten, die jeweils ein Datenobjekt enthalten. Dabei enthält der spezielle Eintrag OBJECT_NAME den Datenobjektnamen. |
| boolean commitAfterExec | J | Der Wert true gibt an, dass die DLE am Ende der Ausführung ein commit der Datenbank durchführen soll. |
| boolean batchMode | J | Der Wert true gibt an, dass die DLE im Batchmodus aufgerufen werden soll. Die Variable BASE:Batchmode wird auf Y gesetzt. Im Batchmodus sind keine Dialoge erlaubt. |
| Map parameters | N | Ein optionales Map Objekt, mit dem auch Variablen übergeben werden können. Diese sind aber nicht im Brick verfügbar, sondern werden nur für die Bricksuche verwendet. |
Die Methode liefert als Ergebnis ein DLEExecuteACK Objekt, das das Ergebnis enthält.
Folgende Methoden stehen zur Verfügung, um das Ergebnis auszulesen:
| Aufruf | Beschreibung |
|---|---|
| getParameter(“RESULTCODE“) | Liefert den Resultcode. |
| getParameter(“RESULTMESSAGE“) | Liefert den Ergebnisstring. |
| getInstructions() | Liefert ein List Objekt, das Map Objekte für jede zurück gelieferte Instruktion enthält. In der Map gibt es einen speziellen Eintrag mit dem Schlüssel INSTRUCTION_NAME, der den Instruktionsnamen enthält. |
| getVariables() | Liefert ein Map Objekt mit den Ergebnisvariablen. |
| getDataObjects() | Liefert ein List Objekt, das Map Objekte für jedes zurück gelieferte Datenobjekt enthält. In der Map gibt es einen speziellen Eintrag mit dem Schlüssel OBJECT_NAME, der den Objektnamen enthält. |