sapnwrfc-d ~master

D bindings for SAP NetWeaver RFC SDK

Summary

This library provides bindings D programming language for the SAP NetWeaver RFC SDK. It allows you to call SAP RFC's using D.

Prerequisite

You need to download and install the SAP NetWeaver RFC SDK for your OS from https://support.sap.com/en/temp/connectors/nwrfcsdk.html. This page contains the links to all relevant SAP notes and documentation. The SAP NetWeaver RFC SDK is copyrighted software and is only available through the official channels mentioned above. It is strongly recommended to download the provided Doxygen documentation, too.

Installation

If you use dub then you only need to add sapnwrfc-d to the dependencies of your project in the dub.json or dub.sdl file:

dub.json:

{
    /* Other stuf */
    "dependencies": {
        /* Other dependencies */
        "sapnwrfc-d"
    }
}

dub.sdl:

dependency "sapnwrfc-d"

Otherwise you have to compile all D files in the source folder into a library named libsapnwrfc-d.a (Linux) or sapnwrfc-d.lib (Windows). You also need to link against the libraries provided by the SAP NetWeaver RFC SDK. (Currently, only libsapnwrfc.a/sapnwrfc.lib is required.) On Windows I recommend that you add the lib folder of the SAP NetWeaver RFC SDK to the LIB and PATH environment variable.

The library supports the SAP NetWeaver RFC SDK releases 7.20 and 7.50. To use the new functions and types of the 7.50 release please define the version identifier sapnwrfc_sdk_750:

dub.json:

"versions": {
    "sapnwrfc_sdk_750"
}

dub.sdl:

versions "sapnwrfc_sdk_750"

Examples

Examples are provided in the examples folder.

• computeday shows how to call a simple RFC.
• sapping connects to a SAP system and retrieves some system information. Useful for connection tests.
• readtable calls RFCREADTABLE and exports the content of a database table.
• repotool displays the metadata for a function and can generate D source code for calling this function.
• createini parses a saplogon.ini file and writes the information for a sapnwrfc.ini file to the screen.
• (Idea: tool to execute arbitrary function by reading parameters in JSON format from stdio and outputing result as JSON to stdout)

Functionality

• Prototypes for (most) C functions of the SAP NetWeaver RFC SDK.
• Decorated functions which throw a SAPException in case of error.

The functions of the SDK are imported with import etc.c.sapnwrfc;. This is the C API as documented in the SDK. You get additonally functionality if you use import sapnwrfc;. Each function from the C API is available. All functions which have an ERROR_INFO parameter have an overloaded prototype without this argument. In case of an error these functions throw a SAPException. The use of module sapnwrfc should be preferred because of the much easier error handling.

Limitations

• The prototypes are still reworked to use out and other type modifiers.
• A high level API is missing. Ideas include:
• The C style string handling should be replaced with D strings
• Data containers should provide a range interface
• ...

License

This project is distributed under the BSD 3-clause licence.