Apprendre à installer les éditeurs de documents en ligne ONLYOFFICE et les intégrer dans un site ou une application Web

Tatiana Kochedykova

Ce tutoriel est conçu pour apprendre les notions de base sur l'installation de ONLYOFFICE Document Server, sa configuration et l'intégration dans un site Web écrit en .NET (C#) ou Node.js.

Un espace de dialogue vous est proposé sur le forum si vous avez des remarques concernant ce tutoriel.
Commentez

- Titre : Apprendre à installer les éditeurs de documents en ligne ONLYOFFICE et les intégrer dans un site ou une application Web

- Auteur : Tatiana Kochedykova

- Parution : 12 janvier 2017

- Public visé :

- Licence : Les sources présentées sur cette page sont libres de droits et vous pouvez les utiliser à votre convenance. Par contre, la page de présentation constitue une œuvre intellectuelle protégée par les droits d'auteur. Copyright ® 2017 Tatiana Kochedykova. 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. Installation de ONLYOFFICE Document Server sur un serveur Linux

- II-A. Configuration minimum requise

- II-B. Installation de ONLYOFFICE à l'aide de Docker

- III. Intégration dans une application ou un site Web

- III-A. Intégration dans un site Web en Node.js sur Windows

- III-B. Intégration dans un site Web en Node.js sur Linux

- III-C. Intégration dans une application .Net (C#)

- IV. Exemples de l'intégration des éditeurs en ligne avec d'autres produits

- IV-A. Vue d'ensemble de l'intégration avec d'autres produits ONLYOFFICE

- IV-B. Intégration avec d'autres solutions

I - Introduction

ONLYOFFICE Document Server est une suite bureautique libre réalisée à base de Canvas (élément de HTML5). Elle inclut trois logiciels : traitement de texte, feuilles de calcul et présentation qui se chargent dans le navigateur Web pour une édition collaborative en temps réel, avec commentaires et tchat.

Les formats pris en charge par les éditeurs de ONLYOFFICE Document Server sont les suivants :

- lecture / édition : .doc, .docx, .odt, .rtf, .txt, .xls, .xlsx, .csv, .ods, .ppt, .pptx, .odp ;

- téléchargement : .doc, .docx, .odt, .rtf, .txt, .pdf, .html, .xlsx, .csv, .ods, pptx.

Les différents éléments constitutifs de la suite sont :

- ONLYOFFICE Document Editor

- ONLYOFFICE Spreadsheet Editor

- ONLYOFFICE Presentation Editor

Ces composants se présentent comme suit :

ONLYOFFICE Document Editor

ONLYOFFICE Spreadsheet Editor

ONLYOFFICE Presentation Editor

La suite bureautique est distribuée sous les termes de la licence de GNU AGPL v 3 et peut être intégrée dans une application ou un site Web écrit en tout langage de programmation : .Net (C#), Node.js, Java, PHP, Ruby, etc.

La suite est particulièrement utile pour les développeurs d'une application Web spécialisée (système CRM, gestion de documents, de projets, mail, éducation ou toute autre application qui prévoit le travail avec les documents ou la collaboration) qui cherchent à étendre ses fonctionnalités et offrir à leurs utilisateurs les possibilités supplémentaires d'édition de documents et de collaboration en équipe : édition collaborative, révision, suivi des modifications, tchat, commentaires, etc.

De plus, on peut toujours personnaliser la suite bureautique en ajoutant des fonctions nécessaires à l'aide des modules complémentaires.

II - Installation de ONLYOFFICE Document Server sur un serveur Linux

II-A - Configuration minimum requise

- CPU : double cœur 2 GHz ou supérieur

- Mémoire : 4 Go

- Disque : au moins 2 Go

- Au moins 2 Go d'espace de pagination

- Plates-formes : 64-bit Red Hat, CentOS ou tout autre distributif compatible avec la version de noyau 3.10 ou plus récente, 64-bit Debian, Ubuntu ou tout autre distributif compatible avec la version de noyau 3.13 ou plus récente

- Prérequis supplémentaires :

- Docker : version 1.4.1 ou plus récente

II-B - Installation de ONLYOFFICE à l'aide de Docker

Pour un fonctionnement correct, la version actuelle de ONLYOFFICE Document Server demande un nombre des dépendances logicielles installées sur Linux telles que mono (version 4.0.0 ou plus récente), MySQL (version 5.6.4 ou plus récente), nginx (version 1.3.13 ou plus récente), nodejs (version 0.12 ou plus récente), libstdc++6 (version 4.9 ou plus récente). Donc, pour simplifier le processus d'installation et éviter les erreurs, il est recommandé de déployer ONLYOFFICE Document Server en utilisant Docker.

Vous avez besoin de Docker 1.4.1 ou de la version plus récente. Pour contrôler la version de Docker installée, exécutez la commande suivante :

$ docker version

Si Docker n'est pas disponible dans votre système Linux, installez-le en suivant les instructions d'installation de Docker pour Debian ou Red-Hat.

Après avoir installé Docker, démarrez-le et exécutez la commande suivante :

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

Cette commande va installer ONLYOFFICE Document Server et toutes les dépendances logicielles nécessaires. On peut trouver la liste de toutes les actions faites sur la page officielle de l'image Docker de ONLYOFFICE Document Server.

III - Intégration dans une application ou un site Web

III-A - Intégration dans un site Web en Node.js sur Windows

- Étape 1 : Téléchargez le code Node.js pour l'intégration des éditeurs. Téléchargez l'exemple du code Node.js du site officiel.

- Étape 2 : Ouvrez le fichier config.js et spécifiez le chemin d'accès aux éditeurs pour les connecter à votre site Web :

config.js

1. config.converterUrl = "http://documentserver/ConvertService.ashx";

2. config.tempStorageUrl = "http://documentserver/ResourceService.ashx";

3. config.apiUrl = "http://documentserver/OfficeWeb/apps/api/documents/api.js";

4. config.preloaderUrl = "http://documentserver/OfficeWeb/apps/api/documents/cache-scripts.html";

où documentserver est le nom du serveur avec ONLYOFFICE Document Server installé.

- Étape 3 : Téléchargez et installez l'environnement Node.js à utiliser pour lancer le projet Node.js du site officiel : https://nodejs.org/en/download/.

- Étape 4 : Exécutez le code Node.js en utilisant une interface en ligne de commande.

1. Lancez l'invite de commande et passez au dossier avec le code Node.js stocké :

cd /d C:\OnlineEditorsExampleNodeJS

1. Pour démarrer le code Node.js, installez les modules de projet en exécutant la commande npm (Node Package Manager, gestionnaire de paquets officiel pour Node.js) :

npm install

Un nouveau dossier node_modules sera créé dans le dossier de projet.

node bin/www

1. Démarrez le projet avec l'invite de commande :

III-B - Intégration dans un site Web en Node.js sur Linux

- Étape 1 : Installez Node.js :

curl -sL https://deb.nodesource.com/setup_4.x | sudo bash -apt-get install nodejs

- Étape 2 : Téléchargez l'archive avec l'exemple Node.js et décompressez l'archive :

wget http://api.onlyoffice.com/app_data/Node.js%20Example.zip
unzip Node.js\ Example.zip

- Étape 3 : Changez le répertoire actuel par le répertoire du projet :

cd ~/OnlineEditorsExampleNodeJS/

- Étape 4 : Installez les dépendances :

npm install

- Étape 5 : Ouvrez le fichier de configuration config.js pour le modifier :

Spécifiez le nom du serveur local où ONLYOFFICE Document Server est installé. Pour cela, il suffit de modifier les lignes suivantes :

1. config.storageUrl = "http://documentserver/FileUploader.ashx";

2. config.converterUrl = "http://documentserver/ConvertService.ashx";

3. config.tempStorageUrl = "http://documentserver/ResourceService.ashx";

4. config.apiUrl = "http://documentserver/OfficeWeb/apps/api/documents/api.js";

5. config.preloaderUrl = "http://documentserver/OfficeWeb/apps/api/documents/cache-scripts.html";

où documentserver est le nom du serveur où ONLYOFFICE Document Server est installé.

- Étape 6 : Démarrez le projet avec Node.js :

nodejs bin/www

- Étape 7 : Contrôlez le résultat en entrant l'adresse dans le navigateur :

http://localhost

III-C - Intégration dans une application .Net (C#)

- Étape 1 : Téléchargez l'exemple du code .Net (C#) du site officiel.

- Étape 2 : Ouvrez le fichier settings.config et spécifiez le chemin d'accès aux éditeurs pour les connecter à votre site Web :

1. <add key="files.docservice.url.storage" value="http://documentserver/FileUploader.ashx" />

2. <add key="files.docservice.url.converter" value="http://documentserver/ConvertService.ashx" />

3. <add key="files.docservice.url.api" value="http://documentserver/OfficeWeb/apps/api/documents/api.js" />

4. <add key="files.docservice.url.preloader" value="http://documentserver/OfficeWeb/apps/api/documents/cache-scripts.html"/>

où documentserver est le nom du serveur avec ONLYOFFICE Document Server installé.

- Étape 3 : Lancez le site Web avec les éditeurs.

IV - Exemples de l'intégration des éditeurs en ligne avec d'autres produits

IV-A - Vue d'ensemble de l'intégration avec d'autres produits ONLYOFFICE

ONLYOFFICE permet d'installer et d'utiliser les éditeurs de documents en ligne séparément ou en les connectant au système collaboratif (ONLYOFFICE Community Server) et au serveur de messagerie (ONLYOFFICE Mail Server).

L'intégration avec la dernière version de ONLYOFFICE Community Server permet de modifier les fichiers chargés du disque dur de l'ordinateur aussi bien que les fichiers stockés en ligne sur Box, Dropbox, GoogleDrive, SharePoint, OneDrive, OwnCloud, etc., tous depuis un seul endroit, les joindre aux projets / tâches, contacts CRM, etc.

IV-B - Intégration avec d'autres solutions

ONLYOFFICE fournit des connecteurs officiels pour intégrer ses éditeurs de documents en ligne (Community et Integration Editions) avec des solutions collaboratives populaires :

- Connecteur pour Alfresco Share, un gestionnaire de contenus ;

- Connecteur pour Confluence, un logiciel de travail collaboratif ;

- Connecteur pour Nextcloud, une solution libre de collaboration documentaire ;

- Connecteur pour ownCloud, une solution de partage de fichiers sécurisée ;

- Connecteur pour SharePoint, une plate-forme de gestion documentaire.

Il y a également des connecteurs créés par des développeurs tiers en utilisant les API :

- CommuniGate

- eXo Platform

- HumHub

- Liferay

- Moodle

- PowerFolder

- XWiki