Tester et déboguer des compléments Office sur un serveur non local

  • Article

Une fois que vous avez terminé le développement et le test sur un localhost et que vous souhaitez mettre en scène et tester le complément à partir d’un serveur ou d’un compte cloud non local, vous pouvez utiliser l’outil office-addin-débogage pour tout projet de complément basé sur Node.js. (L’outil n’est pas pris en charge dans les projets créés avec Visual Studio.)

Remarque

Si vous travaillez sur un ordinateur Windows, vous avez peut-être une autre option pour les tests non locaux. Consultez Charger une version test des compléments Office pour les tests à partir d’un partage réseau.

Projets créés avec teams Toolkit ou office Yeoman Generator (Yo Office)

Si votre projet a été créé avec teams Toolkit ou Office Yeoman Generator (Yo Office), l’outil office-addin-debugging est déjà installé et votre fichier package.json contient start des scripts et stop qui appellent l’outil. Pour l’utiliser pour des tests non locaux, mettez à jour la partie domaine des URL dans votre manifeste pour qu’elle pointe vers votre serveur de préproduction (ou CDN si nécessaire). Exécutez npm run start ensuite à partir de la ligne de commande (ou du terminal Visual Studio Code) pour charger une version test et débogage du complément.

Importante

L’outil office-addin-debugging inscrit le complément dans le Registre Windows ou un dossier spécial sur un Mac. Pour un complément Outlook, il inscrit également le complément dans Exchange. Pour éviter les bogues subtils lors du développement, mettez toujours fin à une session de test en exécutant npm run stop pour vous assurer que ces inscriptions sont supprimées et que le processus serveur est entièrement arrêté. La fermeture manuelle du serveur, de la fenêtre de ligne de commande (ou TERMINAL), de Visual Studio Code ou de l’application Office ne supprime pas ces inscriptions.

Autres projets

Si votre projet n’a pas été créé avec Teams Toolkit ou Yo Office, exécutez l’outil avec npx à la racine du projet. Appelez-le avec sa start commande suivie du chemin d’accès relatif au manifeste. Voici un exemple.

npx office-addin-debugging start manifest.json

Cette commande charge le complément à des fins de test et de débogage. L’outil fonctionne également avec un manifeste de complément uniquement.

Il existe de nombreuses options pour la start commande. Pour plus d’informations, consultez le FICHIER LISEZ-MOI de l’outil sur office-addin-debugging.

Importante

L’outil office-addin-debugging inscrit le complément dans le Registre Windows ou un dossier spécial sur un Mac. Pour un complément Outlook, il inscrit également le complément dans Exchange. Pour éviter les bogues subtils lors du développement, mettez toujours fin à une session de test en exécutant npx office-addin-debugging stop pour vous assurer que ces inscriptions sont supprimées et que le processus serveur est entièrement arrêté. La fermeture manuelle du serveur, de la fenêtre de ligne de commande (ou TERMINAL), de Visual Studio Code ou de l’application Office ne supprime pas ces inscriptions. Si vous avez utilisé l’option --prod avec la start commande , utilisez la même option avec la stop commande .