Extraction to Non-SAP Systems

Transcription

1 ... Extraction to Non-SAP Systems Use You can use the open hub service to extract data to non-sap systems. Various APIs allow you to connect a third-party tool (such as Ascential) to the BW system and then to distribute the data to other non-sap systems. Features You first extract the data from data targets in BW to a database table in the BW system. The third-party tool receives a message when the extraction process is complete. You can define parameters for the third-party tool. You can also use the monitor to oversee the process. Using a process chain, you can start the extraction process either in the BW system itself or from the third-party tool. The Following APIs Are Available: RSB_API_OHS_DEST_SETPARAMS: With this API, the parameters from the third-party tool that are required for the extraction are transferred to the BW system. These parameters are saved in a parameter table within the BW system in the metadata for the open hub. RSB_API_OHS_3RDPARTY_NOTIFY: This API sends a message to the third-party tool after extraction. It transfers the open hub, the request ID, the name of the database table, the number of extracted data records and the time stamp. In addition, you can add another parameter table that contains the parameters that are only relevant for the third-party tool. RSB_API_OHS_REQUEST_SETSTATUS: This API sets the status of extraction to the third-party tool in the open hub monitor. Red means that the existing table is not being overwritten. If the status is green, the request is processed further. RSB_API_OHS_DEST_GETLIST: This API delivers a list of all open hub s. RSB_API_OHS_DEST_GETDETAIL: This API determines the details of an open hub. RSB_API_OHS_DEST_READ_DATA: This API reads data from the database table in the BW system. Optional: RSB_API_OHS_SPOKE_GETLIST: This API supplies a list of all InfoSpokes. RSB_API_OHS_SPOKE_GETDETAIL: This API determines the details of an InfoSpoke. In the next BW Release the InfoSpoke will no longer be used. The open hub will remain. For more information about the parameters, see: API: RSB_API_OHS_DEST_SETPARAMS API: RSB_API_OHS_3RDPARTY_NOTIFY API: RSB_API_OHS_REQUEST_SETSTATUS API: RSB_API_OHS_DEST_GETLIST API: RSB_API_OHS_DEST_GETDETAIL API: RSB_API_OHS_DEST_READ_DATA API: RSB_API_OHS_SPOKE_GETLIST API: RSB_API_OHS_SPOKE_GETDETAIL Process Flow: Extraction to the third-party tool can be executed as follows:

2 1. You define an InfoSpoke with type DB Table and Notification to Third-Party Tools. 2. You create an RFC for your third-party tool and enter it in the definition of the open hub. 3. You use API RSB_API_OHS_DEST_SETPARAMS to define the parameters for the third-party tool that are required for the extraction. 4. You can use the InfoSpoke either to start the extraction directly or include it in a process chain. You can also start this process chain from the third-party tool using process chain API RSPC_API_CHAIN_START. The extraction process then writes the data to a database table in the BW system. 5. When the extraction process is finished, the system sends a notification to the thirdparty tool via API RSB_API_OHS_3RDPARTY_NOTIFY. 6. The third-party tool reads the data from the database table. Afterwards it transfers the status of the extraction to the monitor using API RSB_API_OHS_DEST_SETSTATUS.

3 API: RSB_API_OHS_DEST_SETPARAMS You use this API to transfer the parameters of the third-party tool that are required to extract data to the BI system. These parameters are saved in a parameter table within the BI system in the metadata for the open hub. Import OHDEST RSOHDEST Name of the open hub 3RDPARTYSYSTEM LOGSYS Third-party system (logical system) EXTEND RS_BOOL Extending the parameter Export RETURN BAPIRET2 Tables PARAMETERS BAPI6107PA Parameter table EXTEND: If the value is true, new parameters are added to the existing parameters. If the value is false, the existing parameters are deleted and the new parameters are inserted. The default setting is false. The PARAMETERS table contains all the parameters required by the third-party system and saves these parameters in the metadata of the open hub. When extraction is finished, these parameter are sent to the third-party system (3RDPARTYSYSTEM) using API RSB_API_OHS_DEST_SEND_NOTIFICATION.

4 API: RSB_API_OHS_3RDPARTY_NOTIFY This API sends a message to the third-party tool after extraction. It transfers the open hub, the request ID, the name of the database table, the number of extracted data records and the time stamp. In addition, you can add another parameter table that contains the parameters that are only relevant for the third-party tool. Import OHDEST RSOHDEST Name of the open hub REQUESTID RSBREQUIDOUT Request ID NUMB_OF_PACKETS I Number of packages extracted DBTABNAME RSBTABNAME Name of DB table DBRECORDS SYTABIX Number of records extracted TIMESTAMP BAPIBP_TIMESTAMP Time stamp of extraction (request) Export RETURN BAPIRET2 Tables PARAMETERS BAPI6107PA Parameter table Exceptions COMMUNICATION_FAILURE SYSTEM_FAILURE

