ONLYOFFICE 10.0 pour développeurs : quoi de neuf

ONLYOFFICE 10.0 apporte un ensemble solide de mises à jour pour les développeurs qui créent des applications basées sur les éditeurs. Vous obtiendrez de nouveaux points de terminaison qui simplifient la gestion des fichiers, l’édition de PDF dans Document Builder, et une API de plugins modernisée avec des méthodes asynchrones. La version ajoute également de nouveaux contrôles pour les fonctionnalités d’IA et des paramètres par défaut plus sûrs sur le serveur.

Voici un bref aperçu des changements qui comptent le plus pour vos intégrations, ainsi que quelques modifications de comportement à vérifier avant de mettre jour.

Outils d’IA, options de personnalisation de l’IA et gestion de l’IA côté serveur

ONLYOFFICE Docs 10.0 apporte des outils d’IA à chaque éditeur. Plus que la simple génération de texte, ils comprennent la structure des documents, reconnaissent des éléments, relient le contenu à travers les sections et créent des références cliquables pour une navigation plus aisée. Vous pouvez connecter n’importe quel modèle d’IA, y compris des modèles locaux pour des cas d’utilisation sensibles à la vie privée, et attribuer différents modèles à différentes tâches.

Dans les éditions commerciales d’ONLYOFFICE Docs 10.0, les administrateurs peuvent configurer les fournisseurs d’IA une seule fois dans le panneau d’administration. Les utilisateurs obtiennent ainsi des outils d’IA prêts à l’emploi sans avoir à saisir leurs propres clés API. Les administrateurs peuvent assigner différents modèles à des tâches spécifiques, connecter des serveurs MCP pour un accès à des outils externes et contrôler si la recherche web est disponible. Une fois qu’une configuration côté serveur est sauvegardée, les utilisateurs sont limités aux fournisseurs et modèles approuvés – ils ne peuvent plus ajouter leurs propres clés ou changer quel modèle est utilisé. En savoir plus

Vous décidez si les outils d’IA apparaissent dans votre produit. La version 10.0 vous offre deux niveaux de contrôle :

• Par instance d’éditeur : utilisez editorConfig.customization.ai avec le paramètre disabled pour masquer les fonctionnalités d’IA dans une configuration d’éditeur spécifique.
• À l’échelle du serveur : utilisez le aiSettings.enable paramètre serveur pour désactiver les fonctionnalités d’IA et exclure les Outils d’IA de /plugins.json.

C’est pratique si vous servez différents niveaux de clients, ou si certaines déploiements doivent rester sans IA pour des raisons de conformité.

Applications modulaires

ONLYOFFICE Docs 10.0 introduit des applications modulaires – une nouvelle façon d’étendre les éditeurs sans modifier leur cœur. Des applications telles que Agents IA, Formulaires, Salles et Fichiers s’intègrent dans ONLYOFFICE Docs et ajoutent de nouvelles fonctionnalités.

Pour les développeurs, cela signifie que vous pouvez activer uniquement les capacités dont vos utilisateurs ont besoin, garder votre intégration légère, et étendre étape par étape à mesure que votre produit se développe.

Améliorations de la sécurité et de l’architecture

La version 10.0 déplace plusieurs protections en mode « activé par défaut », de sorte que les nouvelles intégrations commencent à partir d’une base plus sûre.

