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

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.
3 commentaires Donner une note à l'article (5)

Article lu   fois.

L'auteur

Profil Pro

Liens sociaux

Viadeo Twitter Facebook Share on Google+   

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 :

Image non disponible
ONLYOFFICE Document Editor
Image non disponible
ONLYOFFICE Spreadsheet Editor
Image non disponible
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 :

 
Sélectionnez
$ 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 :

 
Sélectionnez
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
    Sélectionnez
    1.
    2.
    3.
    4.
    5.
    
    config.converterUrl = "http://documentserver/ConvertService.ashx";
    config.tempStorageUrl = "http://documentserver/ResourceService.ashx"; 
    config.apiUrl = "http://documentserver/OfficeWeb/apps/api/documents/api.js"; 
    config.preloaderUrl = "http://documentserver/OfficeWeb/apps/api/documents/cache-scripts.html";
    

    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é :

       
      Sélectionnez
      cd /d C:\OnlineEditorsExampleNodeJS
    2. 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) :

       
      Sélectionnez
      npm install

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

    3. Démarrez le projet avec l'invite de commande :
      node bin/www
  • Étape 5 : Contrôlez le résultat en entrant l'adresse dans le navigateur :
    http://localhost:3000

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

  • Étape 1 : Installez Node.js :
     
    Sélectionnez
    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 :
     
    Sélectionnez
    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 :

     
    Sélectionnez
    cd ~/OnlineEditorsExampleNodeJS/
  • Étape 4 : Installez les dépendances :

     
    Sélectionnez
    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 :

 
Sélectionnez
1.
2.
3.
4.
5.
config.storageUrl = "http://documentserver/FileUploader.ashx"; 
config.converterUrl = "http://documentserver/ConvertService.ashx"; 
config.tempStorageUrl = "http://documentserver/ResourceService.ashx"; 
config.apiUrl = "http://documentserver/OfficeWeb/apps/api/documents/api.js";
config.preloaderUrl = "http://documentserver/OfficeWeb/apps/api/documents/cache-scripts.html";

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

  • Étape 6 : Démarrez le projet avec Node.js :
     
    Sélectionnez
    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 :
 
Sélectionnez
1.
2.
3.
4.
<add key="files.docservice.url.storage" value="http://documentserver/FileUploader.ashx" /> 
<add key="files.docservice.url.converter" value="http://documentserver/ConvertService.ashx" /> 
<add key="files.docservice.url.api" value="http://documentserver/OfficeWeb/apps/api/documents/api.js" /> 
<add key="files.docservice.url.preloader" value="http://documentserver/OfficeWeb/apps/api/documents/cache-scripts.html"/>

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

  • Étape 3 : Lancez le site Web avec les éditeurs.
  1. Vérifiez si votre ordinateur satisfait aux exigences techniques suivantes : Microsoft .NET Framework : version 4.5 ;Services d'information sur Internet (IIS) : version 7 ou plus récente.
  2. Cliquez sur Démarrer, puis sur Panneau de configuration, sur Système et sécurité, sur Outils d'administration, sur Gestionnaire IIS pour ouvrir le Gestionnaire IIS.
  3. Ajoutez votre site Web dans le Gestionnaire IIS. Dans le volet Connexions, développez le nœud Sites dans l'arborescence, puis cliquez sur Ajouter un site Web.Dans la boîte de dialogue Ajouter un site Web, dans la zone Nom du site tapez le nom du répertoire avec le projet .Net (C#).Dans la zone Chemin d'accès physique, tapez le chemin d'accès physique au répertoire de contenu.Dans Port spécifiez la valeur unique utilisée pour ce site Web.Vérifiez la version de la plate-forme .NET spécifiée dans le Gestionnaire IIS pour votre site Web. Sélectionnez la version v4.0.Cliquez sur Pool d'applications, puis cliquez droit sur le nom de la plate-forme, puis sur Définir les valeurs par défaut des pools d'applications, puis sur Version .NET CLR.
  4. Parcourez votre site Web avec le Gestionnaire IIS : cliquez droit sur le site, puis sur Gérer le site Web, puis sur Parcourir.

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 Alfresco

Grâce au greffon onlyoffice-alfresco integration les utilisateurs peuvent éditer des documents stockés dans le gestionnaire de contenus Alfresco Share en utilisant les éditeurs de documents en ligne ONLYOFFICE et travailler à plusieurs sur les documents. Le greffon est distribué sous les termes de la licence GPLv3.

IV-C. Intégration avec eXo Platform

L'add-on créé permet d'intégrer ONLYOFFICE Document Server avec l'explorateur de document d'eXo Platform, une plate-forme sociale pour entreprises. Ce qui permet aux utilisateurs d'éditer les documents stockés sur eXo Platform en utilisant les éditeurs intégrés.

Vous avez aimé ce tutoriel ? Alors partagez-le en cliquant sur les boutons suivants : Viadeo Twitter Facebook Share on Google+   

  

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.