Mit dieser GET_RELATION lassen sich externe Programme mit Hilfe des WWCC auf dem Client- Rechner ausführen. Hiermit können aus einem Workflow heraus Fremdprogramme mit Parameterübergabe gestartet werden.
Ebenso ist es möglich, die Programme modal zu starten. Dabei wird dann der Rückgabe-Code der Anwendung zurückgegeben.
Diese Funktion stehen neben der GET_RELATION 4015 auch direkt im Bereich des Workflow-Managers zur Verfügung. Diese Möglichkeiten sind über „externe Programm“ im Workflowmanager verfügbar. Damit können direkt aus einem Workflow heraus die Übergabe-Parameter sowie das Programm dynamisch festgelegt werden.
Es zu beachten, dass der Parameter-String wie bei einer Konsolen-Anwendung übergeben wird. Die Trennung erfolgt durch Leerzeichen. Falls ein Parameter Leerzeichen enthält, so muss der Parameter in doppelte Anführungszeichen gesetzt werden.
Ebenfalls lässt sich hier eine Transferdatei mit angeben, welche vor der Programmausführung auf den Client übertragen wird und zum Zeitpunkt der Programmausführung auf dem Client verfügbar ist.
Beispiel:
Es soll für die Displayansteuerung die Display.INI Datei für das Startprogramm bwcompl.exe übergeben werden.
Außerdem kann der Parameter UseShellExecute übergeben werden. Damit ist es möglich, auch Windows-System-Funktionen direkt aufzurufen.
Beispiel:
Es soll für ein Office-Dokument das installierte Programm aufgerufen werden (Angabe des Dateinamens und Ausführen mit Shell-Execute).
Weiteres Beispiel:
Es soll das Standard-Mail-Programm aufgerufen werden – Übergabe von mailto:MailAdresse@.. als Parameter
Seit 2018 ist es bereits möglich, mehrere Parameter zu übergeben. Diese sollten mit dem Trenner @? getrennt werden.
Beispiel für Multi-Parameter:
/P:MeinProgramm.ini@?/Tastatur: aus
Es ist darauf zu achten das keine “ (Hochkomma) übergeben werden, da diese bei der Ausführung zu Problemen führen können.
Beispiele für Anwendungsfälle:
- Der Workflow erhält einen Button „Zeige Dokumente“, dann wird das Anzeigeprogramm einer Fremdsoftware (DokuVITA) mit Übergabe des gewünschten Beleges aufgerufen.
- Es soll ein Datensatz in ein Fremdsystem eingefügt werden. Hierbei wird die Schnittstelle sowie der Datensatz als Parameterbeschreibung übergeben.
- Es soll für die Kassenanbindung/Display der Text im Display gesetzt werden.
Hierbei wird die Datei DISPLAY.ini für das Programm bwcomp.exe (ist im Lieferumfang des WWC enthalten) übergeben.
Parameter der Funktion:
GET_RELATION[4015!PROGRAMM!PARAMETER!MODAL!TRANS-DATEI!UseShellExecute]
Beschreibung der Parameter
Program ▶
Angabe des STARTPROGRAMMPFADDATEINAME, Pfad und Dateiname eines auszuführenden Programms.
Falls Kein Pfad wird ohne Pfad ausgeführt
Parameter ▶
PARAMETERSTRING, Aufrufparameter die an das Programm übergeben werden
Modal ▶
0=Nein(Dieses Programm arbeitet sofort weiter)
1=Ja(Dieses Programm wartet solange bis das Entfernte Programm beendet ist)
TRANS-DATEI ▶
Wird hier eine Datei angegeben, so wird diese vor dem Programmstart auf den WWClient übertragen und im WWC-Pfad abgespeichert.
Diese Datei ist dann mit .\[Dateiname] als Parameter ansprechbar
UseShellExcute ▶
Normalerweise wird dieProgramm-Ausführung mit CreateProcess im WWCC ausgeführt.
Ist dieser Parameter 1 erfolgt die Ausführung mit ShellExecute.
Bei ShellExecute ist keine Modale Ausführung möglich, es wird also nicht modal ausgeführt.
Rückgabe ▶
Rückgabe-Code je nach Aufruf bei Modal: Programmrückgabe-Code, bei Nicht Modal 1