Partager via

Tester votre complément Office sur Trident

  • Article

Si vous envisagez de prendre en charge des versions antérieures de Windows et Office, votre complément doit fonctionner dans le contrôle de navigateur incorporable appelé « Trident » fourni par Internet Explorer 11. Vous pouvez utiliser une ligne de commande pour passer d’une vue web plus moderne utilisée par les compléments à Trident pour ce test. Pour plus d’informations sur les versions de Windows et d’Office qui utilisent le contrôle Webview Internet Explorer 11, voir Navigateurs et contrôles d’affichage web utilisés par les compléments Office. Dans cet article, « webview » fait référence à la combinaison d’un contrôle webview et d’un moteur JavaScript.

Importante

Les vues web provenant des Explorer internet et des Version antérieure de Microsoft Edge sont toujours utilisées dans les compléments Office

Certaines combinaisons de plateformes et de versions Office, y compris les versions perpétuelles sous licence en volume via Office 2019, utilisent toujours les contrôles webview fournis avec Internet Explorer 11 (appelé « Trident ») et Version antérieure de Microsoft Edge (appelé « EdgeHTML ») pour héberger des compléments, comme expliqué dans Navigateurs et contrôles d’affichage web utilisés par les compléments Office. Internet Explorer 11 a été désactivé dans Windows 10 et Windows 11 en février 2023, et l’interface utilisateur de lancement a été supprimée, mais elle est toujours installée avec ces systèmes d’exploitation. Ainsi, Trident et d’autres fonctionnalités d’Internet Explorer peuvent toujours être appelées par programme par Office.

Nous vous recommandons (mais n’exigez pas) de prendre en charge ces combinaisons, au moins de manière minimale, en fournissant aux utilisateurs de votre complément un message d’échec approprié lorsque votre complément est lancé dans ces vues web. Gardez ces points supplémentaires à l’esprit :

  • Office sur le Web ne s’ouvre plus dans internet Explorer ou Version antérieure de Microsoft Edge. Par conséquent, AppSource ne teste pas les compléments dans Office sur le Web sur ces navigateurs.
  • AppSource teste toujours les combinaisons de versions de plateforme et de bureau Office qui utilisent Trident ou EdgeHTML. Toutefois, il émet un avertissement uniquement lorsque le complément ne prend pas en charge ces vues web ; le complément n’est pas rejeté par AppSource.
  • L’outil Script Lab ne prend plus en charge Trident.

Si vous envisagez de prendre en charge des versions antérieures de Windows et Office, votre complément doit fonctionner dans le contrôle de navigateur incorporable appelé « Trident » fourni par Internet Explorer 11. Vous pouvez utiliser une ligne de commande pour passer d’une vue web plus moderne utilisée par les compléments à Trident pour ce test. Pour plus d’informations sur les versions de Windows et d’Office qui utilisent le contrôle Webview Internet Explorer 11, voir Navigateurs et contrôles d’affichage web utilisés par les compléments Office.

Importante

Trident ne prend pas en charge les versions de JavaScript ultérieures à ES5. Si vous souhaitez utiliser la syntaxe et les fonctionnalités d’ECMAScript 2015 ou version ultérieure, vous devez utiliser un transpileur ou un polyfill, ou les deux. Pour plus d’informations sur ces options, voir Prise en charge des anciennes vues web microsoft et versions d’Office.

En outre, Trident ne prend pas en charge certaines fonctionnalités HTML5 telles que les médias, l’enregistrement et l’emplacement. Pour en savoir plus, consultez Déterminer la vue web dans laquelle le complément s’exécute au moment de l’exécution.

Remarque

  • Office sur le Web ne peut pas être ouvert dans Internet Explorer 11. Vous ne pouvez donc pas (et n’avez pas besoin de) tester votre complément sur Office sur le Web avec Internet Explorer.

  • La Configuration de sécurité renforcée d’Internet Explorer (ESC) doit être désactivée pour que les compléments web Office fonctionnent. Si vous utilisez un ordinateur Windows Server comme client lors du développement de compléments, notez que l’option Échap est activée par défaut dans Windows Server.

Basculer vers la vue web Trident

Conseil

Dans les versions récentes d’Office, l’une des façons d’identifier le contrôle webview utilisé par Office consiste à utiliser le menu personnalité de n’importe quel complément où il est disponible. (Le menu personnalité n’est pas pris en charge dans Outlook.) Ouvrez le menu et sélectionnez Informations de sécurité. Dans la boîte de dialogue Informations de sécurité sur Windows, le runtime signale Microsoft Edge, Version antérieure de Microsoft Edge ou Internet Explorer. Le runtime n’est pas inclus dans la boîte de dialogue dans les versions antérieures d’Office.

Il existe deux façons de basculer la vue web Trident. Vous pouvez exécuter une commande simple dans une invite de commandes, ou vous pouvez installer une version d’Office qui utilise Trident par défaut. Nous recommandons la première méthode, mais vous devez utiliser la seconde dans les scénarios suivants.

  • Votre projet a été développé avec Visual Studio et IIS. Il n’est pas basé Node.js.
  • Vous voulez être absolument robuste dans vos tests.
  • Vous ne pouvez pas utiliser le canal bêta pour Microsoft 365 sur votre ordinateur de développement.
  • Vous développez sur un Mac.
  • Si, pour une raison quelconque, l’outil en ligne de commande ne fonctionne pas.

Basculer via la ligne de commande

