Taakacties
De werkitems die door een taak worden uitgevoerd, worden acties genoemd. Een taak kan één actie of maximaal 32 acties hebben. Houd er rekening mee dat wanneer er meerdere acties worden opgegeven, ze opeenvolgend worden uitgevoerd.
Typen acties
In de volgende tabel met acties wordt het type werk of acties beschreven dat kan worden uitgevoerd door een taak.
Type actie | Beschrijving |
---|---|
ComHandler-actie | Met deze actie wordt een COM-handler geactiveerd. |
Exec-actie | Met deze actie wordt een opdrachtregelbewerking uitgevoerd, zoals het starten van Kladblok. |
E-mailactie | Met deze actie wordt een e-mailbericht verzonden wanneer een taak wordt geactiveerd. |
Berichtactie weergeven | Met deze actie wordt een berichtvak met een opgegeven bericht en titel weergegeven. |
Acties opgeven
De acties van een taak worden opgegeven wanneer de taak wordt gedefinieerd en opgeslagen in een verzameling acties die worden gebruikt door de Task Scheduler-service. De volgende tabel bevat koppelingen naar naslagonderwerpen voor de API's en XML-elementen die zijn gekoppeld aan acties.
Zie Taakplanner gebruikenvoor meer informatie en voorbeelden over het gebruik van de Task Scheduler-interfaces, scriptobjecten en XML.
Interface-API's voor C++ ontwikkeling
API | Beschrijving |
---|---|
eigenschap Actions van ITaskDefinition | Hiermee haalt u de acties op die door de taak worden uitgevoerd of stelt u deze in. |
IActionCollection- | Bevat de acties die door de taak worden uitgevoerd. |
IComHandlerAction- | Vertegenwoordigt een actie waarmee een handler wordt geactiveerd. |
IExecAction- | Vertegenwoordigt een actie waarmee een opdrachtregelbewerking wordt uitgevoerd. |
IEmailAction- | Vertegenwoordigt een actie waarmee een e-mailbericht wordt verzonden. |
IShowMessageAction- | Vertegenwoordigt een actie die een berichtvak weergeeft. |
Scripting Object-API's voor scriptontwikkeling
API | Beschrijving |
---|---|
TaskDefinition.Actions | Hiermee haalt u de acties op die door de taak worden uitgevoerd of stelt u deze in. |
ActionCollection- | Bevat de acties die door de taak worden uitgevoerd. |
ComHandlerAction- | Vertegenwoordigt een actie waarmee een handler wordt geactiveerd. |
ExecAction- | Vertegenwoordigt een actie waarmee een opdrachtregelbewerking wordt uitgevoerd. |
EmailAction- | Vertegenwoordigt een actie waarmee een e-mailbericht wordt verzonden. |
ShowMessageAction- | Vertegenwoordigt een actie die een berichtvak weergeeft. |
XML-elementen
Element | Beschrijving |
---|---|
acties | Hiermee definieert u de acties die door de taak worden uitgevoerd. |
ComHandler- | Vertegenwoordigt een actie waarmee een handler wordt geactiveerd. |
Exec- | Vertegenwoordigt een actie waarmee een opdrachtregelbewerking wordt uitgevoerd. |
SendEmail- | Vertegenwoordigt een actie waarmee een e-mailbericht wordt verzonden. |
ShowMessage- | Vertegenwoordigt een actie die een berichtvak weergeeft. |
Variabelen gebruiken in actie-eigenschappen
Sommige actie-eigenschappen van het type BSTR- kunnen $(Arg0), $(Arg1), ..., $(Arg32)-variabelen in hun tekenreekswaarden bevatten. Deze variabelen worden vervangen door de waarden die zijn opgegeven in de parameters parameter van de IRegisteredTask::Run en IRegisteredTask::RunEx methoden of zijn opgenomen in de gebeurtenistrigger voor de taak. De volgende tabel bevat de actie-eigenschappen die variabelen in hun tekenreekswaarden kunnen gebruiken.
Actie | Eigenschappen |
---|---|
COM-handleractie | C++: Scripting: |
E-mailactie | C++:
Scripting:
|
Exec-actie | C++: Scripting: |
Berichtactie weergeven | C++: Scripting: |