ONLYOFFICE : comment connecter la suite bureautique ONLYOFFICE à Mattermost

La suite bureautique ONLYOFFICE Docs apporte la gestion de documents électroniques dans des services tiers comme plateformes de gestion, de synchronisation et de partage de fichiers. Ainsi, elle complète une gamme d’outils existants avec :

• traitement de texte ;
• tableur ;
• outil de présentations ;
• créateur de formulaires ;
• lecteur et convertisseur de PDF.

L’intégration permet de créer, éditer et coéditer en temps réel des fichiers de formats populaires (DOCX, XLSX, PPTX) et autres.

Dans nos tutoriels précédents, vous trouverez comment connecter ONLYOFFICE avec Nextcloud, Confluence, SharePoint, Moodle, WordPress et une application GED en Python.

Dans ce tutoriel, nous allons vous montrer comment connecter ONLYOFFICE Docs et service de messagerie Mattermost avec une application d’intégration prête à emploi.

Mattermost est un service de collaboration en ligne open source avec messagerie privée et de groupe, conversations organisées en équipes, canaux et partage de fichiers. Conçu pour les organisations et les entreprises, il vise à rassembler toutes les communications d’équipe en un seul endroit, à améliorer la productivité et à assurer une sécurité élevée.

Le connecteur ONLYOFFICE pour Mattermost permet d’ouvrir, de visualiser et de modifier des documents texte, des feuilles de calcul et des présentations partagés dans les chats. Vous pouvez collaborer sur des documents bureautiques avec vos collègues en temps réel en utilisant deux modes de coédition, des autorisations d’accès en lecture seule ou en édition, le suivi des modifications, l’historique des versions, les commentaires et le chat intégré.

Formats pris en charge :

• pour la création, l’édition et l’affichage : DOCX, PPTX, XLSX ;
• pour l’affichage uniquement : XLS, XLSX, CSV, XLSM, XLT, XLTM, ODS, FODS, OTS, PPS, PPSX, PPSM, PPT, PPTX, PPTM, POT, POTX, POTM, ODP, FODP, OTP, DOC, DOCX, DOCM, DOT, DOTX, DOTM, ODT, FODT, OTT, RTF.

Avant tout, vous devez installer des éléments nécessaires à l’intégration :

• ONLYOFFICE Docs (Document Server) installé en version 6.4 ou supérieure. Si vous n’avez pas installé ONLYOFFICE Docs, il est recommandé de le faire avec Docker. Suivez le guide d’installation.
• Mattermost v5.37.2 ou plus.

Une fois Mattermost et ONLYOFFICE correctement installés, l’étape suivante c’est de les relier à l’aide du connecteur.

Pour installer le connecteur, suivez ces étapes :

• clonez la branche master depuis GitHub ;
• allez à la racine du projet ;
• installez les dépendances :
  npm install --legacy-peer-deps ;

• exécutez la commande suivante :
  make dist ;
• allez à la console d’administration de Mattermost —> Plugins —> Gestion des plugins ;
• choisissez le plugin compilé dans votre dossier dist et appuyez sur Charger.

Après l’installation, il faut configurer le connecteur pour que l’intégration fonctionne correctement.

Pour configurer le connecteur, allez à System Console -> ONLYOFFICE -> Cliquez sur Configurer.

Dans les paramètres de configuration, choisissez les options suivantes :

• Activer le plugin. Activez le plugin d'intégration ONLYOFFICE de Mattermost en cochant ce paramètre.
• Adresse de Document Server. Pour connecter ONLYOFFICE Docs, entrez l'adresse suivante :

https://<documentserver>:<port>/

où documentserver est le nom du serveur et port est le numéro de port sur lequel ONLYOFFICE Docs est installé. L'adresse doit être accessible depuis le navigateur de l'utilisateur et depuis le serveur Mattermost. L'adresse du serveur Mattermost doit également être accessible depuis ONLYOFFICE Docs pour fonctionner correctement.

• Clef secrète. À partir de la version 7.2, JWT est activé par défaut et la clef secrète est générée automatiquement pour restreindre l'accès à ONLYOFFICE Docs et pour des raisons de sécurité et d'intégrité des données. Spécifiez votre propre clef secrète dans la configuration du plugin Mattermost. Dans le fichier de configuration de ONLYOFFICE Docs, spécifiez la même clef secrète et activez la validation.
• En-tête JWT. Si la protection JWT est activée, il est nécessaire de spécifier un nom d'en-tête personnalisé, car la politique de sécurité de Mattermost bloque les en-têtes d'autorisation externes. Cet en-tête doit également être spécifié dans les paramètres de signature d'ONLYOFFICE Docs. De plus amples informations sur la signature peuvent être trouvées ici.
• Préfixe JWT. Spécifiez le préfixe ONLYOFFICE Docs.

Pour des instructions détaillées sur l’installation et la configuration du connecteur, consultez la documentation API d’ONLYOFFICE.

Pour ouvrir le fichier dans les éditeurs en ligne ONLYOFFICE, allez dans le menu contextuel en cliquant sur les 3 points ou cliquez sur le nom du fichier et choisissez le bouton « Ouvrir dans ONLYOFFICE » et l'éditeur ONLYOFFICE correspondant s'ouvre dans la même fenêtre.

Par défaut, l’expéditeur du message a le droit de modifier le fichier, et tous les autres membres du chat ont un accès en lecture seule au fichier. Seul l’expéditeur du message peut le modifier en utilisant le bouton « Modifier les droits d’accès » dans le menu contextuel.

• Dans le cadre d’une discussion en tête-à-tête, utilisez le menu déroulant dans le champ Droits d’accès pour le @user.
• Dans le chat de groupe, utilisez « Droits d’accès par défaut » pour définir les mêmes droits d’accès pour tous les membres du chat.

Pour donner des droits d’accès au chat à un participant particulier, saisissez son nom dans la boîte de recherche et cliquez sur « Ajouter ». Le nom d’utilisateur apparaîtra dans la liste, où vous pourrez définir les droits d’accès au fichier.

Le bot ONLYOFFICE envoie des notifications sur les changements dans le document en spécifiant le nom de l'utilisateur qui a fait ces changements.

Liens utiles

Connecteur Mattermost sur GitHub

Télécharger ONLYOFFICE Docs : version communautaire / version pour les entreprises

Consulter la liste des connecteurs disponibles

Connecter les éditeurs ONLYOFFICE à votre application : API / WOPI

Nous tenons à remercier Malick pour la mise au gabarit et escartefigue pour la relecture orthographique.