Aufgabenaktionen

  • Artikel

Die von einer Aufgabe ausgeführten Arbeitselemente werden als Aktionen bezeichnet. Eine Aufgabe kann eine einzelne Aktion oder maximal 32 Aktionen aufweisen. Beachten Sie, dass mehrere Aktionen sequenziell ausgeführt werden, wenn mehrere Aktionen angegeben werden.

Aktionstypen

Die folgende Tabelle mit Aktionen beschreibt den Typ der Arbeit oder der Aktionen, die von einer Aufgabe ausgeführt werden können.

Aktionstyp Beschreibung
ComHandler-Aktion Diese Aktion löst einen COM-Handler aus.
Exec-Aktion Diese Aktion führt einen Befehlszeilenvorgang aus, z. B. das Starten von Editor.
E-Mail-Aktion Diese Aktion sendet eine E-Mail, wenn eine Aufgabe ausgelöst wird.
Nachrichtenaktion anzeigen Diese Aktion zeigt ein Meldungsfeld mit einer angegebenen Nachricht und einem angegebenen Titel an.

Festlegen von Aktionen

Die Aktionen einer Aufgabe werden angegeben, wenn die Aufgabe definiert und in einer Sammlung von Aktionen gespeichert wird, die vom Taskplanerdienst verwendet werden. Die folgende Tabelle enthält Links zu Referenzthemen für die APIs und XML-Elemente, die Aktionen zugeordnet sind.

Weitere Informationen und Beispiele zur Verwendung der Taskplanerschnittstellen, Skripterstellungsobjekte und XML finden Sie unter Verwenden des Aufgabenplaners.

Schnittstellen-APIs für die C++-Entwicklung

API Beschreibung
Actions-Eigenschaft von ITaskDefinition Ruft die Aktionen ab, die von der Aufgabe ausgeführt werden, oder legt sie fest.
IActionCollection Enthält die Aktionen, die von der Aufgabe ausgeführt werden.
IComHandlerAction Stellt eine Aktion dar, die einen Handler auslöst.
IExecAction Stellt eine Aktion dar, die einen Befehlszeilenvorgang ausführt.
IEmailAction Stellt eine Aktion dar, die eine E-Mail-Nachricht sendet.
IShowMessageAction Stellt eine Aktion dar, die ein Meldungsfeld anzeigt.

Skriptobjekt-APIs für die Skriptentwicklung

API Beschreibung
TaskDefinition.Actions Ruft die Aktionen ab, die von der Aufgabe ausgeführt werden, oder legt sie fest.
ActionCollection Enthält die Aktionen, die von der Aufgabe ausgeführt werden.
ComHandlerAction Stellt eine Aktion dar, die einen Handler auslöst.
ExecAction Stellt eine Aktion dar, die einen Befehlszeilenvorgang ausführt.
EmailAction Stellt eine Aktion dar, die eine E-Mail-Nachricht sendet.
ShowMessageAction Stellt eine Aktion dar, die ein Meldungsfeld anzeigt.

XML-Elemente

Element Beschreibung
Aktionen Definiert die Aktionen, die von der Aufgabe ausgeführt werden.
ComHandler Stellt eine Aktion dar, die einen Handler auslöst.
Exec Stellt eine Aktion dar, die einen Befehlszeilenvorgang ausführt.
Sendemail Stellt eine Aktion dar, die eine E-Mail-Nachricht sendet.
Showmessage Stellt eine Aktion dar, die ein Meldungsfeld anzeigt.

Verwenden von Variablen in Aktionseigenschaften

Einige Aktionseigenschaften vom Typ BSTR können $(Arg0), $(Arg1), ..., $(Arg32)-Variablen in ihren Zeichenfolgenwerten enthalten. Diese Variablen werden durch die Werte ersetzt, die im params-Parameter der Methoden IRegisteredTask::Run und IRegisteredTask::RunEx angegeben sind oder im Ereignistrigger für den Task enthalten sind. In der folgenden Tabelle sind die Aktionseigenschaften aufgeführt, die Variablen in ihren Zeichenfolgenwerten verwenden können.

Aktion Eigenschaften
COM-Handleraktion C++:
Skripterstellung:
Email Aktion C++:
Skripterstellung:
Exec-Aktion C++:
Skripterstellung:
Nachrichtenaktion anzeigen C++:
Skripterstellung:

Informationen zum Aufgabenplaner