Connect to SAP S/4HANA

After you have finished setting up your environment, Semarchy xDI, and SAP, you can start working with SAP in xDI Designer.

Create a module

Open xDI Designer, and go to the module manager. Create a new module of type SAP S4HANA.

SAP S4HANA modules require official SAP libraries to work. Find the third-party libraries you set aside for Semarchy xDI, and add them to the module. The libraries you add depend on your operating system:

  • sapjco3.dll for Windows

  • libsapjco3.so or sapjco3.so for Linux and macOS

  • sapjco3.jar and sapidoc3.jar for all operating systems

Finish creating the module, and continue to set up metadata.

Create metadata

  1. Create or open a project in xDI Designer.

  2. From the File menu or the project folder context menu, select New > Metadata. The metadata wizard opens.

  3. In the New Metadata wizard, select SAP S4HANA, and click Next.

    connect reverse metadata

  4. Give your metadata a name, and click Next.

  5. Select the SAP S4HANA module you created previously, and Finish.

xDI Designer opens the metadata object in the background, and the server wizard dialog opens.

Reverse-engineer SAP S/4HANA data

  1. In the server wizard, in the Connection page, enter the connection properties and click Next.

    Screenshot of wizard

  2. In the Reverse page, click on the Refresh button, and wait for Designer to retrieve objects from SAP.

  3. Select the SAP S/4HANA objects that you want to reverse-engineer. You can use the following SAP S/4HANA objects in Designer:

    • Tables: classic database tables storing SAP S4HANA data.

    • IDocs: documents.

    • BAPIs/RFCs: services available to external systems for integration.

    • DataSources: read-only structured data intended for reporting purposes.

      Screenshot of properties

  4. Click Finish. The metadata is ready to use.

You can also access connection information from the metadata object properties, from its context menu.

Connecting to SAP S/4HANA may show many elements to reverse-engineer. To make your metadata object easier to navigate, only reverse-engineer the elements you plan to use. You can always add more elements later.

Next steps

When your metadata is ready, you can start using SAP in integrated flows. See the the SAP usage examples for more information.