Angeben von Regelaktionen
Das Regelobjektmodell unterstützt die meisten Regelaktionen und -bedingungen. Jedes Rule -Objekt verfügt über eine Actions -Eigenschaft, die die Regelaktionen für diese Regel darstellt, sowie über eine Conditions -Eigenschaft und eine Exceptions -Eigenschaft, die die Bedingungen für diese Regel darstellen. In diesem Thema ist beschrieben, wie das Regelobjektmodell die Regelaktionen unterstützt.
Regelaktionen für eine Regel werden durch ein RuleActions-Auflistungsobjekt dargestellt. Ein RuleActions -Objekt verfügt über Eigenschaften, die jeder gebräuchlich verwendeten Regelaktion in einer Regel entsprechen. Wenn eine Regel z. B. zwei Aktionen angibt – verschieben sie die Nachricht in einen bestimmten Ordner und gibt einen Sound ab – dann geben die MoveToFolder- und PlaySound-Eigenschaften des RuleActions-Auflistungsobjekts der Regel entsprechende Regelaktionsobjekte zurück, die aktiviert sind (RuleAction.Enabled ist True).
Aktionen, die nicht in einer Regel angegeben sind, werden nicht im entsprechenden RuleAction-Objekt aktiviert (RuleAction.Enabled ist False). Diese Regelaktionsobjekte werden entweder durch das \ RuleAction-Objekt oder benutzerdefinierte Objekte dargestellt, die vom RuleAction-Objekt abgeleitet sind. Speziell im letzten Beispiel wird von der RuleActions.MoveToFolder -Eigenschaft ein MoveOrCopyRuleAction -Objekt zurückgegeben, und die RuleActions.PlaySound -Eigenschaft gibt ein PlaySoundRuleAction -Objekt zurück, die beide vom RuleAction -Objekt abgeleitet sind. Das RuleAction -Objekt und dessen abgeleitete Objekte verfügen über die ActionType -Eigenschaft, die den Regelaktionstyp anzeigt. MoveOrCopyRuleAction.ActionType gibt beispielsweise den Wert olRuleActionMoveToFolder an, und PlaySoundRuleAction.ActionType gibt olRuleActionPlay an.
Hinweis
Das Rules-Objektmodell behält eine partielle Parität mit dem Regel- und Warnungs-Assistenten bei. Das bedeutet, dass während Sie mit dem Assistenten Regeln erstellen, die im Assistenten angezeigte Aktionen und Bedingungen angeben, Sie Regeln programmgesteuert erstellen können, die einige, aber nicht alle dieser Aktionen und Bedingungen verwenden. Ein Beispiel einer Aktion, die das Regelobjektmodell für Regeln unterstützt, die durch den Assistenten erstellt wurden jedoch nicht für solche, die durch das Objektmodell erstellt wurden, ist das Anfragen einer Serverantwort. Verwenden Sie den Assistenten, um eine Regel zu erstellen, die eine bestimmte Serverantwort als Aktion angibt.
Mit dem Regelobjektmodell, können Sie diese Regelarten in der Rules -Sammlung aufzählen - für jede Regel in der Rules -Sammlung, wird dessen RuleActions -Sammlung aufgezählt und es wird nach aktivierten Regelaktionen für eine Serverantwort gesucht. Im Code würde dies bedeuten, dass für jede Regel in der Rules-AuflistungRuleActions.Item(Index) mithilfe des Index von 1 bis RuleActions.Count aufgezählt und nach einer aktivierten Aktion mit ActionType gleich olRuleActionServerReply gesucht wird. Sie können eine solche Regelaktion auch in einer Regel aktivieren oder deaktivieren. Sie können jedoch nicht programmgesteuert eine Regel erstellen, die die olRuleActionServerReply-Aktion angibt.
In der folgenden Tabelle sind alle Regelaktionen aufgeführt, die vom Regel- und Warnungs-Assistenten unterstützt werden, und ob jede Regelaktion beim Erstellen einer Regel mithilfe des Regelobjektmodells unterstützt wird. Eine Regelaktion, die nicht in mit dem Regelobjektmodell erstellten Regeln unterstützt wird, ist nur für programmgesteuerte Aufzählung unterstützt und für das Aktivieren oder Deaktivieren in vorhandenen Regeln, die mit dem Assistenten für Regeln und Benachrichtigungen erstellt wurden. Die Tabelle zeigt auch, ob die Regelaktion auf Regeln mit den Regeltypen olRuleReceive oder olRuleSend angewendet wird, oder auf beide.
| Aktion | Konstante im olRuleAction-Typ | Unterstützt beim programmgesteuerten Erstellen neuer Regeln? | Anwenden auf olRuleReceive-Regeln? | Anwenden auf olRuleSend-Regeln? |
|---|---|---|---|---|
| Weisen Sie die Nachricht den Kategorien zu, die in der AssignToCategoryRuleAction.Categories-Eigenschaft angegeben sind. | olRuleActionAssignToCategory | Ja | Ja | Ja |
| Senden der Nachricht an die Empfängerliste, die in der SendRuleAction.Recipients-Eigenschaft angegeben ist | olRuleActionCcMessage | Ja | Nein | Ja |
| Löschen der Einträge aller Kategorien für die Nachricht. | olRuleActionClearCategories | Ja | Ja | Ja |
| Kopieren Sie die Nachricht in den Ordner, der in der MoveOrCopyRuleAction.Folder-Eigenschaft angegeben ist. | olRuleActionCopyToFolder | Ja | Ja | Ja |
| Ausführen einer benutzerdefinierten Aktion | olRuleActionCustomAction | Nein | Ja | Ja |
| Rückstellen der Übermittlung nach einer angegebenen Anzahl von Minuten | olRuleActionDefer | Nein | Nein | Ja |
| Die Nachricht wird gelöscht. | olRuleActionDelete | Ja | Ja | Nein |
| Dauerhaftes Löschen der Nachricht | olRuleActionDeletePermanently | Ja | Ja | Nein |
| Anzeigen einer Desktopwarnung | olRuleActionDesktopAlert | Ja | Ja | Nein |
| Deaktivieren der Nachrichtenkennzeichnung | olRuleActionFlagClear | Nein | Ja | Nein |
| Kennzeichnen der Nachricht mit der angegebenen Farbe | olRuleActionFlagColor | Nein | Ja | Nein |
| Kennzeichnen der Nachricht für Aktion in den angegebenen Tagen | olRuleActionFlagForActionInDays | Nein | Ja | Ja |
| Weiterleiten der Nachricht an die in der Eigenschaft SendRuleAction.Recipients angegebene Empfängerliste | olRuleActionForward | Ja | Ja | Nein |
| Weiterleiten der Nachricht als Anlage an die in der Eigenschaft SendRuleAction.Recipients angegebene Empfängerliste | olRuleActionForwardAsAttachment | Ja | Ja | Nein |
| Markieren der Nachricht mit der angegebenen Wichtigkeit | olRuleActionImportance | Nein | Ja | Ja |
| Markieren einer Nachricht als Aufgabe zur Nachverfolgung mithilfe der FlagTo- und MarkInterval-Eigenschaften des MarkAsTaskRuleAction-Objekts | olRuleActionMarkAsTask | Ja | Ja | Nein |
| Markieren als gelesen | olRuleActionMarkRead | Nein | Ja | Nein |
| Verschieben der Nachricht in den Ordner, der in der oveOrCopyRuleAction.Folder-Eigenschaft angegeben ist | olRuleActionMoveToFolder | Ja | Ja | Nein |
| Anzeigen der in der NewItemAlertRuleAction.Text-Eigenschaft angegebenen Meldung | olRuleActionNewItemAlert | Ja | Ja | Nein |
| Benachrichtigen, dass die Nachricht übermittelt wurde | olRuleActionNotifyDelivery | Ja | Nein | Ja |
| Benachrichtigen, dass die Nachricht gelesen wurde | olRuleActionNotifyRead | Ja | Nein | Ja |
| Wiedergeben der in der PlaySoundRuleAction.FilePath-Eigenschaft angegebenen WAV-Datei | olRuleActionPlaysound | Ja | Ja | Nein |
| Drucken der Nachricht auf dem Standarddrucker | olRuleActionPrint | Nein | Ja | Nein |
| Umleiten der Nachricht an die in der Eigenschaft SendRuleAction.Recipients angegebene Empfängerliste | olRuleActionRedirect | Ja | Ja | Nein |
| Starten eines Skript | olRuleActionRunScript | Nein | Ja | Nein |
| Markieren der Nachricht mit der angegebenen Vertraulichkeit | olRuleActionSensitivity | Nein | Nein | Ja |
| Serverantwort mit der angegebenen Nachricht | olRuleActionServerReply | Nein | Ja | Nein |
| Starten einer EXE | olRuleActionStartApplication | Nein | Ja | Nein |
| Verarbeiten weiterer Regeln beenden | olRuleActionStop | Ja | Ja | Ja |
| Antworten mit der angegebenen Vorlagendatei (OFT) | olRuleActionTemplate | Nein | Ja | Nein |
| Unbekannte Regelaktion | olRuleActionUnknown | Nein | Ja | Nein |
Support und Feedback
Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.