1. Home
  2. On-premises 5.2
  3. Guides
  4. Tours
  5. Concepts
  6. Tools
  7. References
    1. Apache Spark
    2. Connectors
      1. Amazon Web Services (AWS) Athena
      2. Amazon Web Services (AWS) DynamoDB
      3. Amazon Web Services (AWS) RedShift
      4. Amazon Web Services (AWS) S3
      5. Apache Drill
      6. Apache Hadoop HDFS
      7. Apache Hive
      8. Apache Kafka
      9. Box
      10. Cassandra (Simba)
      11. Cassandra (Incorta)
      12. Cisco Meraki
      13. Cosmos DB
      14. Custom CData
      15. Custom SQL
      16. Dropbox
      17. File System (LocalFiles)
      18. Freshservice
      19. FTP
      20. Google BigQuery
      21. Google Cloud Storage
      22. Google Drive
      23. Google Sheets
      24. GraphQL
      25. IBM DB2
      26. IBM Netezza
      27. JIRA
      28. JSON
      29. Local Files
      30. Microsoft Azure Gen2
      31. Microsoft SharePoint
      32. Microsoft SQL Server
      33. Microsoft SQL Server (JTDS)
      34. MongoDB BI
      35. MySQL
      36. NetSuite - SuiteAnalytics
      37. NetSuite - SuiteQL
      38. NetSuite - Web Service
      39. OneLogin
      40. Oracle
      41. Oracle B2C Service
      42. Oracle Cloud Applications
      43. Oracle EPM
      44. Oracle Essbase
      45. Oracle Sales Cloud
      46. PostgreSQL
      47. Presto
      48. Salesforce v1
      49. Salesforce v2
      50. SAP ERP
      51. SAP Hana
      52. SAP Sybase IQ
      53. ServiceNow
      54. Smartsheet
      55. Snowflake
      56. Splunk
      57. SFTP
      58. Teradata
      59. Vertica
      60. XML
      61. Zuora
    3. Built-in Functions
    4. Incorta Connector SDK
    5. Security
    6. Visualizations
    7. Other
  8. Integrations
  9. Data applications
  10. Releases

Connectors → SAP ERP

About SAP ERP

SAP ERP is an enterprise resource planning system that is built for businesses of all sizes. SAP ERP has modules specific to industries, from manufacturing to retail. The software supports and integrates almost every functional area of a business process from procurement of goods and services, sale and distribution, finance, accounting, human resource, manufacturing, production planning to logistics and warehouse management.

About the SAP ERP Connector

The SAP ERP Connector loads data into Incorta from the SAP ERP Tables, Views, Advanced Business Application Programming (ABAP) Core Data Services (CDS) Views and HANA CDS Views.

The Connector is built using the SAP Java Connector (JCo) library, and uses a Remote Function Call (RFC) enabled Function Module program to perform the following activities:

  • Receive Requests
  • Generate Schema Definition
  • Extract Data from Tables
  • Log Extraction and Processing Status

The following are the SAP objects used to build the SAP ERP Connector function module:

Object TypeObject Name
ClassCL_ABAP_CHAR_UTILITIES
ClassCL_ABAP_GZIP
ClassCL_ABAP_MEMORY_UTILITIES
ClassCL_ABAP_STRUCTDESCR
ClassCL_ABAP_TABLEDESCR
ClassCL_ALV_TABLE_CREATE
ClassCX_ROOT
ClassCX_SY_DYNAMIC_OSQL_SEMANTICS
ClassCX_SY_DYNAMIC_OSQL_SYNTAX
Function ModuleBALW_BAPIRETURN_GET1
Function ModuleCCU_TIMESTAMP_DIFFERENCE
Function ModuleRZL_READ_DIR_LOCAL
Function ModuleDDIF_FIELDINFO_GET
Function ModuleSUSR_USER_CHECK_EXISTENCE
Function ModuleSYSTEM_CALLSTACK
Function ModuleRFC_GET_ATTRIBUTES
StructureCNVCMIS_A_20_DATA_0064
StructureCNVCMIS_A_20_DATA_0128
StructureCNVCMIS_A_20_DATA_0256
StructureCNVCMIS_A_20_DATA_0512
StructureCNVCMIS_A_20_DATA_1024
StructureCNVCMIS_A_20_DATA_2048
StructureCNVCMIS_A_20_DATA_3072
StructureCNV_10500_DATA_4096
StructureCNV_10500_DATA_8000
StructureEPSF
Table TypesSYS_CALLST
Table TypesTR_TABNAMES

The SAP ERP connector uses configuration parameters to manage table access control. Table access control can be done using the User Profile Authorization Groups method or using a list of table names maintained in a Z Table method.

SAP ERP Connector Compatibility

The SAP ERP connector has been developed and tested for the following SAP ERP Systems:

  • SAP ECC 6.0 EHP 7 - 702, 731, 740, 752
  • SAP S/4 HANA - 1503, 1511, 1605, 1610, 1709, 1809, 1909

The SAP ERP connector supports the following Incorta specific functionality:

FeatureSupported
Chunking✔
Data Agent
Encryption at Ingest
Incremental Load✔
Multi-Source✔
OAuth
Performance Optimized✔
Remote
Single-Source✔
Spark Extraction
Webhook Callbacks✔

Deployment of the SAP ERP Connector in SAP

