Partager via

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

Si vous disposez d’un complément COM ou d’un complément VSTO existant, vous pouvez créer des fonctionnalités presque équivalentes dans votre complément web Office, ce qui permet à votre solution de s’exécuter sur d’autres plateformes, telles que dans Office sur le Web ou sur Mac. Dans ce scénario, les deux compléments sont appelés « équivalents » et vous pouvez utiliser le manifeste du complément Web Office pour contrôler le complément disponible pour les utilisateurs sur les ordinateurs Windows (ou donner le choix aux utilisateurs).

Remarque

Étant donné que les compléments COM et VSTO ne peuvent être installés que sur Windows, cet article fait référence aux compléments COM et VSTO collectivement en tant que compléments « Windows uniquement ».

En règle générale, les compléments doivent être traités comme équivalents uniquement lorsque les conditions suivantes sont remplies, mais il peut y avoir des scénarios exceptionnels où les compléments qui ne répondent pas à ces conditions peuvent être traités comme équivalents.

  • Ils sont tous les deux créés par le même développeur, généralement l’entité spécifiée dans la "developer" propriété du manifeste unifié ou l’élément ProviderName dans le manifeste du complément uniquement.
  • Ils sont tous deux conçus pour être installés sur la ou les mêmes applications Office, et ils traitent de la même charge de travail avec principalement des fonctionnalités qui se chevauchent.
  • Ils ont des noms publics et des interfaces utilisateur identiques ou très similaires, y compris des noms de contrôle et des icônes.

Importante

La fonctionnalité de complément équivalente est prise en charge par la plateforme et les applications suivantes. Les compléments COM, VSTO et XLL ne peuvent pas être installés sur une autre plateforme. Par conséquent, sur ces plateformes, le balisage de manifeste décrit plus loin dans cet article est ignoré.

  • Excel, Word et PowerPoint sur Windows (version 1904 ou ultérieure)
  • Outlook classique sur Windows (version 2102 ou ultérieure) par rapport à une version exchange server prise en charge
    • Exchange Online
    • Exchange Server Subscription Edition (SE)
    • Mise à jour cumulative Exchange 2019 10 ou ultérieure (KB5003612)
    • Mise à jour cumulative Exchange 2016 21 ou ultérieure (KB5003611)

Importante

Les compléments COM et VSTO ne sont pas pris en charge dans le nouvel Outlook sur Windows. Ces compléments sont toujours pris en charge dans le client de bureau Outlook sur Windows classique. Pour plus d’informations, voir Développer des compléments Outlook pour les nouveaux outlook sur Windows.

Étant donné que le complément Windows uniquement et le complément Office n’ont peut-être pas exactement les mêmes fonctionnalités, vous devez prendre en compte trois scénarios.

Obtenir le nom du complément Windows uniquement

Avant de pouvoir configurer le manifeste du complément Office, vous devez d’abord identifier le nom du complément Windows uniquement dans le Registre Windows en procédant comme suit :

  1. Ouvrez l’Éditeur du Registre Windows sur n’importe quel ordinateur sur lequel le complément Windows uniquement 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 Windows uniquement dont vous avez besoin. Notez que les noms respectent la casse.

Masquer le complément Office

Vous pouvez configurer votre complément Office de sorte que lorsque le complément Windows uniquement équivalent est déjà installé sur l’ordinateur d’un utilisateur, Office sur Windows exécute le complément Windows uniquement au lieu du complément Office. Si le complément Windows uniquement est désinstallé, Office activera automatiquement le complément Office lors du prochain démarrage de l’application Office hôte. Si le complément Windows uniquement est installé après le complément Office, lorsque l’application Office est redémarrée, le complément Office est masqué. Pour plus d’informations, voir Comportement des utilisateurs lorsque le complément Office est masqué.

Configurer le manifeste

Importante

S’applique à Excel, Outlook, PowerPoint et Word.

Pour activer la compatibilité entre votre complément Office et le complément Windows uniquement, identifiez le complément Windows uniquement équivalent dans le manifeste de votre complément Office à l’aide du nom que vous avez obtenu dans la section Obtenir le nom du complément Windows uniquement. Office sur Windows utilise ensuite le complément Windows uniquement au lieu du complément Office, s’ils sont tous les deux installés. La configuration dépend du type de manifeste utilisé.

L’exemple suivant montre la partie du manifeste qui spécifie un complément Windows uniquement en tant que complément équivalent. La valeur de la "alternates.prefer.comAddin.progId" propriété identifie le complément Windows uniquement.

Remarque

Bien que la propriété soit appelée « comAddin », elle fait en fait référence à n’importe quel complément Windows uniquement, que le complément soit COM ou VSTO. De même, le terme « progId » est généralement associé uniquement aux compléments COM, mais dans le manifeste, il fait référence au nom du complément Windows uniquement.

"extensions" [
  ...
  "alternates" [
    {
      "prefer": {
        "comAddin": {
          "progId": "ContosoAddin"
        }
      }
    }
  ]
]

