Articles avec le tag :
Parcourir tous les tags
Fermer
Changelog
Fermer
Essayer dans le cloud
Essayer dans le cloud
Centre d'aide
l'intégration
Search

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

ONLYOFFICE offre un connecteur officiel pour intégrer ONLYOFFICE Docs dans Redmine afin de collaborer sur les documents de bureau joints aux modules Redmine suivants : Demandes, Fichiers, Documents, Wiki et Annonces. Vous pouvez télécharger le connecteur ONLYOFFICE à partir de Marketplace Redmine ou de la page ONLYOFFICE sur GitHub. L'application est rendue accessible sous la Licence Apache.

Principales caractéristiques

  • Afficher et modifier les documents texte, les feuilles de calcul et les présentations depuis les modules Redmine en fonction des droits d'accès de l'utilisateur.
  • Créer et remplir les formulaires en ligne.
  • 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 et modifier : DOCX, DOCXF, PPTX, XLSX
  • À remplir les formulaires : OFORM
  • À afficher : DOC, DOCX, DOCM, DOT, DOTX, DOTM, ODT, FODT, OTT, RTF, TXT, HTML, HTM, MHT, XML, PDF, DJVU, FB2, EPUB, XPS, XLS, XLSX, XLSM, XLT, XLTX, XLTM, ODS, FODS, OTS, CSV, PPS, PPSX, PPSM, PPT, PPTX, PPTM, POT, POTX, POTM, ODP, FODP, OTP.

Toutes les nouveautés de la version 2.0.0

Ajouté

  • Conversion de documents.
  • Connexion à un serveur de documents démo.
  • Paramètres de serveur avancés pour spécifier les adresses internes.
  • Validation des paramètres.
  • Ignorer les certificats auto-signés.

Corrigé

  • Problèmes d'autorisations.

Le journal des modifications complet est disponible ici.

Connecter ONLYOFFICE Docs à Redmine

Exigences

  • ONLYOFFICE Docs 6.4 ou version ultérieure

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

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

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

  • Redmine v4.0.0 - v5.0.x. Si vous êtes nouveau sur Redmine, suivez ces instructions pour l'installer.
  • Connecteur ONLYOFFICE v2.0.0 pour Redmine

Installer le connecteur ONLYOFFICE pour Redmine

  1. Téléchargez le plug-in d'intégration ONLYOFFICE pour Redmine. Il existe quelques moyens de le faire :
    1. Téléchargez la dernière version archivée à partir de Redmine Marketplace.
    2. Téléchargez la dernière version archivée à partir de la page ONLYOFFICE sur GitHub : 
      wget https://github.com/ONLYOFFICE/onlyoffice-redmine/archive/refs/tags/vX.X.X.tar.gz

      Où vX.X.X est la version appropriée du connecteur.

      Décompressez l'archive :

      tar -xvzf vX.X.X.tar.gz
    3. Clonez la branche maîtresse : 
      git clone https://github.com/ONLYOFFICE/onlyoffice-redmine
    Le sous-répertoire du plug-in doit être nommé onlyoffice_redmine. Renommez onlyoffice-redmine cloné ou le dossier onlyoffice_redmine-X.X.X décompressé avec le nom onlyoffice_redmine. 
    mv onlyoffice-redmine onlyoffice_redmine
mv onlyoffice-redmine-X.X.X onlyoffice_redmine

    Avant d'installer le plug-in, assurez-vous que l'instance Redmine est arrêtée.

  2. Placez le répertoire du plug-in onlyoffice_redmine dans le répertoire plugins, par exemple : 
    cp -r /root/onlyoffice_redmine/. /redmine/plugins/onlyoffice_redmine
    Le chemin d'accès au répertoire plugins peut différer selon vos options d'installation de Redmine. Pour trouver le chemin d'accès, exécutez la commande find / -type d -name plugins.
  3. Passez au répertoire racine de Redmine : 
    cd redmine
  4. Installez les dépendances : 
    bundle install
  5. Initialisez/mettez à jour la base de données : 
    RAILS_ENV=production bundle exec rake db:migrate
    RAILS_ENV=production bundle exec rake redmine:plugins:migrate NAME=onlyoffice_redmine
  6. Redémarrez l'instance Redmine.

Configurer le connecteur ONLYOFFICE pour Redmine

Passez au panneau Administration -> Plugins, trouvez le plug-in d'intégration ONLYOFFICE pour Redmine et cliquez sur Configurer. Configurez les paramètres suivants :

  • Service de modification de documents - indiquez l'adresse URL et le port de ONLYOFFICE Docs (par exemple, https://documentserver:8080). Ce champ est obligatoire.
    ImportantL'adresse de ONLYOFFICE Docs doit être accessible depuis Redmine, ainsi que l'adresse de Redmine doit être accessible depuis ONLYOFFICE Docs.
  • La section Paramètres avancés du serveur peut être utilisée lorsque la configuration de votre réseau n'autorise pas les demandes entre Redmine et ONLYOFFICE Docs en utilisant les adresses publiques. Dans ce dernier cas indiquez les adresses pour les demandes internes dans les champs correspondants.
    • 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 Redmine.
    • Adresse du serveur pour les demandes internes de ONLYOFFICE Docs - indiquez l'adresse utilisée pour accéder à Redmine à partir du Service de modification de documents.
  • Clé secrète - indiquez la clé secrète utilisée pour signer les données.
    À 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 Redmine : 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 Redmine.
  • Désactiver la vérification du certificat (non sécurisé) - cochez cette case afin de désactiver la vérification du certificat et d'autoriser Redmine à établir la connexion avec ONLYOFFICE Docs lorsque vous utilisez un certificat auto-signé pour votre ONLYOFFICE Docs (sinon, Redmine ne validera pas un certificat auto-signé et n'autorisera pas la connexion à/depuis ONLYOFFICE Docs). C'est une solution non sécurisée et nous recommandons vivement de remplacer le certificat par celui émis par une autorité de certification.
  • Cochez les paramètres de personnalisation suivants si nécessaire :
    • Afficher le bouton du menu du chat.
    • Afficher l'en-tête plus compact.
    • Afficher le bouton du menu Feedback & Support.
    • Afficher le bouton du menu Aide.
    • Afficher un en-tête monochrome de la barre d'outils.

