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 Plone

ONLYOFFICE propose un connecteur officiel pour intégrer ONLYOFFICE Docs dans Plone et modifier les documents au sein du système de gestion de contenu. Vous pouvez télécharger le connecteur ONLYOFFICE à partir de PyPi.org et sur la page ONLYOFFICE sur GitHub.

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

Principales caractéristiques

  • Créer, modifier et afficher des documents texte, des classeurs et des présentations.
  • Modifier un document en collaboration en temps réel: deux modes de collaboration (Strict et Rapide), le mode de Suivi des modifications, commentaires et le 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 et afficher: DOCX, PPTX, XLSX, DOCXF
  • Lecture seule: PDF
  • À remplir des formulaires: OFORM
  • À convertir au formats Office Open XML en utilisant l'option Conversion in ONLYOFFICE (Conversion dans ONLYOFFICE): ODT, ODS, ODP, DOC, XLS, PPT

Toutes les nouveautés de la version 3.0.0

Nouvelles fonctionnalités ajoutées

  • L'option Télécharger comme.
  • Conversion des documents.
  • Connexion à la version démo du serveur de documents.
  • Validation de paramètres.
  • Fusion et publipostage à partir de l'espace de stockage
  • Comparaison de fichiers à partir de l'espace de stockage
  • Insertion des images à partir de l'espace de stockage
  • Options de configuration du serveur avancées pour indiquer les adresses internes.

Fonctionnalités modifiées

  • L'option de configuration document.title pour l'éditeur depuis le titre de l'objet.
  • ONLYOFFICE Docs v6.0 et versions antérieures ne sont plus prises en charge.

Le journal des modifications complet est disponible ici.

Connecter ONLYOFFICE Docs à Plone

Exigences

  • ONLYOFFICE Docs (Document Server) 6.1 ou version ultérieure

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

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

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

  • Python 3.4 ou version ultérieure
  • Le module complémentaire d'intégration ONLYOFFICE 3.0.0 ou version ultérieure pour Plone

Installer le module d'intégration ONLYOFFICE pour Plone

Si la version précédente du module complémentaire est installée (versions antérieures du module complémentaire avec le nom précédent onlyoffice.connector), veuillez la supprimer avant d'installer la nouvelle version. Si vous souhaitez installer une version antérieure, utilisez onlyoffice.connector au lieu de onlyoffice.plone lors de la procédure d'installation.
  1. Ajoutez la ligne onlyoffice.plone à la section eggs du fichier ~/plone/zinstance/buildout.cfg pour qu'il apparaisse comme suit:

    [buildout]
    ...
    eggs =
            onlyoffice.plone
  2. Pour prendre en compte ces modifications, redémarrez buildout à partir de votre console en tant que non superutilisateur:

    sudo -u plone_buildout /plone/zinstance/bin/buildout
  3. Redémarrez votre instance:

    sudo /plone/zinstance/bin/instance restart
  4. Ouvrez votre navigateur, passez à votre page Plone, connectez-vous en tant qu'administrateur et ouvrez la section Site Setup > Add-ons (Configuration du site > Modules complémentaires). Recherchez onlyoffice.plone parmi les extensions disponibles et cliquez sur le bouton Install (Installer) pour l'activer.

Configurer le module d'intégration ONLYOFFICE pour Plone

