Diese Funktionalität ist nur in bestimmten Ausbaustufen verfügbar.

action

Das Tag <action> definiert eine Aktion, die der Jobserver ausführen soll. Die Aktionen werden in der Reihenfolge ihres Auftretens im Dokument ausgeführt. Für das Attribut arguments kann die Formelsprache angewendet werden.

Es können auch statische Methoden aufgerufen werden. Dazu wird die folgende Syntax angewendet:

<action name="<class name>:<static method name>" arguments="List{<argument1>, <argument2>}" />

Das Tag hat keine Unterelemente.

Attribut Verwendung Werte Defaultwert Beschreibung
name benötigt     Absoluter Name der Aktion, bzw. des Commands, z.B. T_Ecad_Ui.UpdateExtensions.
Zum Aufruf einer statischen Methode wird an den absoluten Namen der Klasse, getrennt durch einen Doppelpunkt der Name der statischen Methode gehängt.
arguments benötigt     Liste der Argumente, die an die Aktion, bzw. das Command übergeben werden. Für die Definition der Argumente wird impliziert, dass this auf das Jobobjekt zeigt, welches eine Triggereigenschaft kennt. Um ein Objekt als Argument zu ermitteln, kann die Formelsprache angewendet werden.
Mit der Syntax trigger.<Triggereigenschaft> kann auf eine Eigenschaft des Triggers zugegriffen werden. Es wird zwischen Eigenschaften für File-Trigger, WebService-Trigger und sowohl File-Trigger als auch WebService-Trigger unterschieden.
File-Trigger:
  • trigger.fileName/trigger.getFileName: Gibt den Dateinamen ohne Dateinamenserweiterung zurück, z.B. Job2010916.
  • trigger.fullFileName/trigger.getFullFileName: Gibt den Dateiname mit Dateinamenserweiterung zurück, z.B. Job20140916.xls.
  • trigger.fileExtension/trigger.getFileExtension: Gibt die Dateinamenserweiterung zurück, z.B. xls.
  • trigger.filePath/trigger.getFilePath: Gibt den absoluten Pfad zur Datei zurück, die eine Bearbeitung des Jobs ausgelöst hat, z.B. C:\input\Job20140916.xls.

WebService Trigger:

  • trigger.params/trigger.getParams: Gibt den Wert eines URL-Parameters zurück.

File-Trigger und WebService Trigger:

  • trigger.additionalResultsDir/trigger.getAdditionalResultsDir: Ordner für zusätzliche Daten, z.B. eine PX-Datei.
  • trigger.outputFolder/trigger.getOutputFolder: Gibt den Pfad zum definierten Ausgabeordner für die Ablage der Daten im Erfolgsfall zurück.
  • trigger.failedFolder/trigger.getFailedFolder: Gibt den Pfad zum definierten Ausgabeordner für die Ablage der Daten im Fehlerfall zurück.
  • trigger.jobName/trigger.getJobName: Gibt den eindeutigen Namen des auszuführenden Jobs zurück. Besteht aus dem Wert des Attributs name des Tags <jobdefinition> + <_Zeitstempel (yyMMdd_HHmm_ssSSS)>
Im Rahmen der Formelsprache sind reguläre Ausdrücke erlaubt.

Hinweis:

Die im Beispiel dargestellte Action nutzt ein Command , dessen Implementierung mit Scripting selbst zu erstellen ist.
Das Skript nutzt die Methode markFileForDownload aus der Klasse IJobAPI. Die Methode erwartet als Parameter den Pfad zur Zieldatei.

Beispiel für die Implementierung:


import com.mind8.mechatronic.skill.api.IJobAPI;
IJobAPI.DEFAULT.markFileForDownload(pathToFile);

Um mehrere Dateien zum Download anzubieten ist für jede einzelne Datei das Command JobServer.MarkFileForDownloadCommand auszuführen.

Hinweis:

Zum Herunterladen von Zieldateien muss der Browser so eingestellt sein, dass Pop-up-Fenster für diese Anwendung erlaubt sind.