Fiche concept

API de scripting SAC (scripting d'Application Analytique)

À jour au 2026-09-27

Édité par Cédric Mary, éditeur et directeur de la publication — 27 ans d'écosystème SAP. Comment ces pages sont produites, et où intervient l'automatisation.

Qu'est-ce que API de scripting SAC (scripting d'Application Analytique) ?

Le scripting SAC ne devient nécessaire que lorsqu'une application doit orchestrer le comportement des widgets au-delà de ce qu'une Story statique peut exprimer — pour tout le reste, une Story se gouverne et se transmet plus facilement.

De quoi il s'agit

L'API de scripting SAC est la surface de programmation au dialecte TypeScript des Applications Analytiques de SAP Analytics Cloud — le moteur qui transforme SAC d'un constructeur de Story glisser-déposer en véritable plateforme applicative. Quand un client a besoin d'une application analytique interactive avec navigation custom, formatage conditionnel qu'aucune Story ne sait exprimer, binding de données programmatique ou intégration de systèmes externes, le scripting d'Application Analytique est la réponse.

Ce que le scripting contrôle réellement : chaque widget du canevas (graphique, tableau, liste déroulante, champ de saisie, image) expose une API de propriétés et une API d'événements. Les propriétés permettent au code de scripting de paramétrer à l'exécution le binding de données, les filtres, les dimensions, les mesures, la visibilité, le formatage. Les événements se déclenchent sur les actions utilisateur (onClick, onResultChanged, onSelect, onInitialization) et permettent au code de réagir. Les deux surfaces ensemble permettent à un designer d'application de construire des flux qu'aucune Story statique ne sait exprimer — par exemple un flux de drill où cliquer sur un graphique remplit un second graphique avec la dimension sélectionnée comme filtre, puis active conditionnellement un widget de prévision si la donnée dépasse un seuil.

Pourquoi c'est important

Le scripting s'exécute côté serveur, pas dans le navigateur, et n'a pas de capacité d'appel REST arbitraire — l'intégration externe requiert toujours des connexions OData ou des iFrames BTP.
Les API de propriétés et d'événements de chaque widget permettent au clic sur un graphique de remplir un second graphique et d'activer conditionnellement un widget de prévision — le pattern classique de drill.
Abuser du scripting produit des applications que seul un développeur peut maintenir, ce qui va à l'encontre de l'idée de les transmettre à un analyste citizen.

Points clés

Deux surfaces — l'API Properties (définir la liaison de données, les filtres, la visibilité, le formatage d'un widget à l'exécution) et l'API Events (réagir aux actions utilisateur : onClick, onResultChanged, onSelect, onInitialization).
Sous-ensemble TypeScript — s'exécute côté serveur ; accès au modèle de données SAC, à la collection de widgets, au service Planning, à Smart Predict, à R-Visualization.
Pas de REST arbitraire — pour l'intégration externe, utiliser des connexions OData ou des schémas iFrame BTP.
Quand passer de la Story à l'Analytic Application : quand les interactions doivent orchestrer au-delà du drill, du filtre ou du lien statiques — par exemple activation conditionnelle de widget, changement programmatique de dimension, flux de navigation multi-étapes.
Risque de sur-utilisation — les applications fortement scriptées sont l'affaire des développeurs ; elles produisent des artefacts non maintenables si une Story aurait suffi.
onResultChanged réagit au changement des données d'un widget pour des raisons hors du contrôle du script en cours ; c'est le mauvais outil pour propager un changement que le même script vient de provoquer, qui relève plutôt du gestionnaire à l'origine du changement.
Les intégrations IA et agent (Joule, AI Core, MCP) ne sont jamais appelées directement depuis un script — elles se trouvent derrière un service BTP (CAP ou Integration Suite) exposé en retour à l'application comme une connexion OData.
Économie du premier build : un développeur compétent livre typiquement un premier flux de drill fonctionnel en moins d'une journée, mais déboguer un cycle d'événements inter-widgets non intentionnel peut coûter plus de temps que la construction initiale.

Termes employés sur cette page

Analytic Application: La surface d'application de niveau développeur de SAC ; un canevas avec des widgets, une API de scripting, des événements de cycle de vie ; la réponse quand une Story ne suffit pas.
Scripting API: La surface de programmation de type TypeScript à l'intérieur des Analytic Applications ; expose les propriétés et événements des widgets ; s'exécute côté serveur à l'exécution.
Widget collection: L'ensemble de tous les widgets du canevas ; itérable depuis le script ; chaque widget adressable par son nom ; la base de la manipulation programmatique des widgets.
onResultChanged: L'événement qui se déclenche quand le résultat de données sous-jacent d'un widget est recalculé (par exemple après un changement de filtre) ; l'endroit canonique pour réagir à des changements d'origine externe, pas pour propager un changement que le même script vient de provoquer.
onClick: L'événement qui se déclenche sur une interaction utilisateur directe avec un widget ; l'endroit correct pour fixer l'état de chaque widget dépendant dans un seul gestionnaire quand le script lui-même est à l'origine du changement.
Properties API: La moitié du contrat de l'API de scripting qui permet au code de lire et de fixer la configuration d'un widget à l'exécution — liaison de données, filtres, dimensions, mesures, visibilité, formatage — par opposition à la réaction aux événements.
Event cycle (anti-pattern): Une chaîne non intentionnelle où les gestionnaires d'événements de deux widgets ou plus se redéclenchent mutuellement, multipliant les allers-retours serveur puisque l'API de scripting s'exécute côté serveur ; le correctif consiste à consolider la logique causale dans un seul gestionnaire.

Sources

Fiche complète réservée aux abonnés. Ce que la fiche complète ajoute : le cadre de décision complet · la comparaison SAP · Snowflake · Databricks · Fabric · les pièges courants et leur correctif · l'aide-mémoire · les schémas d'architecture · les blocs de code · les chiffres à citer.

Ouvrir dans l'application →

API de scripting SAC (scripting d'Application Analytique)

Qu'est-ce que API de scripting SAC (scripting d'Application Analytique) ?

De quoi il s'agit

Pourquoi c'est important

Points clés

Termes employés sur cette page

Sources

Concepts liés

Modules d'académie associés

Études approfondies

Guides SAP analytics & TJM