Articles avec le tag :
Parcourir tous les tags
Fermer
Changelog
Fermer
Essayer dans le cloud
Essayer dans le cloud
Centre d'aide
l'intégration
Search

À propos de l'intégration ONLYOFFICE et Jira

ONLYOFFICE propose un connecteur officiel pour intégrer ONLYOFFICE Docs dans Jira Software pour collaborer sur des documents joints aux tickets de Jira. Le connecteur est disponible en téléchargement sur Atlassian Marketplace ou sur GitHub. L'application est rendu accessible sous la Licence Apache.

Pour en savoir plus sur le fonctionnement du connecteur, veuillez consulter notre documentation API .

Principales caractéristiques

  • Créer de nouveaux documents, des feuilles de calcul, des présentations et des formulaires.
  • Afficher et modifier des documents texte, des feuilles de calcul, des présentations et des formulaires à l'aide de l'option Edit in ONLYOFFICE (Modifier dans ONLYOFFICE).
    Pour en savoir plus sur formulaires, veuillez consulter les guides appropriés de création et remplissage de formulaires.
  • 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

  • À créer, modifier et afficher: DOCX, PPTX, XLSX, DOCXF.
  • À remplir des formulaires: OFORM.
  • Lecture seule: 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 ONLYOFFICE Docs pouvant être résolue et connectée par Jira et tout autre client final. L'instance doit envoyer des données en POST directement vers Jira.

    Veuillez consulter la documentation officielle ONLYOFFICE Docs pour en savoir plus sur l'installation d'ONLYOFFICE Docs.

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

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

    Veuillez consulter la documentation officielle Atlassian pour en savoir plus sur l'installation d'ONLYOFFICE Docs.

  • Connecteur ONLYOFFICE v2.1.0 ou la version plus récente pour Jira

Installer le connecteur ONLYOFFICE pour Jira

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

Ajouter le connecteur à partir de Atlassian Marketplace
  1. Connectez-vous à votre instance Jira en tant qu'administrateur.
  2. Cliquez sur l'icône Administration ONLYOFFICE_connector dans le coin supérieur droite et choisissez l'option Manage apps (Gérer les applications) du menu:
    ONLYOFFICE_connector ONLYOFFICE_connector
  3. Le panneau Find new apps (Rechercher de nouvelles applications) s'affiche. Cliquez sur le champ Search the Marketplace (Rechercher sur Marketplace) et saisissez Jira ONLYOFFICE integration app (Application d'intégration Jira ONLYOFFICE).
  4. Cliquez sur le bouton Install (Installer) pour télécharger et installer l'application.
Ajouter le connecteur compilé à partir du code source

Premièrement, il vous faut installer les éléments prérequis afin de pouvoir compiler le connecteur ONLYOFFICE pour Jira:

Pour compiler le connecteur ONLYOFFICE pour Jira, procédez comme suit:

  1. Clonez le référentiel onlyoffice-jira: 
    git clone https://github.com/ONLYOFFICE/onlyoffice-jira.git
  2. Accédez au répertoire onlyoffice-jira: 
    cd onlyoffice-jira
  3. Exécutez la commande suivante: 
    atlas-package

    Attendez que la compilation du connecteur soit terminé. Une fois compilé, le connecteur est enregistré dans le dossier target.

Vous pouvez télécharger le connecteur compilé sur votre page Jira Software Administration -> Manage Apps (Administration du logiciel Jira -> Gestion des applications).

  1. Connectez-vous à votre instance Jira en tant qu'administrateur.
  2. Cliquez sur l'icône Administration ONLYOFFICE_connector dans le coin supérieur droite et choisissez l'option Manage apps (Gérer les applications) du menu:
  3. Sélectionnez la rubrique Manage apps (Gérer les applications) à gauche de la page.
  4. Cliquez sur Upload app (Télécharger l'application).
  5. Cliquez sur le bouton Choose File (Choisir un fichier), parcourez pour rechercher le fichier compilé target/onlyoffice-jira-app.jar et cliquez Upload (Télécharger). Attendez que l'installation de l'application soit terminée.
    ONLYOFFICE_connector ONLYOFFICE_connector

Configurer le connecteur ONLYOFFICE pour Jira

Cliquez sur le bouton Configure (Configurer) au-dessous de Jira ONLYOFFICE integration app (Application d'intégration Jira ONLYOFFICE) sur la page Manage apps (Gérer les applications) ou recherchez l'application sous la rubrique OTHER (AUTRE) sur la page Manage apps (Gérer les applications).

ONLYOFFICE_connector ONLYOFFICE_connector

Dans le champ Document Editing Service address (Adresse du service de modification des documents), indiquez l'adresse IP ou le nom d'hôte du serveur sur lequel ONLYOFFICE Docs est installé.

ImportantL'adresse d'ONLYOFFICE Docs doit être accessible sur Jira et l'adresse de Jira doit être accessible sur ONLYOFFICE Docs.
ONLYOFFICE_connector ONLYOFFICE_connector

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 à Jira d'établir une connexion avec ONLYOFFICE Docs (sinon, Jira 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.

Indiquez Secret key (Clé secrète) - la clé secrète pour valider le jeton JSON dans la 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 également activer la validation du jeton du côté Jira: 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 Jira.

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 le logiciel Jira et ONLYOFFICE Docs utilisant des adresses publiques. Dans ce cas-là, indiquez les adresses pour des demandes internes dans les champs appropriés:

  • L'adresse du serveur Jira Software pour les demandes internes d'ONLYOFFICE Docs.
  • Les adresses d'ONLYOFFICE Docs pour les demandes internes du serveur Jira Software.

Cliquez sur Save (Enregistrer) pour valider la configuration.

Activer le jeton JWT pour l'intégration ONLYOFFICE et Jira

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

  1. 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"
        }
      }
    }
  }
}
  2. 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
  3. 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
  4. 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 Jira sans installer ONLYOFFICE Docs.

