Partager via

Déployer et installer des compléments Outlook à des fins de test

Dans le cadre du processus de développement d’un complément Outlook, vous serez probablement amené à déployer et à installer le complément de manière itérative à des fins de test, ce qui implique les étapes suivantes.

  1. Création d’un fichier manifeste qui décrit le complément.
  2. Déploiement des fichiers d’interface utilisateur du complément sur un serveur web.
  3. Installation du complément dans votre boîte aux lettres.
  4. Test du complément, mise en œuvre des modifications appropriées dans l’interface utilisateur ou dans les fichiers manifeste, et répétition des étapes 2 et 3 pour tester les modifications.

Remarque

Les volets personnalisés sont déconseillés afin de vous assurer que vous utilisez un point d’extension de complément pris en charge.

Création d’un fichier manifeste pour le complément

Chaque complément est décrit par un manifeste, un document qui fournit au serveur des informations sur le complément, fournit des informations descriptives sur le complément pour l’utilisateur et identifie l’emplacement du fichier HTML de l’interface utilisateur du complément. Vous pouvez stocker le manifeste dans un dossier ou un serveur local, tant que l’emplacement est accessible par le serveur Exchange de la boîte aux lettres que vous testez. Nous partons du principe que vous stockez votre manifeste dans un dossier local. Pour plus d’informations sur la création d’un fichier manifeste, voir Manifestes de complément Office.

Déploiement d’un complément sur un serveur web

Vous pouvez utiliser HTML et JavaScript pour créer le complément. Les fichiers sources résultants sont stockés sur un serveur web accessible par le serveur Exchange qui héberge le complément. Après avoir initialement déployé les fichiers sources pour le complément, vous pouvez mettre à jour l’interface utilisateur et le comportement du complément en remplaçant les fichiers HTML ou les fichiers JavaScript stockés sur le serveur web par une nouvelle version du fichier HTML.

Installer le complément

Après avoir préparé le fichier manifeste du complément et déployé l’interface utilisateur du complément sur un serveur web accessible, vous pouvez installer le complément à l’aide de l’une des options suivantes.

Remarque

Pour installer et gérer des compléments dans une boîte aux lettres, le compte de boîte aux lettres doit se voir attribuer le rôle d’utilisateur Mes applications personnalisées dans Exchange. Pour plus d’informations, voir Spécifier les administrateurs et les utilisateurs qui peuvent installer et gérer des compléments pour Outlook dans Exchange Online.

Charger une version test du complément

Pour obtenir des conseils sur la façon de charger une version test de votre complément dans Outlook, voir Chargement de version test des compléments Outlook.

Déployer le complément via le Centre d’administration Microsoft 365

Une autre option pour tester votre complément Outlook consiste à le déployer sur les comptes appropriés via le Centre d’administration Microsoft 365. Dans le Centre d’administration, accédez à Paramètres Applications>intégrées. Ensuite, sélectionnez Charger des applications personnalisées. Pour plus d’informations, voir Déployer et gérer des compléments Office via le portail des applications intégrées.

Installer le complément à l’aide de PowerShell distant

Après avoir créé une session Windows PowerShell à distance sur votre serveur Exchange, vous pouvez installer un complément Outlook en utilisant la cmdlet New-App avec la commande PowerShell suivante.

New-App -URL:"http://<fully-qualified URL">

L’URL complète est l’emplacement du fichier de manifeste de complément que vous avez préparé pour votre complément.

Utilisez les applets de commande PowerShell supplémentaires suivantes pour gérer les compléments d’une boîte aux lettres.

  • Get-App : répertorie les compléments activés pour une boîte aux lettres.
  • Set-App : active ou désactive un complément sur une boîte aux lettres.
  • Remove-App : supprime un complément précédemment installé à partir d’un serveur Exchange.

Versions client

Le choix des versions du client Outlook à tester dépend de vos besoins en matière de développement.

  • Si vous développez un complément pour un usage privé ou uniquement pour les membres de votre organization, il est important de tester les versions d’Outlook utilisées par votre entreprise. Gardez à l’esprit que certains utilisateurs peuvent utiliser Outlook sur le web. Il est donc important de tester les versions de navigateur standard de votre entreprise.

  • Si vous développez un complément à répertorier sur la Place de marché Microsoft, vous devez tester les versions requises comme indiqué dans les stratégies de certification de la Place de marché commerciale 1120.3. Cela inclut les opérations suivantes :

    • la dernière et avant-dernière version d’Outlook sur Windows ;
    • la dernière version d’Outlook sur Mac ;
    • la dernière version d’Outlook sur iOS et Android (si votre complément prend en charge le facteur de forme pour mobile) ;
    • Les versions de navigateur spécifiées dans la stratégie de validation de la Place de marché commerciale 1120.3.

Remarque

Si votre complément ne prend pas en charge l’un des clients ci-dessus car il demande un ensemble de conditions requises d’API que le client ne prend pas en charge, ce client est supprimé de la liste des clients requis.

Outlook sur le web et les versions du serveur Exchange

Les utilisateurs de comptes consommateurs et de Microsoft 365 voient la version moderne de l'interface utilisateur lorsqu'ils accèdent à Outlook sur le web et ne voient plus la version classique qui a été dépréciée. Toutefois, les serveurs Exchange sur site continuent de prendre en charge le protocole Outlook classique sur le web. Par conséquent, pendant le processus de validation, votre soumission peut recevoir un avertissement indiquant que le module complémentaire n'est pas compatible avec Outlook classique sur le web. Dans ce cas, vous devriez envisager de tester votre add-in dans un environnement d'échange sur site. Cet avertissement ne bloque pas votre soumission à la Place de marché Microsoft, mais vos clients peuvent rencontrer une expérience non optimale s’ils utilisent Outlook sur le web dans un environnement Exchange local.

Pour atténuer ce problème, nous vous recommandons de tester votre module d'extension dans Outlook sur le web, connecté à votre propre environnement Exchange privé sur site. Pour plus d’informations, consultez Établir un environnement de test Exchange Server et Outlook sur le web dans Exchange Server.

Vous pouvez également choisir de payer et d'utiliser un service qui héberge et gère des serveurs Exchange sur place. Il existe plusieurs options :

En outre, si vous ne souhaitez pas que vos add-ins soient disponibles pour les utilisateurs qui sont connectés à l'échange sur site, vous pouvez définir le exigences fixées dans le manifeste de l'add-in à 1,6 ou plus. Ces add-ins ne seront pas testés ou validés sur l'interface utilisateur classique de Outlook on the web.

Voir aussi

  • Last updated on