Pour configurer le module complémentaire:

  1. Passez à Site Setup (Configuration du site).
  2. Faites défiler la page vers la section Add-ons Configuration (Configuration de modules complémentaires).
  3. Appuyez sur le bouton ONLYOFFICE Configuration (Configuration d'ONLYOFFICE.).
  4. Dans le champ Document Editing service (Service de modification des documents), indiquez l'adresse URL d'ONLYOFFICE Docs.
    ImportantL'adresse d'ONLYOFFICE Docs doit être accessible sur Plone et l'adresse de Plone doit être accessible sur ONLYOFFICE Docs.
  5. Dans le champ Secret Key (Clé secrète), indiquez la clé secrète utilisée pour signer des données.
    À 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é Plone: 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 Plone.
  6. Dans le champ Server address for internal requests from Document Editing Service (Adresse du serveur pour les demandes internes du Service de modification des documents), indiquez l'adresse utilisée pour accéder à Plone depuis le Service de modification des documents.
  7. Dans le champ Document Editing Service address for internal requests from the server (Adresse du Service de modification des documents pour les demandes internes du serveur), indiquez l'adresse utilisée pour accéder au Service de modification des documents à partir du serveur Plone.
ONLYOFFICE_configure ONLYOFFICE_configure

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

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 la configuration du connecteur, indiquez la même clé secrète dans le champ Secret key (Clé secrète) et enregistrez les paramètres.

Se connecter à la version démo ONLYOFFICE Docs

À partir de la version 3.0.0 du connecteur ONLYOFFICE, il est possible d'essayer les éditeurs ONLYOFFICE en ligne au sein de Plone sans installer ONLYOFFICE Docs.

Pour activer la connexion, activez l'option Connect to demo ONLYOFFICE Document Server (Se connecter à la version démo du serveur ONLYOFFICE Documents) et cliquez sur le bouton Enregistrer.

C'est un serveur d'essai publique qui sera disponible pendant 30 jours. Veuillez ne pas partager de données sensibles.

Commencer à utiliser ONLYOFFICE Docs au sein de Plone

Pour créer un document:

  1. Sous l'onglet Contents (Contenu), cliquez sur Create in ONLYOFFICE (Créer dans ONLYOFFICE) dans le menu à gauche.
  2. Choisissez le type de fichier approprié: Document, Classeur ou Présentation.
    Crйer un fichier crйer
  3. Le nouveau document sera disponible en modification.

Pour modifier un document:

  1. Recherchez le document nécessaire sous l'onglet Contents (Contenu).
    ONLYOFFICE_editfile ONLYOFFICE_editfile
  2. Cliquez sur le document.
  3. Sur la page qui s'affiche, cliquez sur ONLYOFFICE Edit (Édition dans ONLYOFFICE) dans le menu pour ouvrir le document en édition et/ou en lecture seule.
    ONLYOFFICE_editfile1 ONLYOFFICE_editfile1

Pour convertir un document au format Office Open XML:

  1. Recherchez le document nécessaire sous l'onglet Contents (Contenu).
  2. Cliquez sur le document.
  3. Sur la page qui s'affiche, cliquez sur Conversion in ONLYOFFICE (Conversion dans ONLYOFFICE) dans le menu.
    Convertir Convertir
    Consultez la liste complète des formats qui sont convertibles en OOXML.
  4. Cliquez sur Convert (Convertir).
    Convertir Convertir

Pour créer un modèle de formulaire:

  1. Sous l'onglet Contents (Contenu), cliquez sur Create in ONLYOFFICE (Créer dans ONLYOFFICE) dans le menu à gauche.
  2. Sélectionnez l'option Form template (Modèle de formulaire).
  3. Un nouveau modèle de formulaire sera disponible en modification.

Pour remplir un formulaire:

  1. Recherchez le formulaire nécessaire sous l'onglet Contents (Contenu).
  2. Cliquez sur le formulaire.
  3. Sur la page qui s'affiche, cliquez sur Fill in form in ONLYOFFICE (Remplir le formulaire dans ONLYOFFICE) dans le menu.
    Remplir un formulaire Remplir un formulaire
Pour en savoir plus sur formulaires, veuillez consulter les guides appropriés de création et remplissage de formulaires.

Pour télécharger le fichier dans un autre format:

  1. Recherchez le document nécessaire sous l'onglet Contents (Contenu).
  2. Cliquez sur le document.
  3. Sur la page qui s'affiche, cliquez sur Actions dans le menu et sélectionnez Download as (Télécharger comme).
    Tйlйcharger Tйlйcharger
  4. Sélectionnez le format nécessaire dans la liste.
  5. Cliquez sur le bouton Download (Télécharger).
    Tйlйcharger Tйlйcharger
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