SAP Fiori Elements et floorplans

SAP Fiori Elements

SAP Fiori elements est un framework SAPUI5 qui génère des applications SAP Fiori à partir des métadonnées du service OData, des annotations d'interface et d'un app descriptor, avec des floorplans prédéfinis comme le list report et l'object page au lieu de vues et contrôleurs codés à la main. Il échange la liberté de mise en page contre un design cohérent, des fonctions d'entreprise intégrées et moins de code d'interface à maintenir.

L'essentiel

Type
Framework d'interface piloté par les métadonnées, construit sur SAPUI5
Couche
Applications d'interface
Entrées
Service OData V2 ou V4, annotations d'interface (CDS ou XML), paramètres du manifest.json
Floorplans
List report, object page, worklist, analytical list page, overview page
Back-ends typiques
Services RAP en ABAP, services CAP sur SAP BTP
Qui l'utilise
Développeurs SAP Fiori, développeurs ABAP et CAP, designers UX
S'applique à
SAP S/4HANA (toutes éditions), SAP BTP
Couche : Applications d'interfaceOù se situe-t-il ? ▾
Où se situe-t-il ?: L3 · Applications d'interfaceCouche : Applications d'interface.L1L2L3L4L5L6BTP

Couche : Applications d'interface

Ouvrir la carte d'architecture →

Comment fonctionne SAP Fiori elements ?

SAP Fiori elements déplace les décisions d'interface du code vers les métadonnées :

  1. Un service OData expose les entités métier, par exemple les commandes d'achat et leurs postes.
  2. Les annotations décrivent comment l'interface doit les présenter : UI.SelectionFields pour les champs de filtre, UI.LineItem pour les colonnes de tableau, UI.HeaderInfo pour les titres d'objet, UI.Facets pour les sections de l'object page.
  3. L'app descriptor (manifest.json) sélectionne un template de floorplan pour chaque page et définit des options telles que le chargement initial ou le mass edit.
  4. À l'exécution, le framework lit les métadonnées, les annotations et le descriptor, puis construit les pages, y compris la barre de filtres, les variantes, les tableaux, les formulaires, les messages et la navigation.
  5. Lorsque la page générée ne suffit pas, les développeurs ajoutent des extensions au lieu de réécrire la page.

L'essentiel du travail du développeur porte donc sur le service et ses annotations, pas sur le JavaScript. SAP Fiori elements transforme un service bien annoté en application fonctionnelle, et un service mal annoté en application médiocre.

Quels floorplans SAP Fiori elements propose-t-il ?

FloorplanObjectifOData V2OData V4
List reportTrouver, filtrer et traiter de nombreux objetsFloorplanFloorplan
Object pageAfficher, modifier et créer un objetFloorplanFloorplan
WorklistTraiter un ensemble connu d'éléments sans filtrage complexeFloorplan propreConfiguration du list report
Analytical list pageAnalyser avec des graphiques et agir sur les élémentsFloorplan propreConfiguration du list report
Overview pageCards qui résument un domaineFloorplanFloorplan

OData V4 ajoute les building blocks et les custom pages, ce qui permet aux développeurs de combiner des éléments standard avec leur propre code SAPUI5 au sein de la même application. Le list report associé à l'object page est la combinaison classique, souvent abrégée LROP. Choisir un floorplan dans SAP Fiori elements, c'est choisir un modèle d'interaction, pas un template visuel.

OData V2 ou V4 : lequel utiliser avec SAP Fiori elements ?

SAP recommande SAP Fiori elements for OData V4 pour les nouvelles applications et indique que la variante OData V2 reste entièrement prise en charge. En pratique, le choix dépend de trois facteurs :

  • Back-end : les service bindings RAP peuvent publier un service UI en OData V2 ou V4, et CAP sert OData V4 par défaut. Les services construits dans SEGW sont généralement en OData V2.
  • Besoins d'extension : les building blocks et le flexible programming model ne sont disponibles qu'avec OData V4.
  • Applications existantes : une application qui fonctionne en V2 n'a pas besoin d'être migrée pour continuer à tourner ; les paramètres de configuration diffèrent entre les deux, par exemple initialLoad en V4 contre loadDataOnAppLaunch en V2.

Pour une nouvelle application spécifique sur un back-end SAP S/4HANA ou SAP BTP actuel, OData V4 est le choix par défaut dans SAP Fiori elements, et V2 le choix pragmatique lorsque le service existe déjà.

Quand utiliser SAP Fiori elements plutôt que SAPUI5 freestyle ?

SAP Fiori elements convient lorsque la tâche suit un modèle standard : rechercher dans une liste, ouvrir un objet, le modifier, exécuter des actions. Le framework fournit barres de filtres, gestion des variantes, tableaux, drafts, messages, accessibilité et prise en charge de la traduction sans code spécifique, et SAP maintient ces fonctions à jour au fil des releases SAPUI5.

Le SAPUI5 freestyle convient lorsque l'interaction elle-même est inhabituelle : un tableau de planification, un parcours de scan guidé, une mise en page très visuelle ou des données provenant de sources autres qu'OData. Le code freestyle donne un contrôle total et une responsabilité totale de la maintenance.

Les propres recommandations de SAP présentent les deux approches comme combinables plutôt qu'exclusives : partir de SAP Fiori elements, utiliser les building blocks et n'écrire du code freestyle que pour combler les lacunes. Un test de décision utile consiste à savoir si les parties prenantes peuvent accepter la mise en page du floorplan, au moins pour les écrans principaux. SAP Fiori elements est le meilleur choix chaque fois que le besoin porte sur un business object, et non sur une interaction sur mesure.

