Connect to SAP via SAPconnect Interface (BC-CON)¶
Overview¶
As of DPF 4.3.0, fax and email data can be received from SAP via the SAPconnect interface (BC-CON) and processed in Digital Process Factory. The transmission status can be sent back to SAP.
The dpf-sap-connect service provides two functionalities:
-
A SAPconnect check-in function that forwards jobs to the DPF via REST using the DPF JobClient API. This feature uses an RFC server.
-
A SAPconnect status function that asynchronously transmits status messages to the sender system via RFC functions of the BC-CON (SAPconnect) interface. This function includes an RFC client.
To use the SAPconnect Interface with DPF follow the instructions below.
Install SAP NetWeaver RFC¶
-
Open SAP Launchpad in a Web browser:
https://launchpad.support.sap.com/ -
Log on with your SAP user name and password.
-
In SAP Launchpad, search for the OSS number
2573790. -
Follow the download link for
SAP NW RFC SDK {{ SAPNWRFCSDK_VERSION }}and save the current version. -
Extract the downloaded ZIP archive to the following directory:
- on Linux:
/usr/local/nwrfcsdk - on Windows:
C:\Program Files\SAP\nwrfcsdk
- on Linux:
-
On Windows, add the following path to the global environment variable
PATHin Windows:;C:\Program Files\SAP\nwrfcsdk\lib -
On Linux, create
/etc/ld.so.conf.d/saprfc.confwith the following content:/usr/local/nwrfcsdk/liband execute the following command:
sudo ldconfig
Configure SAP NetWeaver RFC¶
For the connection to SAP you can either connect to the SAP message server or a specific SAP application server. An application server executes the actual business logic. The message server is the distributor and load balancer for logons via RFC or SAP GUI.
If your SAP system has a message server, the configuration via message server is recommended.
Literature - sapnwrfc.ini
The sapnwrfc.ini file and its parameters is described in SAP Basis Configuration - Server, Configuration Files - Reference.
-
Create the following SAP configuration file unless it already exists:
- Linux:
/opt/seal/etc/sapnwrfc.ini - Windows:
C:\ProgramData\SEAL Systems\config\sapnwrfc.ini
- Linux:
-
Specify the connection settings in the
sapnwrfc.inifile, setSAPROUTERto/H/<name_saprouter>.PASSWDcan be clear text or encrypted. If the password is encrypted, eitherSECRETorSECRET_FILEhas to be specified.Example - SAP configuration file
sapnwrfc.inifor a connection via application serverDEST=W74 ASHOST=10.100.100.100 TRACE=0 USER=sapuser PASSWD=encryptedsappassword CLIENT=310 SYSNR=01 SAPROUTER=/H/roeadm003.sealsystems.local LANG=ENExample - SAP configuration file
sapnwrfc.inifor a connection via message serverDEST=WMS R3NAME=W74 GROUP=PUBLIC MSHOST=10.100.100.100 CLIENT=000 USER=rfctest PASSWD=364de47d4d093ce8e7c65e244c08e7cb7fe2657e6cdd796a TRACE=0 SAPROUTER=/H/roeadm003.sealsystems.local LANG=ENMSSERVhas to be set additionally, if the server does not listen on the standard servicesapms<SYSNR>, or if this service is not defined in the services file and you need to specify the network port directly. -
Specify the following mandatory environment keys for the
seal-dpf-sap-connectservice:- SAP_SYSTEMS: specifies which destinations are used
- SAPNWRFCINI_PATH: Path to
sapnwrfc.inifile. The file contains the connection details to the specified destinations as specified above
-
Start the following service:
seal-dpf-sap-connect
Configure SAPconnect in SAP¶
Literature - SAP help
On how to configure SAPconnect in SAP, refer to the SAP help pages.