UiPath Documentation
process-mining
latest
false
Process Mining user guide

Setting up Theobald Xtract Universal

Theobald Xtract Universal installation, update, and configuration reference for use with Process Mining in Automation Cloud.

Tip:

Refer to the official Theobald Software documentation for more information on installing and updating Theobald Xtract Universal and customizing the function module for table extraction in SAP.

Theobald Xtract Universal is the SAP certified extraction tool used for data extraction from SAP source systems, integrating with SAP through Remote Function Calls (RFC). Theobald Xtract Universal uses the read-only custom function module /THEO/READ_TABLE, which is installed in SAP.

Important:

/THEO/READ_TABLE is the current custom function module. It replaces Z_THEO_READ_TABLE, which Theobald has deprecated. Use /THEO/READ_TABLE for new installations; to migrate an existing setup, remove the old module as described in step 4.

The /THEO/READ_TABLE transport ships with Theobald Xtract Universal. In your Xtract Universal installation directory, open the ABAP\Table folder and choose the transport that matches your system's SAP_ABA version:

  • THEO_READ_TABLE_740SP08.zip — for SAP_ABA 7.40 SP08 and higher (Unicode systems).
  • THEO_READ_TABLE_46C.zip — for SAP_ABA 4.6C and higher (Unicode and non-Unicode systems).
Note:

Because the transport is included with your Xtract Universal download, it always matches your installed version. You can also download it from the Theobald Customer Portal.

Follow these steps to set up Theobald Xtract Universal.

  1. Download the latest trial version of Theobald Xtract Universal from our website, check out Download Trial Version. Install Theobald Xtract Universal on a Windows Server / Virtual Machine.
  2. On the server where Theobald Xtract Universal is installed, check if the network access to your SAP system is open, check out SAP TCP/IP Ports.
  3. Grant SAP user rights to access the SAP instance.
    Important:

    Use the SAP profile for Table. Check out Authority Objects - SAP User Rights for Table. Make sure that the user has Display access for the process-specific tables of the app template that are used for extraction.

  4. Add the /THEO/READ_TABLE function module in SAP using the SAP transport file.
    Note:

    /THEO/READ_TABLE uses a separate namespace, so it runs alongside the older Z_THEO_READ_TABLE module. When upgrading from Z_THEO_READ_TABLE, Theobald recommends removing the deprecated module: import the deletion transport Z_THEO_READ_TABLE-deletion_request.zip using the SAP Transport Management System (STMS).

  5. Configure Theobald Xtract Universal for the required app template(s). Check out App Templates. If you encounter any issues, contact UiPath® Customer Support for help.
    Note:

    Steps 2-4 will require validation from your SAP team.

Shared Access Signature (SAS) Uri

To be able to upload the data to Process Mining Automation CloudTM you need to have the Shared Access Signature (SAS) uri of the Azure blob storage to which the extracted data needs to be uploaded. Check out Obtaining the authentication credentials for an app.

  • Shared Access Signature (SAS) Uri

Was this page helpful?

Connect

Need help? Support

Want to learn? UiPath Academy

Have questions? UiPath Forum

Stay updated