Conseil

Si vous ne parvenez pas à spécifier la alternates.prefer propriété dans le manifeste de votre complément web Outlook, vous devez configurer stratégie de groupe à la place. Cela s’applique uniquement à Outlook. Pour obtenir de l’aide, voir Configurer le paramètre stratégie de groupe pour les compléments Outlook.

Conseil

Configurer le paramètre stratégie de groupe pour les compléments Outlook

Un utilisateur disposant d’une alimentation administrateur sur son ordinateur peut configurer un complément Windows uniquement pour qu’il soit équivalent à un complément Outlook à l’aide du paramètre Désactiver les compléments web Outlook dont le complément COM ou VSTO équivalent est installé stratégie de groupe paramètre sur l’ordinateur. Cela peut être réalisé même lorsque le manifeste du complément Outlook n’a pas le balisage de complément équivalent. Ensuite, Outlook sur Windows classique utilise le complément Windows uniquement au lieu du complément Outlook s’ils sont tous les deux installés. Voici les étapes de configuration de la stratégie.

  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> utilisateurModèles> d’administrationMicrosoft Outlook 2016>Miscellaneous.

  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 l’ID du manifeste du complément Outlook. Dans le manifeste du complément uniquement, utilisez la valeur de l’élément <ID> . Dans le manifeste unifié, utilisez la valeur de la id propriété à la racine du manifeste. N’ajoutez pas d’accolades {} autour de l’entrée.
    2. Définissez Valeur sur le nom du complément Windows uniquement équivalent. Consultez la section Obtenir le nom du complément Windows uniquement.
    3. Sélectionnez OK pour mettre la mise à jour en vigueur.

    Boîte de dialogue « Compléments web Outlook à désactiver ».

Comportement des utilisateurs lorsque le complément Office est masqué

Lorsqu’un complément Windows uniquement équivalent est spécifié, Office sur Windows n’affiche pas l’interface utilisateur de votre complément Office si le complément Windows uniquement équivalent est installé. Mais 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).

Remarque

La spécification d’un complément Windows uniquement équivalent dans le manifeste n’a aucun effet sur d’autres plateformes, comme Office sur le Web ou sur Mac.

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 du complément Office sur la Place de marché Microsoft

Si un utilisateur acquiert le complément Office à partir de la Place de marché Microsoft et que le complément Windows uniquement équivalent est déjà installé, Office effectue les activités 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 Windows uniquement.

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 Windows uniquement é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 Windows uniquement.

Document partagé avec le complément Office incorporé

Si un utilisateur dispose du complément Windows uniquement installé, 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 Windows uniquement

Excel, PowerPoint, Word

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

Une fois que vous avez spécifié un complément Windows uniquement é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 Windows uniquement.

Outlook

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

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

Masquer le complément Windows uniquement

Remarque

L’option décrite dans cette section présente les limitations suivantes.

  • Il est pris en charge uniquement pour Excel, PowerPoint et Word.
  • La version minimale d’Office qui prend en charge la fonctionnalité est l’abonnement Office sur Windows version 2506 (build 19029.20004).

Configurer le manifeste

Les détails de la configuration de cette fonctionnalité dépendent du type de manifeste utilisé par le complément Office.

Pour désactiver le complément Windows uniquement, procédez comme suit.

  1. S’il n’existe pas déjà, créez une "extensions.alternates.hide.windowsExtensions" propriété.
  2. Ajoutez une propriété enfant effect à la windowsExtensions propriété et définissez sa valeur sur disableWithNotification.
  3. Ajoutez une propriété enfant "comAddin" à la windowsExtensions propriété .
  4. Ajoutez une propriété de tableau enfant progIds à la comAddin propriété .
  5. Ajoutez les noms de tous les compléments Windows uniquement que vous souhaitez masquer au progIds tableau. Pour plus d’informations sur l’obtention de ces noms, consultez Obtenir le nom du complément Windows uniquement.

Remarque

La chaîne « com » est dans le nom comAddin pour des raisons historiques. Dans le manifeste, la propriété fait référence à des compléments COM ou VSTO. De même, le terme « progIds » est généralement associé uniquement aux compléments COM, mais les noms des compléments VSTO peuvent également être inclus dans le progIds tableau.

L’exemple suivant montre à quoi doit ressembler le JSON.

"extensions" [
  {   
    ...
    "alternates": [
      {
        "hide": {
          "windowsExtensions": {
            "effect": "disableWithNotification",
            "comAddin": {
              "progIds": [
                "ContosoAddin"
              ]
            }
          }
        }
      }
    ]
  }
]

Comportement des utilisateurs lorsque le complément Windows uniquement est masqué

Lorsqu’un complément Windows uniquement est masqué, Office sur Windows n’affiche pas son interface utilisateur si le complément Office équivalent est installé. Une boîte de dialogue contextuelle avertit l’utilisateur que cela se produit. Mais Office masque uniquement le complément Windows et n’empêche pas l’installation.

