Confluence

À propos de l'intégration ONLYOFFICE et Confluence

ONLYOFFICE propose un connecteur officiel pour intégrer ONLYOFFICE Docs dans Confluence et modifier les documents de la bibliothèque. Vous pouvez installer le connecteur ONLYOFFICE à partir de Atlassian Marketplace ou téléchargez sur GitHub. Notre référentiel sur GitHub comprend les connecteurs pour Confluence et Confluence Cloud. L'application est rendu accessible sous la Licence Apache.

Pour en savoir plus sur le fonctionnement et la compilation du connecteur ONLYOFFICE pour Confluence, veuillez consulter notre documentation API .
Principales caractéristiques
  • Créer des documents texte, des classeurs et des présentations en utilisant option New document (Nouveau document).
  • Créer et remplir des formulaires en ligne.
  • Modifier et afficher des documents en utilisant l'option Modifier avec ONLYOFFICE.
    Confluence Cloud prend en charge le chargement et la modification de fichiers.
  • 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: DOCX, XLSX, PPTX, formulaires PDF
  • À modifier et afficher: DOCM, DOCX, PDF forms, DOTM, DOTX, HTM, POTM, POTX, PPSM, PPSX, PPTM, PPTX, XLSM, XLSX, XLTM, XLTX, XML
  • À modifier à risque de perte de données: CSV, EPUB, FB2, HTML, ODP, ODS, ODT, OTP, OTS, OTT, RTF, TXT
  • À convertir en Office Open XML: DOC, DOCM, PDF forms, DOT, DOTM, DOTX, EPUB, FB2, FODP, FODS, FODT, HTM, HTML, MHT, ODP, ODS, ODT, OTP, OTS, OTT, OXPS, PDF, POT, POTM, POTX, PPS, PPSM, PPSX, PPT, PPTM, RTF, XLS, XLSM, XLT, XLTM, XLTX, XML, XPS
    Confluence Cloud ne prend pas en charge la conversion. Tous ces formats sont pris en charge en lecture seule.
  • En lecture seule: CSV, DJVU, DOC, DOCM, DOCX, DOT, DOTM, DOTX, EPUB, FB2, FODP, FODS, FODT, HTM, HTML, MHT, ODP, ODS, ODT, OTP, OTS, OTT, OXPS, PDF, POT, POTM, POTX, PPS, PPSM, PPSX, PPT, PPTM, PPTX, RTF, TXT, XLS, XLSM, XLSX, XLT, XLTM, XLTX, XML, XPS
Connecteur pour Confluence: quoi de neuf dans la version 6.1.0

Nouvelles fonctionnalités ajoutées

  • Compatibilité avec Confluence 9.*

Fonctionnalités modifiées

  • La sauvegarde forcée n'est plus pris en charge.
  • La mise en surbrillance de l'historique n'est plus pris en charge.

Le journal des modifications complet est disponible ici.

Connecteur pour Confluence: quoi de neuf dans la version 1.2.0

Nouvelles fonctionnalités ajoutées

  • Créer un nouveau document
  • Ajouter l"image d'utilisateur à l'éditeur
  • Modifier un fichier PDF
  • La fonctionnalité Collage spécial pour ajouter un lien entre fichiers

Fonctionnalités modifiées

  • La liste des formats pris en charge est allongée.

Le journal des modifications complet est disponible ici.

Connecter ONLYOFFICE Docs à Confluence

Exigences
  • ONLYOFFICE Document Server v7.0 (version serveur ou cloud) ou version ultérieure

    Vous avez besoin d'une instance ONLYOFFICE Docs pouvant être résolue et connectée par Confluence et tout autre client final. L'instance doit envoyer des données en POST directement vers Confluence.

    Veuillez consulter la documentation officielle pour en savoir plus sur l'installation d'ONLYOFFICE Docs.
  • Confluence Data Center 7.12.0 - 8.6.0 or Confluence Server 7.12.0 - 8.6.0
  • Connecteur ONLYOFFICE pour Confluence
Installer le connecteur ONLYOFFICE pour Confluence à partir de Atlassian Marketplace

