Redmine

Apprendre à intégrer ONLYOFFICE Docs dans l'application de gestion des projets basé sur le web Redmine à l'aide du connecteur disponible sur Marketplace Redmine ou sur la page ONLYOFFICE sur GitHub.

À propos de l'intégration ONLYOFFICE et Redmine

ONLYOFFICE propose un connecteur officiel pour intégrer ONLYOFFICE Docs dans Redmine pour collaborer sur des documents joints aux module Redmine suivants: Issues (Demandes), Files (Fichiers), Documents (Documents), Wiki (Wiki) et News (Annonces). Vous pouvez télécharger le connecteur ONLYOFFICE à partir de Marketplace Redmine ou sur la page ONLYOFFICE sur GitHub. L'application est rendu accessible sous la Licence Apache.

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

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 des formulaires en ligne.
  • 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
  • À afficher et modifier: DOCX, PPTX, XLSX
  • À remplir des formulaires: PDF
  • En lecture seule: DOC, DOCM, DOT, DOTX, DOTM, ODT, FODT, OTT, RTF, TXT, HTML, HTM, MHT, XML, PDF, DJVU, FB2, EPUB, XPS, XLS, XLSM, XLT, XLTX, XLTM, ODS, FODS, OTS, CSV, PPS, PPSX, PPSM, PPT, PPTM, POT, POTX, POTM, ODP, FODP, OTP.
Toutes les nouveautés de la version 3.1.0

Fonctionnalités

  • Remplissage de fichiers pdf au lieu du format oform.

Corrections

  • Vérification manuelle de la dépendance de la version est corrigée.

Le journal des modifications complet est disponible ici.

Connecter ONLYOFFICE Docs à Redmine

Exigences
  • ONLYOFFICE Document Server v7.1 (version serveur ou cloud) ou version ultérieure

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

    Veuillez consulter la documentation officielle pour en savoir plus sur l'installation d'ONLYOFFICE Docs.
  • Redmine v4.0.0 - v5.0.x. Si vous êtes novice sur Redmine, installez l'application en suivant ces instructions.
  • Connecteur ONLYOFFICE v2.0.0 pour Redmine
