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.

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.