Intégration. Pour bien commencer Redmine - ONLYOFFICE

Fermer

Centre d'aide

l'intégration

How to integrate ONLYOFFICE with Nextcloud

À 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: Demandes, Fichiers, Documents, Wiki et 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.

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, DOCXF, PPTX, XLSX
À remplir des formulaires: OFORM
En lecture seule: 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

Nouvelles fonctionnalités ajoutées

Conversion des documents.
Connexion à la version démo du serveur de documents.
Options de configuration du serveur avancées pour indiquer les adresses internes.
Validation de paramètres.
Ignorer les certificats auto-signés.

Corrigé

Problèmes de permissions.

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

Vous pouvez également utiliser ONLYOFFICE Docs Cloud (version SaaS).
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

Configurer 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 le branche master:
```
git clone https://github.com/ONLYOFFICE/onlyoffice-redmine
```
Le sous-répertoire du module complémentaire doit être nommé 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
```
Avant d'installer le module complémentaire, vérifiez que l'instance de Redmine est arrêtée.
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.
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, (Administration -> Modules complémentaires) et recherchez le module d'intégration ONLYOFFICE pour Redmine et cliquez sur Configure (Configurer). Indiquez les paramètres suivants:

Document Editing Service address (Adresse du service de modification des documents) - saisissez l'adresse URL et le port utilisé pour ONLYOFFICE Docs (par ex. https://documentserver). C'est un champ obligatoire.
ImportantL'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 de modification 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 de modification 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 (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:
- Display Chat menu button (Afficher le bouton du menu Chat).
- Display the header in a more compact way (Vue plus compacte de l'en-tête).
- Display Feedback & Support menu button (Afficher le bouton du menu Commentaires et assistance).
- Display Help menu button (Afficher le bouton du menu Aide).
- Display monochrome toolbar header (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"
        }
      }
    }
  }
}

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.

C'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 sur la liste, activez /désactivez les permissions appropriées et cliquez sur Save (Enregistrer).

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

Créer et modifier des fichiers

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

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

Module Wiki

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

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

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.

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 :