Aller au contenu principal
Version: Any 26

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=None et Secure, ce que font les fichiers shiro.ini livrés. Si votre shiro.ini est personnalisé, vérifiez les lignes suivantes :

    sessionManager.sessionIdCookie.sameSite = NONE
    sessionManager.sessionIdCookie.secure = true
    rememberMeManager.cookie.sameSite = NONE
    rememberMeManager.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&amp;applicationId=juridique&amp;mode=mail&amp;roomId=courriers"/>
<bt:Url id="ImportAttachments.Url" DefaultValue="https://any.exemple.fr/any/addin/taskpane.html?anyServerUrl=https://any.exemple.fr/any&amp;applicationId=juridique&amp;mode=attachments&amp;roomId=courriers"/>
ParamètreValeur
anyServerUrlAdresse 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.
applicationIdNom technique de l'application dans laquelle importer
roomIdNom technique de la room cible, tel qu'il apparaît dans l'URL de la room dans Any
folderPathFacultatif : dossier de la room dans lequel importer
modemail 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 &amp; 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​

  • DisplayName et Description : 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.

  1. Ouvrez le centre d'administration Microsoft 365 : https://admin.microsoft.com.
  2. Allez dans Paramètres → Applications intégrées.
  3. Cliquez sur Charger des applications personnalisées.
  4. Choisissez le type Complément Office, puis Charger le fichier manifeste (.xml) à partir de l'appareil et sélectionnez le manifeste préparé.
  5. Choisissez les utilisateurs concernés : toute l'organisation, des utilisateurs ou des groupes précis.
  6. 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 :

  1. Ouvrez Outlook sur le web (https://outlook.office.com) ou le nouvel Outlook.
  2. Ouvrez un message, puis cliquez sur Applications (ou Obtenir des compléments) dans le ruban.
  3. Allez dans Mes compléments.
  4. 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​

  1. Dans Outlook, ouvrez ou sélectionnez un message.
  2. 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 ….
  3. À la première utilisation, connectez-vous à Any dans le volet.
  4. Complétez le formulaire d'import, puis validez.
  5. Le volet se ferme et une notification confirme l'import sur le message.

Dépannage​

SymptômeCause probableAction
Le groupe Any n'apparaît pasDéploiement centralisé en cours de propagation, ou version d'Outlook trop anciennePatienter jusqu'à 24 heures ; vérifier la version d'Outlook
Le volet reste blanc ou affiche une erreur de chargementAny non joignable depuis le poste, certificat non reconnu, ou adresses du manifeste erronéesOuvrir 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 connexionanyServerUrl sur un domaine différent de celui des pages du complémentUtiliser le même domaine pour anyServerUrl et les adresses /addin/
L'utilisateur doit se reconnecter à chaque ouverture, ou la connexion ne tient pasCookies de session sans SameSite=None; Secure, ou cookies tiers bloqués par le navigateurVé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 roomVérifier les droits de l'utilisateur sur l'application et la room cibles
Import dans la mauvaise roomParamètres applicationId / roomId du manifesteCorriger le manifeste, incrémenter Version et le redéployer