Planning function on BPC hana system
0 likes440 views
This document discusses implementing customer planning logic in SQL script procedures running in the HANA layer for SAP PAK planning functions. The SQL procedures can be called by implementing specific interfaces and have input and output tables matching the aggregation level structure. Parameters are passed to the procedure which executes and returns results by aggregating values in the output table to the original inputs. An example implementation of the interface and calling method is provided.
Planning function on BPC hana system
- 1. SQL-Script based Customer Exit for PAK Planning Functions on HANA. Customers can implement own planning functionality by creating own planning function types and assigning their own class to this planning function type. Such a class has to implement some interfaces. Starting from NW730 SP10 it is possible to implement customer planning logic in own SQL script procedures which run in the HANA layer. Such procedures can be called by implementing the Method TREX_EXECUTE in one of the following interfaces: IF_RSPLFA_SRVTYPE_TREX_EXEC IF_RSPLFA_SRVTYPE_TREX_EXEC_R IF_RSPLFA_SRVTYPE_IMP_EXEC has to be implemented if no reference data shall be used IF_RSPLFA_SRVTYPE_TREX_EXEC_R has to be implemented I reference data shall be available during execution. With NW740 once can also use ABAP managed database procedures to create SQL-Script. Parameters for the SQL script procedure The SQL script procedure must have an IN and an OUT table which have the structure of the aggregation level. The procedure might have an additional table (with the same structure) which contains the reference data (in case the interface IF_RSPLFA_SRVTYPE_TREX_EXEC_R was implemented). Further the procedure might contain elementary IN parameters. Infrastructure to Call SQL Script procedure The SQL-script-procedure is called via the interface method: if_rspls_sql_script->execute_sql_script. This method has the following parameters: I_VIEW Type Set to: i_view - importing parameter of method TREX_EXECUTE I_VIEW_REF Type Set to: i_view_ref - importing parameter of method TREX_EXECUTE; in case you implement IF_RSPLFA_SRVTYPE_TREX_EXEC_R I_T_IOBJ_PARAM Type Each line in this table represents a parameter of the SQL-script procedure. The fields are: NAME Name of parameters IOBJNM Info object (which defines the type of the parameter) VALUE value of the parameters I_PROC_NAME Type SQL-Script-procedure name I_R_MSG Type Ref To Set to: I_R_MSG - importing parameter of method TREX_EXECUTE R_RESULT_VIEW Type Move the value of the returning parameter to r_s_view-view An example how the method if_rsplfa_srvtype_trex_exec_r~trex_execute might be implemented can look like this:
- 2. METHOD if_rsplfa_srvtype_trex_exec_r~trex_execute. DATA: l_r_sql_script TYPE REF TO if_rspls_sql_script, l_procedure_name TYPE string, l_srvtypenm TYPE rsplf_srvtypenm, l_t_iobj_param TYPE if_rsr_pe_adapter=>tn_t_iobj_param. l_r_sql_script = cl_rspls_session_store_manager=>get_sql_script_instance( i_r_store = i_r_ store ). * The method if_rspls_sql_script~get_parameter_values returns a table of parameters * with the values given in the function definition l_r_sql_script->get_parameter_values( EXPORTING i_r_param_set = i_r_param_set i_para_name_for_procedure = 'HANA_PROCEDURE_NAME' IMPORTING e_procedure_name = l_procedure_name e_t_iobj_param = l_t_iobj_param ). * The function parameter given mehtod paramenter i_para_name_for_procedure * will not be returned in the table e_t_iobj_param but the value of this * function parameter will be returned int the mehtod parameter e_procedure_name * This mechanisme can e.g. be used to define function specific HANA-procedure names. * Other examples to get the name of the HANA-procedure name which will be called can be * - you use the technical name of the planning function type: l_srvtypenm = p_r_srv->get_srvtypenm( ). l_procedure_name = l_srvtypenm. * - or you simply give the HANA procedure name in a string: l_procedure_name = 'MY_HANA_PROCEDURE'. r_s_view-view = l_r_sql_script->execute_sql_script( i_view = i_view i_view_ref = i_view_ref i_t_iobj_param = l_t_iobj_param i_proc_name = l_procedure_name i_r_msg = i_r_msg ). ENDMETHOD. "IF_RSPLFA_SRVTYPE_TREX_EXEC_R~TREX_EXECUTE Example for an implementation to call SQL script procedure This example can be found in report RSPLS_SQL_SCRIPT_TOOL (please keep in mind that you have to implement a public class in order to be able to assign the class to the planning function type in transaction RSPLF1). Blocking Blocking has to be considered in the SQL script procedure itself. Result table The result table is treated as delta. So the values from the result table are aggregated to the original values. This behavior is different from the behavior of the result table in the ABAP-Exit. Tool Report With the tool report RSPLS_SQL_SCRIPT_TOOL you can create the following Object on HANA A table with the structure corresponding to the aggregation level. This table can be used to give the type of the table parameters in your SQL script procedure
- 3. A body of the SQL script procedure. This procedure body contains the table parameters by which data (on which the procedure shall operate) is passed and the returning table with the procedure result. Additionally the elementary parameters from the function are listed with the corresponding types. Transportation of these objects between systems In NetWeaver 7.30 and NetWeaever 7.31 you need to take care of transporting HANA Objects by your own. With NetWeaver 7.4 onwards one can leverage ABAP managed database procedures to transport them with other ABAP or BW objects using transport management system (transaction STMS)