This is documentation for Semarchy xDI 2024.4, which is no longer actively maintained.

For more information, see our Global Support and Maintenance Policy.

Set up SAP S/4HANA for Semarchy xDI

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

Import the SAP S/4HANA reference project in Designer, and locate the resources.
Install common SAP resources:
Follow further guides based on your integration flows:
- To work with tables and SQL, see the table setup documentation.
- To query DataSources, see the DataSource setup documentation.
- To process IDocs, see the IDocs setup documentation.
- To call a BAPI/RFC, make sure it is remote enabled.

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

Download resources

This SAP S/4HANA setup process references additional resource text files. You can find these in a Designer reference project, which you can import directly from within Designer.

Right click in the Project Explorer view.
Choose Import.
From the General folder, select Reference - SAP S4HANA, and continue.
Confirm the name of the reference project, and finish.

When the setup instructions mention text files, consult the files in the reference project at that time.

Create the SAP package

In SAP S/4HANA, launch transaction SE80.
Choose Package from the list, and enter ZSTB_PACKAGE in the nearby field.
Press Enter.
In the Create Object dialog box, click on Yes.
In the Software Component field, enter HOME and press Enter. The Transport Layer field can have a value or be empty.
In the request dialog box, leave the Request field unchanged. Press Enter to finish.

Create the function group

In SAP S/4HANA, launch transaction SE80.
Choose Function group from the list, and enter ZSTB_FUNCTION_GROUP in the adjacent field.
Press Enter.
In the Create Object dialog box, click on Yes.
In the Create Function Group dialog box, enter a description in the Short text field.
Click on Save.
In the Create Object Directory Entry dialog box, enter the package name ZSTB_PACKAGE.
Click on Save.
In the request dialog box, leave the Request field unchanged. Press Enter.

Create domains

Open the file ZSTB_SOURCES/ZSTB_domains.txt from the provided resource ZIP file.
Add all the domains from the DEFINITION table in the text file:
1. In SAP S/4HANA, launch transaction SE11.
2. In the Domain field, enter the domain name, such as ZSTB_SESSION_ID_DOMAIN.
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.
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.
8. Click on Save, validate the next prompt, and activate the data element.
9. Repeat these steps for any other DEFINITION entries in the ZSTB_domains.txt file.

Create types

Open the file ZSTB_SOURCES/ZSTB_types.txt from the provided resource ZIP file.
Add all the domains from the table in the text file:
1. In SAP S/4HANA, launch transaction SE11.
2. In the Data type field, enter the type name, such as ZSTB_SESSION_ID_TYPE.
3. Click on Create.
4. In the Create Type dialog box, select the Data element radio button. Click the check mark to validate.
5. In the Data Type tab, enter the corresponding domain in the Domain field, such as ZSTB_SESSION_ID_DOMAIN.
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.
8. Repeat these steps for any other entries in the ZSTB_types.txt file.

Create structures

Open the file ZSTB_SOURCES/ZSTB_structures.txt from the provided resource ZIP file.
Add all the structures from the table in the text file:
1. In SAP S/4HANA, launch transaction SE11.
2. In the Data type field, enter the structure name, such as ZSTB_TRANSFERT_STRUC.
3. Click on Create.
4. In the Create Type dialog box, select the Structure radio button. Click the check mark to validate.
5. In the Components tab, enter the corresponding component names, component types, and descriptions.
6. Fill out the element’s Short Description from the text file.
7. Open the Extra menu, and select Enhancement Category.
8. Validate the Information dialog box if it appears.
9. In the enhancement selection dialog box, select the Cannot Be Enhanced radio button.
10. Click on Save, validate the next prompt, and activate the data element.
11. Repeat these steps for any other entries in the ZSTB_structures.txt file.

Create tables

Open the file ZSTB_SOURCES/ZSTB_tables.txt from the provided resource ZIP file.
Add the structures from the table in the text file:
1. In SAP S/4HANA, launch transaction SE11.
2. In the Database table field, enter the table name, such as ZSTB_TRANSF_TBL.
3. Click on Create.
4. Validate the Information dialog box if it appears.
5. In the Delivery and Maintenance tab, set the Delivery Class to L (temporary data).
6. Click on Technical Settings on the top bar.
7. Click on Save and validate the next prompts to get to the Maintain Technical Settings screen.
8. Set the Data class to APPL1(transaction data).
9. Set the Category size to 8.
10. Click on Save and validate the next prompts to return to the previous screen.
11. In the Components tab, enter the corresponding component names, component types, and descriptions.
12. Activate the key and initial value on dedicated values.
13. Fill out the element’s Short Description from the text file.
14. Open the Extra menu, and select Enhancement Category.
15. Validate the Information dialog box if it appears.
16. In the enhancement selection dialog box, select the Cannot Be Enhanced radio button.
17. Click on Save, validate the next prompt, and activate the data element.
18. Repeat these steps for any other entries in the ZSTB_tables.txt file.