Using the SAP BW Metadata Creation Solution

Transcription

1 Using the SAP BW Metadata Creation Solution You can use the SAP BW metadata creation solution to create InfoSources, InfoObjects, and InfoPackages and start InfoPackages. To create objects in SAP BW, open the sapsolutions/bw/metadata folder on the Informatica platform installation DVD. It contains the following subfolders: Mappings Workflows SrcAndParamFiles The mappings and workflows folders contain XML files that you can import as mappings and workflows into the PowerCenter repository. Upgrade Note When you configure the PowerCenter Integration Service, set OutputMetaDataForFF to No so that the Integration Service does not output metadata for flat file targets. The mappings Folder The mappings folder includes mappings to create objects in SAP BW. The following table lists the mappings included with the SAP BW metadata creation solution: Mapping BAPI_IOBJ_CREATE_ACTIVATE.XML BAPI_ISOURCE_MD_CREATE_ACTIVATE.XML BAPI_ISOURCE_TD_CREATE_ACTIVATE.XML BAPI_IPAK_CREATE.XML BAPI_IPAK_START.XML The workflows Folder Creates and activates an InfoObject. Creates and activates an InfoSource for master data. Creates and activates an InfoSource for transaction data. Creates an InfoPackage. Starts an InfoPackage. The workflows folder includes workflows to create objects in SAP BW. The following table lists the workflows included with the SAP BW metadata creation solution: Workflow INFOOBJECT_CREATE_ACTIVATE.XML INFOSOURCE_MD_CREATE_ACTIVATE.XML INFOSOURCE_TD_CREATE_ACTIVATE.XML INFOPACKAGE_CREATE.XML Creates and activates an InfoObject. This workflow uses the BAPI_IOBJ_CREATE_ACTIVATE mapping to create the InfoObject. Creates and activates an InfoSource for master data. This workflow uses the BAPI_ISOURCE_MD_CREATE_ACTIVATE mapping to create the InfoSource. Creates and activates an InfoSource for transaction data. This workflow uses the BAPI_ISOURCE_TD_CREATE_ACTIVATE mapping to create the InfoSource. Creates an InfoPackage. This workflow uses the BAPI_IPAK_CREATE mapping to create the InfoPackage. 1 PWX-SPS

2 Workflow INFOPACKAGE_START.XML Starts an InfoPackage. This workflow uses the BAPI_IPAK_START mapping to start the InfoPackage. The SrcAndParamFiles Folder The SrcAndParamFiles folder includes support files that you use to create SAP BW metadata. These include parameter files and sample files that you use during a workflow to create SAP BW metadata. The following table lists the files included with the SAP BW metadata creation solution: File INFA_SAPBW_OBJECT_MANAGEMENT.prm BW_TABLE_METADATA.XML BAPI_IPAK_CREATE_SI.txt INFOPACKAGE_NAME.txt TriggerRow.txt Requirements to Create SAP BW Metadata Set the values for mapping parameters and connection variables you use in the SAP BW metadata creation mappings and session tasks before running a workflow. Use this file for every workflow run and set the corresponding session tasks variables in each workflow. Sample XML source file to which you export a target table. Use to specify the metadata for the InfoPackage you want to create in SAP BW. Configure this file before running the INFOPACKAGE_CREATE workflow. Use to specify the technical name of the InfoPackage you want to start. Configure this file before running the INFOPACKAGE_START workflow. The INFOSOURCE_MD_CREATE_ACTIVATE and INFOSOURCE_TD_CREATE_ACTIVATE workflows use this file to start the workflow. Do not modify this file. Before running workflows to create SAP BW metadata, complete the following tasks: Import the mappings. Import the workflows. Create a SAP BAPI/RFC connection and export the target as an XML file. Importing the Mappings Import the mappings from the sapsolutions\bw\metadata\mappings directory on the Informatica platform installation DVD into a new folder in the PowerCenter repository. Note: If you import a mapping into a folder that contains objects that exist in the mapping, the Designer prompts you to rename, replace, reuse, or compare the objects. Select Rename to rename the mapping. Importing the Workflows Import the workflows from the sapsolutions\bw\metadata\workflows directory on the Informatica platform installation DVD into a folder in the PowerCenter repository. Import the mappings before importing the workflows. You must import the workflows into the same folder as the mappings. Creating and Exporting a Target Table To create an InfoObject or InfoSource in SAP BW, create a target definition. The target definition defines the metadata for the InfoSource you want to create in SAP BW. Each column you create defines the metadata for an InfoObject you want to create in SAP BW. If you specify an InfoSource or InfoObject that already exists in SAP BW, the Integration Service does not replace or update the metadata for the InfoSource or InfoObject in SAP BW. After you define an 2 PWX-SPS

