- Accueil
- Connecteurs
- Redmine
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
-
Téléchargez le module d'intégration ONLYOFFICE pour Redmine. Il y a plusieurs façons de ce faire:
- Téléchargez l'archive de la dernière version à partir de Marketplace Redmine.
-
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
-
Clonez la branche principale:
git clone https://github.com/ONLYOFFICE/onlyoffice-redmine
- Avant d'installer le module complémentaire, vérifiez que l'instance de Redmine est arrêtée.
-
Passez au dossier Redmine ONLYOFFICE integration plugin (Module d'intégration Redmine ONLYOFFICE) et obtenez le sous-module:
cd onlyoffice-redmine
git 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
-
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 commandefind / -type d -name plugins
pour rechercher le chemin. -
Passez au répertoire racine Redmine:
cd redmine
-
Installez des dépendances:
bundle install
-
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
- 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.


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
-
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"}}}}}
- Pour Linux -
-
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
-
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
-
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.
Commencer à utiliser ONLYOFFICE Docs au sein de Redmine
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 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 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 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 Open in ONLYOFFICE (Ouvrir dans ONLYOFFICE) à droite du nom de fichier.


Module Documents
Afin d'ouvrir les fichiers dans l'éditeur correspondant, cliquez sur le bouton 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).


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


Remplissez tous les champs requis et cliquez sur Create (Créer).
Module Wiki
Afin d'ouvrir les fichiers dans l'éditeur correspondant, cliquez sur le bouton 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 Annonces
Afin d'ouvrir les fichiers dans l'éditeur correspondant, cliquez sur le bouton 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).


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


Cliquez sur le bouton Convert with ONLYOFFICE (Convertir avec ONLYOFFICE) à droite du nom de fichier.
Sélectionnez le format nécessaire dans la liste. Vous pouvez également modifier le nom du fichier.


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.