Implémentation de tables One-Off
S’applique à : Outlook 2013 | Outlook 2016
Votre fournisseur peut implémenter une ou plusieurs tables ponctuelles. Une table unique est une liste récapitulative de modèles ponctuels utilisés pour créer des destinataires, soit directement dans un conteneur, soit dans la liste des destinataires d’un message sortant. Un modèle unique est un formulaire que les utilisateurs utilisent pour entrer des données pertinentes pour un type particulier d’adresse. Lorsque l’utilisateur a fini d’utiliser le modèle, votre fournisseur crée le nouveau destinataire et l’ajoute au message. En règle générale, chaque modèle gère un type d’adresse unique. Toutefois, il est possible qu’un modèle gère plusieurs types ou que plusieurs modèles gèrent le même type.
Votre fournisseur doit prendre en charge la méthode OpenEntry pour chaque modèle qu’il inclut dans la table unique. L’implémentation d’OpenEntry doit récupérer une table d’affichage pour le modèle. MAPI utilise la table d’affichage pour rendre le modèle visible par l’utilisateur.
Bien que la plupart des lignes des tables ponctuelles représentent des modèles, certaines lignes peuvent être utilisées pour catégoriser ou regrouper des modèles. La valeur de sa colonne PR_SELECTABLE (PidTagSelectable) indique si une ligne d’une table unique représente ou non un modèle. Les lignes qui représentent des modèles ont la colonne PR_SELECTABLE définie sur TRUE ; les lignes qui ne représentent pas les modèles ont la valeur FALSE.
MAPI définit trois types de tables ponctuelles :
Tableau unique qui reflète les modèles pris en charge par un conteneur individuel
Tableau unique qui reflète tous les modèles pris en charge par votre fournisseur
Tableau unique qui reflète tous les modèles pris en charge par tous les fournisseurs du profil, ainsi que certains d’entre eux pris en charge par MAPI
Les deux premiers types sont implémentés par les fournisseurs qui prennent en charge les destinataires de création, sur un message ou dans un conteneur. Votre fournisseur peut inclure le même ensemble ou un autre ensemble de modèles dans ses tables ponctuelles. La différence main entre les deux types est que votre table de fournisseur doit inclure des modèles de création de destinataires qui peuvent être utilisés sur les messages sortants et que votre table de conteneurs doit inclure des modèles pour créer des destinataires à ajouter à votre conteneur. Un conteneur peut uniquement prendre en charge un ensemble restreint de modèles, mais la table unique du fournisseur doit inclure tous les modèles pris en charge par le fournisseur.
Le troisième type de table unique est implémenté par MAPI ; les fournisseurs y accèdent en appelant IMAPISupport ::GetOneOffTable. La table unique MAPI est l’union de toutes les tables de fournisseur ; il inclut tous les modèles pris en charge par chaque fournisseur dans le profil. Il inclut également des modèles pris en charge par MAPI. Votre fournisseur peut utiliser cette table à la place de la table demandée pour un conteneur. Toutefois, les modèles de cette table peuvent également être utilisés pour créer des destinataires pour les messages sortants.