= sapnwrfc - SAP Netweaver RFC support for Ruby - the next generation

== Summary

Welcome to the sapnwrfc Ruby package. This package is intended to facilitate RFC calls to an SAP R/3 system of release NW2004x and above. It may work for earlier versions but it hasn't been tested. The fundamental purpose of the production of this package, is to provide a clean object oriented interface to RFC calls from within Ruby. This will hopefully have a number of effects: (1) make it really easy to do RFC calls to SAP from Ruby in an object oriented fashion (Doh!) (2) promote Ruby as the interface/scripting/glue language of choice for interaction with SAP R/3. (3) make the combination of Linux, Apache, and Ruby the killer app for internet connectivity with SAP. (4) Establish a small fun open source project that people are more than welcome to contribute to, if they so wish.

== Installation

After you have unpacked your kit, you should have all the files listed in the MANIFEST.

In brief, the following should work on most systems: ruby setup.rb

if your rfcsdk is not findable in the system search path, then use the command line switches for mkmf/setup.rb like so: ruby setup.rb config --with-nwrfcsdk-dir=/path/to/rfcsdk ruby setup.rb setup

Now you can either install like so: ruby setup.rb install

or build the gem and install that like so: gem build sapnwrfc.linux.gemspec gem uninstall sapnwrfc gem install sapnwrfc--.gem

VERY IMPORTANT - make sure that you add the library path to LD_LIBRARY_PATH eg - mine is: export LD_LIBRARY_PATH=/home/piers/code/sap/nwrfcsdk/lib

== Documents and Tests

[doc/*] Module Documentation

[tests/*.rb] Test basic connection, and some rfc call examples

== Credits

== License

sapnwrfc is Copyright (c) 2006-2010 Piers Harding. It is free software, and may be redistributed under the terms specified in the README file of the Ruby distribution.

One last thing - The SAP RFCSDK is a prerequisite for this perl package to work. The RFCSDK is proprietrary software owned by SAP AG. For this reason I will not supply ANY component part of the RFCSDK with this perl package, and further more you must obtain it through the normal channels with SAP AG - ie. you must have a licensed SAP R/3 installation at your disposal.

= Other stuff

Author:: Piers Harding piers@ompka.net Requires:: Ruby 1.8.x or later License:: Copyright (c) 2006-2010 Piers Harding Released under Ruby's License