Restrictions du carnet d’adresses
S’applique à : Outlook 2013 | Outlook 2016
Les fournisseurs de carnets d’adresses doivent prendre en charge trois types de restrictions sur les tables de contenu de leurs conteneurs :
Restrictions de propriété de nom ambigu
Restrictions de propriété de clé d’instance
Restrictions de contenu de nom d’affichage préfixé
Les restrictions de nom ambigu sont des restrictions de propriété utilisant la propriété PR_ANR (PidTagAnr) pour faire correspondre les noms de destinataires avec les entrées dans les conteneurs de carnets d’adresses. La restriction de propriété PR_ANR est un type de recherche « best guess » dans lequel les fournisseurs de carnets d’adresses peuvent choisir la propriété correspondante qui convient le mieux à leur conteneur. Par exemple, un fournisseur de carnet d’adresses peut implémenter la restriction PR_ANR en faisant correspondre les noms de destinataires à la propriété PR_ACCOUNT (PidTagAccount) de chaque entrée de conteneur, tandis qu’un autre fournisseur peut utiliser PR_DISPLAY_NAME (PidTagDisplayName).
MAPI recommande que les implémentations de la restriction PR_ANR équilibrent entre des performances adéquates et la satisfaction des utilisateurs. La satisfaction de l’utilisateur peut être compromise lorsqu’un fournisseur de carnet d’adresses implémente la restriction de telle sorte que trop peu ou trop de correspondances sont trouvées. Certains fournisseurs de carnets d’adresses prennent en charge ce que l’on appelle un nom unique ou commun qui n’est pas affichable dans une boîte de dialogue, mais qui peut correspondre à une restriction de nom ambiguë.
Une implémentation classique peut être d’analyser le nom d’affichage du destinataire en mots, en faisant correspondre n’importe quelle entrée qui contient tous les mots. Attention aux détails tels que la sensibilité à la position du mot, si les mots non concutifs sont mis en correspondance et le choix des caractères séparateurs peut varier. Par exemple, si le nom à résoudre est « Bill L », une restriction de PR_ANR classique sélectionne les entrées suivantes comme correspondance :
Billy Larson
Bill Lee
Bill Logan Jr.
Sam Bill Lee
Les restrictions de clé d’instance, ou restrictions de propriété PR_INSTANCE_KEY (PidTagInstanceKey), sont utilisées dans l’implémentation des zones de liste utilisées dans les applications clientes pour l’affichage des tables MAPI. Certaines implémentations de zone de liste permettent aux utilisateurs d’effectuer plusieurs sélections, de faire défiler vers le haut ou vers le bas et de revenir au premier élément sélectionné. Pour implémenter ce comportement, les clients appellent IMAPITable ::FindRow, en passant une restriction de propriété sur la propriété PR_INSTANCE_KEY à la méthode . Les fournisseurs de carnets d’adresses sont nécessaires pour prendre en charge cette restriction.
Une autre fonctionnalité des zones de liste utilisées pour l’affichage des tables est la possibilité de positionner le curseur en fonction d’un ensemble de caractères de préfixe. Lorsque l’utilisateur commence à taper des caractères de préfixe, le client déplace le curseur vers le premier élément qui commence par ces caractères. Les clients implémentent cette fonctionnalité avec une restriction de contenu basée sur la propriété PR_DISPLAY_NAME et le niveau flou FL_PREFIX.