Macros ou fonctions IA ? Comprendre les outils ONLYOFFICE

4 février 2026Par Dasha

ONLYOFFICE vous offre des moyens puissants pour automatiser votre travail sur les documents à l’aide de macros et de fonctions d’IA, vous permettant ainsi de gagner du temps, de réduire les efforts manuels et de travailler plus efficacement.

Ces deux outils vous aident à travailler plus rapidement et plus intelligemment, mais ils fonctionnent différemment et répondent à des besoins différents. Que vous soyez un développeur créant des solutions personnalisées ou simplement quelqu’un qui souhaite travailler plus efficacement, ce guide vous aidera à choisir l’outil adapté à vos besoins.

Macros or AI Functions? Understanding ONLYOFFICE Tools

Comprendre les bases

Que sont les macros ONLYOFFICE ?

Les macros ONLYOFFICE sont de petits scripts qui automatisent les tâches répétitives dans les documents, les feuilles de calcul et les présentations. Elles utilisent JavaScript et l’API Office, vous permettant de formater du contenu, de mettre à jour des données et de créer des flux de travail personnalisés directement dans l’éditeur.

Comment utiliser les macros :

Ouvrez l’onglet Affichage et cliquez sur Macros.
Écrivez le code JavaScript à l’aide de l’API Office.
Cliquez sur Exécuter pour exécuter la macro.
Le script manipule directement le document.

Remarque ! Depuis la version 7.1, les macros s’exécutent en mode strict. Cela signifie que vous devez déclarer toutes les variables avec let ou const avant de les utiliser. Vous ne pouvez pas utiliser les fonctions window, document ou alert.

Exemple : lignes de tableau en couleur

(function () {
  let worksheet = Api.GetActiveSheet();
  for (let i = 1; i < 200; i += 2) {
    let rowOdd = i,
      rowEven = i + 1;
    worksheet.GetRange(
      "A" + rowOdd + ":S" + rowOdd).SetFillColor(Api.CreateColorFromRGB(138, 181, 155)
      );
    worksheet.GetRange(
      "A" + rowEven + ":S" + rowEven).SetFillColor(Api.CreateColorFromRGB(216, 227, 220)
      );
  }
})();

Cette macro colore 200 lignes en alternance en moins d’une seconde, une tâche qui prendrait beaucoup de temps à réaliser manuellement.

Quelles sont les fonctions de l’IA d’ONLYOFFICE ?

Les fonctions IA connectent ONLYOFFICE à des modèles IA tels que ChatGPT. Elles vous permettent d’exécuter des actions sur des documents à l’aide de commandes, afin que l’éditeur puisse effectuer des opérations automatisées en fonction de votre demande. Les fonctions IA font partie du plugin IA (actuellement en version bêta), introduit dans la version 2.4.2.

Configuration

Clonez le référentiel onlyoffice.github.io sur votre machine locale.
Écrivez votre fonction IA dans le dossier helpers (sdkjs-plugins/content/ai/.dev/helpers).
En fonction du type d’éditeur, placez-la dans le dossier cell, slide, ou word.
Mettez à jour la version actuelle du plugin IA dans config.js pour éviter les problèmes de mise en cache
(par exemple, 3.0.3 → 3.0.4).
Exécutez le fichier helpers.py.
Sélectionnez tous les fichiers de plug-in dans le dossier ai (sdkjs-plugins/content/ai), compressez-les et renommez l’archive en ai.plugin.
Replacez le fichier dans sdkjs-plugins/content/ai/deploy.
Envoyez les modifications.
Créez votre site GitHub Pages à partir de ce référentiel (consultez la documentation GitHub Pages).
Préparez un lien vers votre boutique personnalisée en ajoutant /store/index.html à votre URL GitHub Pages : https://YOUR-USERNAME.github.io/onlyoffice.github.io/store/index.html
Accédez à Modules complémentaires → Gestionnaire de plugins.
Cliquez sur l’icône Boutique (</>) dans le coin supérieur droit du Gestionnaire de plugins et saisissez l’URL de votre boutique personnalisée.
Mettez à jour le plugin IA.

Pour obtenir des instructions plus détaillées, consultez cet article.

Comment utiliser les fonctions IA

Configurez votre fournisseur d’IA et votre clé API si nécessaire.
Appuyez sur Ctrl + / pour ouvrir le chat IA.
Tapez ce que vous voulez (par exemple « Expliquez ce texte »).
L’IA sélectionne la fonction appropriée et effectue le travail.
Le résultat apparaît dans votre document.

Les fonctions IA mémorisent votre conversation. Vous pouvez poser des questions complémentaires ou affiner les résultats. Appuyez sur Ctrl + Alt + / pour recommencer à zéro.

Exemple : Ajouter des commentaires IA

La fonction commentText ajoute des commentaires intelligents au texte sélectionné :

Sélectionnez du texte dans votre document.
Appuyez sur Ctrl + / pour ouvrir le chat IA.
Tapez : « Expliquez ce texte ».
Appuyez sur Entrée.

