Managing Rules in the Outlook Object Model

Le modèle objet Rules prend en charge l’ajout, la modification et la suppression par programmation de règles. Les objets de collection Rule et Rules vous permettent d’accéder, d’ajouter et de supprimer des règles définies pour une session. Les objets RuleAction et RuleCondition , leurs objets de collection et les objets d’action et de condition dérivés prennent en charge la modification des actions et des conditions.

Remarque

Le modèle objet Rules fournit une parité partielle avec l’Assistant Règles et alertes dans l’interface utilisateur d’Outlook. Bien qu’il ne prenne pas en charge toutes les règles que vous pouvez éventuellement créer à l’aide de l’Assistant, il prend en charge les actions et conditions de règle les plus couramment utilisées. Comme toute règle créée à l’aide de l’Assistant Règles et alertes , les règles créées par programme sont appliquées aux messages, notamment les éléments de courrier, les demandes de réunion, les demandes de tâches, les documents, les reçus de remise, les confirmations de lecture, les réponses aux votes et les avis d’absence du bureau.

Utilisez Store.GetRules pour obtenir un objet de collection Rules représentant les règles définies pour le magasin utilisé dans la session active.

Après avoir obtenu l’ensemble de règles pour la session active, vous pouvez ajouter de nouvelles règles (à l’aide de Rules.Create), modifier des règles existantes (en activant ou désactivant des règles, en modifiant leur ordre d’exécution et en modifiant les actions de règle et les conditions de règle), ou supprimer des règles (à l’aide de Rules.Remove) de cette collection Rules . Notez que si vous pouvez modifier des règles créées dans les versions d’Outlook antérieures à Microsoft Office Outlook 2007, vous ne pouvez pas utiliser des versions antérieures d’Outlook pour modifier des règles qui ont été créées dans Office Outlook 2007 ou version ultérieure.

Vous pouvez récupérer chaque règle d’une collection Rules en indexant la collection à l’aide de Rules.Item(Index),index étant soit le nom de la règle (la propriété par défaut Rule.Name), soit une valeur comprise entre 1 et le nombre total de règles dans la collection, Rules.Count.

Rule.ExecutionOrder indique l’ordre d’exécution des règles dans la collection et est directement mappé à la valeur numérique index dansRules.Items(Index). Par exemple, Rules.Item(1) représente une règle avec Rule.ExecutionOrder ayant la valeur 1, Rules.Item(2) représente une règle avec Rule.ExecutionOrder étant 2 et Rules.Item(Rules.Count) représente la règle avec Rule.ExecutionOrder étant Rules.Count.

Une fois que vous avez défini une règle, vous devez également l’activer en définissant la propriété Rule.Enabled sur True, puis enregistrer la règle à l’aide de Rules.Save afin que la règle et son état activé persistent au-delà de la session active. Une règle est activée uniquement après avoir été correctement enregistrée. Notez que Rules.Save peut être une opération coûteuse en termes de performances sur les connexions lentes au serveur Exchange . vous pouvez éventuellement afficher une boîte de dialogue de progression permettant à l’utilisateur d’annuler l’opération. Un enregistrement échoue lorsque l’utilisateur modifie la même règle dans l’Assistant Règles et alertes, ou lorsque l’utilisateur annule la boîte de dialogue de progression. Dans ce cas, Rules.Save génère une erreur et l’utilisateur résout le conflit en répondant à la boîte de dialogue d’erreur générée par l’Assistant Règles et alertes.

Lorsque vous utilisez Rules.Save pour enregistrer une ou plusieurs règles qui ont été créées dans Office Outlook 2007, vous êtes invité à entrer une boîte de dialogue pour vous rappeler que vous ne pourrez pas modifier cette règle à l’aide de versions antérieures d’Outlook. Vous devez confirmer la boîte de dialogue avant que l’opération d’enregistrement puisse continuer.

Utilisez Rule.Execute pour exécuter une règle. Notez que bien que vous deviez activer et enregistrer une règle pour qu’elle reste active au-delà de la session en cours, vous pouvez exécuter la règle quel que soit son état. Lorsque vous exécutez une règle, vous pouvez, si vous le souhaitez, spécifier le dossier auquel vous voulez l’appliquer. La valeur par défaut consiste à exécuter la règle sur tous les messages de la boîte de réception, mais pas sur les sous-dossiers de la boîte de réception.

Assistance et commentaires

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.