Pour activer la connexion, activez l'option Connect to demo ONLYOFFICE Document Server (Connecter à la version démo du service de documents ONLYOFFICE) et cliquez sur le bouton Save (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 Jira

Créer, afficher et modifier des fichiers

Les éditeurs ONLYOFFICE sont accessibles sous la rubrique Attachments (Pièces jointes) dans un ticket. Cette option est disponible pour des tickets de tout module dans lequel on peut créer un ticket, par ex.: la liste des tickets, backlog, tickets etc.

La gestion de pièces jointes doit être activé par l'administrateur.

On peut joindre une pièce sur la page du ticket utilisant l'option More -> Attach files (Plus -> Joindre un fichier). Pour en savoir plus, veuillez consulter la documentation oficielle.

Pour ouvrir un document texte, une feuille de calcul, une présentation ou un formulaire, faites glisser le pointeur de la souris sur le fichier nécessaire et cliquez sur l'icône ONLYOFFICE_connector Edit in ONLYOFFICE (Modifier dans ONLYOFFICE). Lorsque la modification d'un format de fichier n'est pas pris en charge, utilisez l'option View in ONLYOFFICE (Afficher l'aperçu dans ONLYOFFICE). Pour des fichiers au format .oform, l'option Fill in form in ONLYOFFICE (Remplir un fichier dans ONLYOFFICE) est disponible.

ONLYOFFICE_connector ONLYOFFICE_connector

Le fichier s'ouvrira dans un nouvel onglet du navigateur dans l'éditeur ONLYOFFICE.

Pour créer un nouveau fichier à l'aide de l'éditeur ONLYOFFICE:

  1. Sous la rubrique Attachments (Pièces jointes) d'un ticket, cliquez sur Create file with ONLYOFFICE (Créer un fichier dans ONLYOFFICE).
  2. Choisissez le type de fichier approprié: Document, Feuille de calcul, Présentation ou Modèle de formulaire.
  3. Saisissez le nom du fichier et cliquez sur Create (Créer).
    Créer un fichier créer
  4. Le fichier s'ouvrira dans un nouvel onglet du navigateur dans l'éditeur ONLYOFFICE.

Permissions d'accès

Permissions d'accès aux fichiers dépendent des droits d'accès au ticket.

Modifier des fichiers. Pour modifier des fichiers, un utilisateur doit avoir la permission de créer une pièce jointe (Créer des pièces jointes).

Afficher l'aperçu des fichiers. L'aperçu de fichiers est disponible dans les Visionneuses ONLYOFFICE pour tous les utilisateurs qui peuvent afficher le ticket mais n'ont pas la permission de modifier le ticket ou de créer des pièces jointes. Lorsque la modification d'un format de fichier n'est pas pris en charge, le fichier s'affichera en lecture seule.

Convertir des documents

Pour convertir un document au format Office Open XML:

  1. Faites glisser le pointeur de la souris sur le fichier nécessaire et cliquez sur l'icône ONLYOFFICE_connector ONLYOFFICE conversion service (Service de conversion ONLYOFFICE).
    Convertir Convertir
  2. Vous pouvez également modifier le nom du fichier.
  3. Cliquez sur Convert (Convertir).
  4. Une fois converti, le fichier sera stocké dans la section Attachments (Pièces jointes).
    Convertir Convertir

Enregistrer des modifications

Les modifications apportées au fichier sont enregistrées en tant que fichier original avec un même nom et l'extension de fichier, par ex. Sample-1.docx.

ONLYOFFICE_connector ONLYOFFICE_connector

Les modifications apportées au document pendant la session de coédition sont enregistrées uniquement dans la première version du fichier. Lorsqu'un document est en cour de modification par plusieurs utilisateurs à la fois, le modifications s'affichent uniquement dans le premier fichier. Ce n'est qu'après le dernier utilisateur a fermé l'éditeur, que la nouvelle version du fichier est ajouté au ticket.

Télécharger des fichiers

Pour télécharger le fichier dans un autre format:

  1. Faites glisser le pointeur de la souris sur le fichier nécessaire et cliquez sur l'icône ONLYOFFICE_connector ONLYOFFICE conversion service (Service de conversion ONLYOFFICE).
    Télécharger Télécharger
  2. Vous pouvez également modifier le nom du fichier.
  3. Sélectionnez le format approprié dans la liste Target type (Type de cible).
  4. Cliquez sur le bouton Download (Télécharger).
  5. Le fichier sera sauvegardé 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