Articles avec le tag :
Fermer
Changelog
Fermer
Essayer dans le cloud
Essayer dans le cloud
Centre d'aide
l'intégration

À propos de l'intégration de ONLYOFFICE et Nuxeo

ONLYOFFICE offre un connecteur officiel pour intégrer ONLYOFFICE Docs dans Nuxeo et modifier les documents au sein du système de gestion de contenu. Vous pouvez installer le connecteur ONLYOFFICE à partir de Nuxeo Marketplace ou de la page GitHub. L'application est rendue accessible sous la Licence Apache.

Pour en savoir plus sur le fonctionnement et la compilation du connecteur ONLYOFFICE pour Nuxeo, veuillez consulter notre documentation API.

Principales caractéristiques

  • Modifier les documents texte, les feuilles de calcul, les présentations et les formulaires.
  • Modifier un document en collaboration en temps réel : deux modes de collaboration (Strict et Rapide), le mode de Suivi des modifications, les commentaires et un chat intégré.
  • Prise en charge de JWT pour l'échange sécurisé afin que personne ne puisse accéder à vos documents sauf celles ayant les privilèges d'accès appropriés.

Formats pris en charge

  • À modifier : DOCX, PPTX, XLSX, DOCXF
  • À remplir les formulaires : OFORM
  • À afficher : PDF, ODT, ODS, ODP, DOC, XLS, PPT, CSV, RTF

Connecter ONLYOFFICE Docs à Nuxeo

Exigences

  • ONLYOFFICE Docs 5.9.4 ou version ultérieure

    Vous avez besoin d'une instance pouvant être résolue et connectée par Nuxeo et tout autre client final. L'instance doit envoyer des données en POST directement au Nuxeo.

    Veuillez consulter la page de documentation ONLYOFFICE Docs officielle pour en savoir plus sur l'installation de ONLYOFFICE Docs.

    Vous pouvez également utiliser ONLYOFFICE Docs Cloud (version SaaS).

  • Nuxeo LTS 2019

Installer le composant additionnel ONLYOFFICE pour Nuxeo

Vous pouvez connecter ONLYOFFICE à l'instance inscrite avec accès à Internet Nuxeo Online Services, à une instance non inscrite, ou une instance hors connexion.

Les instructions sont élaborées en utilisant le script nuxeoctl. Visitez la page de documentation officielle Nuxeo pour en savoir plus sur les options d'installation disponibles.

Les étapes à suivre pour l'instance inscrite avec accès à Internet Nuxeo Online Services :

  1. Arrêtez votre serveur
    ./nuxeoctl stop
  2. Exécutez la commande suivante pour installer le connecteur :
    ./nuxeo/bin/nuxeoctl mp-install onlyoffice-nuxeo-x.x.x
    onlyoffice-nuxeo-x-x-x est la dernière version disponible du connecteur ONLYOFFICE pour Nuxeo.
    Pour vérifier la version du connecteur :
    1. Passez à Nuxeo Marketplace et recherchez le connecteur officiel ONLYOFFICE.
    2. Cliquez sur le bouton Installer.
    3. La version du connecteur est disponible dans la section Pour une instance inscrite avec accès à Internet Nuxeo Online Services.
  3. Une fois que le paquet est téléchargé et installé, démarrez votre serveur
    ./nuxeoctl start

Les étapes à suivre pour l'instance non inscrite ou l'instance hors connexion :

  1. Arrêtez votre serveur
    ./nuxeoctl stop
  2. Téléchargez le connecteur
    wget https://connect.nuxeo.com/nuxeo/site/marketplace/package/onlyoffice-nuxeo/download?version=x.x.x
    version=x.x.x est la dernière version disponible du connecteur ONLYOFFICE pour Nuxeo. Sinon, visitez Nuxeo Marketplace et recherchez le lien vous-même.
  3. Installez le paquet et indiquez le chemin d'accès au fichier .zip
    ./nuxeoctl mp-install /Path/to/file/onlyoffice-nuxeo-x.x.x.zip
  4. Une fois que le paquet est téléchargé et installé, démarrez votre serveur
    ./nuxeoctl start

Configurer le composant additionnel ONLYOFFICE pour Nuxeo

Ouvrez le fichier nuxeo/bin/nuxeo.conf avec un éditeur texte disponible et ajoutez les lignes suivantes :

onlyoffice.docserv.url=http://documentserver/
onlyoffice.jwt.secret=yoursecret

docserv.url est l'adresse URL de l'instance ONLYOFFICE Docs installée et lancée et jwt.secret est la clé secrète pour valider le jeton JSON sur la demande à la connexion de ONLYOFFICE Docs.

