Apprendre à intégrer ONLYOFFICE Docs v6.4 aux services tiers grâce à WOPI

Daria Lapikhina

Pour réagir au contenu de cet article, un espace de dialogue vous est proposé sur le forum. Commentez

- Titre : Apprendre à intégrer ONLYOFFICE Docs v6.4 aux services tiers grâce à WOPI

- Auteur : Daria Lapikhina

- Parution : 15 septembre 2021

- Licence : Copyright ® 2021 Daria Lapikhina - ONLYOFFICE. Aucune reproduction, même partielle, ne peut être faite de ce site et de l'ensemble de son contenu : textes, documents, images, etc. sans l'autorisation expresse de l'auteur. Sinon vous encourez selon la loi jusqu'à trois ans de prison et jusqu'à 300 000 € de dommages et intérêts.

Sommaire

- I. Introduction

- II. À propos de WOPI

- III. Installation de ONLYOFFICE Docs

- III-A. Installation de ONLYOFFICE Docs avec Docker

- III-A-1. Stockage des données

- III-B. Intégration de ONLYOFFICE Docs avec SharePoint et le protocole WOPI

- IV. Remerciements Developpez.com

I - Introduction

La suite bureautique libre ONLYOFFICE Docs est récemment sortie dans la version 6.4 (pour en savoir davantage, lisez cet article). Parmi les nouvelles fonctionnalités, la plus importante pour les développeurs est la prise en charge du protocole WOPI.

Auparavant, la suite bureautique ne s’intégrait aux services GED qu’à l’aide des connecteurs prêts à l'emploi de ONLYOFFICE ou proposés par d’autres développeurs. À partir de la nouvelle version, l’intégration avec des services tiers est devenue possible avec le protocole WOPI.

II - À propos de WOPI

Le protocole WOPI (Web Application Open Platform Interface en anglais) représente les opérations qui permettent d’avoir un accès aux fichiers stockés dans un serveur et de les modifier dans des applications web. Avec WOPI, les développeurs peuvent activer l’édition et la coédition des fichiers en ligne au sein de leurs solutions sans avoir à écrire des applications d'intégration.

La version 6.4 ONLYOFFICE Docs est aussi disponible pour l’intégration avec le protocole WOPI. Lisez la suite pour apprendre à ajouter ONLYOFFICE Docs dans vos solutions grâce à WOPI comme dans l’exemple de la plateforme SharePoint.

III - Installation de ONLYOFFICE Docs

Les éditeurs en ligne ONLYOFFICE peuvent être installés de plusieurs façons. La version communautaire est disponible au téléchargement depuis le site officiel ou peut être compilée avec Docker (option recommandée).

III-A - Installation de ONLYOFFICE Docs avec Docker

Exigences système recommandées :

- RAM : 4 Go ou plus ;

- processeur : 2GHz dual core ou supérieur ;

- swap : au moins 2 Go ;

- disque dur : au moins 2 Go d'espace libre ;

- distribution : Red Hat 64 bits, CentOS ou autre distribution compatible avec un noyau version 3.8 ou ultérieure, Debian 64 bits, Ubuntu ou autre distribution compatible avec un noyau version 3.8 ou ultérieure ;

- Docker : version 1.9.0 ou ultérieure (télécharger depuis site web officiel).

Exécutez la commande suivante dans Docker :

sudo docker run -i -t -d -p 80:80 --restart=always onlyoffice/documentserver

ONYOFFICE Docs sera installé.

Si vous voulez changer le port, utilisez la commande -p. Exemple pour le port 8080 :

`sudo docker run -i -t -d -p 8080:80 --restart always onlyoffice/documentserver`

III-A-1 - Stockage des données

Il est recommandé de garder vos données en dehors des conteneurs Docker sur votre ordinateur. Pour accéder aux données depuis l'extérieur du conteneur, vous devez monter le dossier hôte dans le conteneur. Cela peut être fait en spécifiant le paramètre -v dans la commande docker run.

1. sudo docker run -i -t -d -p 80:80 --restart=always \

2. -v /app/onlyoffice/DocumentServer/logs:/var/log/onlyoffice  \

3. -v /app/onlyoffice/DocumentServer/data:/var/www/onlyoffice/Data  \

4. -v /app/onlyoffice/DocumentServer/lib:/var/lib/onlyoffice \

5. -v /app/onlyoffice/DocumentServer/db:/var/lib/postgresql  onlyoffice/documentserver

Ainsi, si vous supprimez le conteneur ou si quelque chose se passe mal pendant la mise à jour, vous ne perdrez pas vos données. Vous pourrez également mettre à jour vos certificats sans toucher au conteneur.

Maintenant vous avez ONLYOFFICE Docs que vous pouvez intégrer dans vos propres plateformes.

III-B - Intégration de ONLYOFFICE Docs avec SharePoint et le protocole WOPI

Exigence d’installation :

- la version 6.4 de ONLYOFFICE Docs ;

- la version 19 de SharePoint.

Pour connecter les éditeurs en ligne ONLYOFFICE à SharePoint, suivez les étapes suivantes :

1. Ouvrez votre serveur SharePoint. Démarrez la console d’administration centrale de SharePoint et définissez la zone WOPI nécessaire avec la commande suivante :

Set-SPWOPIZone -Zone "external-http"

1. Exécutez la commande suivante pour vérifier s’il existe des liens WOPI vers d’autres types de documents en utilisant la commande :

Get-SPWOPIBinding

1. Supprimez ces liens si nécessaire, en exécutant la commande :

Remove-SPWOPIBinding -All:$true

1. Créez de nouveaux liens pour les actions par défaut en fonction des types de fichiers.

Exécutez la commande suivante pour créer des liens pour tous les types de fichiers en une seule fois :

New-SPWOPIBinding -ServerName ip_or_domain.com:port

La commande pour créer des liens pour des types de fichiers particuliers uniquement :

New-SPWOPIBinding -ServerName ip_or_domain.com:port -Extension DOCX

Maintenant, vous avez des éditeurs ONLYOFFICE intégrés dans votre plateforme SharePoint qui permettent à vos utilisateurs de :

- modifier des documents texte, des feuilles de calcul et des présentations ;

- collaborer sur les documents en temps réel en utilisant deux modes de coédition (Rapide et Strict), des commentaires et un chat intégré ;

- suivre l’historique des modifications.

La version ONLYOFFICE Docs 6.4 est disponible dans la version communautaire gratuite et la version pour les entreprises.

La liste des connecteurs ONLYOFFICE prêts à l’emploi.

Pour plus d’informations, visitez le site web officiel.

IV - Remerciements Developpez.com

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