3 InfoSource or InfoObject you want to create in SAP BW, export the table to an XML file in the SrcFiles directory in the Informatica Services installation. The sapsolutions\bw\metadata\srcandparamfiles folder on the Informatica platform installation DVD includes a sample exported XML file called BW_TABLE_METADATA.XML. Running a Workflow to Create an InfoObject To create and activate an InfoObject, run the INFOOBJECT_CREATE_ACTIVATE workflow. Before you run the workflow, complete the following configuration tasks: Edit the BW_TABLE_METADATA.XML file to configure the metadata for InfoObjects. Configure the connection and mapping variables for the s_bapi_iobj_create_activate session in INFA_SAPBW_OBJECT_MANAGEMENT.prm. Configuring Mapping Parameters and Connection Variables for the BAPI_IOBJ_CREATE_ACTIVATE Mapping After you specify the exported table name, configure the mapping parameters for the BAPI_IOBJ_CREATE_ACTIVATE mapping. The mapping parameters for the BAPI_IOBJ_CREATE_ACTIVATE mapping specify the metadata for the InfoObject. Configure the mapping parameters in INFA_SAPBW_OBJECT_MANAGEMENT.prm. Place the copy of the parameter file in server\bin in the Informatica Services installation directory. You can place the file in another directory if you specify the file name and directory in the workflow or session properties. The following table lists the mapping parameters and connection variables you configure in INFA_SAPBW_OBJECT_MANAGEMENT.prm to create and activate an InfoObject: Mapping Parameter / Connection Variable [s_bapi_iobj_create_activate] $AppConnection_BW_RFC= $$ATTRIBUTEFLAG=X $$TXTTABFL=X $$TEXT_SHORT_FLAG=X $$TEXT_MEDIUM_FLAG=X $$TEXT_LONG_FLAG=X $$FIXCUKY=USD $$FIXUNIT=LB $$INFOAREA= $$APPLICATIONNAME= Required. BAPI/RFC connection name. Define an SAP BAPI/RFC connection object and enter the name here. Optional. Attribute flag that enables the Attribute Only option for the InfoObject. Enter X to enable or enter a null value to disable. Default is X. Optional. Text table flag that enables the With texts option for the InfoObject. Enter X to enable or enter a null value to disable. Default is X. Optional. Text short flag that enables the Short Text Exists option for the InfoObject. Enter X to enable or a enter value to disable. Default is X. Optional. Text medium flag that enables the Medium Text Exists option for the InfoObject. Enter X to enable or enter a null value to disable. Default is X. Optional. Text long flag that enables the Long Text Exists option for the InfoObject. Enter X to enable or enter a null value to disable. Default is X. Optional. Fixed Currency. You can change the value to any valid currency. This property is only used while creating a Key Figure InfoObject of type Amount. Default is U.S. Dollar. Required. Fixed Unit of Measure. You can change the value to any valid unit of measure. This property is only used while creating a Key Figure InfoObject of type Quantity. Default is Pounds. Optional. InfoArea. The valid InfoArea name you enter here is copied to the InfoArea of the characteristic InfoObject. Optional. Application Component. The valid Application Component name you enter here is copied to the Application Component of the characteristic InfoObject. 3 PWX-SPS

