Partager via

À propos de l’API Disponibilité

  • Article

L’API Disponibilité permet aux fournisseurs de messagerie de fournir des informations de disponibilité status pour les comptes d’utilisateur spécifiés dans un intervalle de temps spécifié. La status de disponibilité d’un bloc de temps sur le calendrier d’un utilisateur est l’une des suivantes : absence du bureau, occupé, provisoire ou gratuit.

Créer un fournisseur de disponibilité

Pour fournir des informations de disponibilité aux utilisateurs de messagerie, un fournisseur de messagerie crée un fournisseur de disponibilité et l’inscrit auprès d’Outlook. Le fournisseur de disponibilité doit implémenter les interfaces suivantes. Notez qu’un certain nombre de membres dans ces interfaces ne sont pas pris en charge et doivent retourner les valeurs de retour spécifiées. En particulier, l’API De disponibilité ne prend pas en charge l’accès en écriture aux informations de disponibilité et ne délègue pas l’accès aux comptes.

  • IFreeBusySupport : cette interface prend en charge la spécification des interfaces qui accèdent aux données de disponibilité pour les utilisateurs spécifiés. Il utilise FBUser pour identifier un utilisateur.

  • IFreeBusyData : cette interface obtient et définit un intervalle de temps pour un utilisateur donné et retourne une interface pour énumérer des blocs de données de disponibilité dans cet intervalle de temps. Il utilise le temps relatif pour obtenir et définir cet intervalle de temps. Pour plus d’informations, consultez Utiliser le temps relatif pour accéder aux données de disponibilité.

  • IEnumFBBlock : cette interface prend en charge l’accès et l’énumération de blocs de données de disponibilité pour un utilisateur dans un intervalle de temps.

    Remarque

    Une énumération contient des blocs de disponibilité qui indiquent la status de disponibilité sur le calendrier d’un utilisateur, dans une plage de temps (spécifiée par IFreeBusyData ::EnumBlocks). Les éléments d’un calendrier, tels que les rendez-vous et les demandes de réunion, sont des blocs de formulaire dans l’énumération. Les éléments qui sont adjacents les uns aux autres dans le calendrier et qui ont le même status de disponibilité sont combinés pour former un seul bloc. Une période de temps libre sur un calendrier forme également un bloc. Par conséquent, deux blocs consécutifs d’une énumération n’auraient pas la même status de disponibilité. Ces blocs ne se chevauchent pas dans le temps. Lorsque des éléments se chevauchent dans un calendrier, Outlook fusionne ces éléments pour former des blocs de disponibilité qui ne se chevauchent pas dans l’énumération en fonction de cet ordre de priorité : absent du bureau, occupé, provisoire.

Pour inscrire le fournisseur de disponibilité auprès d’Outlook, le fournisseur de messagerie doit effectuer les opérations suivantes :

  1. Inscrivez le fournisseur de disponibilité auprès de COM, en fournissant un CLSID qui permet d’accéder à l’implémentation du fournisseur d’IFreeBusySupport.

  2. Informez Outlook que le fournisseur de disponibilité existe en définissant la clé suivante (où <xx.x> représente la version d’Outlook) dans le registre système :

    HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Office\<xx.x>\Outlook\SchedulingInformation\FreeBusySupport

    Par exemple, si le fournisseur de transport est SMTP, pour inscrire le fournisseur auprès de Microsoft Outlook 2010, définissez la clé suivante sur les données du tableau suivant :

    HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Office\14.0\Outlook\SchedulingInformation\FreeBusySupport

    Nom Type Valeur
    SMTP REG_SZ {CLSID pour l’implémentation respective d’IFreeBusySupport}

    Dans ce scénario, Outlook co-crée la classe COM et l’utilise pour récupérer des informations de disponibilité pour tous les utilisateurs de messagerie SMTP.

Pour prendre en charge un carnet d’adresses et un fournisseur de transport qui utilisent un type d’entrée d’adresse autre que SMTP, modifiez le nom en conséquence.

Remarque

Pendant l’installation, les fournisseurs de disponibilité doivent case activée si un paramètre de Registre pour le même type d’entrée d’adresse existe déjà. Si c’est le cas, le fournisseur de disponibilité doit remplacer le fournisseur actuel pour ce type d’entrée d’adresse et le restaurer sur ce fournisseur lorsqu’il est désinstallé. Toutefois, si un utilisateur a installé plusieurs fournisseurs de disponibilité pour le même type d’entrée d’adresse, l’utilisateur doit désinstaller ces fournisseurs dans l’ordre inverse d’installation (autrement dit, désinstaller toujours le fournisseur le plus récent). Sinon, le registre peut pointer vers un fournisseur qui a déjà été désinstallé.

Composants d’API

L’API Disponibilité comprend les composants suivants :

Définitions

Types de données

Interfaces