Intégration. Pour bien commencer. Liferay

Fermer

Centre d'aide

l'intégration

How to integrate ONLYOFFICE with Nextcloud

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

ONLYOFFICE offre un connecteur officiel pour intégrer ONLYOFFICE Docs dans Liferay et modifier les documents de la bibliothèque de documents et média Liferay. Vous pouvez télécharger le connecteur ONLYOFFICE à partir de Atlassian Marketplace ou de la page GitHub. Le connecteur est rendu accessible sous la Licence Apache.

Pour en savoir plus sur le fonctionnement du connecteur ONLYOFFICE pour Liferay, veuillez consulter notre documentation API.

Principales caractéristiques

Créer des fichiers en utilisant l'option du menu Créer avec ONLYOFFICE.
Créer et remplir les formulaires en ligne.
Afficher et modifier les documents texte, les feuilles de calcul et les présentations qui existent en utilisant l'option Modifier/Voir ONLYOFFICE du menu depuis la section Documents et Média.
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

À créer, modifier et afficher : DOCX, PPTX, XLSX, DOCXF
À remplir les formulaires : OFORM
À convertir en Office Open XML : ODT, DOC, RTF, TXT, ODP, PPT, ODS, XLS, CSV
À afficher : PDF

Toutes les nouveautés de la version 2.2.0

Ajouté

Aperçu des documents
Sauvegarder les versions intermédiaires lors de l'édition (forcesave)
Modèles de de fichiers vides : Galicien

Modifié

Checkin/checkout au lieu de Verrouiller/déverrouiller
Corrigée l'erreur de déploiement pour le portail-7.4

Le journal des modifications complet est disponible ici.

Connecter ONLYOFFICE Docs à Liferay

Exigences

ONLYOFFICE Docs (Document Server) 6.1.0 ou version ultérieure
Vous avez besoin d'une instance pouvant être résolue et connectée par Liferay et tout autre client final. L'instance doit envoyer des données en POST directement à Liferay.

Veuillez consulter la documentation officielle pour en savoir plus sur l'installation de ONLYOFFICE Docs.
Liferay CE Portal 7.2 GA1+, Liferay DXP 7.2 GA1+, Liferay CE Portal 7.3 GA1+, Liferay DXP 7.3 GA1+, Liferay CE Portal 7.4 GA1+
Connecteur ONLYOFFICE v2.2.0 pour Liferay

Installer le connecteur ONLYOFFICE pour Liferay

Vous pouvez installer le connecteur ONLYOFFICE à l'aide du Gestionnaire d'applications ou depuis le site officiel Liferay App Store.

Pour installer le connecteur à l'aide du Gestionnaire d'applications :

Passez à Panneau de configuration -> Applications -> Gestionnaire d'applications.
Cliquez sur le bouton Options.
Cliquez sur le bouton Télécharger.
Dans la fenêtre qui s'affiche, sélectionnez le fichier d'application ONLYOFFICE.

Pour installer le connecteur depuis App Store :

Passez à Panneau de configuration -> Applications -> Magasin.
Connectez-vous à votre compte Liferay.
Recherchez le connecteur ONLYOFFICE pour Liferay.
Achetez l'application (elle est gratuite).

Une fois l'installation terminée, l'application est prête à l'emploi.

Configurer le connecteur ONLYOFFICE pour Liferay

Passez à Panneau de configuration -> Configuration -> Paramètres du système. Dans la section Plateforme choisissez la catégorie Connecteurs et sélectionnez ONLYOFFICE.

Ici vous pouvez configurer les paramètres suivants :

Adresse de ONLYOFFICE Docs - indiquez l'adresse URL du Service de modification de documents.
Adresse de ONLYOFFICE Docs pour les demandes internes du serveur - indiquez l'adresse utilisée pour accéder au Service de modification de documents à partir de Liferay.
Adresse du serveur pour les demandes internes de ONLYOFFICE Docs - indiquez l'adresse utilisée pour accéder à Liferay à partir de Service de modification de documents.
Clé secrète - indiquez la clé secrète utilisée pour signer les données. Pour en savoir plus, consultez la section de l'article Activer le jeton JWT pour intégrer ONLYOFFICE et Liferay.
Activer Force Save - activez la case à cocher afin de sauvegarder les versions intermédiaires lors de modification.
Activer l'aperçu Web ONLYOFFICE - activez la case à cocher afin d'activer l'aperçu des fichiers.

Une fois que l'application d'intégration est configurée, cliquez sur le bouton Enregistrer pour enregistrer les modifications.

Activer le jeton JWT pour intégrer ONLYOFFICE et Liferay

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 Document Server.

Afin de protéger vos documents vous avez besoin d'activer la validation du jeton et de spécifier 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: Configurer ONLYOFFICE Docs

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 bash et ouvrez-le. /etc/onlyoffice/documentserver/local.json
Activez la validation du jeton en remplaçant la valeur false par true dans trois sections :
- services.CoAuthoring.token.enable.browser
- services.CoAuthoring.token.enable.request.inbox
- services.CoAuthoring.token.enable.request.outbox

Spécifiez votre propre clé secrète en remplaçant la valeur secrète par votre propre chaîne de texte dans trois sections. La clé secrète doit être identique.

services.CoAuthoring.secret.inbox.string
services.CoAuthoring.secret.outbox.string
services.CoAuthoring.secret.session.string

{
  "services": {
    "CoAuthoring": {
      "token": {
        "enable": {
          "request": {
            "inbox": true,
            "outbox": true
          },
          "browser": true
        }
      },
        "secret": {
          "inbox": {
            "string": "yoursecret"
        },
        "outbox": {
          "string": "yoursecret"
        },
        "session": {
          "string": "yoursecret"
        }
      }
    }
  }
}

Enregistrez vos modifications.
Redémarrez les services pour que les modifications de configuration prennent effet.
```
supervisorctl restart all
```

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

Spécifiez la même clé secrète aux paramètres du connecteur dans le champ Clé secrète et enregistrez les paramètres.

Commencer à utiliser ONLYOFFICE Docs au sein de Liferay

Afin de créer un fichier :

Passez à la section Documents et Média.
Cliquez sur le bouton Ajouter fichier.
Dans le menu qui s'affiche, cliquez sur le bouton <Créer avec ONLYOFFICE.
Sur la page qui s'affiche, sélectionnez le type de fichier, saisissez son titre et descriptif (facultatif).
Cliquez sur le bouton Enregistrer.

Afin de modifier un fichier :

Recherchez le fichier nécessaire dans la section Documents et Média.
Cliquez sur le document.
Dans le menu qui s'affiche, cliquez sur le bouton Modifier dans ONLYOFFFICE.

Afin de créer un formulaire :

Passez à la section Documents et Média.
Cliquez sur le bouton Ajouter fichier.
Dans le menu qui s'affiche, cliquez sur le bouton Créer avec ONLYOFFICE.
Choisissez l'option Formulaire, saisissez le titre du fichier et un descriptif (facultatif).
Cliquez sur le bouton Enregistrer.
Enregistrez le formulaire sous .docxf pour pouvoir le modifier, revoir ainsi que collaborer sur ce formulaire par la suite.