Si votre projet est basé sur Node.js (c’est-à-dire qu’il n’est pas développé avec Visual Studio et Internet Information Server (IIS), vous pouvez forcer Office sur Windows à utiliser le contrôle de vue web EdgeHTML fourni par Edge Hérité ou le contrôle Webview Trident fourni par Internet Explorer pour exécuter des compléments, même si vous avez une combinaison de versions Windows et Office qui utiliseraient normalement une vue web plus récente. Pour plus d’informations sur les navigateurs et les vues web utilisés par différentes combinaisons de versions Windows et Office, voir Navigateurs et contrôles d’affichage web utilisés par les compléments Office.

Remarque

L’outil utilisé pour forcer la modification dans l’affichage web est pris en charge uniquement dans le canal d’abonnement bêta de Microsoft 365. Rejoignez le programme Microsoft 365 Insider et sélectionnez l’option Canal bêta pour accéder aux builds bêta d’Office. Voir aussi À propos d’Office : quelle version d’Office est-ce que j’utilise ?.

Strictement, c’est le webview commutateur de cet outil (voir l’étape 2) qui nécessite le canal bêta. L’outil a d’autres commutateurs qui n’ont pas cette exigence.

  1. Si votre projet n’a pas été créé avec l’outil Yeoman generator for Office Add-ins , vous devez installer l’outil office-addin-dev-settings. Exécutez la commande suivante dans une invite de commandes.

    npm install office-addin-dev-settings --save-dev

    Importante

    L’outil office-addin-dev-settings n’est pas pris en charge sur Mac.

  2. Spécifiez la vue web que vous souhaitez qu’Office utilise avec la commande suivante dans une invite de commandes à la racine du projet. Remplacez par <path-to-manifest> le chemin d’accès relatif, qui est simplement le nom de fichier du manifeste s’il se trouve à la racine du projet. ie Remplacez par <webview> ou edge-legacy. Notez que les options sont nommées d’après les navigateurs dans lesquels les vues web proviennent. L’option ie signifie « Trident » et l’option edge-legacy « EdgeHTML ».

    npx office-addin-dev-settings webview <path-to-manifest> <webview>

    Voici un exemple.

    npx office-addin-dev-settings webview manifest.xml ie

    Vous devez voir un message dans la ligne de commande indiquant que le type d’affichage web est désormais défini sur IE (ou Edge Legacy).

  3. Lorsque vous avez terminé, définissez Office pour qu’il reprenne l’utilisation de la vue web par défaut pour votre combinaison de versions Windows et Office avec la commande suivante.

    npx office-addin-dev-settings webview <path-to-manifest> default

Installer une version d’Office qui utilise Internet Explorer

Utilisez la procédure suivante pour installer une version d’Office (téléchargée à partir d’un abonnement Microsoft 365) qui utilise l’Version antérieure de Microsoft Edge webview (EdgeHTML) pour exécuter des compléments ou une version qui utilise internet Explorer (Trident).

  1. Dans n’importe quelle application Office, ouvrez l’onglet Fichier du ruban, puis sélectionnez Compte Office ou Compte. Sélectionnez le bouton À propos du nom d’hôte (par exemple, À propos de Word).

  2. Dans la boîte de dialogue qui s’ouvre, recherchez le numéro de build xx.x.xxxxx.xxxxx complet et effectuez-en une copie quelque part.

  3. Télécharger l’outil Déploiement d’Office.

  4. Exécutez le fichier téléchargé pour extraire l’outil. Vous êtes invité à choisir l’emplacement d’installation de l’outil.

  5. Dans le dossier où vous avez installé l’outil (où se trouve le setup.exe fichier), créez un fichier texte avec le nom config.xml et ajoutez le contenu suivant.

    <Configuration>
  <Add OfficeClientEdition="64" Channel="SemiAnnual" Version="16.0.xxxxx.xxxxx">
    <Product ID="O365ProPlusRetail">
      <Language ID="en-us" />
    </Product>
  </Add>
</Configuration>

  6. Modifiez la Version valeur.

    • Pour installer une version qui utilise EdgeHTML, remplacez-la par 16.0.11929.20946.
    • Pour installer une version qui utilise Trident, remplacez-la par 16.0.10730.20348.

  7. Si vous le souhaitez, modifiez la valeur de OfficeClientEdition pour "32" installer Office 32 bits, puis modifiez la Language ID valeur en fonction des besoins pour installer Office dans une autre langue.

  8. Ouvrez une invite de commandes en tant qu’administrateur.

  9. Accédez au dossier contenant les setup.exe fichiers et config.xml .

  10. Exécutez la commande suivante :

    setup.exe /configure config.xml

    Cette commande installe Office. Le processus peut prendre plusieurs minutes.

  11. Effacez le cache Office.

Importante

Après l’installation, veillez à désactiver la mise à jour automatique d’Office afin qu’Office ne soit pas mis à jour vers une version qui n’utilise pas la vue web avec laquelle vous souhaitez travailler avant d’avoir terminé son utilisation. Cela peut se produire dans les minutes qui suivent l’installation. Procédez comme suit.

  1. Démarrez une application Office et ouvrez un nouveau document.
  2. Ouvrez l’onglet Fichier dans le ruban, puis sélectionnez Compte Office ou Compte.
  3. Dans la colonne Informations sur le produit, sélectionnez Options de mise à jour, puis désactiver Mises à jour. Si cette option n’est pas disponible, Office est déjà configuré pour ne pas se mettre à jour automatiquement.

Lorsque vous avez terminé d’utiliser l’ancienne version d’Office, réinstallez votre version la plus récente en modifiant le config.xml fichier et en remplaçant par Version le numéro de build que vous avez copié précédemment. Répétez ensuite la setup.exe /configure config.xml commande dans une invite de commandes administrateur. Si vous le souhaitez, réactivez les mises à jour automatiques.

Voir aussi