Vous pouvez télécharger le connecteur le plus récent sur Atlassian Marketplace. Pour ce faire, suivez ces simples étapes:

  1. Connectez-vous à votre instance Confluence en tant qu'administrateur.
  2. Cliquer sur la liste déroulante d'administration et sélectionnez Manage apps (Gérer les applications). L'écran Manage apps (Gérer les applications) s'affiche.
  3. Cliquez sur Find new apps (Rechercher de nouvelles applications) ou Find new add-ons (rechercher de nouvelles extensions) sur le panneau gauche de la page.
  4. Utilisez la fonction de recherche pour trouver ONLYOFFICE Connector for Confluence (Connecteur ONLYOFFICE pour Confluence). Les résultats de la recherche incluent les versions d'extensions compatibles avec votre instance Confluence.
    ONLYOFFICE_confluence_install ONLYOFFICE_confluence_install
  5. Cliquez sur Install (Installer) pour télécharger et installer votre application.
  6. Maintenant, vous pouvez cliquez sur Close (Fermer) dans la boîte de dialogue Installed and ready to go (Installé et prêt à l'emploi).

Ou vous pouvez télécharger le paquet compilé target/onlyoffice-confluence-plugin.jar vers Confluence sur la page Manage add-ons (Gérer les extensions).

Les paquets compilés les plus récents sont disponibles ici et sur Atlassian Marketplace.

Compiler l'application d'intégration Confluence ONLYOFFICE

Lorsque vous allez compiler vous-même l'application d'intégration ONLYOFFICE et Confluence (par ex.: modifier le code source et le compiler ensuite), veuillez suivre les instructions ci-après:

  1. Pour créer un build réussi, vous avez besoin de la dernière version stable de Java. Si vous ne parvenez pas à installer une telle version, utilisez les commandes suivantes pour installer Open JDK 8:
    sudo apt-get update sudo apt-get install openjdk-8-jdk
  2. Installez le module complémentaire Atlassian SDK. La description de l'installation est disponible ici.
  3. Obtenez le sous-module:
    git submodule update --init --recursive
  4. Compilez le paquet:
    atlas-package
Configurer le connecteur ONLYOFFICE pour Confluence

Passez à Confluence administration -> Manage apps -> ONLYOFFICE Connector for Confluence -> Configure (Administration Confluence -> Gérer des applications -> Connecteur ONLYOFFICE pour Confluence -> Configurer):

  • Document Server (Serveur de documents) - indiquez l'adresse URL où ONLYOFFICE Docs est installé (par ex. https://documentserver).
    ImportantL'adresse d'ONLYOFFICE Docs doit être accessible sur Confluence et l'adresse de Confluence doit être accessible sur ONLYOFFICE Docs.
  • Secret key (Clé secrète) - indiquez la clé secrète JWT utilisée pour signer les 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é Confluence: 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 Confluence.

Paramètres avancés du serveur:

  • Server address for internal requests from the Document Editing Service (Adresse du serveur pour les demandes internes du Service d'édition de documents) - adresse utilisée pour accéder au serveur Confluence à partir du Service d'édition de documents.
  • Document Editing Service address for internal requests from the server (Adresse du service de modification des documents pour les demandes internes du serveur) - l'adresse utilisée pour accéder au Service d'édition de documents par le serveur Confluence.
    Confluence Cloud ne prend pas en charge la configuration des paramètres avancés.
ONLYOFFICE_confluence_configure ONLYOFFICE_confluence_configure
Comment cela fonctionne

L'intégration ONLYOFFICE suit l'API disponible ici.

  1. L'utilisateur doit passer à Confluence attachments (Pièces jointes Confluence) et sélectionner l'action Edit in ONLYOFFICE (Modifier dans ONLYOFFICE).
  2. Confluence envoie une requête vers OnlyOfficeEditorServlet (URL du formulaire: /plugins/servlet/onlyoffice/doceditor?attachmentId=$attachment.id).
  3. Confluence envoie le document vers le stockage de documents ONLYOFFICE et reçoit un lien temporaire.
  4. Confluence prépare un objet JSON ayant les caractéristiques suivantes:
    • url - le lien temporaire utilisé par ONLYOFFICE Docs pour télécharger le document;
    • callbackUrl - l'adresse URL utilisée par ONLYOFFICE Docs pour informer sur l'état de l'édition du document;
    • docserviceApiUrl - l'adresse URL envoyée par le client à ONLYOFFICE Docs (fourni par iles.docservice.url.api );
    • key - UUID à informer ONLYOFFICE Docs s'il faut télécharger le document encore une fois;
    • title - le titre de document (nom).
  5. Confluence utilise cet objet pour générer une page à partir d'un modèle Freemarker et remplit toutes les valeurs pour que le navigateur du client puisse télécharger l'éditeur.
  6. Le navigateur du client envoie une demande vers la bibliothèque JavaScript depuis ONLYOFFICE Docs et la configuration DocEditor vers ONLYOFFICE Docs avec les caractéristiques ci-dessous.
  7. Ensuite, ONLYOFFICE Docs charge le document depuis Confluence et l'utilisateur commence la rédaction.
  8. Lorsque tous les utilisateurs et navigateurs clients ont terminé la rédaction, la fenêtre d'édition est fermée.
  9. Après 10 secondes d'inactivité, ONLYOFFICE Docs envoie une requête POST vers callbackUrl pour notifier Confluence que tous les clients ont terminé l'édition et ont fermé le document.
  10. Confluence télécharge la nouvelle version du document qui remplace la version ancienne.
Activer le jeton JWT pour l'intégration ONLYOFFICE et Confluence

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
Confluence Cloud ne prend pas en charge la connexion au serveur démo.

Si vous souhaitez essayer les éditeurs en ligne ONLYOFFICE au sein de Confluence sans installer ONLYOFFICE Docs:

  1. Passez à Confluence administration -> Manage apps -> ONLYOFFICE Connector for Confluence -> Configure (Administration Confluence -> Gérer des applications -> Connecteur ONLYOFFICE pour Confluence -> Configurer):
  2. Activez l'option Connect to demo ONLYOFFICE Document Server (Connecter au serveur de documents démo ONLYOFFICE).
  3. Cliquez sur le bouton Save (Enregistrer).
ImportantC'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 Confluence

Pour créer un fichier:

  1. Ouvrez la page où vous souhaitez créer un fichier.
  2. Cliquez sur le bouton New document (Nouveau document).
  3. Choisissez le type de fichier approprié.
  4. Saisissez le nom du fichier dans le champ à côté de l'icône représentant le type de fichier.
  5. Cliquez sur le bouton Save (Enregistrer) Icône Confluence enregistrer objet. .

Le fichier sera ouvert avec l'éditeur ONLYOFFICE Docs.

ONLYOFFICE_confluence_newfile ONLYOFFICE_confluence_newfile

Pour créer un aperçu du fichier:

  1. Ouvrir toute page Confluence pour édition.
  2. Cliquez sur Insert more content (Insérer du contenu)
  3. Sélectionnez l'option Other macros (Autres macros).
  4. Sélectionnez l'option ONLYOFFICE Preview (Aperçu ONLYOFFICE).
  5. Sélectionnez le fichier nécessaire sur la page Attachments (Pièces jointes).
  6. Configurez la largeur et la hauteur de l'aperçu du fichier, le cas échéant.
  7. Cliquez sur le bouton Insert (Insérer).
ONLYOFFICE_confluence_previewfile ONLYOFFICE_confluence_previewfile

Pour télécharger un fichier:

  1. Ouvrez le menu contextuel du fichier en cliquant sur la flèche à gauche du nom de fichier.
  2. Cliquez sur le bouton Download as (Télécharger comme). La fenêtre Download as with ONLYOFFICE (Télécharger en tant que avec ONLYOFFICE) s'affichera.
  3. Modifiez le nom du fichier dans le champ approprié, le cas échéant.
  4. Ouvrez le menu déroulant Target type (Type de cible) et sélectionnez le format nécessaire.
  5. Cliquez sur le bouton Download (Télécharger).
ONLYOFFICE_confluence_downloadfile ONLYOFFICE_confluence_downloadfile

Pour modifier ou afficher un document:

  1. Trouvez le fichier nécessaire.
  2. Cliquer sur le bouton Edit in ONLYOFFICE (Modifier dans ONLYOFFICE).

Le document sera ouvert avec l'éditeur ONLYOFFICE Docs.

Pour collaborer sur un document, les utilisateurs autorisés doivent ouvrir le même fichier à la fois.

ONLYOFFICE_confluence_editfile ONLYOFFICE_confluence_editfile

Pour créer un formulaire:

  1. Ouvrez la page où vous souhaitez créer un fichier.
  2. Cliquez sur le bouton New document (Nouveau document) et sélectionnez l'option Form (Formulaire).
    ONLYOFFICE_newform ONLYOFFICE_newform
  3. Saisissez le nom du fichier dans le champ à côté de l'icône représentant le type de fichier.
  4. Sélectionnez le fichier .docx joint à cette page ou à d'autres pages ou sélectionnez l'option Create from blank (Créer à partir de zéro).
  5. Le formulaire sera ouvert avec l'éditeur ONLYOFFICE Docs.
  6. Sauvegardez le formulaire résultant au format PDF pour pouvoir éditer, réviser ou travailler à plusieurs ultérieurement.

Pour créer un formulaire à remplir et restreindre la modification du formulaire par d'autres utilisateurs:

  1. Passez à Attachments (Pièces jointes).
  2. Cliquez sur Create form using ONLYOFFICE (Créer formulaire à l'aide d'ONLYOFFICE) à droite du fichier PDF. Le fichier sera créé dans la section Attachments (Pièces jointes).
    ONLYOFFICE_createform ONLYOFFICE_createform

Pour remplir un formulaire:

  1. Passez à Attachments (Pièces jointes).
  2. Cliquez sur Fill form in ONLYOFFICE (Remplir formulaire dans ONLYOFFICE) à droite du fichier PDF.
    ONLYOFFICE_fillform ONLYOFFICE_fillform
  3. Le formulaire sera ouvert avec l'éditeur ONLYOFFICE Docs.
Pour en savoir plus sur formulaires, veuillez consulter les guides appropriés de création et remplissage de formulaires.

Hébergez ONLYOFFICE Docs sur votre serveur ou utilisez dans le cloud

Articles avec le tag :
Parcourir tous les tags