Set up SAP for Semarchy xDI

To use SAP with Semarchy xDI, you must configure the SAP server to enable connections between the two. The overview of this process is as follows:

When you finish configuring SAP, proceed to creating SAP metadata and reverse-engineering your data.

Download resources

This SAP setup process references additional resource text files. You can find these in a resources ZIP file, which you can download from the Semarchy website at this link. Download and extract the ZIP file to a location of your choice.

When following the setup instructions, several steps reference files from the archive. Consult the resource files and their content at that time.

Create the SAP package

  1. In SAP, launch transaction SE80.

  2. Choose Package from the list, and enter ZSTB_PACKAGE in the nearby field.

    Screenshot of setup procedure

  3. Press Enter.

  4. In the Create Object dialog box, click on Yes.

    Screenshot of setup procedure

  5. In the Software Component field, enter HOME and press Enter. The Transport Layer field can have a value or be empty.

    Screenshot of setup procedure

  6. In the request dialog box, leave the Request field unchanged. Press Enter to finish.

    Screenshot of setup procedure

Create the function group

  1. In SAP, launch transaction SE80.

  2. Choose Function group from the list, and enter ZSTB_FUNCTION_GROUP in the adjacent field.

    Screenshot of setup procedure

  3. Press Enter.

  4. In the Create Object dialog box, click on Yes.

    Screenshot of setup procedure

  5. In the Create Function Group dialog box, enter a description in the Short text field.

    Screenshot of setup procedure

  6. Click on Save.

  7. In the Create Object Directory Entry dialog box, enter the package name ZSTB_PACKAGE.

    Screenshot of setup procedure

  8. Click on Save.

  9. In the request dialog box, leave the Request field unchanged. Press Enter.

    Screenshot of setup procedure

Create domains

  1. Open the file ZSTB_SOURCES/ZSTB_domains.txt from the provided resource ZIP file.

  2. Add all the domains from the DEFINITION table in the text file:

    1. In SAP, launch transaction SE11.

    2. In the Domain field, enter the domain name, such as ZSTB_SESSION_ID_DOMAIN.

      Screenshot of setup procedure

    3. Click on Create.

    4. Go to the Definition tab.

    5. Enter the Data Type and the number of characters from the text file, such as CHAR and 32.

      Screenshot of setup procedure

    6. Fill out the element’s Short Description from the text file.

    7. If the domain is also listed in the VALUE RANGE table in the text file, follow these steps:

      1. Go to the Value Range tab.

      2. Add an entry for each corresponding line in the text file VALUE RANGE table. Enter the single character value in the SAP Fixed column.

      3. Add entry descriptions.

        Screenshot of setup procedure

    8. Click on Save, validate the next prompt, and activate the data element.

      Screenshot of setup procedure

      Screenshot of setup procedure

      Screenshot of setup procedure

    9. Repeat these steps for any other DEFINITION entries in the ZSTB_domains.txt file.

Create types

  1. Open the file ZSTB_SOURCES/ZSTB_types.txt from the provided resource ZIP file.

  2. Add all the domains from the table in the text file:

    1. In SAP, launch transaction SE11.

    2. In the Data type field, enter the type name, such as ZSTB_SESSION_ID_TYPE.

      Screenshot of setup procedure

    3. Click on Create.

    4. In the Create Type dialog box, select the Data element radio button. Click the check mark to validate.

      Screenshot of setup procedure

    5. In the Data Type tab, enter the corresponding domain in the Domain field, such as ZSTB_SESSION_ID_DOMAIN.

      Screenshot of setup procedure

    6. Fill out the element’s Short Description from the text file.

    7. Click on Save, validate the next prompt, and activate the data element. Do not fill out any field labels in the Field Label tab.

      Screenshot of setup procedure

      Screenshot of setup procedure

      Screenshot of setup procedure

      Screenshot of setup procedure

      Screenshot of setup procedure

    8. Repeat these steps for any other entries in the ZSTB_types.txt file.

Create structures

  1. Open the file ZSTB_SOURCES/ZSTB_structures.txt from the provided resource ZIP file.

  2. Add all the structures from the table in the text file:

    1. In SAP, launch transaction SE11.

    2. In the Data type field, enter the structure name, such as ZSTB_TRANSFERT_STRUC.

      Screenshot of setup procedure

    3. Click on Create.

    4. In the Create Type dialog box, select the Structure radio button. Click the check mark to validate.

      Screenshot of setup procedure

    5. In the Components tab, enter the corresponding component names, component types, and descriptions.

      Screenshot of setup procedure

    6. Fill out the element’s Short Description from the text file.

    7. Open the Extra menu, and select Enhancement Category.

      Screenshot of setup procedure

    8. Validate the Information dialog box if it appears.

      Screenshot of setup procedure

    9. In the enhancement selection dialog box, select the Cannot Be Enhanced radio button.

      Screenshot of setup procedure

    10. Click on Save, validate the next prompt, and activate the data element.

      Screenshot of setup procedure

      Screenshot of setup procedure

      Screenshot of setup procedure

    11. Repeat these steps for any other entries in the ZSTB_structures.txt file.

Create tables

  1. Open the file ZSTB_SOURCES/ZSTB_tables.txt from the provided resource ZIP file.

  2. Add the structures from the table in the text file:

    1. In SAP, launch transaction SE11.

    2. In the Database table field, enter the table name, such as ZSTB_TRANSF_TBL.

      Screenshot of setup procedure

    3. Click on Create.

    4. Validate the Information dialog box if it appears.

      Screenshot of setup procedure

    5. In the Delivery and Maintenance tab, set the Delivery Class to L (temporary data).

      Screenshot of setup procedure

    6. Click on Technical Settings on the top bar.

      Screenshot of setup procedure

    7. Click on Save and validate the next prompts to get to the Maintain Technical Settings screen.

      Screenshot of setup procedure

      Screenshot of setup procedure

      Screenshot of setup procedure

    8. Set the Data class to APPL1(transaction data).

    9. Set the Category size to 8.

      Screenshot of setup procedure

    10. Click on Save and validate the next prompts to return to the previous screen.

      Screenshot of setup procedure

    11. In the Components tab, enter the corresponding component names, component types, and descriptions.

    12. Activate the key and initial value on dedicated values.

      Screenshot of setup procedure

    13. Fill out the element’s Short Description from the text file.

    14. Open the Extra menu, and select Enhancement Category.

      Screenshot of setup procedure

    15. Validate the Information dialog box if it appears.

      Screenshot of setup procedure

    16. In the enhancement selection dialog box, select the Cannot Be Enhanced radio button.

      Screenshot of setup procedure

    17. Click on Save, validate the next prompt, and activate the data element.

      Screenshot of setup procedure

    18. Repeat these steps for any other entries in the ZSTB_tables.txt file.

Create common function modules

Open these text files from the provided resource ZIP file:

  • ZSTB_SOURCES/ZSTB_INSERT_TRANSF_TBL.txt

  • ZSTB_SOURCES/ZSTB_RFC_SQL_DELETE.txt

  • ZSTB_SOURCES/ZSTB_RFC_SQL_FETCH.txt

Open the article about adding function modules. Follow those instructions, once per text file, to create three corresponding modules.

Configure SAP for different elements

See the following pages according to your data integration needs:

Next steps

When you finish the SAP setup process, continue to xDI Designer and connect to your data.