Anweisungsart: Programm, Datei oder Link ausführen

Mit der Anweisungsart "Programm / Datei / Link ausführen" starten Sie im Rahmen einer Regel automatisch eine externe Anwendung, öffnen eine Datei oder rufen eine URL auf. Die Anweisung läuft ohne manuelle Benutzerinteraktion ab und eignet sich für die Automatisierung von Abläufen - zum Beispiel für Benachrichtigungen, Archivierung oder einfache Webhook-Aufrufe.

Wo konfiguriere ich das in der Software?

PARAMETER - (Auswahl des Regel-Bereichs) - REGELN - Schaltfläche: NEU - Bereich: ANWEISUNGEN - Anweisungsart: Programm, Datei oder Link ausführen

Die Anweisungsart steht an folgenden Auswertungspositionen zur Verfügung:

Nach dem Buchen / Stornieren von Vorgängen
Nach der Vorgangs-Druckausgabe
Nach dem Wandeln / Einladen (über das Erfassungsformular)
Eigene Abläufe (Funktionen) XL
Für das Klicken auf ein Feld innerhalb der Übersicht (Hyperlink-Unterstützung)

Voraussetzungen und Einschränkungen

Beachten Sie

Ausführung auf dem Server / Ausführungsort beachten

Der Befehl wird auf dem Rechner ausgeführt, auf dem der microtech-Dienst läuft (in der Regel der Server). Stellen Sie sicher, dass Pfade, Dateiberechtigungen und ausführbare Dateien dort erreichbar sind. Lokale Clientpfade funktionieren in Serverinstallationen in der Regel nicht.

Felder der Anweisungsart

Anweisungsart

Wählen Sie im Dropdown der Regelanweisung den Eintrag Programm / Datei / Link ausführen.

Wert	Bedeutung
Programm / Datei / Link ausführen	Aktiviert die nachfolgenden Felder dieser Anweisungsart

Auszuführendes Objekt

Vollständiger Pfad zur ausführbaren Datei, zur zu öffnenden Datei oder zur aufzurufenden URL.

Eingabeform	Beispiel	Verhalten
Ausführbares Programm (EXE)	`C:\Tools\Benachrichtigung.exe`	Startet das Programm direkt
Datei mit Standardprogramm	`C:\Dokumente\Vorlage.pdf`	Öffnet die Datei mit dem unter Windows registrierten Standardprogramm
URL / HTTP-Link	`https://intern.beispiel.de/aktion`	Öffnet den Link im Standardbrowser
Netzwerkpfad (UNC)	`\\Server\Freigabe\Skript.bat`	Führt das Skript über UNC-Pfad aus

Formelunterstützung

Das Feld unterstützt Formeln. Sie können Datenbankfelder und Formelfunktionen verwenden, um den Pfad oder die URL dynamisch zusammenzusetzen — beispielsweise um eine Vorgangsnummer an einen URL-Parameter anzuhängen.

Beispiel: 'https://intern.beispiel.de/vorgang?nr=' + [Vorgangsnummer]

Parameter

Optionale Startparameter, die dem Programm oder Skript beim Aufruf übergeben werden. Wird kein Parameter benötigt, bleibt das Feld leer.

Eingabeform	Beispiel	Bedeutung
Fester Text	`/silent /log`	Wird unverändert als Kommandozeilenargument übergeben
Formel	`[Vorgangsnummer]`	Dynamischer Wert aus dem aktuellen Datensatz

Formeln in Parametern

Auch das Parameterfeld unterstützt den Formeleditor. So können Sie Felder des aktuellen Vorgangs, der Adresse oder des Artikels als Argument übergeben, ohne ein zwischengeschaltetes Skript zu benötigen.

Startverzeichnis

Arbeitsverzeichnis, aus dem heraus das Programm gestartet wird. Relevant, wenn das Programm oder Skript relative Pfade verwendet.