• JWT activé par défaut. JWT est activé dans default.json.
• Gestion des jetons plus stricte. Si un secret est vide ou non défini, y compris les secrets de locataire, ONLYOFFICE Docs rejette désormais le jeton au lieu de le vérifier ou de le signer.
• Jetons à portée pour les API de service. /converter, /docbuilder, et /command n’acceptent plus de jeton provenant de la configuration de l’éditeur. Un nouveau champ operation dans le jeton est optionnel pour ces requêtes et requis pour /converter/from-file et /docbuilder/from-file.
• Vérification de l’intégrité des fichiers téléchargés. Lorsque votre intégration envoie des en-têtes d’intégrité, le serveur vérifie les fichiers téléchargés par rapport à ceux-ci. Les en-têtes pris en charge incluent Content-Digest, Repr-Digest, x-amz-checksum-*, et WOPI SHA256. Cela est contrôlé par services.CoAuthoring.requestDefaults.checksumVerification, qui est true par défaut.
• Hôtes WOPI explicites. Les hôtes WOPI doivent être autorisés par une règle de filtre IP. La règle générique allow: * n’est plus suffisante, donc spécifiez chaque hôte explicitement.
• Contrôles d’accès à l’API. Utilisez services.CoAuthoring.server.convertServiceEnable et services.CoAuthoring.server.docbuilderEnable pour désactiver les API de conversion publiques et de Document Builder. Les deux sont true par défaut.
• Configuration d’exécution plus stricte. Seul le niveau de journalisation log4js peut être changé via runtime.json.

Un examen approfondi des dernières corrections de sécurité

Édition de PDF dans Document Builder

Document Builder peut éditer des PDF, ce qui ouvre la porte à de nombreux nouveaux scénarios d’automatisation :

• OpenFile gère les PDF de manière intelligente. Les formulaires PDF créés dans ONLYOFFICE s’ouvrent dans l’éditeur de documents. D’autres PDF s’ouvrent dans l’éditeur de PDF avec un accès complet à l’API PDF.
• PDF protégés par mot de passe. Le nouveau paramètre m_sPassword dans OpenFile vous permet d’ouvrir des fichiers protégés.
• Création de formulaires PDF. Appelez CreateFile avec le type pdf pour créer des formulaires PDF.

Côté serveur, les formulaires sauvegardés en tant que PDF régulier sont à présent signés lorsque les utilisateurs les soumettent. Cela vous donne une couche supplémentaire de confiance dans vos flux de travail de formulaires.

Alexander Trofimov, responsable de l’équipe de développement de l’éditeur chez ONLYOFFICE :

Avec ONLYOFFICE Docs 10.0, nous avons rendu les éditeurs encore plus sûrs pour vos intégrations. De plus, cette version apporte un support complet des PDF à Document Builder, afin que les développeurs et les utilisateurs finaux puissent créer, éditer et gérer des PDF directement depuis Builder sans avoir à se fier à des solutions de contournement ou des outils tiers.

Mises à jour de déploiement et d’administration

Faire fonctionner ONLYOFFICE Docs en production est également devenu plus facile :

• Panneau d’administration démarré avec le serveur. Dans les éditions commerciales, le panneau d’administration se lance automatiquement par défaut. Il inclut également des blocs pour voir le secret JWT et des boutons pour ouvrir et démarrer ou arrêter l’exemple de test.
• Création administrative CLI. Vous pouvez maintenant créer le premier administrateur via le CLI de l’hôte documentserver-admin, en utilisant create-admin et reset-admin-password. Cela remplace l’ancienne page web qui s’appuyait sur les journaux de démarrage.
• Récupération automatique des modifications non sauvegardées. Si le serveur s’arrête, les modifications non sauvegardées sont récupérées dans des « fichiers oubliés » automatiquement. Le script séparé changes2forgotten a été supprimé.
• Nouveau port par défaut. Les installations DEB et RPM utilisent désormais le port 8083 par défaut. Mettez à jour vos règles de proxy et de pare-feu si nécessaire.
• Surveillance plus efficace. La nouvelle métrique coauth.connections inclut des balises mode (édition, vue en direct, vue) et replica.
• Drapeau de mise à jour de bureau. Sur Windows, le drapeau de ligne de commande --prefer-alternate-url permet aux éditeurs de bureau de télécharger des mises à jour à partir d’une source alternative.
• Page d’accueil rafraîchie. La page d’accueil du serveur a un nouveau design.

Nouveau support de format de fichier

La version 10.0 ajoute deux mises à jour de format qui vous aident à gérer davantage de documents avec moins de travail personnalisé :

