Rendre votre complément Office compatible avec un complément COM existant

Si vous disposez d’un complément COM existant, vous pouvez créer des fonctionnalités équivalentes dans votre complément Office, ce qui permet à votre solution de s’exécuter sur d’autres plateformes telles qu’Office sur le web ou Mac. Dans certains cas, votre complément Office peut ne pas être en mesure de fournir toutes les fonctionnalités disponibles dans le complément COM correspondant. Dans ce cas, votre complément COM peut offrir une meilleure expérience utilisateur sur Windows que le complément Office correspondant.

Vous pouvez configurer votre complément Office afin que, lorsque le complément COM équivalent est déjà installé sur l’ordinateur d’un utilisateur, Office sur Windows exécute le complément COM au lieu du complément Office. Le complément COM est appelé « équivalent », car Office effectue une transition transparente entre le complément COM et le complément Office en fonction duquel il est installé sur l’ordinateur d’un utilisateur.

Spécifier un complément COM équivalent

Obtenir le ProgId d’un complément COM

Avant de pouvoir spécifier un complément COM équivalent, vous devez d’abord identifier son ProgId. Pour obtenir le ProgId d’un complément COM :

1. Ouvrez l’Éditeur du Registre Windows sur l’ordinateur sur lequel le complément COM est installé.
2. Accédez à HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Office\<Application> Office\Addins ou HKEY_CURRENT_USER\SOFTWARE\Microsoft\Office\<Application> Office\Addins, où <l’application> Office est Excel, Outlook, PowerPoint ou Word. Par exemple, HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Office\Excel\Addins.
3. Copiez le nom de la clé de Registre associée au complément COM dont vous avez besoin. Notez que les noms respectent la casse.

Configurer le manifeste

Pour activer la compatibilité entre votre complément Office et le complément COM, identifiez le complément COM équivalent dans le manifeste de votre complément Office. Ensuite, Office sur Windows utilisera le complément COM au lieu du complément Office, s’ils sont tous les deux installés.

L’exemple suivant montre la partie du manifeste qui spécifie un complément COM en tant que complément équivalent. La valeur de l’élément ProgId identifie le complément COM et l’élément EquivalentAddins doit être positionné immédiatement avant la balise de fermeture VersionOverrides .

<VersionOverrides>
  ...
  <EquivalentAddins>
    <EquivalentAddin>
      <ProgId>ContosoCOMAddin</ProgId>
      <Type>COM</Type>
    </EquivalentAddin>
  </EquivalentAddins>
</VersionOverrides>

Configurer le paramètre de stratégie de groupe

Pour déclarer la compatibilité entre votre complément web Outlook et le complément COM, identifiez le complément COM équivalent dans le paramètre de stratégie de groupe Désactiver les compléments web Outlook dont le complément COM ou VSTO équivalent est installé . Celle-ci doit être configurée sur l’ordinateur de l’utilisateur. Ensuite, Outlook sur Windows classique utilise le complément COM au lieu du complément web, s’ils sont tous les deux installés.

1. Téléchargez la dernière version de l’outil Modèles d’administration, en prêtant attention aux instructions d’installation de l’outil.

2. Ouvrez l’Éditeur de stratégie de groupe local (gpedit.msc).

3. Accédez à Configuration> utilisateur Modèles >d’administrationMicrosoft Outlook 2016> Divers.

4. Sélectionnez le paramètre Désactiver les compléments web Outlook dont le complément COM ou VSTO équivalent est installé.

5. Ouvrez le lien pour modifier le paramètre de stratégie.

6. Dans la boîte de dialogue Compléments web Outlook pour désactiver :

   1. Définissez Nom de la valeur sur le Id qui se trouve dans le manifeste du complément web. Important : n’ajoutez pas d’accolades {} autour de l’entrée.
   2. Définissez Value sur le ProgId du complément COM équivalent.
   3. Sélectionnez OK pour mettre la mise à jour en vigueur.

   

Comportement équivalent pour les utilisateurs

Lorsqu’un complément COM équivalent est spécifié, Office sur Windows n’affiche pas l’interface utilisateur de votre complément Office si le complément COM équivalent est installé. Office masque uniquement les boutons du ruban du complément Office et n’empêche pas l’installation. Par conséquent, votre complément Office apparaîtra toujours aux emplacements suivants dans l’interface utilisateur.

• Sous Mes compléments.
• En tant qu’entrée dans le gestionnaire de ruban (Excel, Word et PowerPoint uniquement).

Les scénarios suivants décrivent ce qui se passe en fonction de la façon dont l’utilisateur acquiert le complément Office.

Acquisition AppSource d’un complément Office

Si un utilisateur acquiert le complément Office à partir d’AppSource et que le complément COM équivalent est déjà installé, Office :

1. Installez le complément Office.
2. Masquez l’interface utilisateur du complément Office sur le ruban.
3. Affichez une légende pour l’utilisateur qui pointe vers le bouton du ruban du complément COM.

Déploiement centralisé du complément Office

Si un administrateur déploie le complément Office sur son locataire à l’aide d’un déploiement centralisé et que le complément COM équivalent est déjà installé, l’utilisateur doit redémarrer Office avant de voir des modifications. Une fois Office redémarré, il effectue les options suivantes :

1. Installez le complément Office.
2. Masquez l’interface utilisateur du complément Office sur le ruban.
3. Affichez une légende pour l’utilisateur qui pointe vers le bouton du ruban du complément COM.

Document partagé avec le complément Office incorporé

Si un utilisateur a installé le complément COM, puis obtient un document partagé avec le complément Office incorporé, alors lorsqu’il ouvre le document, Office :

1. Invitez l’utilisateur à approuver le complément Office.
2. S’il est approuvé, le complément Office s’installe.
3. Masquez l’interface utilisateur du complément Office sur le ruban.

Autre comportement de complément COM

Excel, PowerPoint, Word

Si un utilisateur désinstalle le complément COM équivalent, Office sur Windows restaure l’interface utilisateur du complément Office.

Une fois que vous avez spécifié un complément COM équivalent pour votre complément Office, Office cesse de traiter les mises à jour de votre complément Office. Pour acquérir les dernières mises à jour du complément Office, l’utilisateur doit d’abord désinstaller le complément COM.

Outlook

Le complément COM doit être connecté au démarrage d’Outlook pour que le complément web correspondant soit désactivé.

Si le complément COM est ensuite déconnecté au cours d’une session Outlook ultérieure, le complément web restera probablement désactivé jusqu’à ce qu’Outlook soit redémarré.

Voir aussi

• Rendre vos fonctions personnalisées compatibles avec les fonctions XLL définies par l’utilisateur