Installing the Components for mySAP ERP

This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This page may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

The ERP Connector for Microsoft Office Project Server 2007 requires that you create modules to export data from mySAP™ ERP Human Capital Management (HCM) and from the mySAP ERP Financials CO and PS subsystems for internal orders and project/task accounting. If you implement the work breakdown structure (WBS)–level integration for finance, you also need to create an import module that processes the WBS data (work actuals) from Project Server.

Important
Review the requirements with your mySAP ERP Financials business specialist before you install any components. In almost all cases, you need to modify the actuals import module before you install it on the mySAP ERP Financials system.

To create and install the mySAP ERP modules, you perform the following procedures:

1. Creating a Development Class and Function Group

2. Creating the Project Export Module

3. Creating the Human Resources Export Module

4. Creating the Actuals Import Module

5. Testing the mySAP ERP Modules

If you plan to install only the HR module for ERP Connector, you do not need the project export module or the actuals import module. When you install the ERP Connector on Project Server, the ERP Connector 2007.msi installer creates the [Program Files]\ERP Connector Solution Starter\src\SapSystem directory and includes in it the source code for the mySAP ERP modules. You can also get the source code directly from the computer where you install the Project 2007 SDK download. The default path to the directory for the installed SDK is C:\2007 Office System Developer Resources\Project 2007 SDK\Code Samples\ERPConnector\src\SapSystem.

Note
You can find installation hints for the mySAP ERP modules in the files named install_hints_e.txt (English) and install_hints_d.txt (German), located in the SapSystem directory.

Creating a Development Class and Function Group

Procedure 1. To create a development class and function group

1. Log on to mySAP ERP.

2. In the toolbar box, type the transaction se80 to go to the Development Workbench by using the Object Navigator (Figure 1). To open the Object Selection dialog box, click Edit object, and then click the More tab.

   Figure 1. Creating a development class

   

3. Type the name of the development class, for this example type ZTPG, and then press the F5 key. In the Create Development Class dialog box, type a short description, and then select a transport layer. If no transport layer is available, press F8 to create one (Figure 2). Type values in the other fields, and then save the settings.

   Figure 2. Creating a transport layer for the development class

   

4. Create a function group. Type transaction se80 in the toolbar text box, and then click Edit object in the Object Navigator. In the Object Selection dialog box, click the Function group tab. Type a function group name, and then press F5 (Figure 3).

   Figure 3. Creating a function group

   

Creating the Project Export Module

Use Table 1 to find the data values that you type in Procedure 2, Step 3.

Table 1. Data for the import parameters of the project export module

Parameter name	Type	Reference type	Opt.	Pa.	Short text
I_ORDERID	LIKE	BAPI2075_2-ORDER OPTIONAL	Checked	Checked	Instruction number
I_PROJECT	LIKE	BAPIPR-PROJECT_DEFINITION OPTIONAL	Checked	Checked	Project definition
I_FILENAME	TYPE	STRING	Unchecked	Checked

Procedure 2. To create the project export module

1. Type transaction se80 in the toolbar text box. In the Object Navigator, click Edit object. To create the function module, type the module name Z_TPG_PROJECT_GETINFO_XML, as shown in Figure 4.

   Figure 4. Creating a function module

   

2. On the Attributes tab of the Function module, click Remote-enabled module, and then click Start (Figure 5).

   Figure 5. Setting the function module processing type

   

3. On the Import tab, type the import parameter names and values for the parameter fields, using the data shown in Table 1 and Figure 6.

   Figure 6. Creating the import parameters

   

4. Click the Source code tab. Copy the source code from the file z_tpg_project_getinfo_xml.txt into the source code editor pane.

   Note
   The source code shown in Figure 7 differs slightly from the code in the file. The file is correct.

   Figure 7. Source code for the project export function

   

5. Edit the top include ABAP script. To display the object list, press CTRL+SHIFT+F5. In the Object name column, expand the Includes folder, and then click LYTPGTOP. Copy the code from the LYTPGTOP.txt file into the source code editor pane (Figure 8).

   Figure 8. Editing the top include ABAP script

   