• Visualisation et conversion OFD. Vous pouvez ouvrir et convertir des fichiers ofd. Comme xps, ils s’ouvrent en mode lecture seule.
• Conversion en XLS. Vous pouvez convertir n’importe quel format de tableau en format classique xls. Ceci est utile lorsque vos utilisateurs ou partenaires dépendent encore de systèmes hérités.

Points de terminaison multipart pour le téléchargement direct de fichiers

Jusqu’à présent, les services de conversion et de Document Builder téléchargent des fichiers sources à partir d’une URL. Cela signifiait que vous deviez héberger le fichier quelque part où le serveur pouvait y accéder. La version 10.0 ajoute deux nouveaux points de terminaison qui suppriment cette étape :

• POST /converter/from-file
• POST /docbuilder/from-file

Les deux acceptent des données au format multipart/form-data. Vous pouvez envoyer un fichier ou un script directement dans la requête, de sorte que vous n’avez pas besoin de l’exposer via une URL temporaire.

C’est une option plus propre pour de nombreux flux de travail. Par exemple, un service backend peut convertir les téléversements des utilisateurs à la volée, ou exécuter un script de Document Builder sans d’abord mettre en scène des fichiers.

Exemple de requête : conversion de TXT en DOCX

curl -f -X POST "https://documentserver/converter/from-file" 
  -F 'params={"filetype":"txt","outputtype":"docx","title":"Titre du Document Exemple.txt"}' 
  -F 'file=@example.txt' 
  -o "Titre du Document Exemple.docx"

Modernisation de l’API de plugins

L’API de plugins et de macros a bénéficié de son plus grand rafraîchissement depuis un certain temps.

Un nouvel objet Editor global

Les méthodes sont maintenant appelées comme des fonctions régulières qui retournent une promesse. Au lieu de router chaque appel via window.Asc.plugin.executeMethod, vous pouvez écrire un code asynchrone propre :

const text = await Editor.GetSelectedText();

Le résultat est un code plus court et plus lisible qui s’intègre naturellement dans des projets JavaScript modernes.

Nouvelles méthodes et événements

La version 10.0 ajoute également de nouveaux outils pour construire des plugins plus riches :

• Méthodes : Editor.RunMacro, GetRestrictions, SetButtonDisabled, GetOFormRole
• Événements : onFloatActionButtonClick, onSelectionEnd, onSelectionCancel

Par exemple, les événements de sélection permettent à votre plugin de réagir au moment où un utilisateur termine ou annule une sélection.

La liste complète des modifications pour l’API des plugins

Commencez à développer avec ONLYOFFICE 10.0

La version 10.0 vous offre des API plus propres, plus de puissance d’automatisation et des paramètres par défaut plus sûrs. Voici un plan rapide pour en tirer le meilleur parti :

• Examinez les changements de comportement. Vérifiez l’utilisation des jetons, les règles de filtre IP WOPI, et le nouveau port par défaut.
• Mettez à jour vos plugins. Passez à l’objet global Editor et remplacez les méthodes renommées ou supprimées.
• Essayez les nouveaux points de terminaison. Testez /converter/from-file et /docbuilder/from-file dans vos flux de travail de conversion.
• Décidez pour l’IA. Configurez editorConfig.customization.ai ou aiSettings.enable pour correspondre aux besoins de votre produit.

TÉLÉCHARGER LES VERSIONS POUR DÉVELOPPEURS

Vous construisez avec la version cloud d’ONLYOFFICE Docs ?  Essayez Docs Connect pour une manière plus simple de connecter les éditeurs avec des plateformes et services externes. Contrairement à la version auto-hébergée d’ONLYOFFICE Docs, qui nécessite de déployer et de maintenir les éditeurs sur vos propres serveurs, Docs Connect gère l’hébergement, la maintenance, et les mises à jour régulières pour vous.

Consultez le changelog complet pour chaque détail, et partagez vos retours sur le forum communautaire ONLYOFFICE. Nous avons hâte de voir ce que vous créez !