Intégration. Pour bien commencer. Jira

Fermer

Centre d'aide

l'intégration

How to integrate ONLYOFFICE with Nextcloud

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

ONLYOFFICE offre un connecteur officiel pour intégrer ONLYOFFICE Docs dans Jira afin de collaborer sur les documents de bureau joints à vos tâches à Jira : Vous pouvez le télécharger à partir de Atlassian Marketplace ou de GitHub. L'application est rendue accessible sous la Licence Apache.

Pour en savoir plus sur son fonctionnement, veuillez consulter notre documentation API.

Principales caractéristiques

Afficher et modifier les documents texte, les feuilles de calcul et les présentations en utilisant l'option Modifier dans ONLYOFFICE.
Pour en savoir plus sur les formulaires veuillez consulter les articles consacrés à la création et au remplissage des formulaires.
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, modifier et afficher : DOCX, PPTX, XLSX, DOCXF.
À remplir les formulaires : OFORM.
À afficher : DOC, DOCM, DOC, DOTX, DOTM, ODT, FODT, OTT, RTF, TXT, HTML, HTM, MHT, PDF, DJVU, FB2, EPUB, XPS, XLS, XLSM, XLTZ , XLTX, XLTM, ODS, FODS, OTS, CSV, PPS, PPSX, PPSM, PPT, PPTM, POT, POTX, POTM, ODP, FODP, OTP.

Connecter ONLYOFFICE Docs à Jira

Exigences

ONLYOFFICE Docs 6.4.0 ou version ultérieure
Vous avez besoin d'une instance pouvant être résolue et connectée par Jira et tout autre client final. L'instance doit envoyer des données en POST directement à Jira.

Veuillez consulter la page de documentation ONLYOFFICE Docs officielle pour en savoir plus sur l'installation de ONLYOFFICE Docs.
Jira Software (Server ou Data Center) v. 7.13.0 - 8.19.0
Veuillez consulter la documentation Atlassian pour en savoir plus sur l'installation de Jira Software.

Installer le connecteur ONLYOFFICE pour Jira

Vous pouvez télécharger le connecteur à partir de Atlassian Marketplace officiel ou le compiler à partir des codes source disponibles sur GitHub.

Ajouter le connecteur depuis Atlassian marketplace

Connectez-vous à votre instance Jira Software en tant qu'administrateur.
Cliquez en haut à droite sur l'icône Administration et choisissez l'option Gérer les applications du menu.
La section Trouver de nouvelles applications s'ouvre. Cliquez sur le champ Rechercher Marketplace et recherchez Application d'intégration Jira ONLYOFFICE.
Cliquez sur le bouton Installer pour télécharger et installer l'application.

Ajouter le connecteur compilé à partir des codes source

Pour que la compilation du connecteur ONLYOFFICE pour Jira soit possible vous avez avant tout besoin d'installer les conditions préalables suivantes :

Afin de compiler le connecteur ONLYOFFICE pour Jira veuillez suivre ces étapes :

Clonez le référentiel onlyoffice-jira.

git clone https://github.com/ONLYOFFICE/onlyoffice-jira.git

Passez au répertoire onlyoffice-jira.
```
cd onlyoffice-jira
```
Exécutez la commande suivante :
```
atlas-package
```
Attendez la fin de la compilation du connecteur. Quand le connecteur est compilé il peut être trouvé dans le dossier target.

Le connecteur compilé peut être téléchargé sur votre page Jira Software Administration -> Gérer les applications.

Connectez-vous à votre instance Jira Software en tant qu'administrateur.
Cliquez en haut à droite sur l'icône Administration et choisissez l'option Gérer les applications du menu.
Sélectionnez la section Gérer les applications sur le panneau gauche.
Cliquez sur le lien Télécharger l'application.
Cliquez sur le bouton Sélectionner le fichier, parcourez le fichier compilé target/onlyoffice-jira-app.jar et cliquez sur Télécharger. Attendez la fin de l'installation de l'application.

Configurer le connecteur ONLYOFFICE pour Jira

Cliquez sur le bouton Configurer au-dessous de l'Application d'intégration Jira ONLYOFFICE installée à la page Gérer les applications ou trouvez l'application dans la section AUTRES à la page Gérer les applications.

Dans le champ Adresse du Service de modification de documents indiquez l'adresse IP ou le nom d'hôte du serveur sur lequel ONLYOFFICE Docs est installé.

