Implementieren von One-Off Tabellen
Gilt für: Outlook 2013 | Outlook 2016
Ihr Anbieter kann eine oder mehrere einmalige Tabellen implementieren. Eine einmalige Tabelle ist eine Zusammenfassungsliste von einmaligen Vorlagen, die zum Erstellen von Empfängern verwendet werden, entweder direkt in einem Container oder in der Empfängerliste einer ausgehenden Nachricht. Eine einmalige Vorlage ist ein Formular, mit dem Benutzer Daten eingeben, die für einen bestimmten Adresstyp relevant sind. Wenn der Benutzer die Arbeit mit der Vorlage abgeschlossen hat, erstellt Ihr Anbieter den neuen Empfänger und fügt ihn der Nachricht hinzu. In der Regel verarbeitet jede Vorlage einen einzelnen Adresstyp. Es ist jedoch möglich, dass eine Vorlage mehrere Typen behandelt oder mehrere Vorlagen denselben Typ behandeln.
Ihr Anbieter muss die OpenEntry-Methode für jede Vorlage unterstützen, die in der einmaligen Tabelle enthalten ist. Die Implementierung von OpenEntry sollte eine Anzeigetabelle für die Vorlage abrufen. MAPI verwendet die Anzeigetabelle, um die Vorlage für den Benutzer sichtbar zu machen.
Obwohl die meisten Zeilen in einmaligen Tabellen Vorlagen darstellen, können einige zeilen zum Kategorisieren oder Gruppieren von Vorlagen verwendet werden. Ob eine Zeile in einer einmaligen Tabelle eine Vorlage darstellt, wird durch den Wert der PR_SELECTABLE Spalte (PidTagSelectable) angegeben. Zeilen, die Vorlagen darstellen, haben die PR_SELECTABLE Spalte auf TRUE festgelegt; Zeilen, die keine Vorlagen darstellen, ist auf FALSE festgelegt.
MAPI definiert drei Typen von einmaligen Tabellen:
Eine einmalige Tabelle, die die Vorlagen widerspiegelt, die ein einzelner Container unterstützt
Eine einmalige Tabelle, die alle Vorlagen enthält, die Ihr Anbieter unterstützt.
Eine einmalige Tabelle, die alle Vorlagen enthält, die alle Anbieter im Profil unterstützen, sowie einige, die MAPI unterstützt.
Die ersten beiden Typen werden von Anbietern implementiert, die die Erstellungsempfänger unterstützen, entweder in einer Nachricht oder in einem Container. Ihr Anbieter kann denselben Satz oder einen anderen Satz von Vorlagen in seine einmaligen Tabellen einschließen. Der Standard Unterschied zwischen den beiden Typen besteht darin, dass Ihre Anbietertabelle Vorlagen zum Erstellen von Empfängern enthalten sollte, die für ausgehende Nachrichten verwendet werden können, und Dass Ihre Containertabelle Vorlagen zum Erstellen von Empfängern enthalten sollte, die Ihrem Container hinzugefügt werden sollen. Ein Container unterstützt möglicherweise nur einen eingeschränkten Satz von Vorlagen, aber die einmalige Anbietertabelle sollte jede Vorlage enthalten, die der Anbieter unterstützt.
Die dritte Art von einzelseitiger Tabelle wird von MAPI implementiert; Anbieter erhalten Zugriff darauf, indem sie IMAPISupport::GetOneOffTable aufrufen. Die einmalige MAPI-Tabelle ist die Vereinigung aller Anbietertabellen. Es enthält jede Vorlage, die von jedem Anbieter im Profil unterstützt wird. Es enthält auch Vorlagen, die von MAPI unterstützt werden. Ihr Anbieter kann diese Tabelle anstelle der für einen Container angeforderten Tabelle verwenden. Die Vorlagen in dieser Tabelle können jedoch auch zum Erstellen von Empfängern für ausgehende Nachrichten verwendet werden.