4 Running a Workflow to Create an InfoSource for Master Data To create and activate an InfoSource for master data, run the INFOSOURCE_MD_CREATE_ACTIVATE workflow. Before you run the workflow, complete the following tasks: Create the InfoObjects you want to include in the InfoSource. Edit the BW_TABLE_METADATA.XML file to configure the metadata for InfoObjects. Configure the mapping parameters and connection variables for the s_bapi_isource_md_create_activate session in INFA_SAPBW_OBJECT_MANAGEMENT.prm. Creating the InfoObjects Before you run the workflow to create an InfoSource for master data, create the InfoObjects you want to include in the InfoSource. You can include InfoObjects that you created using the SAP BW metadata creation solution. You can also use InfoObjects that you created in SAP BW. Configuring Mapping Parameters and Connection Variables for the BAPI_ISOURCE_MD_CREATE_ACTIVATE Mapping After you specify the exported table name, configure the mapping parameters for the BAPI_ISOURCE_MD_CREATE_ACTIVATE mapping. The mapping parameters specify the metadata for an InfoSource for master data. Configure the mapping parameters in INFA_SAPBW_OBJECT_MANAGEMENT.prm. Place the copy of the parameter file in server\bin in the Informatica Services installation directory. You can place the file in another directory if you specify the file name and directory in the workflow or session properties. The following table lists the mapping parameters and connection variables you configure in INFA_SAPBW_OBJECT_MANAGEMENT.prm to create and activate an InfoSource for master data: Mapping Parameter / Connection Variable [s_bapi_isource_md_create_activate] $$AppConnection_BW_RFC= $$SOURCESYSTEM= $$INFOOBJECT= $$LOADMETHOD=T $$APPLICATIONNAME= $$DELTAUPDATE=X $$RELOADABLE= $$DELTAUPDATETEXT=X $$RELOADABLETEXT= Required. BAPI/RFC connection name. Define an SAP BAPI/RFC connection object and enter the name here. Required. Name of the source system to which the Master InfoSource will be assigned. Required. Name of primary InfoObject for the Master InfoSource. Enter the name of the InfoObject that is used as the primary InfoObject for the InfoSource. Optional. Load Method. Enter T for transactional RFC or I for IDoc. Default is T. Optional. Name of Application Component. When you specify this option, the Integration Service creates the Master InfoSource under the Application Component. Otherwise, the Integration Service creates it under Unassigned nodes. Optional. Delta Update. Enter X to enable or enter a null value to disable. Default is X. Optional. Reloading Data Request is Permitted. Enter X to enable or enter a null value to disable. Default is null value. Optional. Delta Update for Texts is Supported. Enter X to enable or enter a null value to disable. Default is X. Optional. Reloading Data Request for Texts is Permitted. Enter X to enable or enter a null value to disable. Default is null value. 4 PWX-SPS

5 Running a Workflow to Create an InfoSource for Transaction Data To create and activate an InfoSource for transaction data, run the INFOSOURCE_TD_CREATE_ACTIVATE workflow. Before you run the workflow, complete the following configuration tasks: Create the InfoObjects you want to include in the InfoSource. Edit the BW_TABLE_METADATA.XML file to configure the metadata for InfoObjects. Configure the mapping parameters and connection variables for the s_bapi_isource_td_create_activate session in INFA_SAPBW_OBJECT_MANAGEMENT.prm. Creating the InfoObjects Before you run the workflow to create an InfoSource for master data, create the InfoObjects you want to include in the InfoSource. You can include InfoObjects that you created using the SAP BW metadata creation solution. You can also use InfoObjects that you created in SAP BW. Configuring Mapping Parameters and Connection Variables for the BAPI_ISOURCE_TD_CREATE_ACTIVATE Mapping After you specify the exported table name, configure the mapping parameters for the BAPI_ISOURCE_TD_CREATE_ACTIVATE mapping. The mapping parameters specify the metadata for an InfoSource for transaction data. You configure the mapping parameters in INFA_SAPBW_OBJECT_MANAGEMENT.prm. Place the copy of the parameter file in server\bin in the Informatica Services installation directory. You can place the file in another directory if you specify the file name and directory in the workflow or session properties. The following table lists the mapping parameters and connection variables you configure in INFA_SAPBW_OBJECT_MANAGEMENT.prm to create and activate an InfoSource for transaction data: Mapping Parameter / Connection Variable [s_bapi_isource_td_create_activate] $$AppConnection_BW_RFC= $$SOURCESYSTEM= $$INFOSOURCE= $$LOADMETHOD=T $$FULLUPDATE=X $$DELTAUPDATE= $$RELOADABLE= Required. BAPI/RFC connection name. Define an SAP BAPI/RFC connection object and enter the name here. Required. Name of the source system to which the Master InfoSource will be assigned. Required. Name of the Transaction InfoSource to be created. Running a Workflow to Create an InfoPackage Optional. Load Method. Enter T for transactional RFC or I for IDoc. Default is T. Optional. Full update supported. Enter X to enable or enter a null value to disable. Default is X. Optional. Delta Update. Enter X to enable or enter a null value to disable. Default is a null value. Optional. Subsequent Claim of a Data Package Supported. Enter X to enable or enter a null value to disable. Default is a null value. To create an InfoPackage in SAP BW, run the INFOPACKAGE_CREATE workflow. Before you run the workflow, complete the following configuration tasks: Configure the InfoPackage metadata in BAPI_IPAK_CREATE_SI.txt. Configure the connection variable for the s_bapi_ipak_create session in INFA_SAPBW_OBJECT_MANAGEMENT.prm. 5 PWX-SPS

