Skip to content

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:

  1. A SAPconnect check-in function that forwards jobs to the DPF via REST using the DPF JobClient API. This feature uses an RFC server.

  2. 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

  1. Open SAP Launchpad in a Web browser:

    https://launchpad.support.sap.com/
    
  2. Log on with your SAP user name and password.

  3. In SAP Launchpad, search for the OSS number 2573790.

  4. Follow the download link for SAP NW RFC SDK {{ SAPNWRFCSDK_VERSION }} and save the current version.

  5. Extract the downloaded ZIP archive to the following directory:

    • on Linux: /usr/local/nwrfcsdk
    • on Windows: C:\Program Files\SAP\nwrfcsdk
  6. On Windows, add the following path to the global environment variable PATH in Windows:

    ;C:\Program Files\SAP\nwrfcsdk\lib
    
  7. On Linux, create /etc/ld.so.conf.d/saprfc.conf with the following content:

    /usr/local/nwrfcsdk/lib
    

    and 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.

  1. Create the following SAP configuration file unless it already exists:

    • Linux: /opt/seal/etc/sapnwrfc.ini
    • Windows: C:\ProgramData\SEAL Systems\config\sapnwrfc.ini
  2. Specify the connection settings in the sapnwrfc.ini file, set SAPROUTER to /H/<name_saprouter>.

    PASSWD can be clear text or encrypted. If the password is encrypted, either SECRET or SECRET_FILE has to be specified.

    Example - SAP configuration file sapnwrfc.ini for a connection via application server

    DEST=W74
    ASHOST=10.100.100.100
    TRACE=0
    USER=sapuser
    PASSWD=encryptedsappassword
    CLIENT=310
    SYSNR=01
    SAPROUTER=/H/roeadm003.sealsystems.local
    LANG=EN
    

    Example - SAP configuration file sapnwrfc.ini for a connection via message server

    DEST=WMS
    R3NAME=W74
    GROUP=PUBLIC
    MSHOST=10.100.100.100
    CLIENT=000
    USER=rfctest
    PASSWD=364de47d4d093ce8e7c65e244c08e7cb7fe2657e6cdd796a
    TRACE=0
    SAPROUTER=/H/roeadm003.sealsystems.local
    LANG=EN
    

    MSSERV has to be set additionally, if the server does not listen on the standard service sapms<SYSNR>, or if this service is not defined in the services file and you need to specify the network port directly.

  3. Specify the following mandatory environment keys for the seal-dpf-sap-connect service:

    • 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
  4. 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.


Back to top