Office Editor
|
Version 1.0.2 Dolibarr V20 à V24 PHP 7.4 à 8.5 Télécharger sur DoliStore |
Présentation
Éditeur bureautique (Office Editor) modifie les documents de Dolibarr ERP CRM avec le vrai LibreOffice, exécuté dans votre navigateur : vous ouvrez le document, vous le modifiez et vous l'enregistrez, sans quitter Dolibarr.
Fonctionnalités
Modifiez des documents bureautiques en ligne, avec le vrai LibreOffice (Writer, Calc, Impress, Draw) exécuté dans votre navigateur (WebAssembly). Cela fonctionne sur :
- les documents joints à n'importe quel objet (onglets "Fichiers joints"),
- les documents générés par Dolibarr (propositions, commandes, factures...),
- les documents de l'espace GED (Documents),
- les modèles de documents ODT et ODS (administrateurs uniquement).
Formats pris en charge, chacun enregistré dans son propre format :
| Format | Extensions |
|---|---|
| OpenDocument | .odt (texte), .ods (classeur), .odp (présentation), .odg (dessin) |
| Microsoft Office (Office Open XML) | .docx, .xlsx, .pptx |
Les formats Microsoft sont ouverts et enregistrés par les filtres d'import et d'export de LibreOffice : l'éditeur affiche l'avertissement « Format Microsoft : la mise en page peut changer légèrement à l'enregistrement. » Gardez une copie des fichiers importants, ou travaillez en OpenDocument quand c'est possible. Les anciens formats binaires (.doc, .xls, .ppt) ne sont pas pris en charge.
Aucun service externe n'est utilisé et rien n'est à installer sur le serveur : le moteur d'édition est fourni dans le module.
Prérequis
| Élément | Prérequis |
|---|---|
| Dolibarr | 20 ou supérieur |
| PHP | 7.4 ou supérieur, avec l'extension zip |
| Connexion | HTTPS (ou localhost) : la page de l'éditeur nécessite l'isolation cross-origin |
| Navigateur | Un navigateur de bureau récent (Chrome, Edge, Firefox) avec assez de mémoire. Les mobiles ne sont pas pris en charge. |
| Réseau | La première ouverture télécharge le moteur (environ 57,8 Mo compressés), puis le cache du navigateur est utilisé |
Installation et droits
- Déployez le fichier zip du module dans le répertoire custom de Dolibarr.
- Allez dans Accueil - Configuration - Modules et activez "Éditeur bureautique" (nom technique odteditor).
- Donnez le droit "Utiliser l'éditeur bureautique" aux utilisateurs concernés.
Les utilisateurs doivent aussi avoir le droit d'écriture sur le domaine du document qu'ils modifient (par exemple le droit de modifier les propositions pour éditer un document de proposition) et l'accès à l'objet auquel le document appartient. Les domaines ouverts aux non-administrateurs sont : propositions, commandes, factures, propositions fournisseurs, commandes fournisseurs, factures fournisseurs, tiers, contacts, projets, interventions, contrats, expéditions, produits et services, adhérents, tickets, et la GED (droit « envoyer »). Les documents des autres domaines et les modèles de documents ne sont modifiables que par les administrateurs. Les utilisateurs externes ne peuvent pas utiliser l'éditeur.
Utilisation
- Une icône crayon apparaît à côté des fichiers d'un format pris en charge dans les onglets "Fichiers joints", dans le bloc des documents générés des fiches et dans les listes de la GED. Cliquez dessus pour ouvrir l'éditeur.
- L'éditeur s'ouvre dans un onglet plein écran avec les menus et barres d'outils de LibreOffice (Writer, Calc, Impress ou Draw selon le document). Une barre supérieure affiche le nom du fichier, les boutons Enregistrer (ou Ctrl+S), Télécharger ma version et Fermer, ainsi qu'un état ("Enregistré à HH:MM", "Modifications non enregistrées", messages de verrou).
- Tant qu'une personne modifie un document, les autres voient "En cours de modification par X depuis ..." et ne peuvent que le consulter. Après le délai du verrou sans activité (10 minutes par défaut), elles peuvent reprendre la main. Le premier éditeur reçoit alors un message, ne peut plus enregistrer, mais peut encore télécharger sa version pour conserver son travail.
- La page de configuration du module (Accueil - Configuration - Modules - Éditeur bureautique, icône clé) comporte trois onglets : Configuration, Modèles de documents (liste des modèles ODT et ODS, avec un lien de modification ; les ODS servent aux générateurs de tableurs de Dolibarr) et À propos.
- Dans l'onglet Configuration, le bouton "Tester le moteur" ouvre un document d'exemple en lecture seule pour vérifier que le moteur fonctionne dans votre navigateur. La version du moteur et sa date de compilation y sont aussi affichées.
Enregistrement
- L'enregistrement écrase le fichier sur place, dans le format du fichier : un DOCX reste un DOCX. Le serveur vérifie que la version enregistrée est un document valide de ce même format (OpenDocument : entrée mimetype et contenu ; Microsoft : types de contenu et partie principale).
- La taille du fichier enregistré est limitée par le paramètre ci-dessous, et aussi par les limites d'envoi du serveur (PHP upload_max_filesize et post_max_size, et le serveur web : client_max_body_size de nginx, 1 Mo par défaut, répond HTTP 413 au-delà ; LimitRequestBody d'Apache).
- Avec le module DoliTrashCan activé, la version précédente du fichier est envoyée à la corbeille.
- Quand un antivirus est configuré dans Dolibarr (Accueil - Configuration - Sécurité), la version enregistrée est d'abord analysée ; une version refusée laisse le document inchangé.
- L'entrée GED du fichier (lien de partage, description, mots-clés...) est conservée.
Paramètres
- Taille maximale d'un document enregistré (Mo) : 50 par défaut.
- Minutes sans activité avant qu'un verrou puisse être repris : 10 par défaut.
