Project-Outlook

Outlook-Daten

Auslesen der Aufgabenlisten aus Outlook

Organisation von Daten in Outlook

Outlook bildet intern eine Ordnerstruktur ab, die vergleichbar ist mit Ordnern auf einer Festplatte. In den Ordnern befinden sich die E-Mails, Kontakte usw.
Alle E-Mails, Aufgaben und Kontakte besitzen ein gemeinsames Interface item. Bevor auf die Eigenschaften eines Objektes zugegriffen werden kann, muss ein Casting durchgeführt werden.
Für jeden Ordner ist festgelegt, von welchem Typ (E-Mails, Kontakte…) seine enthaltenen Daten sind, siehe Abbildung. Trotz dieser Festlegung können auch Daten eines anderen Typs enthalten sein. Beispielsweise dürfen E-Mails in einem Ordner abgelegt werden, der für Aufgaben vorgesehen ist.


Bild: Auswahl des Typs (E-Mails, Aufgaben etc.) bei der Erstellung eines Ordners in Outlook

Voraussetzungen zum Zugriff auf den Code

Für einen Zugriff auf die Daten muss eine Verbindung zwischen dem compilierten Programmcode und dem Outlook-Prozess hergestellt werden. Dies lässt sich mit sehr einfach mit einem Addin realisieren. Visual Studio bietet ein vordefiniertes Projekt Outlook 2007 Add-In an. Mit Hilfe einer Variable erhält man Zugriff auf die Outlook-Session.

Ausschnitte aus dem Sourcecode

Hinweis: Die Codeausschnitte wurden aus Gründen der Übersichtlichkeit gekürzt.

Klasse OutlookController

Der Konstruktor der Klasse OutlookController erhält einen Übergabeparameter vom Typ Outlook.Application (Z6). Dabei handelt es sich um eine Referenz auf die Outlooksitzung. Über die Referenz kann auf die gesamte Ordnerstruktur innerhalb Outlook zugegriffen werden. Um auf alle Unterordner zugreifen zu können, wird die Funktion findTaskFolder() rekursiv aufgerufen (Z13, Z45). Die Funktion speichert alle für Aufgaben vorgesehene Ordner in einer ArrayList (Z39). Ausnahme bilden der Papierkorb und der Spam-Ordner (Z23ff). Sie werden von dem Durchsuchen ausgenommen. Zur weiteren Analyse jedes Aufgabenordners wird eine selbstentwickelte Klasse TaskFolder verwendet (Z39).

  1. public class OutlookController
  2. {
  3.     private Outlook.Application OutlookSession;
  4.     private ArrayList mTaskFolders = new ArrayList();
  5.  
  6.     public OutlookController(Outlook.Application Session)
  7.     {
  8.         OutlookSession = Session;
  9.  
  10.         //start searching for task folders
  11.         foreach (Outlook.Folder fold in OutlookSession.Session.Folders)
  12.         {
  13.             findTaskFolder(fold);
  14.         }
  15.     }
  16.  
  17.  
  18.     private void findTaskFolder(Outlook.Folder folder)
  19.     {
  20.         //ignore folder with deleted items and junk folder
  21.         //detect these 2 folders via name of default junk and default trash
  22.         //folder
  23.         if (folder.Name
  24.                 != OutlookSession.Session.
  25.                 GetDefaultFolder(Microsoft.Office.Interop.
  26.                 Outlook.OlDefaultFolders.olFolderDeletedItems).Name
  27.                 &&
  28.             folder.Name
  29.                 != OutlookSession.Session.
  30.                 GetDefaultFolder(Microsoft.Office.Interop.
  31.                 Outlook.OlDefaultFolders.olFolderJunk).Name
  32.             )
  33.         {
  34.  
  35.             //only remind folders containing tasks
  36.             if (folder.DefaultItemType.GetHashCode() ==
  37.                 Outlook.OlItemType.olTaskItem.GetHashCode())
  38.             {
  39.                 mTaskFolders.Add(new TaskFolder(folder));
  40.             }
  41.  
  42.             //find subfolders in this folder, recursively
  43.             foreach (Outlook.Folder fold in folder.Folders)
  44.             {
  45.                 findTaskFolder(fold);
  46.             }
  47.         }
  48.     }
  49. }
[Get Code]

Klasse TaskFolder

Wie bereits beschreiben, kann ein Ordner mit Aufgaben auch E-Mails etc. enthalten. Aus diesem Grund werden alle Aufgaben herausgefiltert (Z9). Jede Aufgabe in Outlook wird über ein Objekt der selbstentwickelten Klasse ExtendedTask verwaltet (Z12).

  1. public class TaskFolder
  2. {
  3.     Outlook.Folder fold;
  4.     ArrayList taskarr = new ArrayList();
  5.  
  6.     public TaskFolder(Outlook.Folder uebfolder)
  7.     {
  8.         fold = uebfolder;
  9.         var result = uebfolder.Items.OfType<Outlook.TaskItem>();
  10.         foreach(Outlook.TaskItem titem in  result)
  11.         {
  12.             taskarr.Add(new ExtendedTask(titem));
  13.         }
  14.     }
  15. }
[Get Code]

Klasse ExtendedTask

Die Klasse erhält über den Konstruktor auf eine Referenz auf eine Aufgabe in Outlook (Z5). Die Referenz wird in der Klasse gespeichert.
Weitere Funktionen sind Getter auf die Eigenschaften der Aufgabe und die Berechnung der Priorität (Z10, Z18, Z37). Die Priorität in Outlook 2007 kann folgende Werte annehmen: hoch, normal oder niedrig. Daraus wird ein Zahlenwert abgeleitet. Für die Visualisierung wird zusätzlich eine normierte Priorität berechnet.

  1. public class ExtendedTask
  2. {
  3.     private Outlook.TaskItem mitem;
  4.  
  5.     public ExtendedTask(Outlook.TaskItem uitem)
  6.     {
  7.         mitem = uitem;
  8.     }
  9.  
  10.     public Outlook.TaskItem Task
  11.     {
  12.         get
  13.         {
  14.             return mitem;
  15.         }
  16.     }
  17.  
  18.     public double calculatedpriority
  19.     {
  20.         get
  21.         {
  22.             //high ~ 0
  23.             //middle ~ 1
  24.             //low ~ 2
  25.             double prio;
  26.             if (Task.Importance == Outlook.OlImportance.olImportanceLow)
  27.                 prio = 2.0;
  28.             else if (Task.Importance == Outlook.OlImportance.olImportanceNormal)
  29.                 prio = 1.0;
  30.             else //importance high
  31.                 prio = 0.0;
  32.  
  33.             return prio;
  34.         }
  35.     }
  36.  
  37.     public double calculatednormalizedpriority
  38.     {
  39.         get
  40.         {
  41.             return calculatedpriority / 2.0;
  42.         }
  43.     }
  44. }
[Get Code]

← Umsetzung als Outlook-Addin | ● | Erzeugen und Darstellen von 3D-Modellen in WPF →

Options: