Tour d’horizon des API pour les développeurs : ONLYOFFICE Docs 9.1 et DocSpace 3.5

Bienvenue dans le dernier tour d’horizon des API de l’écosystème ONLYOFFICE. Avec la sortie d’ONLYOFFICE Docs 9.1 et DocSpace 3.5, nous introduisons une multitude de nouvelles fonctionnalités et améliorations puissantes conçues pour offrir aux développeurs plus de contrôle, de flexibilité et d’efficacité.

Cet article vous présente les principales mises à jour, de la prise en charge de nouveaux formats et des options de personnalisation dans Docs aux améliorations significatives apportées au SDK pour DocSpace. Découvrons ensemble ce que ces nouvelles versions réservent à vos projets de développement.

Mises à jour dans ONLYOFFICE Docs 9.1

La version 9.1 d’ONLYOFFICE Docs apporte diverses améliorations à l’API.

Prise en charge et conversion de nouveaux formats

Afin d’élargir la compatibilité des documents, nous avons ajouté la prise en charge de nouveaux formats et étendu les capacités de conversion :

• ouverture de fichiers HML ;
• conversion de présentations PPTX au format TXT.

Personnalisation

Nous vous offrons davantage de contrôle sur l’apparence et la convivialité des éditeurs. Le paramètre editorConfig.customization.uitheme, qui définit le thème de l’éditeur, est désormais disponible pour les éditeurs mobiles. Cela vous permet de créer une expérience visuelle cohérente sur toutes les plateformes.

Nous avons également mis à jour les exigences en matière de taille pour editorConfig.customization.logo.image. Vous pouvez désormais utiliser une image de 300 x 20 pixels pour afficher votre logo personnalisé dans l’en-tête de l’éditeur.

const config = {  
   editorConfig: {    
     customization: {
      logo: {        
      image: "https://example.com/logo.png",
      ....
      uiTheme: "theme-dark", ...

Intégration WOPI

Pour ceux qui utilisent l’interface WOPI (Web Application Open Platform Interface), nous avons ajouté la propriété UserCanOnlyComment à l’opération CheckFileInfo. Cette propriété booléenne vous permet de spécifier si un utilisateur doit disposer uniquement de droits de commentaire, l’empêchant ainsi d’effectuer d’autres modifications.

De plus, nous avons amélioré la gestion des erreurs. Si un document ne peut pas être verrouillé via WOPI, il s’ouvrira désormais en mode visualisation avec un message d’erreur approprié, garantissant ainsi une expérience utilisateur plus fluide.

Nouvelle méthode pour les plugins

Nous avons étendu l’API pour les feuilles de calcul et les présentations avec la méthode RemoveOleObject (pour les feuilles de calcul / pour les diapositives). Cela vous permet de supprimer par programmation un objet OLE d’un classeur ou d’une présentation à l’aide de son ID interne, ce qui vous offre un meilleur contrôle sur le contenu intégré.

expression.RemoveOleObject(internalId);

API Office

La version 9.1 introduit un nombre important de nouvelles méthodes dans l’API JavaScript Office. Ces ajouts ouvrent de nouvelles possibilités puissantes pour la manipulation programmatique de documents, en particulier dans les feuilles de calcul. Les principaux domaines d’extension sont les suivants :

• Mise en forme conditionnelle : ensemble complet de méthodes permettant de gérer les règles de mise en forme conditionnelle, notamment les valeurs supérieures à la moyenne, les échelles de couleurs, les barres de données, les jeux d’icônes, les 10 premières valeurs et les valeurs uniques.
• Géométrie et chemins : nouvelles méthodes permettant de travailler avec la géométrie, les chemins et les commandes de chemin, pour un contrôle plus précis des formes et des dessins.
• XML personnalisé : méthodes permettant d’interagir avec des parties XML personnalisées dans les documents.
• Gestion des objets et des propriétés : nouvelles méthodes de conversion et nouveaux outils pour gérer les propriétés des documents.
• Contrôle avancé des objets : méthodes améliorées pour travailler avec des sections, des classeurs, des tableaux croisés dynamiques, des plages et des présentations.

Consultez la liste complète des nouvelles méthodes

SDK et exemples d’intégration mis à jour

Pour prendre en charge ces mises à jour, nous avons publié une version mise à jour du SDK Java compatible avec Docs 9.1. Elle inclut la prise en charge de la nouvelle conversion de présentation en TXT et la gestion du format HTML.

Nous avons également mis à jour nos exemples de test pour la connexion des éditeurs, y compris les exemples Node.js qui illustrent la prise en charge du format Docs v9.1. Découvrez-les sur GitHub

Mises à jour dans ONLYOFFICE DocSpace 3.5

DocSpace 3.5 introduit une série d’améliorations conçues pour donner plus de moyens aux développeurs, notamment des SDK améliorés et une API backend mise à jour.

SDK des plugins DocSpace 2.0.0

Le nouveau SDK des plugins introduit plusieurs changements importants visant à améliorer la sécurité et les fonctionnalités des boîtes de dialogue modales.

• Sécurité des fichiers améliorée : nous avons déplacé les paramètres de sécurité des fichiers dans une énumération FilesSecurity distincte pour une meilleure organisation et plus de clarté. L’interface IFileItem inclut désormais les propriétés fileSecurity et security.
• Boîtes de dialogue modales améliorées : vous pouvez désormais créer des boîtes de dialogue modales avec un meilleur contrôle de leur apparence à l’aide des propriétés withoutBodyPadding et withoutHeaderMargin. Nous avons également ajouté l’action updateCreateDialogModal pour les mises à jour dynamiques.
• Boîtes de dialogue de création plus intelligentes : l’interface ICreateDialog a été améliorée avec de nouvelles propriétés telles que isAutoFocusOnError, errorText, onError, onChange, isCloseAfterCreate et isCreateDisabled, vous offrant un contrôle plus précis sur les interactions utilisateur et la validation des formulaires.

Vous pouvez également consulter les plugins système mis à jour basés sur le SDK 2.0.0 en action dans DocSpace :

• draw.io
• Markdown
• Convertisseur PDF
• Saisie vocale

Mise à jour des SDK API DocSpace v3.5

Pour nous aligner sur la version 3.5 de DocSpace, nous avons mis à jour nos SDK API dans plusieurs langages. Ces SDK offrent un moyen pratique d’interagir avec l’API DocSpace, de gérer les fichiers, les utilisateurs et les salles par programmation.

Les SDK mis à jour sont disponibles pour :

• TypeScript : @onlyoffice/docspace-api-sdk sur npm
• C# : DocSpace.API.SDK sur NuGet
• Python : docspace-api-sdk sur PyPI

Commencez à construire dès aujourd’hui

Les dernières mises à jour d’ONLYOFFICE Docs et DocSpace offrent aux développeurs une boîte à outils plus riche et plus puissante. Du contrôle et de la personnalisation approfondis de l’API dans les éditeurs à un SDK plus robuste pour les plugins DocSpace, ces améliorations sont conçues pour vous aider à créer des solutions plus intégrées et plus riches en fonctionnalités.

Nous vous encourageons à explorer la documentation mise à jour, à télécharger les derniers SDK et à commencer à mettre en œuvre ces nouvelles fonctionnalités dans vos projets. Nous sommes impatients de voir ce que vous allez créer !

Obtenez la dernière version de ONLYOFFICE Docs pour les développeurs :

TÉLÉCHARGER MAINTENANT