Eingabe	Bedeutung
Leer	Das Betriebssystem wählt das Startverzeichnis automatisch
Absoluter Pfad, z. B. `C:\Tools\`	Das Programm wird aus diesem Verzeichnis heraus gestartet

Ausführung abwarten

Steuert, ob microtech wartet, bis das gestartete Programm beendet ist, bevor der weitere Regelablauf oder der Programmfluss fortgesetzt wird.

Wert	Bedeutung
Aktiviert	microtech wartet auf die Beendigung des gestarteten Prozesses (synchron)
Deaktiviert	Das Programm wird gestartet und microtech fährt sofort fort (asynchron)

Beachten Sie

Blockierendes Verhalten bei langen Prozessen: Wenn Sie Ausführung abwarten aktivieren und das gestartete Programm sehr lange läuft oder auf Benutzereingaben wartet, blockiert der microtech-Buchungsprozess bis zum Abschluss. Aktivieren Sie diese Option nur, wenn das Ergebnis des Programms für nachfolgende Regelanweisungen oder den Buchungsablauf relevant ist.

Fenster-Modus

Legt fest, wie das Programm- oder Konsolenfenster beim Start dargestellt wird.

Wert	Bedeutung
Normal	Programm startet im normalen Fenstermodus
Minimiert	Programmfenster startet minimiert in der Taskleiste
Maximiert	Programmfenster startet maximiert
Unsichtbar / Kein Fenster	Das Programm läuft ohne sichtbares Fenster (geeignet für Skripte und Hintergrundprozesse)

Hintergrundskripte

Für Batch-Dateien, PowerShell-Skripte oder andere Konsolentools, die im Hintergrund laufen sollen, empfiehlt sich der Fenster-Modus Unsichtbar / Kein Fenster, damit Benutzer nicht durch ein aufblinkendes Konsolenfenster abgelenkt werden.

Steuerfelder der Regelanweisung

Diese Felder gelten für alle Anweisungsarten und steuern den Ablauf innerhalb einer Regel.

Feld	Bedeutung
Keine weiteren Regelanweisungen auswerten	Wenn diese Anweisung ausgeführt wurde, werden nachfolgende Anweisungen dieser Regel nicht mehr ausgewertet
Keine weiteren Regeln auswerten	Nach Ausführung dieser Anweisung werden auch alle weiteren Regeln an dieser Auswertungsposition übersprungen
Nur ausführen, wenn zuvor keine Regelanweisung ausgeführt wurde	Diese Anweisung wird nur dann ausgeführt, wenn keine der vorherigen Anweisungen in dieser Regelauswertung aktiv war

Zusammenspiel mit anderen Anweisungen

Kombinieren Sie diese Steuerfelder gezielt, wenn das Ausführen einer externen Anwendung nur als "Fallback" oder als abschließende Aktion gelten soll — z. B. nur dann, wenn keine vorherige Feldzuweisung gegriffen hat.

Typische Einsatzszenarien

Szenario	Konfiguration
Nach dem Buchen eines Vorgangs automatisch eine E-Mail-Benachrichtigung per Skript auslösen	Auswertungsposition: "Nach dem Buchen von Vorgängen"; Objekt: Pfad zum Mailskript; Parameter: Vorgangsnummer als Formel
PDF-Datei nach dem Buchen automatisch in ein Archivverzeichnis kopieren	Objekt: `xcopy.exe` oder PowerShell-Skript; Startverzeichnis und Parameter mit Datenbankfeldern gefüllt
Webhook oder externe REST-API aufrufen (einfache GET-Anfrage ohne Rückantwort)	Objekt: URL als Formel; kein Parameter; Ausführung abwarten: deaktiviert

POST-Anfragen mit Rückantwort

Wenn Sie HTTP-POST-Anfragen senden und die Antwort des Servers in ein Datenbankfeld zurückschreiben möchten, verwenden Sie stattdessen die Anweisungsart HTTP-Befehl senden. Diese Anweisungsart ist für bidirektionale HTTP-Kommunikation ausgelegt.