ONLYOFFICE Docs v7.2 pour les développeurs : mises à jour de l’API

6 octobre 2022By Dasha

Outre la publication des nouvelles fonctionnalités de la version 7.2, nous avons mis à jour l’API pour les éditeurs et les modules complémentaires. Lisez la suite, pour en savoir plus.

ONLYOFFICE Docs 7.2 for developers: API updates

Visionneuse en direct et nouveaux paramètres de licence

La visionneuse en direct permet aux utilisateurs de voir les modifications apportées par les autres collaborateurs en temps réel lorsqu’ils ouvrent un document, une feuille de calcul ou une présentation en mode d’affichage uniquement. En savoir plus

Pour mettre en œuvre cette fonctionnalité, il faut obtenir une nouvelle licence qui comprendra des champs distincts pour la visionneuse en direct : connections_view et users_view_count pour le nombre de connexions et d’utilisateurs, et users_view pour le quota d’utilisateurs. Consultez les informations de réponse de la licence pour en savoir plus.

Veuillez noter que les connexions au serveur pour la visualisation en direct sont comptées séparément du nombre total de connexions simultanées*.

*Le nombre d’onglets de navigateur avec des documents peuvent être ouverts pour être édités en même temps.

Travail avec des documents depuis l’extérieur

Ainsi, vous pouvez créer un connecteur spécial pour apporter des modifications aux documents en utilisant vos propres boutons/méthodes au lieu des boutons de l’éditeur. Par exemple, vous pourrez générer un flux avec les commentaires de tous vos documents, y répondre et fermer les commentaires en un seul endroit, ou remplir automatiquement des formulaires avec les données exportées des bases de données.

Veuillez noter que la classe API Connector est incluse dans l’API avancée et qu’elle n’est pour l’instant disponible qu’en tant que démo (elle sera ajoutée à la documentation API lors de la prochaine mise à jour – version 7.2.1). Si vous souhaitez l’essayer dès maintenant, veuillez contacter notre équipe commerciale à l’adresse sales@onlyoffice.com.

Améliorations de l’API pour les modules complémentaires

Marketplace. Le nouveau gestionnaire de plugins permet aux utilisateurs d’explorer tous les plugins disponibles et de les installer ou supprimer en un seul clic, directement dans les éditeurs. À cet égard, nous avons mis à jour les instructions dans la documentation de l’API sur la création et l’ajout de plugins. Vous pouvez également consulter ce billet de blog.

Mise à jour du schéma de localisation. Vous pouvez désormais ajouter un fichier langs.json dans le dossier des traductions. En savoir plus

Le nouveau fichier contient les noms des fichiers avec les traductions pour une langue spécifique et comprend un tableau du type suivant :

[ 
  "cs-CZ",
  "de-DE",
  "es-ES",
  "fr-FR",
  "ru-RU"
]

Nouvelles méthodes : ChangeOleObject, GetAllForms, GetFileToDownload, GetFormsByTag, GetFormValue, GetImageDataFromSelection, GetInstalledPlugins, InstallPlugin, PutImageDataToSelection, RemovePlugin, SetFormValue, ShowButton, UpdatePlugin, etc. Check the full API changelog for plugins

JWT activé par défaut

À partir de la version 7.2, un secret JWT aléatoire est automatiquement généré et il suffit de l’ajouter du côté de l’application hôte. Vous pouvez obtenir le secret JWT par défaut et le remplacer par une clé personnalisée si nécessaire. En savoir plus

Autres mises à jour de l’API

Thème Contraste sombre. Activez une nouvelle variation du thème Sombre dans le paramètre editorConfig.customization.uiTheme. Il présente des nuances encore plus sombres, tandis que la surface de travail est presque noire.

"customization": { ......
   "uiTheme": "theme-contrast-dark",
    }, .......

Ajustement de la section À propos. Vous pouvez désormais ajouter le numéro de téléphone de votre entreprise dans la section À propos dans les éditeurs, ainsi que votre logo, votre adresse, votre courriel, etc. Pour ce faire, configurez le paramètre editorConfig.customization.customer.

"editorConfig": {         
    "customization": { ........
         "customer": {
         "address": "My City, 123a-45",
           .....
         "phone": "37188888888"
           },

Codes de langue à quatre lettres. Le paramètre editorConfig.lang qui définit la langue de l’interface de l’éditeur prend en charge les codes à quatre lettres. Par exemple, pour définir la langue portugaise, spécifiez pt-pt, tandis que pt-br indique le portugais brésilien.

"editorConfig": {
.....
 "lang": "pt-pt",

Il en va de même pour les codes linguistiques zh-cn (chinois simplifié) et zh-tw (chinois traditionnel).

Nouvelle action pour WOPI discovery. L’action embedview dans WOPI discovery rend une vue non modifiable d’un document qui est optimisé pour être intégré dans une page web :

<action name="embedview" ext="docx"...

Il fonctionne dans notre intégration SharePoint via WOPI en remplaçant l’URL selon ces instructions et est pertinent pour tous les intégrateurs indépendants de WOPI.

Mise à jour du calculateur de prix

Le nouveau calculateur de forfaits permet de configurer davantage de paramètres tels que la multilocation et le multiserveur, l’accès à l’API avancée, la visionneuse en direct, etc. En savoir plus

Calculer maintenant