Создание правила для передачи почтовых элементов от руководителя и их пометки к исполнению
В этом примере показано, как задать правило для передачи почтовых элементов от руководителя пользователя и пометить их к исполнению.
Пример
Примечание.
Приведенный ниже пример кода представляет собой фрагмент из книги Программирование приложений для Microsoft Office Outlook 2007.
Правила Outlook могут выполняться как на стороне сервера, так и на стороне клиента, в зависимости от типа учетной записи и правила. Существует несколько способов реализации правил в соответствии с принятой в организации схемой хранения элементов в почтовых ящиках. Например, можно создать иерархию вложенных папок, в которых будут храниться прочитанные и непрочитанные сообщения по теме. Также можно создать иерархию вложенных папок, упорядоченную по отправителю сообщения. Кроме того, можно назначать сообщениям категории и использовать папки поиска для сбора сообщений по категориям.
Объектная модель Rules содержит объект Rule , представляющий правило в приложении Outlook, что позволяет создавать программным способом правила, реализующие принятую в организации схему, создавать уникальные правила для решений, а также обеспечивать развертывание определенных правил для групп пользователей. С помощью объектной модели Rules можно программным способом добавлять, изменять и удалять правила. С помощью коллекции Rules и объекта Rule также можно получать доступ к правилам, определенным для сеанса, добавлять и удалять их.
Объект Rule содержит свойство RuleType , которое определяет тип правила (отправка или получение). Свойство RuleType устанавливается при создании правила и может быть изменено только посредством удаления правила или его повторного создания с другим значением свойства RuleType. Объекты RuleAction и RuleCondition , соответствующие объекты коллекций, производные действия и объекты условий обеспечивают дополнительные возможности по изменению действий и условий правил.
В объектной модели Rules поддерживаются не все правила, которые можно создать с помощью мастера правил и оповещений в интерфейсе пользователя Outlook, однако при этом обеспечивается поддержка наиболее распространенных действий и условий. Правила, создаваемые с помощью мастера правил и оповещений, которые применяются к сообщениям, в том числе к почтовым элементам, приглашениям на собрания, запросам на задачи, документам, уведомлениям о доставке, уведомлениям о прочтении, результатам голосования и уведомлениям об отсутствии на работе, также можно создавать программным способом.
Правило может выполняться на сервере Exchange или в клиенте Outlook при условии, что почтовый ящик текущего пользователя размещается на сервере Exchange. Свойство IsLocalRule объекта Rule возвращает значение true, свидетельствующее о выполнении правила в клиенте и необходимости запуска приложения Outlook для выполнения правила. Если правило выполняется на сервере, для оценки условий и выполнения действий правила запускать приложение Outlook не требуется.
Примечание.
[!Примечание] Отдельная коллекция, представляющая условия исключений из правила, не предусмотрена. Следует использовать свойство Exceptions объекта Rule для получение коллекции RuleConditions , которая представляет условия исключений из правила.
Для создания правил с помощью объектной модели Outlook выполните следующие действия:
Получите коллекцию Rules из свойства DefaultStore объекта NameSpace , вызвав метод GetRules() для объекта Store по умолчанию. Используйте попробовать... блокировка catch для учетной записи пользователя, который находится в автономном режиме или отключен от сервера Exchange Server. Это предотвращает появление ошибки в Outlook.
Вызовите метод Create(String, OlRuleType) для объекта Rules, чтобы создать переменную экземпляра объекта Rule. Для этого укажите параметры Name и OlRuleType.
С помощью коллекций RuleActions и RuleConditions включите действия, условия и исключения для объекта Rule. Обратите внимание, что условия, включенные в коллекции RuleConditions, возвращаемой свойством Exceptions , обрабатываются как условия исключений из правила и добавление встроенных настраиваемых действий и условий в эту коллекцию не поддерживается.
Присвойте свойству Enabled значение true для любого подлежащего исполнению действия, условия или исключения. Для некоторых действий и свойств, например для свойства Folder , требуется настройка дополнительных свойств, позволяющих сохранять объект Rule без ошибок.
В завершение вызовите метод Save(Object) для коллекции Rules, чтобы сохранить созданные или измененные правила. Для обработки исключений метод Save следует заключить в блок try…catch.
В следующем примере кода в процедуре CreateManagerRule реализованы описанные выше действия. В процедуре CreateManagerRule сначала проверяется, представляет ли свойство CurrentUser объект ExchangeUser, который определяет, является ли текущий пользователь пользователем Exchange. Если текущий пользователь является пользователем Exchange, процедура CreateManagerRule получает руководителя текущего пользователя путем вызова метода GetExchangeUserManager() для объекта ExchangeUser свойства CurrentUser объекта NameSpace. После этого создается правило получения для перемещения полученных сообщений во вложенную папку папки "Входящие" для следующих условий:
Отправителем сообщения является руководитель пользователя.
Получатель указан в строке Кому: сообщения.
Сообщение не является приглашением на собрание или обновлением такого приглашения.
В завершение сообщение помечается к исполнению за сегодняшний день. В процедуре CreateManagerRule также реализован правильный порядок обработки ошибок при условиях, которые могут привести к возникновению исключений, например в случае перехода пользователя в автономный режим или отключения в режиме Exchange с кэшированием.
Если вы используете Visual Studio для тестирования этого примера кода, сначала добавьте ссылку на компонент Microsoft Outlook 15.0 Object Library и задайте переменную Outlook при импорте пространства имен Microsoft.Office.Interop.Outlook. Инструкция using не должна находиться непосредственно перед функциями в примере кода, но ее нужно добавить перед объявлением общедоступного класса. В следующей строке кода показано, как выполнить импорт и назначение в C#.
using Outlook = Microsoft.Office.Interop.Outlook;
private void CreateManagerRule()
{
Outlook.ExchangeUser manager;
Outlook.Folder managerFolder;
Outlook.AddressEntry currentUser =
Application.Session.CurrentUser.AddressEntry;
if (currentUser.Type == "EX")
{
try
{
manager = currentUser.
GetExchangeUser().GetExchangeUserManager();
}
catch
{
Debug.WriteLine("Could not obtain user's manager.");
return;
}
Outlook.Rules rules;
try
{
rules = Application.Session.DefaultStore.GetRules();
}
catch
{
Debug.WriteLine("Could not obtain rules collection.");
return;
}
if (manager != null)
{
string displayName = manager.Name;
Outlook.Folders folders =
Application.Session.GetDefaultFolder(
Outlook.OlDefaultFolders.olFolderInbox).Folders;
try
{
managerFolder =
folders[displayName] as Outlook.Folder;
}
catch
{
managerFolder =
folders.Add(displayName, Type.Missing)
as Outlook.Folder;
}
Outlook.Rule rule = rules.Create(displayName,
Outlook.OlRuleType.olRuleReceive);
// Rule conditions
// From condition
rule.Conditions.From.Recipients.Add(
manager.PrimarySmtpAddress);
rule.Conditions.From.Recipients.ResolveAll();
rule.Conditions.From.Enabled = true;
// Sent only to me
rule.Conditions.ToMe.Enabled = true;
// Rule exceptions
// Meeting invite or update
rule.Exceptions.MeetingInviteOrUpdate.Enabled = true;
// Rule actions
// MarkAsTask action
rule.Actions.MarkAsTask.MarkInterval =
Outlook.OlMarkInterval.olMarkToday;
rule.Actions.MarkAsTask.FlagTo = "Follow-up";
rule.Actions.MarkAsTask.Enabled = true;
// MoveToFolder action
rule.Actions.MoveToFolder.Folder = managerFolder;
rule.Actions.MoveToFolder.Enabled = true;
try
{
rules.Save(true);
}
catch (Exception ex)
{
Debug.WriteLine(ex.Message);
}
}
}
}