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 ONLYOFFICE et Nuxeo

ONLYOFFICE propose 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 télécharger sur GitHub. L'application est rendu 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 des documents texte, des classeurs, des présentations et des formulaires.
  • Modifier un document en collaboration en temps réel: deux modes de collaboration (Strict et Rapide), Suivi des modifications, 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

  • Modification: DOCX, PPTX, XLSX, DOCXF
  • À remplir des formulaires: OFORM
  • Lecture seule: 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 vers Nuxeo.

    Veuillez consulter la documentation officielle ONLYOFFICE pour en savoir plus sur l'installation d'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 enregistrée Nuxeo Online Services avec accès à Internet, à une instance non enregistrée, ou une instance hors connexion.

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

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

  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 For a Nuxeo Online Sevices registered instance with internet access (Pour une instance enregistrée de Nuxeo Online Sevices avec accès à Internet).
  3. Une fois le paquet téléchargé et installé, démarrez votre serveur
    ./nuxeoctl start

Les étapes à suivre pour l'instance non enregistrée 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 le paquet 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 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 d'ONLYOFFICE Docs.

ImportantL'adresse d'ONLYOFFICE Docs doit être accessible sur Nuxeo et l'adresse de Nuxeo doit être accessible sur ONLYOFFICE Docs.
À partir de la version de ONLYOFFICE Docs v.7.2, JWT est activé par défaut et la clé secrète est générée automatiquement. Il vous faut également activer la validation du jeton du côté Nuxeo: recherchez votre clé secrète dans le fichier de configuration ONLYOFFICE Docs, ensuite indiquez la même clé secrète dans les paramètres du connecteur. Pour en savoir plus, consultez la section Activer le jeton JWT pour l'intégration ONLYOFFICE et Nuxeo.

Activer le jeton JWT pour l'intégration ONLYOFFICE et Nuxeo

Afin de protéger des documents contre un accès non autorisé, les éditeurs ONLYOFFICE utilisent le jeton JSON (JWT). Le jeton est ajouté à la configuration lorsque l'éditeur de documents est initialisé et l'échange de commandes entre les services internes de ONLYOFFICE Docs est effectué. La clé secrète est utilisée pour signer le jeton web JSON et valider le jeton sur demande à ONLYOFFICE Docs.

À partir de la version de ONLYOFFICE Docs v.7.2, JWT est activé par défaut et la clé secrète est générée automatiquement. Il vous faut rechercher votre clé secrète dans le fichier de configuration ONLYOFFICE Docs, ensuite indiquez la même clé secrète dans les paramètres du connecteur.

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

  1. Ouvrez le fichier local.json avec tout éditeur de texte disponible.
    • Pour Linux - /etc/onlyoffice/documentserver/local.json
    • Pour Windows - %ProgramFiles%\ONLYOFFICE\DocumentServer\config\local.json
    • Pour Docker – indiquez le conteneur ONLYOFFICE Docs en utilisant la commande docker exec -it <containerID> bash et ouvrez /etc/onlyoffice/documentserver/local.json

      Vous pouvez également utiliser la commande suivante pour rechercher la clé secrète par défaut et sans ouvrir le fichier 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. Le paramètre true figure 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 qui a été généré automatiquement figure dans trois sections. Vous pouvez remplacer le secret par défaut par votre propre clé secrète. La clé secrète doit être la même dans toutes trois sections.
    • services.CoAuthoring.secret.inbox.string
    • services.CoAuthoring.secret.outbox.string
    • services.CoAuthoring.secret.session.string
  4. Lorsque vous apportez des modifications, il vous faut les enregistrer et redémarrer les services pour prendre en compte ces modifications.
    supervisorctl restart all

Étape 2: Indiquez la même clé secrète dans la configuration du connecteur.

Dans le fichier nuxeo/bin/nuxeo.conf, indiquez la même clé secrète dans la chaîne onlyoffice.jwt.secret=yoursecret et sauvegardez les paramètres.

Commencer à utiliser ONLYOFFICE Docs au sein de Nuxeo

Pour modifier ou afficher un document ou un formulaire:

  1. Ouvrez le fichier nécessaire.
  2. Cliquez sur le bouton View in ONLYOFFICE (Afficher dans ONLYOFFICE).

    Le document ou le formulaire sera disponible en affichage et modification.

ONLYOFFICE_viewfile ONLYOFFICE_viewfile
Pour édition collaborative, les conditions suivantes sont requises: il faut définir les permissions permettant aux utilisateurs de modifier le document et le connecteur doit prendre end charge le format du document.
Pour en savoir plus sur formulaires, veuillez consulter les guides appropriés de création et remplissage de formulaires.

Pour collaborer sur un document:

  1. Ouvrez la page sommaire du document.
  2. Cliquez sur l'icône Collaborative Edition With ONLYOFFICE (Édition collaborative dans 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