Getting Started

This section shows how to install and set up ERPConnect for the first time.

Installation

Download and install the following components:

• .NET SDK.
• An editor of your choice e.g., Visual Studio Code.
• Download the latest version of ERPConnect from the customer portal or download a 30 day trial version. Execute the ERPConnectSetup.exe file to install ERPConnect. For information on system requirements, see Requirements.
• Download the Netweaver RFC library from the SAP Marketplace download area.

For more information, see Documentation: Installation.

Setup

To set up a project that connects to an SAP system:

1. Open Visual Studio Code.
2. Install the C# Dev Kit plugin.
3. Create a new Console App.
4. Integrate the ERPConnectStandard20.dll library from the ERPConnect installation directory at C:\Program Files\ERPConnect into your project.

5. Integrate the SAP NetWeaver library:

   Example: Integrate Libraries

   <Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup>
       <OutputType>Exe</OutputType>
       <TargetFramework>net10.0</TargetFramework>
       <ImplicitUsings>enable</ImplicitUsings>
       <Nullable>enable</Nullable>
   </PropertyGroup>
   <ItemGroup>
       <Reference Include="ERPConnectStandard20">
       <HintPath>..\ERPConnectStandard20.dll</HintPath>
       </Reference>
   </ItemGroup>
   <ItemGroup>
       <Content Include="../icudt57.dll">
       <Link>icudt57.dll</Link>
       <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
       </Content>
       <Content Include="../icuin57.dll">
       <Link>icuin57.dll</Link>
       <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
       </Content>
       <Content Include="../icuuc57.dll">
       <Link>icuuc57.dll</Link>
       <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
       </Content>
       <Content Include="../sapnwrfc.dll">
       <Link>sapnwrfc.dll</Link>
       <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
       </Content>
   </ItemGroup>
   </Project>
   

6. Set the (demo) license before connecting to SAP. The demo license is provided as a .json file that is located in the installation directory of ERPConenct, e.g., C:\Program Files\ERPConnect\ERPConnectLicense.json. Use one of the following methods to set the license:

   Read the license fileCopy the content of the license file into the code

   ERPConnect.LIC.LoadJsonLicense(@"C:\Users\[user]\Documents\ERPConnect\ERPConnectLicense.json");
   

   ERPConnect.LIC.SetJsonLicense("""
   {
       "product": "ERPConnect",
       "kind": "Enterprise",
       "licensee": "Theobald Software GmbH, Stuttgart, Germany",
       "serialNumber": "ERPC12249",
       "created": "20250407T120102.862Z",
       "signature": "0Q1wTR21...h2eDBwbrg=="
   }
   """);
   

7. Create an R3Connection object for the SAP connection and define all input parameters. Use an SAP dialog user with sufficient SAP authorization for the connection, see Authorization Objects - SAP User Rights.

   Single Server loginLoad BalancingRFC via WebSocket

   1 2 3 4 5 6 7 8 9 10 11 12

   using (R3Connection con = new R3Connection()) { con.UserName = "SAPUser"; con.Password = "SAPPassword"; con.Language = "EN"; con.Client = "800"; con.Host = "sap-erp-as05.example.com"; con.SystemNumber = 00; con.Protocol = ClientProtocol.NWRFC; //use ClientProtocol.RFC for classic RFC library con.Open(); }

   1 2 3 4 5 6 7 8 9 10 11 12 13 14

   using (R3Connection con = new R3Connection()) { con.UserName = "SAPUser"; con.Password = "SAPPassword"; con.Language = "DE"; con.Client = "800"; con.MessageServer = "sap-erp-as05.example.com"; con.LogonGroup = "PUBLIC"; con.SID = "ECC"; con.Protocol = ClientProtocol.NWRFC; //use ClientProtocol.RFC for classic RFC library con.UsesLoadBalancing = true; con.Open(); }

   1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17

   using (R3Connection con = new R3Connection()) { con.UsesWebSocket = true; con.WebSocketHost = "myinstance-api.s4hana.cloud.sap"; con.WebSocketPort = 443; con.TlsSettings = new TlsSettings { TrustAll = false, CryptoLibrary = @"C:\lib\sapcrypto.dll", ClientPse = "CLIENT.PSE" }; con.AliasUser = "TESTUSER", con.Password = "Password", con.Open(); }

8. Establish the connection using Open().

9. Build the .NET Project.
10. Run the program to test the SAP connection.

Your program now connects to SAP. For more information, see Documentation: Connect to SAP.

Next Steps

ERPConnect offers the following features for reading and writing data from and to SAP: