L'éditeur en ligne pour les documents ONLYOFFICE Docs introduit de nouvelles mises à jour de l’API : tour d'horizon des améliorations

L’équipe de développement d’ONLYOFFICE a récemment introduit de nombreuses améliorations à son API, destinées à enrichir les possibilités d’intégration, à faciliter la personnalisation des éditeurs et à renforcer la sécurité des environnements collaboratifs. Ces changements offrent aux développeurs davantage de souplesse pour répondre à des cas d’usage variés, allant de la gestion documentaire à l’intégration dans des solutions métier complexes.

Prise en charge étendue des formats de fichiers

L’API Docs prend désormais en charge des formats de fichiers supplémentaires, offrant une plus grande compatibilité, afin de garantir une expérience transparente aux utilisateurs travaillant avec des types de fichiers variés. Il s’agit notamment des formats Apple iWork et Hancom Office :

  • pages
  • key
  • numbers
  • hwp
  • hwpx

Ces formats peuvent être spécifiés à l’aide de la propriété documentType, par exemple :
Code : Sélectionner tout - Visualiser dans une fenêtre à part
1
2
const config = {
  documentType: "pages",


Options de personnalisation améliorées

Les développeurs ont désormais plus de contrôle sur le comportement et l’apparence de l’éditeur. Les principales mises à jour sont les suivantes :



Fonctions de sécurité améliorées

L’API Docs introduit la gestion des fichiers protégés par un mot de passe grâce à l’événement events.onUserActionRequired. La fonction est appelée lorsqu’une action de l’utilisateur est requise pour ouvrir un document dans les cas suivants :

  • lorsque l’utilisateur doit saisir un mot de passe pour ouvrir le document protégé ;
  • lorsque l’utilisateur doit sélectionner un encodage pour le fichier TXT ;
  • lorsque l’utilisateur doit sélectionner un encodage et un délimiteur pour le fichier CSV.

Voici un exemple du fonctionnement de l’événement :

Code : Sélectionner tout - Visualiser dans une fenêtre à part
1
2
3
4
5
function onUserActionRequired() {
  console.log("Enter a password")
}; const config = {
  events: {
    onUserActionRequired,   }, }; const docEditor = new DocsAPI.DocEditor("placeholder", config);


Par ailleurs, vous pouvez désormais utiliser la commande drop pour interdire l’édition de documents à des utilisateurs spécifiques :

Code : Sélectionner tout - Visualiser dans une fenêtre à part
1
2
3
4
5
{
  "c": "drop",
  "key": "Khirz6zTPdfd7",
  "users": ["6d5a81d0"]
}


La liste complète des modifications apportées à l’API Docs est disponible ici.

Obtenez la dernière version de ONLYOFFICE Docs Developer.

Nouvelles méthodes de l’API Office

L’API Office reçoit des mises à jour importantes pour une meilleure gestion des documents, notamment :

  • Signets
  • Contrôles du contenu
  • Sections
  • Filtres automatiques
  • Sélection
  • Et plus encore

Ces améliorations permettent des interactions et des expériences d’édition plus riches. Pour une description détaillée des commandes, consultez le journal des modifications de l’API Office.


Mises à jour de l’API des plugins

Plusieurs nouvelles méthodes et propriétés élargissent les capacités des plugins :

  • Recherche de contenu

    La méthode GetSelectedContent permet de récupérer un contenu sélectionné dans un format spécifié.
    expression.GetSelectedContent(prop);
  • Messages d’erreur

    La méthode ShowError permet aux plugins d’afficher des messages d’erreur ou d’avertissement.
    expression.ShowError(error, level);
  • Propriétés du contrôle de contenu amélioré

    Les nouvelles propriétésShd (ombrage d’arrière-plan) et Border améliorent l’objet ContentControlProperties pour une meilleure personnalisation visuelle.

  • Activation du panneau

    Le paramètre isActivated vous permet de spécifier si un panneau de plugin créé est développé (true) ou réduit (false) au chargement.

Consultez la liste complète des mises à jour de l’API du plugin.