5 API: RSB_API_OHS_REQUEST_SETSTATUS This API sets the status of extraction to the third-party tool in the monitor. If the status is green, the request is processed further. Red means that the existing table is not being overwritten. The third-party tool sets the status to red when there is a processing error in the third-party system. This ensures that the existing data is not overwritten until the error has been corrected. The status is written to table RSBREQUID3RD. The following diagram shows how the status entry is processed: The OHD state is the status of extraction to the BI system; it is dependent on the status of the third-party tool. This status is set by the third-party tool. STOP means that the request has not been started. The BI system waits until the status of the third-party tool is set to green. Only then does it start extraction. Import REQUESTID RSBREQUIDOUT Request ID STATUS RSBSTAT3RD Status of processes in third-party tool; G = Green, R = Red MESSAGE BAPI_MSG Message for the monitor. This text can contain 220 characters, however only 200 characters are displayed in the

6 Export RETURN BAPIRET2 monitor.

7 API: RSB_API_OHS_DEST_GETLIST This API delivers a list of all open hub s. Import OHDEST RSOHDEST Name of the open hub DESTTYPE RSDESTTYPE Type of : TAB = DB table TAB3 = Third-party tool FILE = flat file Export RETURN BAPIRET2 Tables DEST_TAB RSBOHDESTS List of open hub s Table DEST_TAB contains all the s that the import parameter accesses.

8 API: RSB_API_OHS_DEST_GETDETAIL This API identifies the details of an open hub. The target system gets the structure and the table with the metadata of the open hub. This API is used at design time and in the runtime. Import OHDEST RSOHDEST Name of the open hub SKIP_TECKEY RS_BOOL Skips technical key in the target structure Export RFCINFOSPOKE RSINFOSPOKE Name of the InfoSpoke RFCUPDATEMETHOD RSBUPDMODE Extraction mode for the InfoSpoke RFCDATABASETABLENAME RSBTABNAME Name of DB table RFCPROCESSCHAIN RSPC_CHAIN Process chain RFCDESTYPE RSDESTTYPE Type of open hub RFCTLOGOSRC RSTLOGOSRC TLOGO type of data source RETURN BAPIRET2 Tables DBTAB_STRUCTURE BAPI6118DALO Structure of the DB table of the open hub PARAMETERS BAPI6107PA Parameter table of thirdparty tool T_MESSAGES BAPIRETTAB Messages

9 API: RSB_API_OHS_DEST_READ_DATA This API reads data from the database table in the BI system. Import OHDEST RSOHDEST Name of the open hub REQUESTID RSBREQUIDOUT Request ID PACKETID I Number of data packages that are read SKIP_TECKEY RS_BOOL Skips technical key in the target structure (layout structure) Export NUMROWS BAPI6116XX- NUMROWS Number of rows LINES_PER_RECORD BAPI6116XX- NUMROWS Number NUMB_OF_PACKETS I Number of packages for this request in the DB table RETURN BAPIRET2 Tables DATALAYOUT BAPI6118DALO Layout of records RESULTDATA BAPI6116DA Data records with FOLLOW indicator

10 API: RSB_API_OHS_SPOKE_GETDETAIL This API identifies the InfoSpoke details. Import INFOSPOKE RSINFOSPOKE Name of the InfoSpoke Export RFCOHDEST RSOHDEST Name of the open hub RFCUPDATEMETHOD RSBUPDMODE Extraction mode for the InfoSpoke RFCPROCESSCHAIN RSPC_CHAIN Process chain RFCOHSOURCE RSOHSOURCE Open hub data source RFCTLOGOSRC RSTLOGOSRC TLOGO type of data source RFCMAXPACKSIZE RSIDOCSIZE Maximum number of records per package RETURN BAPIRET2 Tables T_MESSAGES BAPIRETTAB Messages

11 API: RSB_API_OHS_SPOKE_GETLIST This API returns a list of all InfoSpokes. Import INFOSPOKE RSINFOSPOKE Name of the InfoSpoke Export RETURN BAPIRET2 Tables SPOKE_TAB RSBO_S_SPOKE List of InfoSpokes