Apr\u00e8s avoir travaill\u00e9 sur plusieurs projets SAP, j\u2019ai remarqu\u00e9 une tendance r\u00e9currente : une multitude de projets SEGW remplis de fonction imports qui sont g\u00e9n\u00e9ralement mal utilis\u00e9s ou inutiles. Fort de mon exp\u00e9rience \u2014 et apr\u00e8s avoir \u00e9tudi\u00e9 la documentation SAP \u2014 j\u2019ai d\u00e9cid\u00e9 d\u2019\u00e9crire ce blog afin de faire la lumi\u00e8re sur les fonction imports. J\u2019expliquerai ce qu\u2019ils sont, \u00e0 quoi ils servent, quand les utiliser et quand il vaut mieux les \u00e9viter. Je le ferai non seulement pour les projets SAP SEGW, mais aussi pour leurs \u00e9quivalents dans les frameworks plus r\u00e9cents que sont SAP RAP et CAP \u2014 car je m\u2019investis activement dans ces approches de d\u00e9veloppement modernes et je travaille sur des projets m\u00e9tiers qui les exploitent.
Pour rendre cela plus concret, je pr\u00e9senterai un exemple pratique, que j\u2019ai mis \u00e0 disposition sur GitHub.<\/p>\n\n\n\n
\u00c9claircissons cette confusion ensemble. Alors, attrapez votre caf\u00e9 et plongeons dans le sujet !<\/p>\n\n\n\n
Une fonction imports dans OData est un moyen de d\u00e9finir et d\u2019appeler des op\u00e9rations personnalis\u00e9es dans un service, qui vont au-del\u00e0 des actions standards de gestion des donn\u00e9es \u2014 comme la cr\u00e9ation, la lecture, la mise \u00e0 jour ou la suppression d\u2019enregistrements (CRUD). Ces actions standard sont g\u00e9n\u00e9ralement prises en charge via les m\u00e9thodes HTTP POST, GET, PUT\/MERGE et DELETE<\/p>\n\n\n\n
Cependant, si vous devez effectuer une t\u00e2che plus sp\u00e9cifique qui ne rentre pas parfaitement dans les op\u00e9rations CRUD classiques, vous pouvez cr\u00e9er un fonction imports dans votre mod\u00e8le de donn\u00e9es \u00e0 l\u2019aide de Service Builder. Ces op\u00e9rations personnalis\u00e9es peuvent ensuite \u00eatre d\u00e9clench\u00e9es via les m\u00e9thodes HTTP GET ou POST.<\/p>\n\n\n\n
Mais d\u2019abord, un petit mot de prudence : ces fonction imports sp\u00e9cifiques ne doivent \u00eatre utilis\u00e9s que pour des actions impossibles \u00e0 r\u00e9aliser avec les op\u00e9rations CRUD traditionnelles. Si la t\u00e2che peut \u00eatre accomplie via une cr\u00e9ation, lecture, mise \u00e0 jour ou suppression standard, alors une fonction imports n\u2019est pas n\u00e9cessaire.<\/p>\n\n\n\n
Voyons un exemple pour mieux comprendre.<\/p>\n\n\n\n
Op\u00e9rations CRUD de base :<\/strong><\/em><\/p>\n\n\n\n Ces op\u00e9rations couvrent les besoins fondamentaux de gestion des donn\u00e9es pour les enregistrements de vols :<\/p>\n\n\n\n Op\u00e9rations personnalis\u00e9es :<\/em><\/strong><\/p>\n\n\n\n Il s\u2019agit d\u2019op\u00e9rations sp\u00e9cifiques au m\u00e9tier, qui vont au-del\u00e0 du CRUD standard :<\/p>\n\n\n\n Les op\u00e9rations personnalis\u00e9es sont s\u00e9par\u00e9es du CRUD car elles encapsulent des comportements propres au domaine m\u00e9tier, qui ne peuvent pas \u00eatre g\u00e9r\u00e9s simplement par de la manipulation de donn\u00e9es. Cette distinction permet une architecture plus claire et plus facile \u00e0 maintenir \u2014 o\u00f9 le CRUD g\u00e8re la persistance des donn\u00e9es de base, tandis que les op\u00e9rations personnalis\u00e9es prennent en charge la logique m\u00e9tier plus fine et sp\u00e9cifique \u00e0 l\u2019application.<\/p>\n\n\n\n Voici un exemple d\u2019impl\u00e9mentation de l\u2019appel \u00e0 une fonction imports d\u00e9fini dans SEGW.<\/p>\n\n\n\n C\u00f4t\u00e9 front-end, une fonction imports est d\u00e9clench\u00e9 via une requ\u00eate OData en utilisant callFunction(), par exemple : C\u00f4t\u00e9 back-end, cela est g\u00e9r\u00e9 en red\u00e9finissant la m\u00e9thode EXECUTE_ACTION dans la classe *_DPC_EXT. Code front-end :<\/p>\n\n\n\n Code back-end : Les fonction imports sont un outil puissant, mais comme tout outil, ils doivent \u00eatre utilis\u00e9s avec discernement. Dans SEGW, il est pr\u00e9f\u00e9rable de les r\u00e9server aux op\u00e9rations qui ne s\u2019int\u00e8grent pas naturellement dans le CRUD. Un mauvais usage peut entra\u00eener des services surcharg\u00e9s, peu clairs, et inutilement complexes.<\/p>\n\n\n\n Dans la prochaine partie de cette s\u00e9rie, j\u2019explorerai comment des cas d\u2019usage similaires sont g\u00e9r\u00e9s dans RAP et CAP \u2014 avec un projet GitHub pour illustrer tout cela en pratique.<\/p>\n\n\n\n <\/p>\n","protected":false},"excerpt":{"rendered":" Apr\u00e8s avoir travaill\u00e9 sur plusieurs projets SAP, j\u2019ai remarqu\u00e9 une tendance r\u00e9currente : une multitude…<\/p>\n","protected":false},"author":6,"featured_media":8428,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[42],"tags":[85,84,86,89,54,88,87,44],"class_list":{"0":"post-8424","1":"post","2":"type-post","3":"status-publish","4":"format-standard","5":"has-post-thumbnail","7":"category-sap-fiori","8":"tag-actions","9":"tag-function-imports","10":"tag-functions","11":"tag-sap-cap","12":"tag-sap-fiori","13":"tag-sap-rap","14":"tag-sap-segw","15":"tag-sapui5"},"yoast_head":"\n\n
\n
Alors que les op\u00e9rations CRUD se concentrent sur la cr\u00e9ation, la lecture, la mise \u00e0 jour ou la suppression d\u2019enregistrements, les actions personnalis\u00e9es r\u00e9alisent souvent des calculs, d\u00e9clenchent des workflows ou appliquent des r\u00e8gles m\u00e9tier sur plusieurs entit\u00e9s.<\/p>\n\n\n\nExemple d\u2019impl\u00e9mentation<\/h2>\n\n\n\n
\/sap\/opu\/odata\/SERVICE_NAME\/FunctionImportName(\u2026)<\/p>\n\n\n\n
Dans cette m\u00e9thode, le param\u00e8tre iv_action_name permet d\u2019identifier la fonction sp\u00e9cifique appel\u00e9e. Les param\u00e8tres d\u2019entr\u00e9e sont accessibles via la table it_parameter, et la logique m\u00e9tier correspondante est alors impl\u00e9ment\u00e9e en cons\u00e9quence.<\/p>\n\n\n\nlet oModel = this.getView().getModel();\nlet mParameters = {\n FlightID: \"12345\"\n};\n\noModel.callFunction(\"\/PrintFlightDetails\", {\n method: \"POST\",\n urlParameters: mParameters,\n success: function(oData, response) {\n MessageToast.show(oData.Message);\n },\n error: function(oError) {\n MessageToast.show(\"Error printing flight details\");\n }\n});<\/code><\/pre>\n\n\n\n
(En supposant que nous avons pr\u00e9alablement d\u00e9fini la fonction imports dans le projet SEGW, ainsi qu\u2019une classe ABAP orient\u00e9e objet pour g\u00e9rer l\u2019objet m\u00e9tier Flight)<\/p>\n\n\n\nMETHOD execute_action.\n \n \" Check if the action name is 'PrintFlightDetails'\n IF iv_action_name = 'PrintFlightDetails'.\n \" Retrieve input parameter\n READ TABLE it_parameter INTO DATA(ls_parameter) WITH KEY name = 'FlightID'.\n IF sy-subrc = 0.\n DATA(lv_flightid) = ls_parameter-value.\n ELSE.\n \" Manage error\n ENDIF.\n\n \" Instantiate the flight manager class\n DATA(lo_flight) = NEW zcl_flight( lv_flightid ).\n\n \" Call the method to update the flight status\n DATA(lv_message) = lo_flight->print_flight_details( ).\n\n ...\n\n ENDIF.\nENDMETHOD.<\/code><\/pre>\n\n\n\nConclusion<\/h2>\n\n\n\n