Complément Outlook
Any fournit un complément (add-in) Outlook qui permet d'enregistrer dans Any, sans quitter Outlook, un e-mail ou ses pièces jointes. Il ajoute deux commandes au ruban des messages :
- Envoyer le mail vers Any : importe le message complet, au format
.eml; - Envoyer les pièces jointes vers Any : importe les pièces jointes du message.
La commande ouvre un volet latéral qui affiche la boîte de dialogue d'import d'Any : l'utilisateur y renseigne les métadonnées du document, comme pour un import depuis l'interface web.
Le complément est livré avec Any : ses fichiers sont servis par le serveur Any lui-même, sous https://<serveur>/<contexte>/addin/. Il n'y a rien à héberger ailleurs.
Prérequis
Outlook. Outlook sur le web, nouvel Outlook pour Windows, Outlook classique pour Windows (Microsoft 365) et Outlook pour Mac. Les boutons du ruban nécessitent la prise en charge de l'ensemble d'API Mailbox 1.14 ; les versions perpétuelles anciennes d'Outlook (2016, 2019) ne sont pas prises en charge.
Serveur Any.
-
Any doit être accessible en HTTPS, avec un certificat reconnu par les postes, depuis le poste de chaque utilisateur : le volet du complément charge directement les pages d'Any.
-
Les cookies de session doivent être émis avec les attributs
SameSite=NoneetSecure, ce que font les fichiersshiro.inilivrés. Si votreshiro.iniest personnalisé, vérifiez les lignes suivantes :sessionManager.sessionIdCookie.sameSite = NONEsessionManager.sessionIdCookie.secure = truerememberMeManager.cookie.sameSite = NONErememberMeManager.cookie.secure = true
Droits des utilisateurs. L'utilisateur doit pouvoir importer du contenu dans la room cible :
- la fonctionnalité Import de contenu active sur l'application ;
- la permission
content:import:content; - le droit d'écriture sur la room (et, le cas échéant, sur le dossier) cible.
Sans ces droits, le volet affiche « Vous n'avez pas les permissions suffisantes pour importer du contenu ».
Préparer le manifeste
Un complément Office est décrit par un fichier manifeste XML, qui indique à Outlook où trouver les pages du complément et où importer les messages. Le manifeste modèle est fourni avec Any :
https://<serveur>/<contexte>/addin/manifest.xml
Téléchargez-le, puis adaptez-le à votre installation dans un éditeur de texte.
Adresse du serveur
Remplacez toutes les adresses se terminant par /addin/… (icônes, page du volet et page de commandes) par l'adresse de votre serveur Any :
<IconUrl DefaultValue="https://any.exemple.fr/any/addin/assets/icon-64.png"/>
<HighResolutionIconUrl DefaultValue="https://any.exemple.fr/any/addin/assets/icon-128.png"/>
...
<SourceLocation DefaultValue="https://any.exemple.fr/any/addin/taskpane.html"/>
...
<bt:Image id="Icon.16x16" DefaultValue="https://any.exemple.fr/any/addin/assets/icon-16.png"/>
<bt:Image id="Icon.32x32" DefaultValue="https://any.exemple.fr/any/addin/assets/icon-32.png"/>
<bt:Image id="Icon.80x80" DefaultValue="https://any.exemple.fr/any/addin/assets/icon-80.png"/>
<bt:Url id="Commands.Url" DefaultValue="https://any.exemple.fr/any/addin/commands.html"/>
Destination des imports
La destination des imports est définie par les paramètres des adresses ImportMail.Url (Envoyer le mail vers Any) et ImportAttachments.Url (Envoyer les pièces jointes vers Any) :
<bt:Url id="ImportMail.Url" DefaultValue="https://any.exemple.fr/any/addin/taskpane.html?anyServerUrl=https://any.exemple.fr/any&applicationId=juridique&mode=mail&roomId=courriers"/>
<bt:Url id="ImportAttachments.Url" DefaultValue="https://any.exemple.fr/any/addin/taskpane.html?anyServerUrl=https://any.exemple.fr/any&applicationId=juridique&mode=attachments&roomId=courriers"/>
| Paramètre | Valeur |
|---|---|
anyServerUrl | Adresse d'Any, contexte compris (par exemple https://any.exemple.fr/any). Elle doit être sur le même domaine que les pages du complément. |
applicationId | Nom technique de l'application dans laquelle importer |
roomId | Nom technique de la room cible, tel qu'il apparaît dans l'URL de la room dans Any |
folderPath | Facultatif : dossier de la room dans lequel importer |
mode | mail pour importer le message, attachments pour importer les pièces jointes. Ne pas modifier. |
Dans le fichier XML, les paramètres sont séparés par & et non par &.
Le type de document, le formulaire et les métadonnées proposés sont ceux de la configuration d'import de l'application et de la room cibles.
Identification du complément
DisplayNameetDescription: nom et description affichés aux utilisateurs.Id: identifiant unique du complément. Si vous déployez d'autres manifestes dans le même tenant Microsoft 365 — par exemple un par application, ou un pour la recette et un pour la production — attribuez à chacun un nouvel identifiant (GUID).Version: incrémentez-la à chaque modification d'un manifeste déjà déployé, pour qu'Outlook prenne en compte la nouvelle version.- Les libellés des commandes se modifient dans la section
<bt:ShortStrings>.
Pour proposer plusieurs destinations (par exemple une room par service), préparez un manifeste par destination, chacun avec son propre Id et son propre DisplayName, et affectez chacun aux utilisateurs concernés.
Valider le manifeste
Avant de le déployer, vous pouvez vérifier le manifeste avec l'outil de Microsoft :
npx office-addin-manifest validate manifest.xml
Déployer le complément
Déploiement centralisé (recommandé)
Le déploiement centralisé installe le complément pour les utilisateurs ou groupes choisis, sans action de leur part. Il nécessite un compte Administrateur général ou Administrateur Exchange du tenant Microsoft 365.
- Ouvrez le centre d'administration Microsoft 365 :
https://admin.microsoft.com. - Allez dans Paramètres → Applications intégrées.
- Cliquez sur Charger des applications personnalisées.
- Choisissez le type Complément Office, puis Charger le fichier manifeste (.xml) à partir de l'appareil et sélectionnez le manifeste préparé.
- Choisissez les utilisateurs concernés : toute l'organisation, des utilisateurs ou des groupes précis.
- Acceptez les autorisations demandées, puis cliquez sur Terminer le déploiement.
Le complément apparaît dans Outlook après un délai qui peut aller jusqu'à 24 heures. Pour une mise à jour, chargez le nouveau manifeste (avec un numéro de Version supérieur) sur la même application intégrée.
Outlook avec Exchange Server (sur site)
Dans le Centre d'administration Exchange, allez dans Organisation → Compléments, cliquez sur + puis Ajouter à partir d'un fichier, et sélectionnez le manifeste. Rendez ensuite le complément disponible, ou obligatoire, pour les utilisateurs.
Installation par un utilisateur
Pour un test, ou si le déploiement centralisé n'est pas utilisé, un utilisateur peut installer le complément lui-même, si la politique de son organisation l'autorise :
- Ouvrez Outlook sur le web (
https://outlook.office.com) ou le nouvel Outlook. - Ouvrez un message, puis cliquez sur Applications (ou Obtenir des compléments) dans le ruban.
- Allez dans Mes compléments.
- Dans Compléments personnalisés, cliquez sur Ajouter un complément personnalisé → Ajouter à partir d'un fichier et sélectionnez le manifeste.
Le complément installé ainsi apparaît également dans Outlook pour Windows et pour Mac connectés au même compte.
Utilisation
- Dans Outlook, ouvrez ou sélectionnez un message.
- Dans le ruban, groupe Any, cliquez sur Envoyer le mail vers Any ou sur Envoyer les pièces jointes vers Any. Selon le client Outlook, les boutons peuvent se trouver sous le menu Applications ou ….
- À la première utilisation, connectez-vous à Any dans le volet.
- Complétez le formulaire d'import, puis validez.
- Le volet se ferme et une notification confirme l'import sur le message.
Dépannage
| Symptôme | Cause probable | Action |
|---|---|---|
| Le groupe Any n'apparaît pas | Déploiement centralisé en cours de propagation, ou version d'Outlook trop ancienne | Patienter jusqu'à 24 heures ; vérifier la version d'Outlook |
| Le volet reste blanc ou affiche une erreur de chargement | Any non joignable depuis le poste, certificat non reconnu, ou adresses du manifeste erronées | Ouvrir https://<serveur>/<contexte>/addin/taskpane.html dans un navigateur du poste |
| Le volet affiche une page d'erreur de sécurité ou reste vide après connexion | anyServerUrl sur un domaine différent de celui des pages du complément | Utiliser le même domaine pour anyServerUrl et les adresses /addin/ |
| L'utilisateur doit se reconnecter à chaque ouverture, ou la connexion ne tient pas | Cookies de session sans SameSite=None; Secure, ou cookies tiers bloqués par le navigateur | Vérifier shiro.ini ; autoriser les cookies pour le domaine d'Any |
| « Vous n'avez pas les permissions suffisantes pour importer du contenu » | Fonctionnalité d'import désactivée, permission content:import:content absente, ou pas de droit d'écriture sur la room | Vérifier les droits de l'utilisateur sur l'application et la room cibles |
| Import dans la mauvaise room | Paramètres applicationId / roomId du manifeste | Corriger le manifeste, incrémenter Version et le redéployer |