This section provides step by step information for importing binary transports containing Incorta’s development objects into the SAP instance. It is intended for SAP BASIS administrators or Incorta schema administrators with proper SAP transactions and SAP transport management access rights.

Installation User Profile

The following authorization objects are required for the SAP User in order to complete the import steps:

SAP Transaction CodeSAP Transaction DescriptionAuthorization Object
CG3ZFile UploadS_DATASET
STMSTransport Management SystemS_TRANSPRT, S_CTS_ADMI
SE10Transport OrganizerS_TRANSPRT, S_DATASET
STMS_IMPORTTransport Request ImportES_TRANSPRT, S_CTS_ADMI
AL11Display SAP DirectoriesS_ADMI_FCD
FILECross-Client File Names/Paths
SE16NGeneral Table Display
SM30Maintain Table View
SE11ABAP Dictionary MaintenanceS_DEVELOP
SU01User MaintenanceS_USER_GRP
SU53Check User Authorization
AdditionalUser InterfaceS_GUI
SM69Operation System Commands

Extract User Profile

The extract user, INC_RFC, will be created as a communications data user type. The following authorization objects are required for the SAP User in order to complete the data extraction from Incorta:

Authorization ObjectAuthorization FieldAuthorization Value
S_RFCRFC_TYPEFUGR, FUNC
S_\RFCRFC_NAMERFCPING, SYST, ZINC_INTF_REL, ZINC_SAP_ERP_DATA_EXTRACTOR, RFC1, RFCPING, RFC_GET_FUNCTION_INTERFACE, DDIF_FIELDINF_GET, SDIFRUNTIME
S_RFCTACTVT16 - Execute
S_TCODETCDSE16, ZSE16
S_BTCH_ADMBTCADMINA - Optional Check for Class A Jobs
B - Optional Check for Class B Jobs
C - Copy Another User’s Jobs
D - Authorization to Display Jobs from Other Clients
N - No Administrator Authorization
P - Authorization to Create Periodic Jobs
Y - Background Administrator Authorization
S_BTCH_JOBJOBACTIONRELE
S_BTCH_JOBJOBGROUP*
S_DATASETPROGRAMSAPLZINC_INTF_REL
S_DATASETAACTVT06, 33, 34
S_DATASETFILENAME*
S_LOG_COMCOMMANDZINC_CHMOD, ZINC_CHOWN, ZINC_COMPRESS, ZINC_TRANS_CF, ZINC_TRANS_SCP, ZINC_WINSCP_CMD
S_LOG_COMOPSYSTEMLinux, NT, Unix, Windows NT
S_LOG_COMHOST*
S_TABU_DISDICBERCLS<Table_Authorization_Group>
S_TABU_DISACTVT03 - Display
S_TABU_NAMACTVT03 - Display
S_TABU_NAMTABLE<Table_Name>
S_TABU_CLICLIIDMAINTX – If the same user is used for table maintenance.
Note
  • <Table_Name> represents a complete list of table names. Wild card characters are not supported.
  • <Table_Authorization_Group> represents a complete list of authorization group names. Wild card characters are not supported.

SAP Function Module Installation Steps

The steps to install the SAP function module are as follows, with details for each step in the sections below:

Setup the SAP Function Module Transport Request

Download the Installation Files

Contact Incorta Support to obtain the SAP ERP Connector binary transport ZIP file. The ZIP file will contain two files:

  • CO file: The filename is in the format KXXXXXX.YYY
  • DATA file: The filename is in the format RXXXXXX.YYY
Note

XXXXXX is a six digit number and YYY is the source system ID.

Upload the Transport Files

Upload the CO and DATA transport files to the target application server.

Upload the CO File

Execute the SAP Transaction Code CG3Z in the SAP GUI to upload the CO file to the default CO transport request directory: /usr/sap/trans/cofiles