Comment étendre une application SAP Fiori elements ?

Les options d'extension dépendent de qui possède l'application :

  • Votre propre application : les points d'extension permettent aux développeurs d'ajouter des colonnes, actions, sections, facettes d'en-tête et filtres personnalisés ; avec OData V4, le flexible programming model ajoute les building blocks et les custom pages.
  • Une application livrée par SAP : les adaptation projects, créés avec SAP Fiori tools, modifient ou étendent l'application sans modifier le code de SAP ; l'adaptation key user permet aux key users de réorganiser ou de masquer des champs à l'exécution.
  • Côté données : un nouveau champ commence généralement dans le service et ses annotations, pas dans l'interface.

La disponibilité varie selon l'édition : dans SAP S/4HANA Cloud Public Edition, vérifiez lesquelles de ces voies SAP prend en charge pour l'application concernée. Toute extension d'une application SAP Fiori elements devient du code ou de la configuration dont quelqu'un doit assumer la responsabilité au fil des mises à niveau.

Quelles sont les erreurs courantes avec SAP Fiori elements ?

  1. Lutter contre le floorplan. De grandes quantités de code spécifique pour imposer une mise en page non standard annulent le bénéfice en maintenance ; à ce stade, le SAPUI5 freestyle est souvent plus honnête.
  2. Le traiter comme du no-code. Les annotations sont du code sous une autre forme ; elles exigent revue, gestion de versions et tests.
  3. Ignorer la gestion des drafts. Les scénarios d'édition sans service compatible draft perdent la reprise du travail, le verrouillage et les validations auxquels les utilisateurs s'attendent.
  4. Ne pas examiner les valeurs par défaut. Le chargement initial, le mass edit et les types de tableaux ont des valeurs par défaut qui peuvent charger trop de données ou trop peu ; définissez-les délibérément.
  5. Annoter à deux endroits. Les annotations peuvent se trouver dans les CDS du back-end et dans des fichiers d'annotations locaux ; les fichiers locaux remplacent les métadonnées du service, et le dernier fichier déclaré dans manifest.json l'emporte, si bien que les doublons rendent le comportement difficile à tracer.

La plupart des problèmes de SAP Fiori elements sont des problèmes de conception du service et des annotations qui ne deviennent visibles que dans l'interface.

SAP Fiori elements, SAPUI5 freestyle ou SAPUI5 : quelle différence ?

SAP Fiori elementsApplication SAPUI5 freestyleSAPUI5
DéfinitionFramework qui génère des pages à partir des métadonnéesApplication avec des vues et des contrôleurs écrits à la mainLe framework d'interface sur lequel les deux reposent
Ce qu'écrivent les développeursAnnotations, paramètres du descriptor, extensionsJavaScript ou TypeScript, vues XMLSans objet ; c'est la bibliothèque
Liberté de mise en pageLimitée aux floorplans et aux extensionsTotaleTotale
MaintenanceFonctions du framework mises à jour par SAPEntièrement à la charge de l'équipe applicativeBibliothèque versionnée maintenue par SAP

SAPUI5 est la boîte à outils ; SAP Fiori elements et SAPUI5 freestyle sont deux manières de construire des applications avec elle.

Questions fréquentes

SAP Fiori elements est-il la même chose que SAPUI5 ?

Non. SAPUI5 est le framework d'interface JavaScript. SAP Fiori elements repose sur SAPUI5 et génère des pages complètes à partir des métadonnées et des annotations OData, de sorte que les développeurs configurent des floorplans au lieu d'écrire des vues et des contrôleurs. Les deux s'exécutent dans le même runtime SAPUI5.

SAP Fiori elements nécessite-t-il OData ?

Oui. SAP Fiori elements lit les métadonnées et les annotations d'un service OData V2 ou OData V4 pour construire ses pages. Les données issues d'autres protocoles doivent d'abord être exposées en OData, ou l'application doit utiliser du SAPUI5 freestyle pour cette partie.

Que désignaient les smart templates ?

Smart templates est l'ancien nom de SAP Fiori elements. La documentation SAP des releases antérieures utilise encore ce terme, tout comme les praticiens à l'occasion, mais il désigne le même framework piloté par les annotations.

Peut-on ajouter du code spécifique à une application SAP Fiori elements ?

Oui. Les points d'extension permettent d'ajouter des colonnes, actions, sections et filtres personnalisés, et SAP Fiori elements for OData V4 ajoute les building blocks et les custom pages. Plus une application contient de code spécifique, plus elle se comporte comme une application freestyle en matière de maintenance.

Quels outils servent à construire des applications SAP Fiori elements ?

SAP Fiori tools, un ensemble d'extensions pour SAP Business Application Studio et Visual Studio Code, génère des applications SAP Fiori elements, édite les annotations et le descriptor, et visualise la navigation entre les pages. Le service back-end est généralement construit avec RAP ou CAP.

Sources

S'applique à
SAP S/4HANA on-premise · SAP S/4HANA Cloud Private Edition · SAP S/4HANA Cloud Public Edition · SAP BTP
Dernière relecture

Pour aller plus loin

SAP, SAP Fiori, SAPUI5, SAP S/4HANA, SAP BTP et les autres produits et services SAP mentionnés sont des marques commerciales ou des marques déposées de SAP SE (ou d'une société affiliée à SAP) en Allemagne et dans d'autres pays. Ce guide est indépendant ; il n'est ni affilié à SAP SE, ni sponsorisé, ni approuvé par SAP SE.