L’IA lit votre texte, génère une explication et l’ajoute sous forme de commentaire dans votre document.

Voici comment cela fonctionne en coulisses :

// Simplified structure of an AI Function
func.call = async function (params) {
  // 1. Get the selected text
  let text = await Asc.Editor.callCommand(function () {
    let doc = Api.GetDocument();
    let range = doc.GetRangeBySelect();
    return range ? range.GetText() : "";
  });
  // 2. Ask the AI model
  let requestEngine = AI.Request.create(AI.ActionType.Chat);
  let argPrompt = params.prompt + ":\n" + text;
  // 3. Add the AI's answer as a comment
  await requestEngine.chatRequest(argPrompt, false, async function (data) {
    await Asc.Editor.callCommand(function () {
      let doc = Api.GetDocument();
      let range = doc.GetRangeBySelect();
      range.AddComment(data, model, "uid" + model);
    });
  });
};

Vous pouvez voir le code complet de la fonction commentText ici.

Pourquoi les fonctions de l’IA sont-elles plus flexibles ?

Les fonctions IA invoquent CallCommand séparément (voir les lignes dans le code ci-dessus), ce qui vous permet d’exécuter une logique personnalisée avant et après les opérations sur les documents. Elles sont donc parfaites pour l’intégration de l’IA : vous pouvez envoyer des requêtes au modèle IA, traiter la réponse, puis mettre à jour le document. L’application Macros regroupe tout dans CallCommand, ce qui est plus simple mais moins flexible.

Principales différences

Les macros permettent de manipuler directement des documents hors ligne. Les fonctions IA permettent d’intégrer des modèles IA à ONLYOFFICE.

Voici comment ils se comparent :

Aspect	Macros	Fonctions IA
Configuration	Faciles – déjà intégré	Plus complexes – Configuration du fournisseur d’IA + fonctions personnalisées
Coût	Gratuites	Payantes (frais facturés par le fournisseur d’IA)
Internet	Fonctionnent hors ligne	Nécessitent une connexion à un service d’IA
Conditions préalables	JavaScript + API Office	JavaScript + API Office + modifications de l’agent IA
Courbe d’apprentissage	Difficiles pour les non-programmeurs	Difficiles pour les non-programmeurs
Cohérence des résultats	Toujours le même résultat	Peut varier
Flexibilité	Limitées – enveloppées dans `CallCommand`	Plus flexibles – invoquer `CallCommand` séparément
Performance	Rapides – exécution directe	Variables – dépend du temps de réponse de l’IA
Prise en charge des versions	Disponible depuis les premières versions	Beta (à partir de v2.4.2)
Idéal pour	Développeurs, contrôle précis, automatisation hors ligne	Tâches assistées par l’IA, opérations sur les documents et traitement
Confidentialité	Exécution locale uniquement	Données envoyées à un service d’IA externe

Quand utiliser chaque outil

Macros

Choisissez les macros lorsque vous avez besoin de manipuler directement des documents :

Travail hors ligne : aucune connexion Internet requise.
Gratuites : automatisez autant que vous le souhaitez sans frais.
Opérations directes sur les documents : mise en forme, manipulation des données, calculs.
Résultats exacts : une même entrée donne toujours le même résultat.
Prototypage rapide : écrivez du code et testez-le immédiatement dans l’éditeur.
Travail de production : rapports financiers, documents de conformité, flux de travail automatisés.

Fonctions IA

Choisissez les fonctions IA lorsque votre automatisation nécessite des capacités IA :

Intégration de modèles d’IA : connexion aux services d’IA et utilisation de leurs résultats.
Automatisation des documents : application directe des résultats de l’IA au document.
Traitement contextuel : gestion du contenu en tenant compte de la sélection ou de la structure du document.
Logique avancée : flexibilité nécessaire pour exécuter du code personnalisé avant/après les opérations sur les documents.

Conclusion

Les macros et les fonctions IA d’ONLYOFFICE ont des objectifs différents. La distinction principale est simple :

Les macros servent à manipuler directement les documents. Elles sont gratuites, fonctionnent hors ligne et sont parfaites pour toute automatisation ne nécessitant pas d’IA. Utilisez-les pour le formatage, les calculs, la manipulation de données et les formules personnalisées.

Les fonctions IA servent à intégrer des modèles IA à ONLYOFFICE. Elles sont plus complexes à développer que les macros, nécessitent une connexion Internet et des frais liés au fournisseur d’IA, mais elles constituent le choix idéal lorsque vous avez besoin de capacités d’IA. Utilisez-les pour générer du contenu, traiter des documents et automatiser des tâches documentaires à l’aide de l’IA.

ONLYOFFICE continue d’améliorer ces deux outils. Les macros bénéficient de nouvelles fonctionnalités telles que les fonctions asynchrones. Les fonctions IA sortent de leur phase bêta avec une fiabilité accrue et davantage de capacités. Comprendre ces deux outils vous permet de tirer pleinement parti de l’automatisation ONLYOFFICE.