La version 9.0 de la suite bureautique en ligne ONLYOFFICE Docs apporte des améliorations pour les développeurs, notamment les mises à jour de l’API ainsi que de nouvelles options de personnalisation

ONLYOFFICE Docs 9.0 apporte des améliorations pour les développeurs et intégrateurs : nouvelles options de personnalisation, formats de fichiers supplémentaires, optimisations de performance et extension des API pour les plugins, macros et documents. Voici un tour d'horizon des changements les plus pertinents pour la communauté technique.

OnlyOffice est une suite bureautique en ligne et un écosystème d'applications collaboratives. Elle propose des éditeurs en ligne pour les documents texte, les feuilles de calcul, les présentations, les formulaires et les PDF, ainsi qu'une plateforme de collaboration en salles. La version 9.0 d'ONLYOFFICE Docs est disponible et introduit plus de 30 fonctionnalités inédites et environ 500 correctifs, avec une attention particulière portée à l’interface utilisateur, à la compatibilité des formats, à l’intégration de l’intelligence artificielle, et à l'amélioration des flux de travail collaboratifs.

En outre, ONLYOFFICE Docs 9.0 introduit de nombreuses améliorations conçues pour les développeurs et intégrateurs : nouvelles options de personnalisation, formats de fichiers supplémentaires, optimisations de performance et extension des API pour les plugins, macros et documents. Voici un tour d'horizon des changements les plus pertinents pour la communauté technique.

Visionneuse de diagrammes

La nouvelle visionneuse de diagrammes est disponible pour le web, le bureau et le web mobile. Il permet d’ouvrir des fichiers de diagramme sans avoir recours à des applications tierces.

Où trouver dans l’API : le type de document du diagramme est ajouté au paramètre documentType.

Nom : 2-diagram-viewer.png
Affichages : 3245
Taille : 78,5 Ko

Prise en charge de nouveaux formats de fichiers

ONLYOFFICE continue d’étendre ses possibilités d’utilisation en prenant en charge de nouveaux formats de fichiers. Dans la version 9.0, il est possible d’ouvrir les fichiers Markdown et OpenDocument Graphic pour les visualiser.

Où trouver dans l’API : ajout de l’ouverture des formats odg et md.

De plus, avec le lancement de la visionneuse de diagrammes, nous avons ajouté la conversion des formats vsdm, vsdx, vssm, vssx, vstm et vstx. Vérifier l’API

Nom : Horizontal-New-formats-support.png
Affichages : 489
Taille : 296,4 Ko

Options de personnalisation étendues

La personnalisation a atteint de nouveaux sommets dans la version 9.0, permettant à vos utilisateurs finaux d’adapter leur expérience ONLYOFFICE exactement comme ils le souhaitent.

Nouveaux thèmes d’interface utilisateur

Deux nouveaux thèmes, Clair moderne et Sombre moderne, sont présentés pour optimiser la recherche de chaque éditeur.

Où trouver dans l’API : Les identifiants des thèmes theme-white et theme-night sont ajoutés au paramètre editorConfig.customization.uiTheme.