6. Double-click Function modules. Click the Goto menu, and then click Main program. Change the line:

   * INCLUDE LYTPGF...               " Subprograms
   

   To be the following:

   INCLUDE LYTPGF99.
   

   In Figure 9, the entry depends on the name of the function module. Double-click the marked section, and then click Yes.

   Figure 9. Including the LYTPGF99 global routine

   

7. In the Includes folder, click LYTPGF99 and then edit the source code. Copy the code from the LYTPGF99.txt file into the source code editor pane (Figure 10).

   Figure 10. Editing the LYTPGF99 global routine

   

Creating the Human Resources Export Module

Use Table 2 to find the data values that you type in Procedure 3, Step 3.

Table 2. Data for the import parameters of the HR export module

Parameter name	Type	Reference type	Opt.	Pa.	Short text
I_COSTCENTER	LIKE	BAPIEMPLB-COSTCENTER DEFAILT	Unchecked	Checked	Cost center
I_FILENAME	TYPE	STRING	Unchecked	Checked

Procedure 3. To create the HR export module

1. Type transaction se80 in the toolbar text box. In the Object Navigator, click Editobject, and then click the Function group tab in the Object Selection dialog box. To create the HR function module, type the module name Z_TPG_EMPLOYEE_ORGUNIT_XML, as shown in Figure 11.

   Figure 11. Creating the HR function module

   

2. On the Attributes tab of the Function module, click Remote-enabled module, and then click Start (Figure 12).

   Figure 12. Setting the HR function module processing type

   

3. On the Import tab, type the import parameter names and values for the parameter fields, using the data shown in Table 2 and Figure 13.

   Figure 13. Creating the HR import parameters

   

4. Click the Source code tab. Copy the source code from the z_tpg_employee_orgunit_xml.txt file into the source code editor pane.

   Note
   The source code shown in Figure 14 differs slightly from the code in the file. The file is correct.

   Figure 14. Source code for the HR import function

   

5. Press CTRL+F3 to generate the HR module from the ABAP™ code.

Creating the Actuals Import Module

You need to revise the function module so that it uses your own messages, and then create a message class. ABAP code in the z_tpg_update_cat2.txt file includes comments such as the following:

*   message - Error during upload of file

Delete the comment symbol at the beginning of the lines that start with "* message" and add your own messages.

Use Table 3 to find the data values that you type in Procedure 4, Step 3.

Table 3. Data for the import parameters of the HR export module

Parameter name	Type	Reference type	Opt.	Pa.	Short text
I_FILENAME	TYPE	RLGRAP	Unchecked	Checked

Procedure 4. To create the actuals import module

1. Type transaction se80 in the toolbar text box. In the Object Navigator, click Edit object. To create the function module, type the module name Z_TPG_UPDATE_CAT2.

2. On the Attributes tab of the Functionmodule, click Remote-enabled module, and then click Start.

3. On the Import tab, type the import parameter name and values for the parameter fields, using the data shown in Table 3 and Figure 15.

   Figure 15. Creating the actuals import parameter

   

4. Click the Source code tab. Copy the source code from the z_tpg_update_CAT2.txt file into the source code editor pane (Figure 16).

   Figure 16. Source code for the actuals import function

   

5. Press CTRL+F3 to generate the actuals import module from the ABAP code.

Testing the mySAP ERP Modules

Procedure 5. To test the modules

1. Type transaction se80 in the toolbar text box. In the Object Navigator, expand Function modules, right-click the module you want to test, and then click Test (Figure 17).

   Figure 17. Selecting Test on the shortcut menu

   

2. If you created the human resources (HR) module, test module Z_TPG_EMPLOYEE_ORGUNIT_XML. Type a sample cost center and name of the file to export, as shown in Figure 18, and then press F8 to execute the function.

   Figure 18. Testing the HR module

   

3. If you created the project export module, test module Z_TPG_PROJECT_GETINFO_XML. Type a sample ORDER ID, PROJECT ID, and name of the file to export, as shown in Figure 19, and then press F8 to execute the function.

   Figure 19. Testing the project export module

   

4. If you created the actuals import module, test module Z_TPG_UPDATE_CAT2, as shown in Figure 20. Press F8 to execute the function.

   Figure 20. Testing the actuals import module

   

See Also

Concepts

ERP Connector Solution Starter for Project Server 2007

Installing the ERP Connector on Project Server