Choix d’une classe de message
S’applique à : Outlook 2013 | Outlook 2016
Comme décrit dans Classes de messages MAPI, les classes de message sont importantes pour établir la relation entre les types de messages personnalisés et, par extension, entre les serveurs de formulaires eux-mêmes. Heureusement, le choix d’une chaîne de classe de message est assez simple. La chaîne de classe de message d’une classe de message est une chaîne arbitraire, mais elle doit utiliser les conventions suivantes :
La chaîne doit satisfaire toutes les conventions décrites dans la documentation de la propriété PR_MESSAGE_CLASS (PidTagMessageClass). Il est important de noter que la chaîne doit être composée entièrement de caractères ANSI et comporter moins de 256 caractères.
Si votre serveur de formulaires est dérivé d’un serveur de formulaires existant ou s’il s’agit d’une extension d’un serveur de formulaires existant, votre chaîne de classe de message doit être formée en ajoutant un point et un autre mot à la chaîne de classe de message du serveur de formulaires sur lequel votre formulaire est basé. Par exemple, vous souhaiterez peut-être implémenter un formulaire pour replanifier une réunion, et votre formulaire est basé sur un formulaire existant pour la planification des réunions. Si la chaîne de classe de message du formulaire de planification de réunion est « IPM. Réunion », votre chaîne de classe de message peut être « IPM. Meeting.Reschedule ».
Si votre formulaire n’est basé sur aucun formulaire existant, votre chaîne de classe de message doit toujours commencer par le préfixe « IPM. » ou « IPC », selon que le formulaire est destiné à être reçu par une personne ou par une autre application. « IPM. » désigne un message personnel qui se retrouve généralement dans la boîte de réception d’un utilisateur, et « IPC » désigne un message de communication interprocessus qui n’est généralement pas remis à la boîte de réception d’un utilisateur.
Si votre classe de message est destinée à être lisible par l’homme, la chaîne de classe de message doit commencer par « IPM ». Une classe de message est généralement considérée comme lisible par l’homme si elle utilise des propriétés qui contiennent des données de texte brut, HTML ou RTF (Rich Text Format). Si votre formulaire utilise la propriété PR_BODY (PidTagBody), il doit presque certainement utiliser une chaîne de classe de message « IPM ». Par exemple, si vous implémentez un formulaire pour les bons de commande et que votre organization exige que les bons de commande soient approuvés par un responsable, votre chaîne de classe de message peut être « IPM. Purchase_Order ». Les formulaires conçus pour être utilisés avec des dossiers publics ou des applications de dossiers publics sont généralement considérés comme personnels, car ils sont lus par des personnes, même s’ils ne sont pas réellement adressés à l’adresse e-mail d’une personne. Le préfixe classique pour les classes de messages de dossier public est « IPM.Post ».
Si votre classe de message est destinée à être reçue par une autre application plutôt que par une personne, la chaîne de classe de message doit commencer par « IPC ». Par exemple, si vous implémentez un formulaire qui permet aux utilisateurs de s’abonner automatiquement à des listes de diffusion, votre chaîne de classe de message peut être « IPC. Abonnez-vous ».
Votre chaîne de classe de message ne doit jamais se terminer par un point.
La chaîne de classe de message doit être placée dans la section [Description] du fichier de configuration du formulaire, dans l’entrée MessageClass , comme suit :
MessageClass=IPM.Meeting.Reschedule
Une fois que vous avez choisi une chaîne de classe de message appropriée, vous devez générer un identificateur de classe pour celle-ci. Les identificateurs de classe peuvent être générés avec la commande Create GUID incluse dans Visual Studio. L’identificateur de classe doit être placé dans l’entrée CLSID du fichier de configuration du formulaire, avec l’entrée MessageClass , semblable à ce qui suit :
CLSID={88FFF551-B8C5-11ce-8DE0-00AA0060D242}
Votre identificateur de classe sera presque certainement différent, bien sûr. Pour plus d’informations, consultez Création d’un fichier de configuration de formulaire.
Lorsque le formulaire est installé sur l’ordinateur d’un utilisateur, votre processus d’installation ( qu’il s’agisse d’un programme d’installation ou autre) doit effectuer une entrée de Registre dans la section *HKEY_CLASSES_ROOT\CLSID* du Registre pour l’identificateur de classe. Cette entrée doit être définie sur la chaîne de classe de message. Par exemple, vous devez créer une entrée de Registre similaire à la suivante pour l’exemple d’identificateur de classe ci-dessus :
HKEY_CLASSES_ROOT\CLSID\{88FFF551-B8C5-11ce-8DE0-00AA0060D242}="IPM.Meeting.Reschedule"
Pour plus d’informations, consultez Installation d’un formulaire dans une bibliothèque.