The Upload File: Parameters dialog requires the following information:

  • Source file on front end (e.g. /Incorta/Release1/Transport_Requests/K900012.ERP)
  • Target file on the application server (e.g. /usr/sap/trans/cofiles/K900012.ERP

Upload the DATA File

Execute the SAP Transaction Code CG3Z in the SAP GUI to upload the DATA file to the default DATA transport request directory: /usr/sap/trans/data

The Upload File: Parameters dialog requires the following information:

  • Source file on front end (e.g. /Incorta/Release1/Transport_Requests/R900012.ERP)
  • Target file on the application server (e.g. /usr/sap/trans/cofiles/R900012.ERP)

Import the Transport Request

Import the transport request with the following steps:

  • Execute the SAP Transaction Code STMS_IMPORT in the SAP GUI to import the transport request for the uploaded files.
  • Select the Extras→Other Requests→Add menu option to add a new transport request to the import queue.
  • In the Add Transport Request to Import Queue dialog:
    • Enter the transport request (e.g. ERPK900012) or select the lookup button to view the available transport request codes.
    • Select the green checkbox.
  • In the Add Transport Request confirmation dialog, select Yes.
  • Once the transport request is added, it is shown in the Import Queue. To import the transport request, select the transport request in the queue, and select Import Request (truck icon).
  • In the Import Transport Request dialog
    • Enter the Target Client (e.g. 100).
    • Select Options, and select the checkbox for each Import Option.
    • Select the green checkbox.
  • In the Start Import dialog, select Yes.
  • Once the transport is imported, the Import Queue Short Text for the request will be populated (e.g. Incorta SAP ERP Extraction connector RFC - RELEASE 1). Select the request to view the Import Log File. All objects should have been created with a valid return code.

Configure the SAP Function Module

Connection Properties

Connection properties are used to define the default settings or appropriate values for the Function Module(s). Connection properties are stored in a key value pair format. The ZINC_CONFIG_PROP table is used to store the connection properties. The table has three columns: Function Module, Property Name and Property Value. Connection properties are stored for a specific Function Module. Execute the SAP Transaction Code SM30 to view or change the connection properties.

Note

The connection properties and the values are development objects. These should be changed only if needed during development or initial integration.

The following are the ZINC_CONFIG_PROP connection properties and the respective default values:

Property NameProperty DescriptionProperty Value
ZINC_CP_ASYNC_FILE_CLEAN_UP_METHODEnter the file clean up method. Possible values are:
  • IMMEDIATE - Remove the data file, schema definition file and control file, if any, immediately
  • SCHEDULE - Clean the file up manually during testing
IMMEDIATE
ZINC_CP_ASYNC_FILE_TRAN_METHODEnter the method used when extracting the data. The default value is ASYNC_FILE_UPLOAD_TO_INCORTA_SERVER_SCP.ASYNC_FILE_UPLOAD_TO_INCORTA_SERVER_SCP
ZINC_CP_AUTO_CLEANUP_FLAGEnable or disable the auto file clean up process. Possible values are Y and N.Y
ZINC_CP_BUILDEnter the date of the last build.20201020
ZINC_CP_CHARACTER_ENCODINGEnter the character encoding format used for data extraction. The default is utf-16le.utf-16le
ZINC_CP_CLEANUP_WINDOW_HOURSEnter how often the cleanup program should run. The default is 24.24
ZINC_CP_COMPRESSION_ENABLEDEnable or disable compression. The default value is N.Y
ZINC_CP_COMPRESSION_METHODEnter the compression method to be used for extracted data. The default is GZIP.GZIP
ZINC_CP_COMPRESS_ENCODINGEnter the character encoding format used for data compression. The default is iso-8859-1.iso-8859-1
ZINC_CP_DATE_FORMATEnter how the date should be represented in the extraction. The default is YYYYMMDD.YYYYMMDD
ZINC_CP_DATE_FORMAT_BWEnter how the date should be represented in the Business Warehouse (BW) extraction. The default is YYYY.MM.DD.YYYY.MM.DD
ZINC_CP_DELETE_LOGEnable or disable the auto deletion process for log entries. Possible values are Y and N.Y
ZINC_CP_DELIMITER_CHARACTERSEnter the character or characters used for delimiting the columns. The default value is ,.,
ZINC_CP_DEL_LOG_PERIODEnter the number of days you wish to keep the log entries in the log tables for debugging and/or test purposes. The default is 90.90
ZINC_CP_ENABLE_PARALLEL_PROCESSING*Enable or disable parallel processing. The default value is Y.N
ZINC_CP_ENABLE_TIMESTAMP_CHUNKINGEnable or disable chunking using the timestamp field. The default value is Y.Y
ZINC_CP_ENCLOSING_CHARACTERSEnter the character or characters used for enclosing the column value when the delimiter is found in the column value. The default is “.“
ZINC_CP_ENCRYPTION_ENABLEDEnter or disable encryption.
ZINC_CP_ENCRYPTION_METHODEnter the encryption method.
ZINC_CP_ESCAPE_CHARACTERSEnter the character or characters used to escape the delimiter occurrence in the column value. The default is “.“
ZINC_CP_EXTRACTION_METHODEnter how the data extraction and transfer will be done. The default is SYNCHRONOUS.SYNCHRONOUS
ZINC_CP_EXTRACTION_SELECTIONEnter what types of extractions are allowed in the connector. The default is TABLE.TABLE
ZINC_CP_FILE_LAST_CLEANUP_TIMESTAMPStore the timestamp when the last cleanup occurred for the mirror files. The function module will update the timestamp when the file cleanup program has successfully completed.20200406161645.3327320
ZINC_CP_FILE_LOCATIONEnter where the extraction file will be stored. The file location is either a logical file path name or actual physical directory path. The default value is the logical file path name created in FILE t-code and the value is ZINC_INCORTA.ZINC_INCORTA
ZINC_JOB_SERVER_GRPEnter the background job server group allocation. The default is blank.ZINC_JOBSG
ZINC_CP_LOG_SELECTED_COLUMNSN
ZINC_CP_MIRROR_FILE_ENABLEDEnable file generation for the data extraction. Possible values are N and Y. The default is N.N
ZINC_CP_MIRROR_FILE_STORE_HOURSEnter how many hours the file can be stored on the application server. The default is 8.24
ZINC_CP_PARALLELPROCESSING_SERVERGROUP*Enter the server group for parallel processes.INCORTA
ZINC_CP_RELEASEEnter the current version of the connector.4.4
ZINC_CP_REQUEST_TYPEEnter what types of requests are allowed in the connector. Possible values are:
GET_DATA
GET_SCHEMA
GET_SCHEMA_LIST
GET_TABLE_LIST
GET_COLUMN_LIST
SUBMIT_REQUEST
EXECUTE_REQUEST
SUBMIT_REQUEST_ORIG
EXECUTE_REQUEST_ORIG

The default is GET_DATA.		GET_DATA
ZINC_CP_ROW_DELIMITER_TYPECODEEnter the character or characters used for delimiting the rows. The default is CR_LF.CR_LF
ZINC_CP_SCHEMA_DISCOVERY_METHODEnter what type of table access restriction is allowed for the connection. Supported possible methods are:
  • User Profile Authorization Groups – ZINC
  • _
  • AUTH
  • _
  • GROUPS
  • Custom Z Table List – ZINC
  • _
  • TAB
  • _
  • ACCESS
ZINC_AUTH_GROUPS
ZINC_CP_SCHEMA_TABLE_UPDATESUpdate the schema definition log tables with the latest table definitions and when they are executed. The default value is Y.Y
ZINC_CP_SELECT_PACKAGE_SIZEEnter the package size that is used when extracting the data. The default is 15000.50000
ZINC_CP_STXL_LAST_LOAD_DATE00000000
ZINC_CP_TIME_FORMATEnter how the time should be represented in the extraction. The default is HHMMSS.HHMMSS
ZINC_CP_TRANSPORT_ENTRIESEnter the request number.S4HK900246
ZINC_CP_UNCOMPRESSED_DATA_PACKET_SIZE_MBEnter the package size in MB used when extracting the data in Uncompressed Mode. The default value is 100.100

*These properties are available only for S4/Hana. The rest are available for all SAP versions.

Update the Schema Discovery Method

The following steps can be used to update the Schema Discovery Method:

  • Execute the SAP Transaction Code SM30 in the SAP GUI.
  • Enter the table name ZINC_CONFIG_PROP.
  • Select Display.
  • Select Edit (pen and glasses icon) to edit the table contents.
  • Select Save (floppy disk icon).

Setup and Configure the SAP Data Extraction User

Create the Data Extraction User

Execute SAP Transaction Code SU01 to create the INC_DE_USER user, which is used to access the SAP system for the data extraction.

  • In the User Maintenance: Initial Screen dialog, enter the user ID, INC_DE_USER, in User.

  • Select create (paper icon).

  • Enter the following Person properties for the Incorta Data Extract User:

    • Last name: INCORTA
    • First name: DATA EXTRACT USER

  • Select Logon Data and select a User Type of Communications Data.

    Note

    If the same user will be used to perform table maintenance or log into the SAP GUI, then select a User Type of Dialog.

  • Select the Defaults tab to change the defaults as necessary.

  • Select save (floppy disk icon).

Create the User Role and Assignment

Configure the Authorization Objects, Fields and Values for the INC_DE_USER.

Data Extraction Folder

Configure the Physical Folder

To configure the physical folder, perform the following steps:

  • Execute the SAP Transaction Code FILE.
  • Search for the logical file path: ZINC_INCORTA
  • Select the Assignment of Physical Paths to Logical Path option.
  • For the Physical Paths, choose the type of operating system (OS) used for the application server.
  • Double click the OS Name.
  • Enter the physical path to the folder (e.g. tmp/<FILENAME>).
Note
  • The physical path can be changed as desired.
  • At least 100GB is needed for auto growth in support of a full load.
  • The remove file feature has been implemented, which will clean up the folder automatically.

Setup the Logical Folder Content Display

To setup the logical content folder display, perform the following steps:

  • Execute the SAP Transaction Code AL11.
  • Select the Configure User Directories icon to create a new mapping.
  • In the User-Defined Directories dialog, enter the following information:
    • Name of Directory Parameter: DIR_INCORTA
    • Directory Name: /usr/sap/INCORTA_SAPDATAOUTPUT
    • Valid for Server Name: all
  • Select Save (floppy disk icon).

Verify the SAP Function Module Setup

To verify the SAP Function Module, perform the following steps:

  • Execute the SAP Transaction Code SE37.
  • In the Function Builder: Initial Screen dialog, enter the name of the main function module, ZINC_SAP_ERP_DATA_EXTRACTOR.
  • Select the Test/Execute icon.

Get Schema Request

  • In the Test Function Module: Initial Screen dialog, enter the following import parameter:
    • IN_REQUEST_TYPE: GET_SCHEMA_LIST
  • Select the Execute icon.
  • The output for GET_SCHEMA_LIST is captured in the OUT_SCHEMA_DEFINITION table. Select the OUT_SCHEMA_DEFINITION entries to see the contents of the table.

Get Data – Master or Lookup Table

  • In the Test Function Module: Initial Screen dialog, enter the following import parameters:
    • IN_REQUEST_TYPE: GET_DATA
    • IN_EXTRACTION_SELECTION: TABLE
    • IN_SELECTED_TABLE_NAME: T024
  • Select the Execute icon.
  • The output for GET_DATA is captured in the output table specified in the OUT_DYNAMIC_TABLE_SELECTED output parameter. For the selected table, T024, the output table is OUT_DYNAMIC_TABLE_WIDTH_1024.
  • Select the output table entries to see the contents of the extracted data.

Get Data – Transaction Table Stand Alone

  • In the Test Function Module: Initial Screen dialog, enter the following import parameters:
    • IN_REQUEST_TYPE: GET_DATA
    • IN_EXTRACTION_SELECTION: TABLE
    • IN_SELECTED_TABLE_NAME: BKPF
    • IN_SELECTED_TAB_FULLINC_FILTER: BKPF~CPUDT >= '20150101' AND BKPF~CPUDT <= '20150131'
  • Select the Execute icon.
  • The output for GET_DATA is captured in the output table specified in the OUT_DYNAMIC_TABLE_SELECTED output parameter. For the selected table, BKPF, the output table is OUT_DYNAMIC_TABLE_WIDTH_2048.
  • Select the output table entries to see the contents of the extracted data.

Get Data – Transaction Table with Parent Table

  • In the Test Function Module: Initial Screen dialog, enter the following import parameters:
    • IN_REQUEST_TYPE: GET_DATA
    • IN_EXTRACTION_SELECTION: TABLE
    • IN_SELECTED_TABLE_NAME: BSEG
    • IN_PARENT_TABLE_NAME: BKPF
    • IN_PARENT_TABLE_JOIN_CONDT: BKPF~BUKRS = BSEG~BUKRS AND BKPF~BELNR = BSEG~BELNR AND BKPF~GJAHR = BSEG~GJAHR
    • IN_SELECTED_TAB_FULLINC_FILTER: BKPF~CPUDT >= '20150101' AND BKPF~CPUDT <= '20150131'
  • Select the Execute icon.
  • The output for GET_DATA is captured in the output table specified in the OUT_DYNAMIC_TABLE_SELECTED output parameter. For the selected table BSEG, the output table is OUT_DYNAMIC_TABLE_WIDTH_5000.
  • Select the output table entries to see the contents of the extracted data.

Steps to connect SAP ERP and Incorta

To connect SAP ERP and Incorta, here are the high level steps, tools, and procedures:

Create an external data source

Here are the steps to create a external data source with the SAP ERP connector:

  • Sign in to the Incorta Direct Data Platform.
  • In the Navigation bar, select Data.
  • In the Action bar, select + New → Add Data Source.
  • In the Choose a Data Source dialog, in Other, select SAP ERP.
  • In the New Data Source dialog, specify the applicable connector properties.
  • To test, select Test Connection.
  • Select Ok to save your changes.

SAP ERP connector properties

Here are the properties for the SAP ERP connector:

PropertyControlDescription
Data Source Nametext boxEnter the name of the data source
SAP Application Server Hosttext boxEnter the SAP application server host
SAP System Numbertext boxEnter the SAP system number. The value is between 00 and 99.
SAP Clienttext boxEnter the SAP client number. This number is used to perform the RFC logon to SAP, binding the agent process with the account created during the transport import.
User IDtext boxEnter the SAP user ID
Passwordtext boxEnter the SAP password
BAPI Nametext boxOptionally enter the Business Application Programming Interface (BAPI) name. The default is ZINC\_SAP\_ERP\_DATA\_EXTRACTOR.
Peak Limittext boxOptionally enter the maximum number of active connections that can be created for a destination simultaneously. The default is 10.
Pool Capacitytext boxOptionally enter the maximum number of idle connections kept open by the destination. The default is 3.
Metadata Cache Time in Minutestext boxOptionally enter the metadata cache time in minutes. The default is 60.
Extraction Methoddrop down listSelect the extraction method.
The options are:
  • Asynchronous
  • Synchronous
. The default is Asynchronous.
Process Data At IncortatoggleEnable this property to process data at Incorta
Keep File For DebuggingtoggleEnable this property to save the file for debugging
Enable EncryptiontoggleEnable this property for data encryption
Asynchronous File Transfer Methoddrop down listSelect the upload method. The options are: Upload to Incorta Server using SCP Upload to Incorta Server using WinSCP Upload to Incorta Shared Drive Upload to Common Shared Drive
Destination Hosttext boxEnter the destination host IP address to transfer files from SAP to Incorta.
Destination Authentication Methoddrop down listEnter the authentication method. The options are:
  ●  Private Key
  ●  Password
Destination Usernametext boxEnter the destination username of Incorta machine. The default is incorta.
Destination Pathtext boxEnter the destination path. The default is /home/incorta/ASYNC_DATAEXTRACTS/SAPS4HANAIDES
Use Data AgenttoggleEnable using a data agent to securely ingest data from an external data source that is behind a firewall. For more information, please review Tools → Data Agent and Tools → Data Manager.
Data Agentdrop down listEnable Use Data Agent to configure this property. Select from the data agents created in the tenant, if any.

Create a schema with the Schema Wizard

Here are the steps to create an SAP ERP schema with the Schema Wizard:

  • Sign in to the Incorta Direct Data Platform.
  • In the Navigation bar, select Schema.
  • In the Action bar, select + New → Schema Wizard.
  • In (1) Choose a Source, specify the following:
    • For Enter a name, enter the schema name.
    • For Select a Datasource, select the SAP ERP external data source.
    • Optionally create a description.
  • In the Schema Wizard footer, select Next.
  • In (2) Manage Tables, in the Data Panel, first select the name of the Data Source, and then check the Select All checkbox.
  • In the Schema Wizard footer, select Next.
  • In (3) Finalize, in the Schema Wizard footer, select Create Schema.

Create a schema with the Schema Designer

Here are the steps to create an SAP ERP schema using the Schema Designer:

  • Sign in to the Incorta Direct Data Platform.
  • In the Navigation bar, select Schema.
  • In the Action bar, select + New → Create Schema.
  • In Name, specify the schema name, and select Save.
  • In Start adding tables to your schema, select SAP.
  • In the Data Source dialog, specify the SAP ERP table data source properties.
  • Select Add.
  • In the Table Editor, in the Table Summary section, enter the table name.
  • To save your changes, select Done in the Action bar.

SAP ERP table data source properties

For a schema table in Incorta, you can define the following SAP ERP specific data source properties as follows:

Property | Control | Description Property | Control | Description ---------|---------|------------- Type | drop down list | Default is SQL Database Data Source | drop down list | Select the SAP ERP external data source Schema | drop down list | Select the SAP schema Table | drop down list | Select the SAP table Derived Columns | text box | Enter the table derived columns Selected Columns | text box | Enter the source table columns you would like to include. Use a comma separator between column names with no spaces. For example, MATNR,KOKRS,BELNR. Leave this field empty if you need to include all the source table columns. Extraction Filter | text box | Enter the filter to apply to the data extracted from the source table. The extraction filter requires a column to be referenced as <TABLE_NAME>~<COLUMN_NAME>. For example, COSP~GJAHR = 2021. Full Load Setup | toggle | Enable this property to set up the full load details Full Load Derived Columns | text box | Enable Full Load Setup to configure this property. Define constant value columns. This is useful in cases where the number of full load columns is less than the number of incremental load columns. Dependent Table | toggle | Enable Full Load Setup to configure this property. Enable this property to specify a dependent table. Dependent Schema | drop down list | Enable Dependent Table to configure this property. Select the dependent schema. Dependent Table | drop down list | Enable Dependent Table to configure this property. Select the dependent table. Dependent Join Type | drop down list | Enable Dependent Table to configure this property. Select the join type between the source table and dependent table. The options are:

  • INNER JOIN
  • LEFT OUTER JOIN
Join Condition | text box | Enable Dependent Table to configure this property. Enter the join condition between the source table and dependent table. The join condition requires a column to be referenced as <TABLE_NAME>~<COLUMN_NAME>. For example, BKPF~BUKRS = BSEG~BUKRS. Dependent Columns | text box | Enable Dependent Table to configure this property. Enter the names of the columns that you would like to include from the dependent table. Use a comma separator between column names with no spaces. For example, CPUDT,AEDAT,HWAE2. Leave this field empty if you do not want to include any dependent columns. Dependent Table Extraction Filter | text box | Enable Dependent Table to configure this property. Enter the filter to be applied to the data extracted from the dependent table. This filter will only be considered when you join a cluster and/or pool table with a transparent table. The extraction filter requires a column to be referenced as <TABLE_NAME>~<COLUMN_NAME>. For example, CDHDR~OBJECTCLAS IN ('MAKT','MAKTC'). Dependent Table 2 | toggle | Enable Dependent Table to configure this property. Enable this property to specify a second dependent table. Dependent Schema 2 | drop down list | Enable Dependent Table 2 to configure this property. Select the dependent schema for the second dependent table. Dependent Table 2 | drop down list | Enable Dependent Table 2 to configure this property. Select the second dependent table. Dependent Table 2 Join Type | drop down list | Enable Dependent Table 2 to configure this property. Select the join type between the source table and the second dependent table. The options are:
  • INNER JOIN
  • LEFT OUTER JOIN
Dependent Table 2 Join Condition | text box | Enable Dependent Table 2 to configure this property. Enter the join condition between the source table and the second dependent table. The join condition requires a column to be referenced as <TABLE_NAME>~<COLUMN_NAME>. For example, BKPF~BUKRS = BSEG~BUKRS. Dependent Table 2 Columns | text box | Enable Dependent Table 2 to configure this property. Enter the names of the columns that you would like to include from the second dependent table. Use a comma separator between column names with no spaces. For example, CPUDT,AEDAT,HWAE2. Leave this field empty if you do not want to include any dependent columns. Dependent Table 3 | toggle | Enable Dependent Table 2 to configure this property. Enable this property to specify a third dependent table. Dependent Schema 3 | drop down list | Enable Dependent Table 3 to configure this property. Select the dependent schema for the third dependent table. Dependent Table 3 | drop down list | Enable Dependent Table 3 to configure this property. Select the third dependent table. Dependent Table 3 Join Type | drop down list | Enable Dependent Table 3 to configure this property. Select the join type between the source table and the third dependent table. The options are:
  • INNER JOIN
  • LEFT OUTER JOIN
Dependent Table 3 Join Condition | text box | Enable Dependent Table 3 to configure this property. Enter the join condition between the source table and the third dependent table. The join condition requires a column to be referenced as <TABLE_NAME>~<COLUMN_NAME>. For example, BKPF~BUKRS = BSEG~BUKRS. Dependent Table 3 Columns | text box | Enable Dependent Table 3 to configure this property. Enter the names of the columns that you would like to include from the third dependent table. Use a comma separator between column names with no spaces. For example, CPUDT,AEDAT,HWAE2. Leave this field empty if you do not want to include any dependent columns. Additional Full Load Extraction Filter | text box | Enter an additional filter to apply to the data extracted from the source table during a full load. The extraction filter requires a column to be referenced as <TABLE_NAME>~<COLUMN_NAME>. For example, COSP~WRTTP IN ('E','V'). Full load Fetch Method | drop down list | Select the backend database fetch method to use when executing a full load query against the SAP Function Module. The options are:
  • OPEN
  • _
  • SQL (default)
  • OPEN
  • _
  • CURSOR
Use Full Load Chunking | toggle | Enable this property to process the full data load in chunks Chunking Column Type | drop down list | Enable Use Full Load Chunking to configure this property. Select the chunking column type. The options are:
  • Chunking by date or timestamp columns
  • Chunking by string or number column
Manage Full Load Column Selection (e.g. table~column1, table~column2) | text box | Enable Use Full Load Chunking to configure this property. Enter the specific columns to use for chunking. Manage Full Load Start Date (format: yyyyMMdd, e.g. 20181225) | text box | Enable Use Full Load Chunking and select Chunking by date or timestamp columns as the Chunking Column Type to configure this property. Enter the full load start date. Manage Full Load End Date (format: yyyyMMdd, e.g. 20181225) | text box | Enable Use Full Load Chunking and select Chunking by date or timestamp columns as the Chunking Column Type to configure this property. Enter the full load end date. Manage Full Load Increment By | text box | Enable Use Full Load Chunking and select Chunking by date or timestamp columns as the Chunking Column Type to configure this property. Enter the full load increment quantity. The default is 30. Manage Full Load Group Restriction | text box | Enable Use Full Load Chunking and select Chunking by string or number columns as the Chunking Column Type to configure this property. Enter the full load group restriction. The default is 100. Full Load by Filter | text box | Enable Use Full Load Chunking and select Chunking by Year and Period columns as the Chunking Column Type to configure this property. Enter the full load static extraction filter. The extraction filter requires a column to be referenced as <TABLE_NAME>~<COLUMN_NAME>. You can also use a global variable to get dynamic values for the filter condition. For example, COSP~GJAHR = 2021 AND (COSP~PERBL > @@GV_PERIOD OR COSP~BUDGET_PD > @@GV_PERIOD). Join Condition | text box | Enable Dependent Table to configure this property. Enter the join condition between the source table and dependent table. Incremental Load | toggle | Enable the incremental load configuration for the schema table Incremental Load Type | drop down list | Enable Incremental to configure this property. Select the incremental load type. The options are:
  • Incremental Load by date or timestamp columns
  • Incremental Load by Static Filter
  • Chunking by string or number columns
Incremental Load Derived Columns | text box | Enable Incremental Load Setup to configure this property. Define constant value columns. This is useful in cases where the number of incremental load columns is less than the number of full load columns. Incremental Dependent Table | toggle | Enable Incremental Load Setup to configure this property. Enable this property to specify an incremental dependent table. Incremental Dependent Schema | drop down list | Enable Incremental Dependent Table to configure this property. Select the incremental dependent schema. Incremental Dependent Table | drop down list | Enable Incremental Dependent Table to configure this property. Select the incremental dependent table. Incremental Dependent Join Type | drop down list | Enable Incremental Dependent Table to configure this property. Select the join type between the source table and incremental dependent table. The options are:
  • INNER JOIN
  • LEFT OUTER JOIN
Incremental Join Condition | text box | Enable Incremental Dependent Table to configure this property. Enter the join condition between the source table and incremental dependent table. The join condition requires a column to be referenced as <TABLE_NAME>~<COLUMN_NAME>. For example, BKPF~BUKRS = BSEG~BUKRS. Incremental Dependent Columns | text box | Enable Incremental Dependent Table to configure this property. Enter the names of the columns that you would like to include from the incremental dependent table. Use a comma separator between column names with no spaces. For example, CPUDT,AEDAT,HWAE2. Leave this field empty if you do not want to include any incremental dependent columns. Incremental Dependent Table Extraction Filter | text box | Enable Incremental Dependent Table to configure this property. Enter the filter to be applied to the data extracted from the incremental dependent table. This filter will only be considered when you join a cluster and/or pool table with a transparent table. The extraction filter requires a column to be referenced as <TABLE_NAME>~<COLUMN_NAME>. For example, CDHDR~OBJECTCLAS IN ('MAKT','MAKTC'). Incremental Dependent Table 2 | toggle | Enable Incremental Dependent Table to configure this property. Enable this property to specify a second incremental dependent table. Incremental Dependent Schema 2 | drop down list | Enable Incremental Dependent Table 2 to configure this property. Select the dependent schema for the second incremental dependent table. Incremental Dependent Table 2 | drop down list | Enable Incremental Dependent Table 2 to configure this property. Select the second incremental dependent table. Incremental Dependent Table 2 Join Type | drop down list | Enable Incremental Dependent Table 2 to configure this property. Select the join type between the source table and the second incremental dependent table. The options are:
  • INNER JOIN
  • LEFT OUTER JOIN
Incremental Dependent Table 2 Join Condition | text box | Enable Incremental Dependent Table 2 to configure this property. Enter the join condition between the source table and the second incremental dependent table. The join condition requires a column to be referenced as <TABLE_NAME>~<COLUMN_NAME>. For example, BKPF~BUKRS = BSEG~BUKRS. Incremental Dependent Table 2 Columns | text box | Enable Incremental Dependent Table 2 to configure this property. Enter the names of the columns that you would like to include from the second dependent table. Use a comma separator between column names with no spaces. For example, CPUDT,AEDAT,HWAE2. Leave this field empty if you do not want to include any dependent columns. Incremental Dependent Table 3 | toggle | Enable Incremental Dependent Table 2 to configure this property. Enable this property to specify a third incrementaldependent table. Incremental Dependent Schema 3 | drop down list | Enable Incremental Dependent Table 3 to configure this property. Select the dependent schema for the third incremental dependent table. Incremental Dependent Table 3 | drop down list | Enable Incremental Dependent Table 3 to configure this property. Select the third incremental dependent table. Incremental Dependent Table 3 Join Type | drop down list | Enable Incremental Dependent Table 3 to configure this property. Select the join type between the source table and the third incremental dependent table. The options are:
  • INNER JOIN
  • LEFT OUTER JOIN
Incremental Dependent Table 3 Join Condition | text box | Enable Dependent Table 3 to configure this property. Enter the join condition between the source table and the third incremental dependent table. The join condition requires a column to be referenced as <TABLE_NAME>~<COLUMN_NAME>. For example, BKPF~BUKRS = BSEG~BUKRS. Incremental Dependent Table 3 Columns | text box | Enable Incremental Dependent Table 3 to configure this property. Enter the names of the columns that you would like to include from the third incremental dependent table. Use a comma separator between column names with no spaces. For example, CPUDT,AEDAT,HWAE2. Leave this field empty if you do not want to include any dependent columns. Additional Incremental Load Extraction Filter | text box | Enter an additional filter to apply to the data extracted from the source table during an incremental load. The extraction filter requires a column to be referenced as <TABLE_NAME>~<COLUMN_NAME>. For example, COSP~WRTTP IN ('E','V'). Incremental load Fetch Method | drop down list | Select the backend database fetch method to use when executing an incremental load query against the SAP Function Module. The options are:
  • OPEN
  • _
  • SQL (default)
  • OPEN
  • _
  • CURSOR
Incremental Load Type | drop down list | Enable Incremental to configure this property. Select the incremental load type. The options are:
  • Incremental Load by date or timestamp columns
  • Incremental Load by Static Filter
  • Chunking by string or number columns
  • Chunking by Year and Period columns
Incremental Extract Using | drop down list | Select Incremental Load by date or timestamp columns or Chunking by string or number columns as the Incremental Load Type to configure this property. Select one of the following options for the incremental load extract:
  • Last Successful Extract Time (
  • Incremental Load by date or timestamp column
  • only)
  • Get Chunking Values Filter (
  • Chunking by string or number columns
  • only)
  • Maximum Value of a Column
Use Change Management Document Tables for Delta Records | toggle | Select Incremental Load by date or timestamp columns as the Incremental Load Type to configure this property. Enable this property to use the change management document tables for the delta records Incremental Load Column Selection (e.g. table~column1, table~column2) | text box | Select Incremental Load by date or timestamp columns, Chunking by string or number columns, or Chunking by Year and Period columns as the Incremental Load Type to configure this property. Enter the specific columns to use for incremental loading. Incremental Load Start Date (format: yyyyMMdd, e.g. 20181225) | text box | Select Incremental Load by date or timestamp columns or Chunking by Year and Period columns as the Incremental Load Type to configure this property. Enter the incremental load start date. Incremental Load End Date (format: yyyyMMdd, e.g. 20181225) | text box | Select Incremental Load by date or timestamp columns or Chunking by Year and Period columns as the Incremental Load Type to configure this property. Enter the incremental load end date. Incremental Load Increment By | text box | Select Incremental Load by date or timestamp columns as the Incremental Load Type to configure this property. Enter the incremental load increment quantity. Incremental Load by Filter | text box | Select Incremental Load by Static Filter as the Incremental Load Type to configure this property. Enter the incremental load static filter. Incremental Load Get Chunking Group Value Filter | text box | Select Chunking by string or number columns as the Incremental Load Type to configure this property. Enter the incremental load get chunking group value filter. Manage Incremental Load Group Restriction | text box | Select Chunking by string or number columns as the Incremental Load Type to configure this property. Enter the incremental load group restriction. The default is 100. Packet size in MB | text box | Enter the packet size in MB. The default is 10. Use Parallel Process in SAP Function Module | toggle | This property is only applicable if Asynchronous was selected for the Extraction Method during the associated external data source creation. Enable this property to use parallel queries to load the data. Instead of using a single process for one SQL statement, in parallel queries the work is spread across multiple processes. This is useful where there is a lot of data in operations like full table scans of large tables. Use Parallel Processing For Chunking in Asynchronous Method | toggle | This property is only applicable if Asynchronous was selected for the Extraction Method during the associated external data source creation. Enable this property to load data chunks (batches) in parallel. If disabled, the system will load data chunks sequentially (first chunk will be loaded first, then the second fetch, etc.). Callback | toggle | Turn this option on to enable the Callback URL field Callback URL | text box | This property appears when the Callback toggle is enabled. Specify the URL.

View the schema diagram with the Schema Diagram Viewer

Here are the steps to view the schema diagram using the Schema Diagram Viewer:

  • Sign in to the Incorta Direct Data Platform.
  • In the Navigation bar, select Schema.
  • In the list of schemas, select the SAP ERP schema.
  • In the Schema Designer, in the Action bar, select Diagram.

Load the schema

Here are the steps to perform a Full Load of the SAP ERP schema using the Schema Designer:

  • Sign in to the Incorta Direct Data Platform.
  • In the Navigation bar, select Schema.
  • In the list of schemas, select the SAP ERP schema.
  • In the Schema Designer, in the Action bar, select Load → Load Now → Full.
  • To review the load status, in Last Load Status, select the date.

Explore the schema

With the full load of the SAP ERP schema complete, you can use the Analyzer to explore the schema, create your first insight, and save the insight to a new dashboard.

To open the Analyzer from the schema, follow these steps:

  • In the Navigation bar, select Schema.
  • In the Schema Manager, in the List view, select the SAP ERP schema.
  • In the Schema Designer, in the Action bar, select Explore Data.