6 Configuring InfoPackage Metadata in BAPI_IPAK_CREATE_SI.txt In BAPI_IPAK_CREATE_SI.txt, configure the metadata for the InfoPackage. You can use the sample file in the sapsolutions\bw\metadata\srcandparamfiles directory on the Informatica platform installation DVD as a template to create a copy of the file. The sample file includes a header row of text that specifies the properties for the InfoPackage that you need to define in the file. Do not delete the header row at the beginning of the file. Use the header row as a template to configure the metadata for the InfoPackage you want to create. You can configure multiple InfoPackages in BAPI_IPAK_CREATE_SI.txt. Place the copy of BAPI_IPAK_CREATE_SI.txt in the SrcFiles directory in the Informatica Services installation. The following table lists each property in BAPI_IPAK_CREATE_SI.txt: Property InfoSource InfoSourceType LogSys DataSource DataSourceType UpdateMasterData Text UpdateMode_Read Required. Name of the InfoSource. Required. Type of InfoSource. Enter I for Transaction InfoSource. Enter O for Master InfoSource. Required. Technical name for the SourceSystem. Required. Technical name for the DataSource that is mapped on the InfoSource. Required. Technical type for the DataSource. Enter D for transaction DataSource. Enter M for master data attributes. Enter T for master text DataSource. Required. If master data exists for the data, this property indicates whether the system only loads data. Required. Text description of InfoPackage. Required. InfoPackage processing mode. Enter F for Full Update. Enter D for Delta Update. Enter R for Repeat Update. Enter C to initialize delta procedure. Enter I to construct initial count. Configuring Connection Variable for the s_bapi_ipak_create Session After configuring the InfoPackage metadata, configure the connection variable for the s_bapi_ipak_create session. The connection variable specifies the SAP BW connection to use to create the InfoPackage. Configure the connection variable in INFA_SAPBW_OBJECT_MANAGEMENT.prm. Place the copy of the parameter file in server\bin in the Informatica Services installation directory. You can place the file in another directory if you specify the file name and directory in the workflow or session properties. The following table lists the connection variables you configure for the s_bapi_ipak_create session: Connection Variable [s_bapi_ipak_create] $$AppConnection_BW_R FC= Required. BAPI/RFC connection name. Define an SAP BAPI/RFC connection object and enter the name here. Running a Workflow to Start an InfoPackage To start an InfoPackage in SAP BW, run the INFOPACKAGE_START workflow. Before you can run the workflow, complete the following configuration tasks: Specify the InfoPackage technical name in INFOPACKAGE_NAME.txt. Configure the connection variable for the BAPI_IPAK_START mapping in INFA_SAPBW_OBJECT_MANAGEMENT.prm. Configure the 3 rd Party Selection tab for the InfoPackage in SAP BW. 6 PWX-SPS

7 Specifying InfoPackage Technical Name in INFOPACKAGE_NAME.txt In INFOPACKAGE_NAME.txt, specify the technical name for the InfoPackage you want to start. You can use the sample file in the sapsolutions\bw\metadata\srcandparamfiles directory on the Informatica platform installation DVD as a template to create a copy of INFOPACKAGE_NAME.txt. Place the copy of the file in the SrcFiles directory in the Informatica Services installation. When you create an InfoPackage using the metadata creation solution, you can find the InfoPackage technical name in the following output file TgtFiles\INFOPACKAGE_NAME1.OUT in the Informatica Services installation. You can also find the InfoPackage technical name in the InfoPackage properties in SAP BW. Configuring Connection Variable for the s_bapi_ipak_start Session After you specify the InfoPackage technical name, configure the connection variable for the s_bapi_ipak_start session. Configure the connection variable in INFA_SAPBW_OBJECT_MANAGEMENT.prm. Place the copy of the parameter file in server\bin in the Informatica Services installation directory. You can place the file in another directory if you specify the file name and directory in the workflow or session properties. The following table lists the properties you configure for the BAPI_IPAK_START mapping: Mapping Parameters [s_bapi_ipak_start] $$AppConnection_BW_RF C= Required. BAPI/RFC connection name. Define an SAP BAPI/RFC connection object and enter the name here. Configuring the 3 rd Party Selection Tab for the InfoPackage in SAP BW Before you run the workflow to start an InfoPackage, you need to configure the 3 rd Party Selection tab for the InfoPackage in SAP BW to input PowerCenter workflow and session task names. For more information about configuring the 3 rd Party Selection tab in SAP BW, see Loading Data into SAP BW in the PowerExchange for SAP NetWeaver User Guide. 7 PWX-SPS