Outlook tworzenie reguły przenoszenia wiadomości

Taka prosta operacja, którą każdy potrafi wykonać z poziomu UI w outlooku już taką prostą operacją z poziomu kodu nie jest.  Albo dokładnie mówiąc jest, jeżeli wie się wszystko i pisało się Outlooka. To pewnie banalna sprawa. Jeżeli jednak tak jak ja, nie pisaliście nigdy nic pod outlook to pewnie dla was to będzie taka sama zagwozdka jak dla mnie. A dla mnie była dość dużą zagwozdką, bo przez brak jednej linijki zmarnowałem!!!! Cały dzień debuggując i zachodząc co jest nie tak.

Moje zadanie polegało na tym, by dodać zasadę, że jak przyjdzie email, którego nie chcemy to możemy na nim kliknąć i powiedzieć: przenieść mi to do Junk Email folder za każdym razem jak ten sam nadawca wyśle mi wiadomość. Czyli tak zwana reguła: przenieść mail od danej osoby do danego folderu.

Wiedząc co chcemy robić zabieramy się do roboty.

Będziemy tworzyć obiekty COMowe więc potrzebujemy trochę więcej rzeczy niż normalnie. By w ogóle rozpocząć to potrzebujemy dostęp do przestrzeni nazw (Outlook Name Space – MAPI jest jedynym dostępnym przynajmniej w Outlook 2007) by dobrać się do storage w którym są przechowywane takie rzeczy jak reguły. Na razie opiszę kod a potem pokarzę pełną wersję:

var session = _outlook.Session;
var store = session.DefaultStore;
var rules = store.GetRules();

Mając dostęp do reguł, możemy stworzyć nową regułę:

var rule = rules.Create(ruleName, OlRuleType.olRuleReceive);

I następnie już działać w oparciu o nią dodając różne warunki i akcje.

Dla przykładu warunek od kogo otrzymaliśmy wiadomość wygląda tak:

var ruleConditions = rule.Conditions;
var fromCondition = ruleConditions.From;
fromCondition.Recipients.Add(email);

// UWAGA zaraz o tym napiszę
fromCondition.Recipients.ResolveAll();
fromCondition.Enabled = true;

Akcja przenoszenia do folderu:

var ruleActions = rule.Actions;
var moveRuleAction = ruleActions.MoveToFolder;

moveRuleAction.Folder = destinationFolder;
moveRuleAction.Enabled = true;

Całośc naspnie trzeba zapisać:

rules.Save(true);

Niby proste? No ale. Jeżeli nie zrobicie ResolveAll() to wasza reguła będzie wyglądała tak samo jakbyście ją stworzyli z palca ALE WAM NIGDY NIE ZADZIAŁA. Nawet jeżeli dodajecie osobę która nie jest kontaktem tylko dodajecie ją po email to musicie zrobić ResolveAll(). Tego oczywiście nigdzie nie ma powiedziane, albo ja nie znalazłem. Kosztowało to mnie dzień………. dzień.

Jest jeszcze jedna sprawa, folder musi istnieć do którego się próbujemy dostać. Plusem jest to, że w naszym przypadku to są dwie linijki:

var rootFolder = store.GetRootFolder();
var destinationFolder = session.GetDefaultFolder(OlDefaultFolders.olFolderJunk);

Poniżej cały kod metody wraz z sprawdzianem czy nasza reguła już istnieje:

private readonly _Application _outlook;

public bool Block(string email)
{
    var ruleName = Msgs.BlockedEmailRuleName.FormatWith(email);

    NameSpace session = null;
    Store store = null;
    Rules rules = null;
    MAPIFolder destinationFolder = null;
    MAPIFolder rootFolder = null;
    Rule rule = null;
    RuleConditions ruleConditions = null;
    ToOrFromRuleCondition fromCondition = null;
    RuleActions ruleActions = null;
    MoveOrCopyRuleAction moveRuleAction = null;

    try
    {
        session = _outlook.Session;
        store = session.DefaultStore;
        rules = store.GetRules();

        var exists = rule_exists(ruleName, rules);
        if (exists)
        {
            return true;
        }

        rootFolder = store.GetRootFolder();
        destinationFolder = session.GetDefaultFolder(OlDefaultFolders.olFolderJunk);

        rule = rules.Create(ruleName, OlRuleType.olRuleReceive);

        ruleConditions = rule.Conditions;

        fromCondition = ruleConditions.From;
        fromCondition.Recipients.Add(email);
        fromCondition.Recipients.ResolveAll();
        fromCondition.Enabled = true;

        ruleActions = rule.Actions;
        moveRuleAction = ruleActions.MoveToFolder;
        moveRuleAction.Folder = destinationFolder;
        moveRuleAction.Enabled = true;

        rules.Save(true);
    }
    catch(System.Exception ex)
    {
        _log.Error(ex, "Block|");
        return false;
    }
    finally
    {
        moveRuleAction.Release();
        ruleActions.Release();
        fromCondition.Release();
        ruleConditions.Release();
        rule.Release();
        rootFolder.Release();
        destinationFolder.Release();
        rules.Release();
        store.Release();
        session.Release();
    }

    return true;
}

private bool rule_exists(string name, Rules rules)
{
    Rule rule = null;

    try
    {
        for (var i = 1; i <= rules.Count; i++)
        {
            rule = rules[i];

            if (rule.Name == name)
            {
                return true;
            }

            rule.Release();
        }
    }
    catch {}
    finally
    {
        rule.Release();
    }

    return false;
}

Mam nadzieję, że się komuś ten krótki fragment kodu przyda. Mi go brakowało :(