Installer le connecteur ONLYOFFICE pour Redmine
  1. Téléchargez le module d'intégration ONLYOFFICE pour Redmine. Il y a plusieurs façons de ce faire:
    1. Téléchargez l'archive de la dernière version à partir de Marketplace Redmine.
    2. Téléchargez l'archive de la dernière version à partir de Marketplace Redmine.
      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 principale:
      git clone https://github.com/ONLYOFFICE/onlyoffice-redmine
    4. Avant d'installer le module complémentaire, vérifiez que l'instance de Redmine est arrêtée.
    5. Passez au dossier Redmine ONLYOFFICE integration plugin (Module d'intégration Redmine ONLYOFFICE) et obtenez le sous-module:
      cd onlyoffice-redminegit submodule update --init --recursive
    Le nom du sous-répertoire du module complémentaire doit être onlyoffice_redmine. Renommez le dossier cloné onlyoffice-redmine ou le dossier décompressé onlyoffice_redmine-X.X.X en onlyoffice_redmine.
    >mv onlyoffice-redmine onlyoffice_redmine
    mv onlyoffice-redmine-X.X.X onlyoffice_redmine
  2. Placez le répertoire onlyoffice_redmine dans le référentiel plugins, e.g:
    cp -r /root/onlyoffice_redmine/. /redmine/plugins/onlyoffice_redmine
    Le chemin d'accès au référentiel plugins peut varier selon les options d'installation Redmine. Vous pouvez utiliser la commande find / -type d -name plugins pour rechercher le chemin.
  3. Passez au répertoire racine Redmine:
    cd redmine
  4. Installez des 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. Réinitialisez l'instance Redmine.
Configurer le connecteur ONLYOFFICE pour Redmine

Passez au panneau Administration > Plugins, recherchez le module complémentaire ONLYOFFICE pour Redmine et cliquez sur Configure (Configurer). Indiquez les paramètres suivants:

  • Document Editing Service address (Adresse du service d'édition des documents) - saisissez l'adresse URL et le port utilisé pour ONLYOFFICE Docs (par ex. https://documentserver:8080). C'est un champ obligatoire.
    L'adresse d'ONLYOFFICE Docs doit être accessible sur Redmine et l'adresse de Redmine doit être accessible sur ONLYOFFICE Docs.
  • La rubrique Advanced server settings (Paramètres avancés du serveur) peut être utilisé lorsque la configuration de votre réseau ne permet pas d'exécuter les demandes entre Redmine et ONLYOFFICE Docs utilisant des adresses publiques. Dans ce cas-là, indiquez les adresses pour des demandes internes dans les champs appropriés:
    • ONLYOFFICE Docs address for internal requests from the server (Adresse d'ONLYOFFICE Docs pour les demandes internes du serveur) - indiquez l'adresse utilisée pour accéder au Service d'édition des documents à partir du serveur Redmine.
    • Server address for internal requests from ONLYOFFICE Docs (Adresse du serveur pour les demandes internes d'ONLYOFFICE Docs) - indiquez l'adresse utilisée pour accéder à Redmine depuis le Service d'édition des documents.
  • 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é Redmine: 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 Redmine.
  • Disable certificate verification (insecure) (Désactiver la validation du certificat (non sécurisé)) - activez cette option pour désactiver la validation du certificat et permettre à Redmine d'établir une connexion avec ONLYOFFICE Docs lorsque vous utilisez un certificat auto-signé pour ONLYOFFICE Docs (sinon, Redmine ne validera pas le certificat et ne permettra pas la connexion avec ONLYOFFICE Docs). C'est une solution non sécurisée et nous vous recommandons vivement de remplacer ce certificat par un autre émis par une l'autorité de certification.
  • Le cas échéant, configurez les paramètres de personnalisation suivants:
    • Afficher le bouton du menu Chat.
    • Vue plus compacte de l'en-tête.
    • Afficher le bouton du menu Commentaires et assistance.
    • Afficher le bouton du menu Aide.
    • Permuter l'affichage de l'en-tête de la barre d'outils en monochrome.

Cliquez sur le bouton Apply (Appliquer) en bas de la page.

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

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 2.0.0 du connecteur ONLYOFFICE, il est possible d'essayer les éditeurs ONLYOFFICE en ligne au sein de Redmine 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.

ImportantC'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 Redmine

Toutes les modifications sont sauvegardées dans le fichier d'origine.
Modifier les niveaux d'accès

Veuillez noter que la liste des opérations sur des fichiers dans chaque module varie selon le rôle attribué à l'utilisateur et les permissions associées à celle-ci.

Passez à Administration > Roles and permissions, (Administration > Rôles et autorisations) choisissez le rôle nécessaire dans la liste, activez/désactivez les autorisations nécessaires et cliquez sur Save (Enregistrer).

Pour en savoir plus, veuillez consulter la documentation officielle Redmine.

Module Demandes

Afin d'ouvrir les fichiers joints aux demandes ou aux commentaires à une demande dans l'éditeur correspondant, cliquez sur le bouton Icône ONLYOFFICEEdit in ONLYOFFICE / Open in ONLYOFFICE (Modifier dans ONLYOFFICE / Ouvrir dans ONLYOFFICE) à droite du nom de fichier.

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

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

Module Demandes Module Demandes
Module Fichiers

Les fichiers ne peuvent être ouverts que par les utilisateurs ayant les permissions View files (Afficher des fichiers) ou Manage files (Gérer des fichiers). Afin d'ouvrir les fichiers dans l'éditeur correspondant, cliquez sur le bouton ONLYOFFICE Icône ONLYOFFICE Open in ONLYOFFICE (Ouvrir dans ONLYOFFICE) à droite du nom de fichier.

Module Fichiers Module Fichiers
Module Documents

Afin d'ouvrir les fichiers dans l'éditeur correspondant, cliquez sur le bouton Icône ONLYOFFICE Edit in ONLYOFFICE / Open in ONLYOFFICE (Modifier dans ONLYOFFICE / Ouvrir dans ONLYOFFICE) à droite du nom de fichier.

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

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

Module Documents Module Documents

Afin de créer un formulaire, cliquez sur le lien Create in ONLYOFFICE (Créer dans ONLYOFFICE) et choisissez l'option Form Template (Modèle de formulaire).

créer un formulaire: créer un formulaire:

Remplissez tous les champs requis et cliquez sur Create (Créer).

Pour en savoir plus sur formulaires, veuillez consulter les guides appropriés de création et remplissage de formulaires.
Module Wiki

Afin d'ouvrir les fichiers dans l'éditeur correspondant, cliquez sur le bouton Icône ONLYOFFICE Edit in ONLYOFFICE / Open in ONLYOFFICE (Modifier dans ONLYOFFICE / Ouvrir dans ONLYOFFICE) à droite du nom de fichier.

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

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

Module Wiki Module Wiki
Module Annonces

Afin d'ouvrir les fichiers dans l'éditeur correspondant, cliquez sur le bouton Icône ONLYOFFICE Edit in ONLYOFFICE / Open in ONLYOFFICE (Modifier dans ONLYOFFICE / Ouvrir dans ONLYOFFICE) à droite du nom de fichier.

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

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

Module Annonces Module Annonces
Convertir des fichiers

La possibilité de convertir des fichiers est disponible dans les modules Redmine suivants: Issues, Documents, Wiki, and News (Demandes, Fichiers, Documents, Wiki et Annonces).

Convertir des fichiers Convertir des fichiers

Cliquez sur le bouton Convert with ONLYOFFICE (Convertir avec ONLYOFFICE) Icône ONLYOFFICE à droite du nom de fichier.

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

Convertir des fichiers Convertir des fichiers

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

Regarder la vidéo

Comment intégrer ONLYOFFICE dans Redmine

Hébergez ONLYOFFICE Docs sur votre serveur ou utilisez dans le cloud

Articles avec le tag :
Parcourir tous les tags