Code : Sélectionner tout - Visualiser dans une fenêtre à part
1
2
3
4
5
6
7
8
9
10
11
12
13
14
1 2 3 4 5 6 const config = { editorConfig: { customization: { ... uiTheme: "theme-white", ...


Sélection de la taille des polices pour l’interface utilisateur en chinois simplifié

Ce nouveau paramètre garantit une taille de police précise dans les mises en page en chinois simplifié, offrant ainsi la possibilité d’utiliser des styles occidentaux ou traditionnels.

Où trouver dans l’API : paramètre editorConfig.customization.forceWesternFontSize, la valeur par défaut est false.

Code : Sélectionner tout - Visualiser dans une fenêtre à part
1
2
3
4
5
const config = {
  editorConfig: {
    customization: {
....  forceWesternFontSize: false,
...


Masquage des avatars des utilisateurs

Ce nouveau paramètre vous permet de masquer les avatars des utilisateurs dans l’en-tête de l’éditeur, ce qui contribue à créer une interface propre et sans distraction.

Où trouver dans l’API : paramètre editorConfig.customization.layout.header.user, la valeur par défaut est true.

Code : Sélectionner tout - Visualiser dans une fenêtre à part
1
2
3
4
5
6
7
8
9
10
const config = {
  editorConfig: {
    customization: {
... layout: {
        header: {
          editMode: true,
          save: true,
          user: true,
          users: true,
        },

Amélioration des performances grâce au préchargement

À partir de la version 9.0, vous pouvez précharger les ressources statiques (HTML, CSS, JS, polices) dans le cache du navigateur avant d’ouvrir un fichier afin d’accélérer le chargement initial de l’éditeur de documents. Vérifier l’API

Deux options sont disponibles :

1) Utilisation du paramètre ?preload=placeholder

Code : Sélectionner tout - Visualiser dans une fenêtre à part
1
2
3
<div id="placeholder"></div>

<script type="text/javascript" src="https://documentserver/web-apps/apps/api/documents/api.js?preload=placeholder"></script>


2) Insertion manuelle d’une iframe de préchargement

Code : Sélectionner tout - Visualiser dans une fenêtre à part
<iframe src="https://documentserver/web-apps/apps/api/documents/preload.html" style="display:none;"></iframe>


Obtenez la dernière version de ONLYOFFICE Docs Developer : Télécharger

Amélioration de l’API pour les plugins et les macros

Boutons personnalisés pour les contrôles de contenu. Utilisez la classe Asc.ButtonContentControl pour créer des boutons uniques pour vos plugins. Définissez des actions à l’aide de la méthode attachOnClick et ajoutez vos propres icônes pour améliorer les fonctionnalités. Vérifier l’API

Code : Sélectionner tout - Visualiser dans une fenêtre à part
1
2
3
4
5
6
7
8
9
10
11
12
(function(window){
  window.Asc.plugin.init = function()
  {
    let button = new Asc.ButtonContentControl();
    button.icons = '/resources/check%scale%(default).png';
    button.attachOnClick(function(contentControlId){
      Asc.plugin.executeMethod("RemoveContentControl", [contentControlId]);
    });       button = new Asc.ButtonContentControl();
    button.icons = '/resources/close%scale%(default).png';
    button.attachOnClick(function(contentControlId){
      Asc.plugin.executeMethod("RemoveContentControls", [[{"InternalId": contentControlId}]]);
    });   } })(window);


Définition de la diapositive active en fonction de son index. Accédez facilement à n’importe quelle diapositive dans les présentations grâce à la nouvelle méthode GoToSlide.

expression.GoToSlide(slideNumber);

Élément de liste de contrôle de contenu. L’introduction de l’énumération ContentControlListElement simplifie encore la gestion des contrôles de contenu dans les documents.

Calculs asynchrones. Gérez toute requête dans le corps d’une fonction personnalisée créée à l’aide de macros.

Code : Sélectionner tout - Visualiser dans une fenêtre à part
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
(function () {
  /**
   * World Bank indicator value for a specific year.
   * @customfunction
 
   * @param   {string} country   ISO-3 code, e.g. "TUR"
   * @param   {string} indicator Indicator code, e.g. "SP.POP.TOTL"
   * @param   {number} year      Four-digit year, e.g. 2024
   * @returns {any}             Numeric value or #N/A
   *
   * @example =WB("TUR","SP.POP.TOTL",2024)
   */
  async function WB(country, indicator, year) {
    // Build URL (World Bank allows CORS)
    const url =
      `https://api.worldbank.org/v2/country/${country}/indicator/${indicator}` +
      `?format=json&per_page=20000`;
    try {
      const r = await fetch(url);
      const [meta, data] = await r.json();
      // Find the row for the requested year
      const row = data.find((v) => v.date === year.toString());
      if (!row || row.value == null) return "#N/A";
      return row.value;               // resolves the Promise
    } catch (e) {
      return "#ERROR";
    }   }    // Register the function so it becomes a sheet formula
  Api.AddCustomFunction(WB); })();



Nouveaux exemples

Avec la dernière mise à jour de la documentation de l’API, nous avons inclus encore plus d’exemples prêts à l’emploi pour Document Builder et les macros, ce qui rend votre processus de développement plus fluide et plus efficace.

Framework de construction




Macros

De nouveaux exemples de macros sont disponibles pour tous les types d’éditeurs, par exemple :



Voir tous les exemples de macro


API Office

Pour l’API Office JavaScript, OnlyOffice a ajouté de nouvelles méthodes pour la version 9.0, y compris celles pour :

  • Contrôles de contenu
  • XML personnalisé
  • Formulaires
  • Propriétés personnalisées
  • Core
  • Plage
  • Dessin
  • Présentation
  • Page de notes


Voir la liste complète des nouvelles méthodes


Obtenez la dernière version de ONLYOFFICE Docs Developer : Télécharger