ImportantL'adresse de ONLYOFFICE Docs doit être accessible depuis Nuxeo, ainsi que l'adresse de Nuxeo doit être accessible depuis ONLYOFFICE Docs.
À partir de la version ONLYOFFICE Docs v7.2 le jeton JWT est activé par défaut et la clé secrète est générée automatiquement. Vous devez également l'activer du côté de Nuxeo : trouvez votre propre clé secrète dans le fichier de configuration ONLYOFFICE Docs et ensuite spécifiez la même clé secrète aux paramètres du connecteur. Pour en savoir plus, consultez la section de l'article Activer le jeton JWT pour intégrer ONLYOFFICE et Nuxeo.

Activer le jeton JWT pour intégrer ONLYOFFICE et Nuxeo

Afin de protéger les documents de tout accès non autorisé, les éditeurs ONLYOFFICE utilisent le jeton JSON Web Token (JWT). Le jeton est ajouté à la configuration lors de l'initialisation de l'éditeur de documents et lors de l'échange de commandes entre les services internes de ONLYOFFICE Docs. La clé secrète est utilisée pour signer le jeton JSON et valider le jeton sur la demande à la connexion de ONLYOFFICE Docs.

À partir de la version ONLYOFFICE Docs v7.2 le jeton JWT est activé par défaut et la clé secrète est générée automatiquement. Vous avez besoin de trouver votre propre clé secrète dans le fichier de configuration ONLYOFFICE Docs et ensuite de spécifier la même clé secrète aux paramètres du connecteur.

Étape 1 : Trouvez votre propre clé secrète dans le fichier de configuration ONLYOFFICE Docs

  1. Ouvrez le fichier local.json à l'aide d'un éditeur de texte disponible.
    • Pour Linux - /etc/onlyoffice/documentserver/local.json
    • Pour Windows - %ProgramFiles%\ONLYOFFICE\DocumentServer\config\local.json
    • Pour Docker - entrez le conteneur ONLYOFFICE Docs en utilisant la commande docker exec -it <containerID> bash et ouvrez-le. /etc/onlyoffice/documentserver/local.json

      À titre subsidiaire, vous pouvez utiliser la commande suivante pour trouver la clé secrète par défaut sans ouvrir local.json :

      sudo docker exec <containerID> /var/www/onlyoffice/documentserver/npm/json -f /etc/onlyoffice/documentserver/local.json 'services.CoAuthoring.secret.session.string'

    Le fichier local.json doit ressembler à ceci :

    {
      "services": {
        "CoAuthoring": {
          "token": {
            "enable": {
              "request": {
                "inbox": true,
                "outbox": true
              },
              "browser": true
            }
          },
          "secret": {
            "inbox": {
              "string": "yoursecret"
            },
            "outbox": {
              "string": "yoursecret"
            },
            "session": {
              "string": "yoursecret"
            }
          }
        }
      }
    }
    
  2. La valeur true est spécifiée dans trois sections. Cela signifie que la validation du jeton est activée.
    • services.CoAuthoring.token.enable.browser
    • services.CoAuthoring.token.enable.request.inbox
    • services.CoAuthoring.token.enable.request.outbox
  3. La clé secrète générée automatiquement est spécifiée dans trois sections. Vous pouvez remplacer la valeur secrète par défaut avec votre propre clé secrète. La clé secrète doit être identique dans trois sections.
    • services.CoAuthoring.secret.inbox.string
    • services.CoAuthoring.secret.outbox.string
    • services.CoAuthoring.secret.session.string
  4. Si vous apportez des modifications, enregistrez-les et redémarrez les services pour que les modifications de configuration prennent effet.
    supervisorctl restart all

Étape 2 : Spécifiez la même clé secrète aux paramètres du connecteur

Dans le fichier nuxeo/bin/nuxeo.conf spécifiez la même clé secrète à la chaîne onlyoffice.jwt.secret=yoursecret et enregistrez les paramètres.

Commencer à utiliser ONLYOFFICE Docs au sein de Nuxeo

Afin de modifier ou afficher un document ou un formulaire :

  1. Ouvrez le fichier nécessaire.
  2. Cliquez sur le bouton Afficher dans ONLYOFFICE.

    Le document sera disponible pour affichage et modification.

ONLYOFFICE_viewfile ONLYOFFICE_viewfile
Pour édition collaborative les conditions suivantes sont requises : il faut définir les autorisations permettant aux utilisateurs de modifier le document et le connecteur doit prendre en charge le format du document.
Pour en savoir plus sur les formulaires, veuillez consulter les articles consacrés à la création et au remplissage des formulaires.

Pour collaborer sur un document :

  1. Ouvrez la page sommaire du document.
  2. Cliquez sur l'icône Co-édition avec ONLYOFFICE dans le coin inférieur droit de la fenêtre.

    Le document sera disponible pour modification en collaboration.

Download Best editors on your website Let your site users view, edit and collaborate
on all types of text, spreadsheet and presentation files
Cela peut vous aider aussi :
Fermer