Donner à l’utilisateur le choix du complément à utiliser

Remarque

L’option décrite dans cette section présente les limitations suivantes.

  • Il est pris en charge uniquement pour Excel, PowerPoint et Word.
  • La version minimale d’Office qui prend en charge la fonctionnalité est l’abonnement Office sur Windows version 2506 (build 19029.20004).

Configurer le manifeste

Les détails de la configuration de cette fonctionnalité dépendent du type de manifeste utilisé par le complément Office.

Pour permettre à l’utilisateur de choisir le complément à masquer, procédez comme suit.

  1. S’il n’existe pas déjà, créez une "extensions.alternates.hide.windowsExtensions" propriété.
  2. Ajoutez une propriété enfant effect à la windowsExtensions propriété et définissez sa valeur sur userOptionToDisable.
  3. Ajoutez une propriété enfant "comAddin" à la windowsExtensions propriété .
  4. Ajoutez une propriété de tableau enfant progIds à la comAddin propriété .
  5. Ajoutez au tableau les noms de tous les compléments Windows uniquement équivalents progIds . Pour plus d’informations sur l’obtention de ces noms, consultez Obtenir le nom du complément Windows uniquement.

Remarque

La chaîne « com » est dans le nom comAddin pour des raisons historiques. Dans le manifeste, la propriété fait référence à des compléments COM ou VSTO. De même, le terme « progIds » est généralement associé uniquement aux compléments COM, mais les noms des compléments VSTO peuvent également être inclus dans le progIds tableau.

L’exemple suivant montre à quoi doit ressembler le JSON.

"extensions" [
  {   
    ...
    "alternates": [
      {
        "hide": {
          "windowsExtensions": {
            "effect": "userOptionToDisable",
            "comAddin": {
              "progIds": [
                "ContosoAddin"
              ]
            }
          }
        }
      }
    ]
  }
]

Comportement des utilisateurs lorsqu’ils ont le choix du complément masqué

Si vous configurez le manifeste pour donner le choix à l’utilisateur, l’utilisateur voit une boîte de dialogue similaire à ce qui suit lorsqu’il installe le complément Office. Le lien En savoir plus dans la boîte de dialogue pointe vers la page d’aide suivante qui fournit des informations pour aider l’utilisateur à prendre la décision : Résoudre les conflits de version pour les compléments Office.

Boîte de dialogue intitulée « Programme d’installation du complément Contoso JS ». Le premier paragraphe indique : « Le complément JS Contoso a identifié les anciennes versions suivantes du complément susceptibles de provoquer des conflits . » Sous ce paragraphe se trouve un seul paragraphe à puces qui indique « Nom du complément COM : Contoso ». Vous trouverez ci-dessous un paragraphe qui indique : « Voulez-vous désactiver les anciennes versions du complément ? (Si vous choisissez Non, vous obtiendrez toujours la nouvelle version si vous ouvrez Office sur Mac ou Office sur le Web.)'. Vous trouverez ci-dessous un lien intitulé « En savoir plus ». En dessous se trouvent deux boutons intitulés Oui et Non.

Si l’utilisateur choisit Oui et qu’Office désactive et masque correctement le complément Windows uniquement, une boîte de dialogue semblable à ce qui suit s’ouvre et conseille à l’utilisateur de redémarrer l’application Office.

Boîte de dialogue intitulée « Complément ancienne version désactivé ». Le premier paragraphe indique : « L’ancienne version du complément a été désactivée avec succès. » En dessous, un paragraphe indique : « Pour vous assurer que les modifications prennent effet, nous vous recommandons de redémarrer cette application Office. Vous pouvez continuer sans redémarrer, mais certaines mises à jour peuvent ne pas être appliquées avant le prochain lancement. En dessous se trouve un bouton OK.

Si l’utilisateur choisit Oui , mais qu’Office ne peut pas désactiver le complément Windows uniquement pour une raison quelconque, une boîte de dialogue similaire à ce qui suit s’ouvre et conseille à l’utilisateur de désactiver manuellement le complément Windows uniquement.

Boîte de dialogue intitulée « Veuillez désactiver le complément manuellement ». Le premier paragraphe dit : « L’ancienne version du complément n’a pas pu être entièrement désactivée. Pour terminer le processus, désactivez manuellement le complément COM dans l’application Office où il a été installé. » Vous trouverez ci-dessous des instructions intitulées « Voici comment faire ». Les instructions se lisent comme suit : '1. Accédez à Fichier, Options, Compléments. 2. Dans la liste déroulante Gérer en bas, choisissez le type de complément, puis cliquez sur Ok. 3. Dans la boîte de dialogue, décochez le complément pour le désactiver. 4. Redémarrez l’application pour appliquer des modifications (facultatives mais recommandées). En dessous se trouve un bouton OK.

Voir aussi

  • Last updated on