Registering the dox42 Server Module for SAP® Solutions for dox42 Server

You need to register the dox42 Server Module for SAP® Solutions in the web.config file in order to use it with dox42 Server.

Prerequisites

• dox42 Server installed and Server License Key activated.

• .NET Framework 4.5.2 or higher is installed on the server.

Steps

1. Copy the following assemblies to the bin folder of your dox42 Server (C:\dox42Server\bin):

   • SAPDataEngine.dll

   • SAPConfigDialog.dll

   • dox42SAPLicence.dll

   • ERPConnect35.dll

2. Additional step, only when using the dox42 RFC for SAP® Solutions Data Source.

   With SAP NetWeaver: Copy the following four assemblies from SAP NetWeaver to the systems32 folder of your dox42 Server (C:\Windows\system32):

   • icudt57.dll

   • icuin57.dll

   • icuuc57.dll

   • sapnwrfc.dll

     Note

     • These libraries are required by ERPConnect35. For further information please refer to Theobald Software - SAP Libraries.

     • You can download the libraries from the SAP Software Download Center.

   Without SAP NetWeaver: Alternatively to using SAP NetWeaver you can also use the Client Protocol RFC. If you wish to do so, copy the following library to the systems32 folder of your dox42 Server (C:\Windows\system32):

   • librfc32.dll

     Note

     You can download this library from the SAP Software center. Search for and download the SAP KERNEL 32-BIT or SAP KERNEL 64-BIT components.

3. Register the dox42 Server Modules for SAP® Solutions you would like to use in the web.config file of your server.

   <customDataSources>
   
   <add key="SAPDataEngine.SAPDataSourceParser" 
   value ="SAP RFC;c:\dox42Server\bin\SAPDataEngine.dll"/>
   
   <add key="SAPDataEngine.OData.SAPODataDataSourceParser" 
   value ="SAP OData;c:\dox42Server\bin\SAPDataEngine.dll"/>
   
   <add key="SAPDataEngine.JSON.SAPJSONDataSourceParser" 
   value ="SAP JSON;c:\dox42Server\bin\SAPDataEngine.dll"/>
    
   </customDataSources>

4. In the web.config file on the server, navigate to the <appSettings> section and add the following entry:

   <appSettings>
   
   <add key="dox42SAPLicenseKey" value="…"/>

5. Make sure to replace ... with your actual SAP license key.

   Tip

   In the code below, you can find the entry in line 3.

   <appSettings>
   
   <add key="LicenseFilePath" value="c:\dox42Server\License" />
   
   <add key="LicenseKey" value="…"/>
   
   <add key="dox42SAPLicenseKey" value="…"/>
   
   <add key="MailServer" value="smtp.1und1.de"/>
   
   <add key="dox42ServerMail" value="mydox42server@dox42.com"/>
   
   <add key="MailServerPassWord" value="…"/>
   
   <add key="SendErrorsToMail" value="mymonitoring@dox42.com"/>
   
   <add key="Certificate" value="c:\ dox42Server\Certs\Certificate.pfx"/>
   
   <add key="CertificatePassWord" value="…"/>
   
   <add key="CheckServiceHeader" value="true"/>
   
   <add key="UserPermissionODBCConnectionString"
   
   value="Driver={SQL Server Native Client 10.0};Server=…;Database=…;Uid=…;Pwd=…;"/>
   
   <add key="CheckUserPermissionSQL"
   
   value="SELECT COUNT(*) FROM Users where Username =
   
   '%username%' and Password = '%password%'" />
   
   <add key="ThrowExceptionOnError" value="false"/>
   
   </appSettings>

6. Save the web.config file.

Note

For more information on the dox42 Server, see dox42 Server documentation.

Result

You have registered the dox42 Server Module for SAP® Solutions and can now use it with dox42 Server.