Application SAPUI5 freestyle

Une application SAPUI5 freestyle utilise la structure d'application SAPUI5 standard, chaque écran étant écrit par l'équipe de développement :

1. Composant et app descriptor — le composant démarre l'application ; le manifest.json déclare les sources de données, les modèles, les routes et les inbounds de navigation.
2. Vues — généralement des vues XML qui placent des contrôles SAPUI5 tels que tableaux, formulaires et graphiques.
3. Contrôleurs — du code JavaScript ou TypeScript pour les événements, les retours de validation, les boîtes de dialogue et la navigation.
4. Modèles — des modèles OData pour les données back-end, des modèles JSON pour l'état local, des modèles de ressources pour les textes.
5. Intégration au launchpad — un target mapping ou un inbound rend l'application accessible depuis une tile ou un lien.

SAP Fiori tools génère toujours le squelette du projet, mais SAP marque désormais ses modèles SAPUI5 freestyle comme dépréciés et recommande de partir de la custom page de SAP Fiori elements pour OData V4, qui laisse toujours le contenu de la page à l'équipe. Rien dans l'interface n'est dérivé des annotations, sauf si l'équipe ajoute délibérément des building blocks. Une application SAPUI5 freestyle se définit donc par l'auteur de l'interface — l'équipe — et non par le framework qui l'exécute.

Les recommandations de SAP aux développeurs préconisent d'utiliser SAP Fiori elements autant que possible et le code freestyle autant que nécessaire. Le développement freestyle est le bon point de départ lorsqu'au moins une de ces conditions est remplie :

• l'interaction ne correspond à aucun floorplan, par exemple un écran de scan guidé ou un tableau de planification ;
• l'application doit travailler avec des sources de données qui ne sont pas des services OData annotés, ou avec des systèmes externes ;
• l'équipe a besoin d'un contrôle fin du rendu et des performances ;
• le design s'écarte délibérément des modèles standard pour un groupe d'utilisateurs spécifique.

Exemple : Alder Manufacturing souhaite que les magasiniers confirment les livraisons de Bright Freight en scannant les palettes sur une tablette, avec de grands boutons et un déroulement en une seule étape. Aucun floorplan ne convient à cette interaction ; une page freestyle se justifie donc. À l'inverse, une liste des livraisons ouvertes destinée aux superviseurs correspond à un list report. La décision de construire une application SAPUI5 freestyle doit se prendre écran par écran, et non projet par projet.

• Contrôle total du design : toute mise en page, interaction ou visualisation que les contrôles SAPUI5 peuvent exprimer est possible.
• Toute source de données : l'application peut combiner services OData, API REST et données locales sans avoir besoin d'annotations.
• Même langage visuel : comme elle utilise les contrôles et thèmes SAPUI5, une application freestyle bien conçue ressemble au reste de SAP Fiori.
• Combinable : des pages freestyle et des pages SAP Fiori elements peuvent coexister dans la même application, et les building blocks de SAP Fiori elements pour OData V4 peuvent être assemblés dans des mises en page spécifiques.
• Adaptable par d'autres : SAPUI5 flexibility prend en charge l'adaptation des applications freestyle comme des applications SAP Fiori elements, à condition que l'application active l'indicateur flexEnabled et utilise des ID de contrôle stables.

L'application SAPUI5 freestyle est l'option qui lève le plafond de ce que l'interface utilisateur peut faire.

• La responsabilité reste au client. Les recommandations de SAP placent la maintenance et la responsabilité du code des applications freestyle principalement du côté du client ou du partenaire, par rapport à SAP Fiori elements, où le framework en assume une plus grande part.
• La cohérence est une tâche de design. La conformité SAP Fiori est automatique pour les floorplans, mais doit être construite et revue pour les écrans freestyle.
• L'évolution du framework est manuelle. Les nouvelles fonctionnalités des floorplans arrivent dans les applications SAP Fiori elements via le framework ; les applications freestyle ne changent que si quelqu'un les modifie, y compris lorsque SAPUI5 déprécie des API.
• Les compétences sont spécifiques. L'équipe a besoin de compétences en développement web et sur le framework SAPUI5, et pas seulement en OData et en annotations.
• La logique peut glisser vers le navigateur. Les règles codées dans un contrôleur ne protègent pas les données écrites par d'autres canaux.

Ces limites sont le prix de la flexibilité : une application SAPUI5 freestyle coûte plus cher à maintenir en bon état sur toute sa durée de vie.

SAP décrit trois points de départ, et une même application peut combiner les trois :

L'option intermédiaire relève du flexible programming model, qui permet aux développeurs de mélanger des building blocks pilotés par les métadonnées avec leur propre code. Pour les équipes qui choisissent le freestyle par habitude, c'est souvent le meilleur compromis. Le choix entre freestyle et SAP Fiori elements est rarement tout ou rien ; le flexible programming model en fait une décision page par page.

1. Choisir le freestyle par habitude. Examinez d'abord les floorplans ; ne construisez en freestyle que là où ils ne conviennent pas.
2. Aucun responsable désigné après le go-live. Une plainte fréquente dans les communautés de praticiens concerne les applications spécifiques que personne ne maintient une fois l'équipe projet partie. Désignez un responsable avant le déploiement.
3. Développer sur une version SAPUI5 plus récente que celle de la production. Testez avec la version du serveur front-end cible.
4. Des règles métier uniquement dans le contrôleur. Conservez aussi les validations dans le service back-end.
5. Des ID de contrôle instables. SAPUI5 flexibility identifie les contrôles par des ID stables ; des ID générés compromettent donc l'adaptation par les key users et fragilisent les tests automatisés.

La plupart des problèmes des applications SAPUI5 freestyle apparaissent des mois après le go-live, c'est pourquoi la responsabilité compte autant que la qualité du code.