Mettre en place un complément Office sur Microsoft Azure avec Visual Studio
Le complément Office le plus simple est constitué d’un fichier manifeste et d’une page HTML. Le fichier manifeste décrit les caractéristiques du complément, telles que son nom, les clients de bureau Office qu’il peut exécuter et l’URL de la page HTML du complément. La page HTML est contenue dans une application web avec laquelle les utilisateurs interagissent lorsqu’ils installent et exécutent votre complément au sein d’une application cliente Office. Vous pouvez héberger l’application web d’un complément Office sur n’importe quelle plateforme d’hébergement web, y compris Azure.
Cet article décrit comment déployer une application web de complément sur Azure et charger une version test du complément pour le tester dans une application cliente Office.
Importante
Le processus décrit dans cet article ne s’applique pas aux compléments Outlook. Pour obtenir des instructions sur les compléments intermédiaires pour Outlook sur Azure, consultez Stage an Outlook Add-in on Microsoft Azure with Visual Studio.
Configuration requise
Installez Visual Studio 2022 et choisissez d’inclure la charge de travail développement Azure .
Remarque
Si vous avez déjà installé Visual Studio 2022, utilisez la Visual Studio Installer pour vous assurer que la charge de travail de développement Azure est installée.
Installation d’Office.
Remarque
Si vous n’avez pas encore Office, vous pouvez vous inscrire pour obtenir un essai gratuit d’un mois.
Obtenez un abonnement Azure.
Remarque
Si vous n’avez pas encore d’abonnement Azure, vous pouvez en obtenir un dans le cadre de votre abonnement Visual Studio ou vous inscrire pour obtenir une version d’évaluation gratuite.
Étape 1 : Créer un dossier partagé pour héberger votre fichier manifeste de complément
Ouvrez l’explorateur de fichiers sur votre ordinateur de développement.
Cliquez avec le bouton droit (ou sélectionnez et maintenez la touche) sur le lecteur C :\, puis choisissez Nouveau>dossier.
Nommez le nouveau dossier AddinManifests.
Cliquez avec le bouton droit (ou sélectionnez et maintenez la touche) sur le dossier AddinManifests, puis choisissez Partager avec>des personnes spécifiques.
Dans Partage de fichiers, sélectionnez la flèche déroulante vers le bas, puis choisissez Tout le monde>Ajouter>Partager.
Remarque
Dans cette procédure pas à pas, vous utilisez un partage de fichiers local comme catalogue approuvé dans lequel vous allez stocker le fichier manifeste du complément. Dans un scénario réel, vous pouvez plutôt choisir de déployer le fichier manifeste dans un catalogue SharePoint ou de publier le complément sur AppSource.
Étape 2 : Ajouter le partage de fichiers au catalogue de compléments approuvés
Démarrez Word et créez un document.
Remarque
Bien que cet exemple utilise Word, vous pouvez utiliser n’importe quelle application Office qui prend en charge les compléments Office tels qu’Excel, PowerPoint ou Project.
Choisissez Fichier>Options.
Dans la boîte de dialogue Options Word, choisissez Centre de gestion de la confidentialité, puis Paramètres du Centre de gestion de la confidentialité.
Dans la boîte de dialogue Centre de gestion de la confidentialité, choisissez Catalogues de compléments approuvés. Entrez le chemin d’accès UNC (Universal Naming Convention) pour le partage de fichiers que vous avez créé précédemment en tant qu’URL du catalogue (par exemple, \\YourMachineName\AddinManifests), puis choisissez Ajouter un catalogue.
Activez la case Afficher dans le menu.
Remarque
Lorsque vous stockez un fichier manifeste de complément sur un partage spécifié en tant que catalogue de compléments web approuvé, le complément apparaît sous Dossier partagé dans la boîte de dialogue Compléments Office qui démarre à partir deCompléments>d’accueil>Obtenir des compléments.
Fermez Word.
Étape 3 : Créer un complément Office dans Visual Studio
Démarrez Visual Studio en tant qu’administrateur.
Choisissez Créer un nouveau projet.
À l’aide de la zone de recherche, entrez complément.
Choisissez Complément Word web comme type de projet, puis cliquez sur Suivant pour accepter les paramètres par défaut.
Visual Studio crée un complément Word de base que vous pourrez publier tel quel, sans apporter de modifications à son projet web. Pour créer un complément pour une autre application Office, telle qu’Excel, répétez les étapes et choisissez un type de projet avec l’application Office souhaitée.
Étape 4 : Publier votre application web de complément Office sur Azure
Avec votre projet de complément ouvert dans Visual Studio, cliquez avec le bouton droit (ou sélectionnez et maintenez)le projet web, puis choisissez Publier.
Suivez les instructions fournies dans Publier votre application web. Ignorez les sections de l’article qui précèdent Publier votre application web, mais assurez-vous que le bouton Visual Studio est sélectionné en haut de la page.
Visual Studio publie le projet web pour votre complément Office sur votre site web Azure. Lorsque Visual Studio termine la publication du projet web, votre navigateur s’ouvre et affiche une page web avec le texte « Votre application web s’exécute et attend votre contenu ». Il s’agit de la page par défaut actuelle de l’application web.
Copiez l’URL racine (par exemple :
https://YourDomain.azurewebsites.net) ; vous en aurez besoin lorsque vous modifierez le fichier manifeste du complément plus loin dans cet article.
Étape 5 : Modifier et déployer le fichier manifeste du complément
Dans Visual Studio avec l’exemple de complément Office ouvert dans l’explorateur de solutions, développez la solution pour que les deux projets s’affichent.
Développez le projet complément Office (par exemple, WordWebAddIn), cliquez avec le bouton droit (ou sélectionnez et maintenez la touche) sur le dossier du manifeste, puis choisissez Ouvrir. Le fichier manifeste du complément s’ouvre.
Dans le fichier manifeste, recherchez et remplacez toutes les instances de « ~remoteAppUrl » par l’URL racine de l’application web de complément sur Azure. Il s’agit de l’URL que vous avez copiée précédemment après la publication de l’application web de complément sur Azure (par exemple :
https://YourDomain.azurewebsites.net).Choisissez Fichier, puis Enregistrer tout. Ensuite, copiez le fichier manifeste du complément (par exemple, WordWebAddIn.xml).
À l’aide du programme Explorateur de fichier, accédez au partage de fichiers réseau que vous avez créé à l’Étape 1 : Créer un dossier partagé, puis collez le fichier manifeste dans le dossier.
Étape 6 : Insérer et exécuter le complément dans l’application cliente Office
Démarrez Word et créez un document.
Sélectionnez Compléments d’accueil>, puis Obtenir des compléments.
Dans la boîte de dialogue Compléments Office, choisissez DOSSIER PARTAGÉ. Word recherche le dossier que vous avez désigné comme catalogue de compléments approuvés (à l’étape 2 : Ajouter le partage de fichiers au catalogue de compléments approuvés) et affiche les compléments dans la boîte de dialogue. Vous devriez voir l’icône de votre exemple de complément.
Cliquez sur l’icône de votre complément, puis choisissez Ajouter. Un bouton Afficher le volet de tâches pour votre complément est ajouté au ruban.
Dans le ruban de l’onglet Accueil, choisissez le bouton Afficher le volet de tâches. Le complément s’ouvre dans un volet de tâches à droite du document actif.
Vérifiez que le complément fonctionne en sélectionnant du texte dans le document et en choisissant le bouton Mettre en surbrillance dans le volet de tâches.
Déploiement de mises à jour
Vous allez déployer les mises à jour sur votre application web de la même manière que celle décrite précédemment. Les modifications apportées au manifeste nécessitent la redistribution de votre manifeste aux utilisateurs. Le processus à suivre dépend de votre méthode de publication. Pour plus d’informations sur la mise à jour de votre complément, voir Gérer votre complément Office.