En bref
RAP (RESTful Application Programming Model) est le modèle de développement natif de S/4HANA. Il unifie en un seul paradigme la couche données (CDS Views), le comportement métier (Behavior Definition) et l'exposition OData V4. Il alimente Fiori Elements et garantit la compatibilité Clean Core. Sur S/4HANA, tout nouveau développement d'application devrait passer par RAP.
La prise en main de RAP dépend de l'expérience ABAP, de la maîtrise des CDS Views et des cas d'usage rencontrés. Le Draft Handling et les actions complexes demandent une pratique progressive sur des projets réels.
SAP a tiré les leçons de cet écosystème fragmenté. Le RESTful Application Programming Model, introduit avec S/4HANA 1909 et devenu incontournable à partir de 2021, unifie l'ensemble sous un modèle cohérent et orienté API-first. Une Business Object (BO) RAP encapsule la structure de données, les règles métier et l'exposition OData V4. Fiori Elements consomme directement ces métadonnées pour générer les interfaces standard.
L'architecture RAP en quatre couches
- Couche 1DataCDS Views : Interface View, puis Projection View annotée
@UI - Couche 2ComportementBehavior Definition : opérations, actions, validations
- Couche 3ImplémentationClasse ABAP
FOR BEHAVIOR OF: la logique métier - Couche 4ExpositionService Definition + Service Binding OData V4
1. La couche Data, CDS View
Tout Business Object RAP commence par une CDS View (Core Data Services). Elle définit la structure des données : quelles tables lire, quelles associations naviguer, quels champs calculer. Sur cette vue de base, on empile une Interface View puis une Projection View orientée consommation.
Les annotations @UI définissent directement dans la CDS la disposition de l'interface : quels champs apparaissent dans la liste, quels champs dans le formulaire, quels filtres sont disponibles par défaut. C'est le principe de l'annotation-driven UI, Fiori Elements consomme ces métadonnées pour générer l'interface, sans une ligne de JavaScript.
Exemple de Projection View :
@AccessControl.authorizationCheck: #CHECK
@EndUserText.label: 'Sales Order, S/4HANA'
define root view entity ZC_KaiSalesOrder
provider contract transactional_query
as projection on ZI_KaiSalesOrder
{
@UI.lineItem: [{ position: 10 }]
key SalesOrder,
@UI.lineItem: [{ position: 20 }]
NetAmount,
Currency,
_Items : redirected to composition child ZC_KaiSalesOrderItem
}
2. La couche Comportement, Behavior Definition
La Behavior Definition (BDEF) est le contrat du Business Object : elle déclare quelles opérations sont permises (create, update, delete), quels champs sont en lecture seule, quelles actions métier existent (approve, submit, reject), et quelles validations ou déterminations sont déclenchées. Elle est écrite dans un langage déclaratif propre à RAP, différent de l'ABAP classique.
Exemple de Behavior Definition :
managed implementation in class zbp_i_kaisalesorder unique;
strict ( 2 );
define behavior for ZI_KaiSalesOrder alias SalesOrder
persistent table zkai_so
lock master
authorization master ( instance )
{
create; update; delete;
validation checkAmount on save { field NetAmount; }
determination setCurrency on modify { create; }
action release result [1] $self;
association _Items { create; }
}
3. La couche Implémentation, Behavior Implementation Class
La classe d'implémentation (une classe ABAP standard annotée FOR BEHAVIOR OF) contient la logique métier concrète : que fait l'action ApproveOrder ? Quelle est la règle de validation ValidateAmount ? Cette classe implémente les méthodes déclarées dans la BDEF et bénéficie de toute la puissance de l'ABAP orienté objet.
Exemple de validation dans la classe d'implémentation :
CLASS lhc_salesorder DEFINITION INHERITING FROM cl_abap_behavior_handler.
PRIVATE SECTION.
METHODS checkAmount FOR VALIDATE ON SAVE
IMPORTING keys FOR SalesOrder~checkAmount.
ENDCLASS.
CLASS lhc_salesorder IMPLEMENTATION.
METHOD checkAmount.
READ ENTITIES OF zi_kaisalesorder IN LOCAL MODE
ENTITY SalesOrder
FIELDS ( NetAmount )
WITH CORRESPONDING #( keys )
RESULT DATA(orders).
LOOP AT orders INTO DATA(order) WHERE NetAmount <= 0.
APPEND VALUE #( %tky = order-%tky ) TO failed-salesorder.
APPEND VALUE #( %tky = order-%tky
%msg = new_message_with_text(
severity = if_abap_behv_message=>severity-error
text = 'Le montant doit être positif' ) )
TO reported-salesorder.
ENDLOOP.
ENDMETHOD.
ENDCLASS.
4. La couche Exposition, Service Definition + Service Binding
Le Business Object n'est pas exposé au monde extérieur par les annotations CDS. Deux objets dédiés s'en chargent : un Service Definition qui déclare quelles Projection Views sont publiées dans le service, et un Service Binding qui choisit le protocole et le scénario d'usage, typiquement ODATA V4, UI pour alimenter Fiori Elements, ou ODATA V4, Web API pour les intégrations B2B. C'est le binding qui crée l'endpoint /sap/opu/odata4/... consommable par les clients.
Exemple de Service Definition :
@EndUserText.label: 'Sales Order'
define service ZUI_KaiSalesOrder {
expose ZC_KaiSalesOrder as SalesOrder;
expose ZC_KaiSalesOrderItem as SalesOrderItem;
}
RAP vs BOPF, Web Dynpro, Module Pool : quand utiliser quoi ?
Sur un système S/4HANA récent, les anciens modèles ne disparaissent pas du jour au lendemain. Voici le tableau de décision qu'on applique en mission chez Kaï :
| Besoin | Modèle recommandé | Pourquoi |
|---|---|---|
| Nouvelle application Fiori transactionnelle sur S/4HANA 1909+ | RAP Managed | Standard SAP cible, Clean Core, Fiori Elements directement consommable |
| Exposition d'une logique BAPI / legacy en API moderne | RAP Unmanaged | Wrapping propre sans réécrire le legacy, OData V4 exposé proprement |
| Application historique en Web Dynpro à maintenir | Web Dynpro (sans la réécrire) ou migration RAP si refonte fonctionnelle | SAP maintient Web Dynpro mais ne fait plus évoluer. Migrer = projet à part entière |
| Batch, traitement de masse, logique sans UI | ABAP classique (avec objets SAP Released) | RAP n'apporte aucune valeur sans UI ; reste maintenable si on respecte Clean Core |
| Module Pool ou Dynpro existant | À planifier pour migration RAP | Plus aucun investissement SAP sur Dynpro ; risque de dette technique critique |
| BOPF existant en production | BOPF → RAP (refonte) | BOPF est officiellement déprécié au profit de RAP par SAP depuis S/4HANA 2020 |
La règle simple : tout nouveau développement Fiori sur S/4HANA part en RAP. Pour l'existant, on planifie la migration uniquement lors d'une refonte fonctionnelle, pas en mode "réécriture pour la réécriture".
Managed vs Unmanaged : deux scénarios
RAP propose deux modes de persistance selon la nature des données à manipuler.
Le mode Managed est le cas d'usage standard pour tout Business Object dont les données sont stockées dans des tables Z ou des extensions de tables standard SAP. Le framework gère automatiquement le CRUD, le lock, l'ETag et le Draft. Le développeur n'écrit que la logique spécifique : validations, déterminations, actions.
Le mode Unmanaged est réservé aux cas où le BO encapsule des données sans propriété directe sur leur persistance : appel de BAPIs existants, wrapping d'une interface legacy, données réparties sur plusieurs systèmes distants. Dans ce cas, le développeur prend en charge l'ensemble du cycle de vie, sauvegarde, lock, ETag, ce qui est sensiblement plus complexe.
Sur un nouveau projet S/4HANA, le choix par défaut est toujours le mode Managed. Le mode Unmanaged s'utilise uniquement quand les données ne peuvent pas être gérées directement par le framework.
Draft Handling : les saisies multi-étapes
L'une des fonctionnalités les plus puissantes de RAP est le Draft Handling : la capacité à sauvegarder temporairement un enregistrement en cours de saisie sans l'activer définitivement. L'utilisateur peut quitter l'application, revenir plus tard, reprendre sa saisie là où il l'a laissée. Fiori Elements gère l'indicateur visuel "Draft" automatiquement.
Le framework prend en charge la persistance et la gestion des brouillons. La configuration du Draft doit être adaptée au Business Object et vérifiée sur les scénarios utilisateurs.
RAP et Fiori Elements : le duo gagnant
RAP seul ne produit pas d'interface. C'est en combinaison avec Fiori Elements que le modèle atteint sa pleine puissance. Fiori Elements propose quatre templates de pages standard :
- List Report : liste avec filtres et variant management, idéale pour les cockpits de gestion
- Object Page : fiche détail avec sections et facettes, pour la création et modification
- Analytical Page : vue analytique avec KPI cards et micro-charts, pour le reporting
- Overview Page : tableau de bord multi-cartes, pour les pages d'accueil métier
Ces templates se génèrent automatiquement à partir des annotations @UI des CDS Views. Aucun HTML ni JavaScript à écrire. Le résultat est une application Fiori conforme aux SAP Fiori Design Guidelines, responsive par défaut, accessible et maintenue à chaque upgrade SAP sans aucune intervention du développeur.
Par où commencer avec RAP ?
La maîtrise des CDS Views, des associations, des annotations et des projections constitue une base importante pour développer avec RAP. Le travail sur des cas concrets, les revues de code et la documentation aident l'équipe à progresser.
L'outil de développement est Eclipse ADT (ABAP Development Tools), la SE80 ne supporte pas les artefacts RAP. SAP fournit dans ADT un Business Object Generator qui crée automatiquement l'ensemble des artefacts (Interface View, Projection View, BDEF, Behavior Implementation Class) depuis la structure de tables. C'est le point de départ recommandé pour tout nouveau Business Object.
La prise en main de RAP dépend de l'expérience ABAP, de la maîtrise des CDS Views et des cas d'usage rencontrés. Le Draft Handling et les actions complexes demandent une pratique progressive sur des projets réels.
Pièges fréquents qu'on voit en mission
Cinq erreurs récurrentes qu'on corrige en mission chez nos clients sur S/4HANA :
1. Démarrer RAP sans maîtriser les CDS Views
Aborder RAP sans comprendre les associations CDS, les annotations et la distinction Interface / Projection peut rendre les développements difficiles à maintenir. Il est préférable de consolider ces bases avant d'aborder les comportements métier.
2. Confondre Service Definition et Service Binding
Le Service Definition déclare quelles vues exposer. Le Service Binding choisit le protocole (OData V4 UI vs Web API). On voit régulièrement des projets avec un Service Binding mal configuré qui empêche Fiori Elements de générer correctement la List Report (manque l'annotation @UI.lineItem côté Projection View, alors que la cause est en réalité un binding en mode "Web API" au lieu de "UI"). Une heure de debug pour rien.
3. Utiliser Unmanaged par défaut
Par confort ou par peur de "perdre le contrôle", certains développeurs partent en Unmanaged même quand les données sont stockées dans des tables Z. Conséquence : tout le CRUD, le lock, l'ETag et le Draft sont à implémenter à la main, des centaines de lignes de code qui auraient été gérées par le framework. Règle : tables Z = Managed par défaut, point.
4. Oublier le Authorization Control au niveau CDS
L'autorisation RAP se gère via les DCL (Data Control Language) au niveau CDS. Pas dans la Behavior Implementation. On voit fréquemment des projets où l'autorisation est codée à la main dans l'implémentation, ça marche, mais ce n'est pas étanche, et ça ne respecte pas le standard SAP qui privilégie l'autorisation déclarative.
5. Vouloir customiser Fiori Elements en SAPUI5 freestyle
Avant de choisir SAPUI5 freestyle, vérifiez ce que les annotations CDS et les possibilités d'extension Fiori Elements couvrent. Le choix dépend des interactions attendues, de la compatibilité du système et de la capacité de l'équipe à maintenir l'application.
Retour d'expérience, Projet Kuhn Group
Sur la migration S/4HANA Greenfield de Kuhn Group, RAP et Fiori Elements ont été utilisés pour des applications métier. Le travail a porté sur la structure du code, les interfaces et la transmission aux équipes :
- Structuration des développements autour des modèles CDS, des comportements RAP et des interfaces Fiori Elements.
- Préparation des évolutions S/4HANA avec des choix techniques documentés et des tests adaptés.
- Accompagnement de l'équipe interne pour faciliter la reprise et la maintenance des applications.
- Travail sur la cohérence des interfaces avec les recommandations SAP Fiori.
Les évolutions de version nécessitent de vérifier les applications et leurs dépendances. L'organisation du code et les tests contribuent à anticiper les adaptations.
Questions fréquentes
RAP remplace-t-il complètement l'ABAP classique ?
Pour les nouvelles applications avec interface Fiori, oui. RAP est le modèle cible sur S/4HANA. Pour les batchs, traitements de masse et logiques sans interface utilisateur, l'ABAP classique reste pertinent, à condition d'utiliser uniquement les objets SAP Released.
Quelle est la différence entre RAP Managed et Unmanaged ?
En mode Managed, le framework RAP gère automatiquement le CRUD, le lock et l'ETag sur des tables Z. En mode Unmanaged, le développeur prend en charge l'ensemble du cycle de vie, utile pour wrapper des BAPIs existants ou encapsuler une interface legacy.
Faut-il connaître les CDS Views pour apprendre RAP ?
Oui, les CDS Views sont la fondation de RAP. Sans maîtrise des CDS (associations, annotations @UI, extension), il est impossible de construire un Business Object RAP correct. C'est le prérequis indispensable avant de se former à RAP.
Peut-on utiliser RAP sur SAP ECC ?
Non. RAP est exclusivement disponible sur S/4HANA (on-premise à partir de la version 1909). Sur ECC, les alternatives sont BOPF, Web Dynpro et Module Pool. RAP nécessite également Eclipse ADT, la SE80 ne supporte pas le développement RAP.
Combien de temps faut-il pour maîtriser RAP ?
La prise en main de RAP dépend de l'expérience ABAP, de la maîtrise des CDS Views et des cas d'usage rencontrés. Le Draft Handling et les actions complexes demandent une pratique progressive sur des projets réels.
Sources et périmètre
Cet article s'appuie sur notre pratique des projets SAP et sur la documentation publique de référence. Les liens ci-dessous permettent de vérifier et d'approfondir les notions abordées (liens vérifiés le 10 novembre 2026).
- SAP Community, ABAP RESTful Application Programming Model (RAP). Page de référence SAP sur RAP : guides, tutoriels et actualités.
- SAP Developer Center, mission RAP100. Parcours SAP pour construire une application Fiori elements avec RAP.
- SAP-samples, Flight Reference Scenario for RAP (GitHub). Scénario de référence publié par SAP : CDS, Behavior Definitions et services.
- SAP-samples, ABAP Cheat Sheets, EML. Syntaxe EML pour manipuler les Business Objects RAP, avec exemples exécutables.
Un développement RAP à réaliser ou une équipe SAP à renforcer ?
Nous intervenons sur la conception et le développement de vos applications RAP / Fiori Elements, la reprise de code et le Tech Lead. En direct avec votre DSI ou aux côtés de votre intégrateur, nous cadrons le périmètre technique et travaillons avec votre équipe.
Échanger sur votre projet RAPDécouvrir nos interventions en développement et renfort SAP · Développeur SAP ? Rejoignez-nous