Articles avec le tag :
Fermer
Changelog
Fermer
Essayer dans le cloud
Essayer dans le cloud
Centre d'aide
l'intégration

À 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

  • Créer de nouveaux documents texte, feuilles de calcul, présentations et formulaires.
  • 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.

    Vous pouvez également utiliser ONLYOFFICE Docs Cloud (version SaaS).

  • Jira Software (Server ou Data Center) v. 9.0.0 - 9.3.1

    Veuillez consulter la documentation Atlassian pour en savoir plus sur l'installation de Jira Software.

  • Connecteur ONLYOFFICE v2.1.0 ou version ultérieure pour Jira

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
  1. Connectez-vous à votre instance Jira Software en tant qu'administrateur.
  2. Cliquez en haut à droite sur l'icône ONLYOFFICE_connector Administration et choisissez l'option Gérer les applications du menu.
    ONLYOFFICE_connector ONLYOFFICE_connector
  3. La section Trouver de nouvelles applications s'ouvre. Cliquez sur le champ Rechercher Marketplace et recherchez Application d'intégration Jira ONLYOFFICE.
  4. 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 :

  1. Clonez le référentiel onlyoffice-jira.
    git clone https://github.com/ONLYOFFICE/onlyoffice-jira.git
  2. Passez au répertoire onlyoffice-jira.
    cd onlyoffice-jira
  3. 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.

  1. Connectez-vous à votre instance Jira Software en tant qu'administrateur.
  2. Cliquez en haut à droite sur l'icône ONLYOFFICE_connector Administration et choisissez l'option Gérer les applications du menu.
  3. Sélectionnez la section Gérer les applications sur le panneau gauche.
  4. Cliquez sur le lien Télécharger l'application.
  5. 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.
    ONLYOFFICE_connector ONLYOFFICE_connector

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.

ONLYOFFICE_connector ONLYOFFICE_connector

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

ImportantL'adresse de ONLYOFFICE Docs doit être accessible depuis Jira, ainsi que l'adresse de Jira doit être accessible depuis ONLYOFFICE Docs.
ONLYOFFICE_connector ONLYOFFICE_connector

Désactiver la vérification du certificat (non sécurisé) - cochez cette case afin de désactiver la vérification du certificat et d'autoriser Jira à établir la connexion avec ONLYOFFICE Docs lorsque vous utilisez un certificat auto-signé pour votre ONLYOFFICE Docs (sinon, Jira ne validera pas un certificat auto-signé et n'autorisera pas la connexion à/depuis ONLYOFFICE Docs). C'est une solution non sécurisée et nous recommandons vivement de remplacer le certificat par celui émis par une autorité de certification.

Indiquez une Clé secrète - la clé secrète pour valider le jeton JSON sur la demande à la connexion de ONLYOFFICE Docs.

À partir de la version ONLYOFFICE Docs v7.2 le jeton JWT est activé par défaut et la clé secrète est générée automatiquement. Vous devez également l'activer du côté de Jira : trouvez votre propre clé secrète dans le fichier de configuration ONLYOFFICE Docs et ensuite spécifiez la même clé secrète aux paramètres du connecteur. 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 ONLYOFFICE Docs.

À partir de la version ONLYOFFICE Docs v7.2 le jeton JWT est activé par défaut et la clé secrète est générée automatiquement. Vous avez besoin de trouver 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 : Trouvez votre propre clé secrète dans le fichier de configuration ONLYOFFICE Docs

  1. 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 <containerID> bash et ouvrez-le. /etc/onlyoffice/documentserver/local.json

      À titre subsidiaire, vous pouvez utiliser la commande suivante pour trouver la clé secrète par défaut sans ouvrir 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. La valeur true est spécifiée 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 générée automatiquement est spécifiée dans trois sections. Vous pouvez remplacer la valeur secrète par défaut avec votre propre clé secrète. La clé secrète doit être identique dans trois sections.
    • services.CoAuthoring.secret.inbox.string
    • services.CoAuthoring.secret.outbox.string
    • services.CoAuthoring.secret.session.string
  4. Si vous apportez des modifications, enregistrez-les et 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.

Se connecter à la version démo de ONLYOFFICE Docs

À partir de la version 2.0.0 du connecteur ONLYOFFICE il est possible d'essayer les éditeurs en ligne ONLYOFFICE avec Jira sans installation réelle de ONLYOFFICE Docs.

Pour activer la connexion cochez la case Se connecter à la version démo de ONLYOFFICE Docs et cliquez sur le bouton Enregistrer.

C'est un serveur d'essai publique qui sera disponible pendant 30 jours. Ne partagez pas vos données sensibles.

Commencer à utiliser ONLYOFFICE Docs au sein de Jira

Créer, 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 qui existe, placez le pointeur de la souris sur le fichier nécessaire et cliquez sur l'icône ONLYOFFICE_connector Modifier dans ONLYOFFICE. Lorsque le format de fichier n'est pas pris en charge pour modification, l'option Afficher dans ONLYOFFICE est disponible. Pour les fichiers .oform l'option Remplir le formulaire dans ONLYOFFICE est disponible.

ONLYOFFICE_connector ONLYOFFICE_connector

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

Afin de créer un nouveau fichier en utilisant les éditeurs ONLYOFFICE :

  1. Dans la section Pièces jointes d'une tâche cliquez sur l'option Créer un fichier avec ONLYOFFICE.
  2. Choisissez le type approprié de fichier : Document, Feuille de calcul, Présentation ou Modèle de formulaire.
  3. Saisissez le nom du fichier et cliquez sur Créer.
    Create file create
  4. 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.

Convertir des documents

Pour convertir un document au format Office Open XML :

  1. Déplacez le pointeur de la souris sur le fichier nécessaire et cliquez sur l'icône ONLYOFFICE_connector Service de conversion ONLYOFFICE.
    Convert Convert
  2. Vous pouvez éventuellement modifier le nom du fichier.
  3. Cliquez sur le bouton Convertir.
  4. Le fichier converti sera stocké dans la section Pièces jointes.
    Convert Convert

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.

ONLYOFFICE_connector ONLYOFFICE_connector

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.

Télécharger des fichiers

Afin de télécharger un document dans un format différent :

  1. Déplacez le pointeur de la souris sur le fichier nécessaire et cliquez sur l'icône ONLYOFFICE_connector Service de conversion ONLYOFFICE.
    Download Download
  2. Vous pouvez éventuellement modifier le nom du fichier.
  3. Sélectionnez le format nécessaire dans la liste Type cible.
  4. Cliquez sur le bouton Télécharger.
  5. Le fichier téléchargé sera stocké 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 :
Fermer