I. Introduction▲
Les applications de bureau ONLYOFFICE, dont le code source est disponible sur GitHub sous les termes de la licence AGPL v.3., permettent de travailler pleinement sur les documents en mode hors connexion ou de passer en mode en ligne en vous connectant au cloud (le cloud ONLYOFFICE, Nextcloud, ownCloud, Seafile) pour coéditer en temps réel les documents qui y sont stockés.
Pour de plus amples informations sur les options d’installation et les aspects fonctionnels de la suite, consultez cet article.
À partir de la dernière version, dont les nouveautés sont présentées ici, vous êtes capable non seulement d’accéder aux documents stockés dans les services nommés ci-dessus, mais aussi de connecter votre solution de GED afin de commencer l’édition ou la rédaction collaborative avec vos collègues.
Pour relier les éditeurs de bureau avec votre propre service web afin d’éditer les fichiers en ligne ou même lancer la rédaction collaborative, suivez les étapes de ce tutoriel.
II. Créer le dossier de la GED▲
Créez le dossier en indiquant le fournisseur de solution de GED en tant que nom dans le répertoire des fournisseurs (par exemple : onlyoffice). Le chemin vers le dossier dépend de votre système d’exploitation :
Pour Linux : - /opt/onlyoffice/desktopeditors/editors/providers/
Pour Windows : - %ProgramFiles%\ONLYOFFICE\DesktopEditors\providers\
III. Spécifier les paramètres de l’intégration▲
Créez le fichier de configuration config.json pour spécifier les paramètres de l’intégration qui sont listés ci-dessous :
Nom |
Rôle |
Type |
Exemple |
---|---|---|---|
Provider |
Définit l’ID du fournisseur qui est utilisé pour se référer aux applications de bureau dans les commandes JavaScript. |
string |
« onlyoffice » |
name |
Définit le nom affiché dans la section du choix de service GED lors de l’ajout d’un cloud. |
string |
« ONLYOFFICE » |
check |
Définit les paramètres pour vérifier la disponibilité du portail. Lorsque la requête GET est envoyée, la réponse suivante doit s’afficher : HTTP_STATUS_CODE = 200
|
object |
|
editorPage |
Définit l’URL relative qui indique le type du fichier qui s’ouvre en tant qu’un document. |
string |
« /apps/onlyoffice/ » |
startPage |
Définit l’URL relative ajoutée à l’adresse IP ou au domaine lors de la création d’une nouvelle connexion. |
string |
« / » |
icons |
Définit les icônes pour les portails :
type : string,
|
object |
Voici l’exemple de code que vous pouvez utiliser pour relier les éditeurs de bureau avec votre logiciel de GED :
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
{
"provider"
:
"nextcloud"
,
"name"
:
"Nextcloud"
,
"check"
:
{
"url"
:
"status.php"
,
"headers"
:
{
"OCS-APIREQUEST"
:
true
}
},
"editorPage"
:
"/apps/onlyoffice/"
,
"startPage"
:
"/"
,
"cryptoSupport"
:
true,
"icons"
:
{
"connectionsList"
:
"./assets/listicon.svg"
,
"buttonLogo"
:
"./assets/buttonlogo.svg"
}
}
IV. Ajouter des icônes▲
Créez deux icônes pour la page de l’application et ajoutez-les dans le dossier dédié du fichier de configuration config.json :
-
une icône pour la liste des connexions disponibles. La taille requise est 36 sur 36 :
- une icône pour le bouton du fournisseur de service pour la page de connexion si la liste des clouds connectés est vide. La taille requise est 148 sur 38 :
Les formats d’image supportés sont .png, .jpeg, .svg. Nous suggérons d’utiliser les fichiers .svg
pour assurer un affichage correct sur les écrans HiDPI avec la mise à l’échelle à 200 %.
V. Rendre la connexion opérationnelle▲
Lancez les applications de bureau ONLYOFFICE ou redémarrez-les si besoin et passez la section « Se connecter au cloud » afin de vérifier que la GED a été bien connectée et que tout fonctionne correctement.
En suivant cette démarche, vous allez ajouter un bouton de votre logiciel de GED dans la section
« Connecter au cloud » pour y accéder depuis l’interface des éditeurs de bureau ONLYOFFICE. Pour ouvrir les documents, les modifier ou lancer la collaboration, il vous faudra faire quelques ajustements dans votre GED.
VI. Remerciements Developpez.com▲
Nous tenons à remercier Malick pour la mise au gabarit et escartefigue pour la relecture orthographique.