Vous pouvez également indiquer une Clé secrète - la clé secrète pour valider le jeton JSON sur la demande à la connexion de ONLYOFFICE Docs. Pour en savoir plus, consultez la section de l'article Activer le jeton JWT pour intégrer ONLYOFFICE et Jira.

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 Jira Software et ONLYOFFICE Docs en utilisant les adresses publiques. Dans ce dernier cas indiquez les adresses pour les demandes internes dans les champs correspondants.

L'adresse du serveur Jira Software pour les demandes internes à partir de ONLYOFFICE Docs.
L'adresse ONLYOFFICE Docs pour les demandes internes à partir du serveur Jira Software.

Cliquez sur Enregistrer afin d'enregistrer les paramètres.

Activer le jeton JWT pour intégrer ONLYOFFICE et Jira

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

Afin de protéger vos documents vous avez besoin d'activer la validation du jeton et de spécifier 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: Configurer ONLYOFFICE Docs

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 bash et ouvrez-le. /etc/onlyoffice/documentserver/local.json
Activez la validation du jeton en remplaçant la valeur false par true dans trois sections :
- services.CoAuthoring.token.enable.browser
- services.CoAuthoring.token.enable.request.inbox
- services.CoAuthoring.token.enable.request.outbox

Spécifiez votre propre clé secrète en remplaçant la valeur secrète par votre propre chaîne de texte dans trois sections. La clé secrète doit être identique.

services.CoAuthoring.secret.inbox.string
services.CoAuthoring.secret.outbox.string
services.CoAuthoring.secret.session.string

{
   "services": {
    "CoAuthoring": {
      "token": {
        "enable": {
          "request": {
            "inbox": true,
            "outbox": true
          },
        "browser": true
        }
      },
      "secret": {
        "inbox": {
          "string": "yoursecret"
        },
            "outbox": {
             "string": "yoursecret"
    },
          "session": {
            "string": "yoursecret"
        }
      }
    }
  }
}

Enregistrez vos modifications.
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.

Commencer à utiliser ONLYOFFICE Docs au sein de Jira

Afficher et modifier les fichiers

Vous pouvez ouvrir les éditeurs ONLYOFFICE dans le bloc Pièces jointes d'une tâche. Cette option est disponible pour les tâches aux modules où une tâche peut être ouverte, par exemple, liste des tâches, backlog, tâches etc.

Les pièces jointes doivent être activées par l'administrateur.

Une nouvelle pièce jointe peut être ajoutée à la page de la tâche à l'aide de l'option Plus -> Joindre des fichiers. Pour en savoir plus veuillez consulter la documentation officielle.

Afin d'ouvrir un document texte, une feuille de calcul, une présentation ou un formulaire placez le pointeur de la souris sur le fichier nécessaire et cliquez sur l'icône ONLYOFFICE_connector Modifier dans ONLYOFFICE.

Le fichier s'ouvre dans un nouvel onglet du navigateur au sein de l'éditeur ONLYOFFICE correspondant.

Permissions d'accès

Les permissions d'accès aux fichiers dépendent des droits d'accès d'un utilisateur à la tâche appropriée.

Modifier les fichiers. Pour pouvoir modifier les fichiers un utilisateur a besoin d'obtenir la permission de créer les pièces jointes (Create attachments).

Afficher les fichiers. Un fichier peut être aperçu au sein des visionneuses ONLYOFFICE par tous les utilisateurs qui ont la permission d'afficher une tâche mais dont le droit de modifier la tâche ou de créer les pièces jointes est limité. Lorsque le format de fichier n'est pas pris en charge pour modification le fichier s'ouvre pour affichage.

Enregistrer les modifications

Les modifications apportées à un fichier sont enregistrées à un nouveau fichier portant le même nom que le fichier d'origine avec un suffixe ajouté à la fin du nom du fichier, par exemple, Sample-1.docx.

Les modifications apportées à un fichier lors de la modification en collaboration ne sont enregistrées que dans la première version du fichier. Lorsque le même document est modifié par plusieurs utilisateurs en même temps les modifications ne s'affichent que dans le premier fichier. Une nouvelle version du fichier ne s'ajoute pas à la tâche jusqu'à la fermeture de l'éditeur par le dernier utilisateur.

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 :