Cliquez sur le bouton Appliquer en bas afin d'enregistrer les modifications.

ONLYOFFICE_configure ONLYOFFICE_configure

Activer le jeton JWT pour intégrer ONLYOFFICE et Redmine

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

Se connecter à la version démo de ONLYOFFICE Docs

À partir de la version 2.0.0 du connecteur ONLYOFFICE il est possible d'essayer les éditeurs en ligne ONLYOFFICE avec Redmine sans installation réelle de ONLYOFFICE Docs.

Pour activer la connexion cochez Connecter au démo ONLYOFFICE Document Server et cliquez sur le bouton Enregistrer.

C'est un serveur d'essai publique qui sera disponible pendant 30 jours. Ne partagez pas vos données sensibles.

Commencer à utiliser ONLYOFFICE Docs au sein de Redmine

Toutes les modifications sont enregistrées dans le fichier d'origine.

Changer les permissions

Il est à noter que pour chaque module les actions possibles sur le fichier (affichage et modifications) dépendent des permissions du rôle de l'utilisateur.

Passez à Administration -> Rôles et autorisations, choisissez le rôle nécessaire sur la liste, activez /désactivez les permissions appropriées et cliquez sur Enregistrer.

Veuillez consulter la documentation officielle Redmine pour plus de détails.

Afficher et modifier les fichiers

Module Demandes

Afin d'ouvrir les fichiers joints aux demandes ou aux commentaires à une demande dans l'éditeur correspondant, cliquez sur le bouton ONLYOFFICE icon Modifier dans ONLYOFFICE / Ouvrir dans ONLYOFFICE à droite du nom du fichier.

La possibilité de modifier les documents est accessible aux utilisateurs ayant la permission Modifier des demandes.

La possibilité d'ouvrir les fichiers pour l'affichage est accessible aux utilisateurs ayant la permission Afficher des demandes.

Issues module Issues module
Module Fichiers

Les fichiers ne peuvent être ouverts que par les utilisateurs ayant les permissions Afficher des fichiers ou Gérer des fichiers. Afin d'ouvrir les fichiers dans l'éditeur correspondant, cliquez sur le bouton ONLYOFFICE icon Ouvrir dans ONLYOFFICE à droite du nom du fichier.

Issues module Issues module
Module Documents

Afin d'ouvrir les fichiers dans l'éditeur correspondant, cliquez sur le bouton ONLYOFFICE icon Modifier dans ONLYOFFICE / Ouvrir dans ONLYOFFICE à droite du nom du fichier.

La possibilité de modifier les documents est accessible aux utilisateurs ayant la permission Modifier des documents.

La possibilité d'ouvrir les fichiers pour l'affichage est accessible aux utilisateurs ayant la permission Afficher des documents.

Issues module Issues module

Afin de créer un formulaire, cliquez sur le lien Créer dans ONLYOFFICE et choisissez l'option Modèle de formulaire.

create a form create a form

Remplissez les champs requis et cliquez sur Créer.

Pour en savoir plus sur les formulaires, veuillez consulter les articles consacrés à la création et au remplissage des formulaires.
Module Wiki

Afin d'ouvrir les fichiers dans l'éditeur correspondant, cliquez sur le bouton ONLYOFFICE icon Modifier dans ONLYOFFICE / Ouvrir dans ONLYOFFICE à droite du nom du fichier.

La possibilité de modifier les documents est accessible aux utilisateurs ayant la permission Modifier des pages Wiki.

La possibilité d'ouvrir les fichiers pour l'affichage est accessible aux utilisateurs ayant la permission Afficher Wiki.

Issues module Issues module
Module Annonces

Afin d'ouvrir les fichiers dans l'éditeur correspondant, cliquez sur le bouton ONLYOFFICE icon Modifier dans ONLYOFFICE / Ouvrir dans ONLYOFFICE à droite du nom du fichier.

La possibilité de modifier les documents est accessible aux utilisateurs ayant la permission Modifier des annonces.

La possibilité d'ouvrir les fichiers pour l'affichage est accessible aux utilisateurs ayant la permission Afficher des annonces.

Issues module Issues module

Convertir les fichiers

La possibilité de convertir des fichiers est disponible dans les modules Redmine suivants : Demandes, Documents, Wiki et Annonces.

Converting files Converting files

Cliquez sur le bouton ONLYOFFICE icon Convertir avec ONLYOFFICE à droite du nom du fichier.

Sélectionnez le format nécessaire dans la liste. Vous pouvez éventuellement modifier le nom du fichier.

Converting files Converting files

Cliquez sur le bouton Convertir pour enregistrer le fichier converti dans la section Redmine correspondante. Cliquez sur le bouton Télécharger pour enregistrer le fichier converti sur votre ordinateur localement.

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