Implementing the Microsoft BizTalk 2010 Adapter for mySAP Business Suite

August 30, 2012 at 10:58 am 2 comments

Microsoft BizTalk Server 2010 has a lot of great capabilities and one of the most interesting is the BizTalk Adapter Pack because it provides service enablement for Line of Business (LOB) applications on top of the .NET Windows Communication Foundation (WCF) technology. Out of the box it supports popular packaged applications and databases like:

  • SAP
  • Siebel eBusiness Applications
  • Oracle eBusiness Suite
  • Oracle Database
  • SQL Server Database

Because of its easy of use one of the most popular scenarios in which you implement the BizTalk Adapter Pack is to integrate Microsoft BizTalk Server and mySAP Business Suite.

In this post I’ll show you how to implement the Microsoft BizTalk 2010 Adapter for mySAP Business Suite Client Version 7.1 in a development environment. There are several configurations supported for production and development but for this post we’ll use the one suggested for 32-bit BizTalk processes:

 image

The VM configured for this implementation consists of the following characteristics:

Hardware
Intel Core i7 @ 2.2GHz
4GB RAM
100GB HDD

Software
Windows 2008 R2 Enterprise x64 SP1
SQL Server 2008 R2 Developer x64 SP1
BizTalk Server 2010 Developer x64
Visual Studio 2010 Ultimate SP1

In order to begin the installation process you first need to install several DLLs required by the BizTalk Adapter Pack to interface with the SAP system. Most of the packages that contain these DLLs must be downloaded from the SAP Service Marketplace by the SAP administrator in your organization. This is required because access to the SAP Software Distribution Center is restricted by a ‘Download Software’ authorization object. This ensures that software is downloaded only by authorized users.

Because we are planning to use only 32-bit only hosts there is no need to install the x64 versions of the RFCSDK, R3DLLINS and Visual C++ run-time DLLs.

1) Download and extract the RFCSDK 7.0 (Unicode) (32-bit) client files
Confirm that SAP GUI for Windows is not installed. Uninstall SAP GUI if installed.

Get RFCSDK at SAP software download center (http://service.sap.com/swdc)

Download RFC_9-20000972.SAR (RFC) and extract using SAPCAR.exe. From command prompt  execute SAPCAR –xvf <file path>

image

image

image

image

2) Copy required files (icudt30.dll, icuin30.dll, icuuc30.dll, librfc32u.dll, libsapu16vc71.dll, libsapucum.dll) to c:\windows\sysWOW64

File version of icudt30.dll, icuin30.dll, icuuc30.dll : 3.0.0.0
File version of librfc32u.dll : 7000.0.100.5358
File version of libsapu16vc71.dll, libsapucum.dll : 7000.100.13.42057

image

image

3) Download and setup R3DLLINS.exe (SAP Note 684106) for SAP release 6.40 and 7.00
Get attached file of SAP note 684106 (http://service.sap.com/notes)
Related files : msvcr71.dll, msvcp71.dll, mfc71.dll, mfc71u.dll
File version of msvcr71.dll : 7.10.3052.4
File version of other files : 7.10.3077.0

image

image

4) Download and setup Microsoft Visual C++ run-time DLLs required for SAP 7.1 client (SAP Note 684106) from the following link http://go.microsoft.com/fwlink/?LinkId=107086

image

Once the SAP prerequisites are installed we can proceed to setup the remaining BizTalk components.

5) Install the Windows Communication Foundation Line of Business SDK 2010 x64.

Execute the AdapterFramework.msi installer located in the BizTalk Server  2010 installation media.

image

image

image

image

In a production environment you should only install the WCF LOB SDK Runtime, in this case we are setting up a development server so we will install all the features.

image

image

6) Install the BizTalk 2010 Adapter Pack x86. If you are planning to use the SAP Adapter in x64 Hosts you should also install de x64 version of the Adapter Pack.

Execute the AdapterSetup.msi installer located in the BizTalk Server 2010 installation media.

image

image

image

For this installation select only the following features:

  • Microsoft BizTalk Adapter for mySAP Business Suite
  • .Net Framework Data Provider for mySAP Business Suite

image

image

image

image

At this point you have installed successfully the Microsoft BizTalk 2010 Adapter for mySAP Business Suite. Now you can configure and test it.

SAP Adapter Configuration

Ton configure the SAP Adapter you need to perform the following steps:

1) Open the BizTalk Administration Console. Expand the Adapters folder and right click New – Adapter

image

2) Enter a meaningful name for the adapter and select WCF-SAP from the adapters drop down list.

image

3) Click OK in the warning window.

image

Now the WCF SAP Adapter has been added in BizTalk make sure it is configured to use the proper Adapter Handler (x86 or x64) according with the Adapter Pack version previously installed.

image

Consuming the Adapter in Visual Studio

Once the SAP Adapter is installed and configured you can consume it from Visual Studio to extract the metadata and message formats needed to communicate with SAP.

For example, lets suppose we want to construct and send a MATMAS IDOC to SAP, to do so we only need to do the following easy steps:

1) Open a BizTalk project in Visual Studio, right click over it and select Add – Add Generated Items

image

2) Select Consume Adapter Service – Consume Adapter Service and click on Add

image

3) In the Consume Adapter Window select sapBinding and click on Configure

image

4) In Security select you SAP credentials type and enter them

image

5) Go to URI Properties and enter the connection parameters

image

image

6) In Binding Properties set Enable BizTalk Compatibility Mode to True and click on OK

image

7) Click Connect

image

8) Select the proper Contact Type, Category (BAPI, IDOC, RFC), and Operation (MATMAS03). Click Add, enter a file name prefix and click OK.

image

Once the service has been imported you will see an XSD of the operation previously selected and the correspondent binding file needed to configure the BizTalk port.

image

From here you would implement your BizTalk application as usual, using the supplied XSD to build the messages needed to communicate with SAP.

Send Port Configuration

Once your BizTalk application has been deployed you can use the WFC-Custom binding file generated in Visual Studio

image

or manually create an specific transport configuration

image

just don’t forget to specify the SOAP Action Header as in the XML binding file otherwise you’ll get an error like this:

image

Conclusion

Implementing the Microsoft BizTalk 2010 Adapter for mySAP Business Suite is an easy task once you have all the files from de SAP Service market place. Having it in place allows you to considerably reduce the amount of time needed to develop intercommunication processes with SAP.

You can learn more about the Microsoft BizTalk 2010 Adapter Pack in the following guides:

Microsoft Windows Communication Foundation (WCF) Line of Business (LOB) Adapter SDK 2010 Documentation

Microsoft BizTalk Adapter Pack 2010 Documentation

Entry filed under: BizTalk. Tags: , , .

Implementing Office Web Apps Server Preview 2013 How to create a BizTalk 2010 R2 CTP Virtual Machine in Windows Azure

2 Comments Add your own

  • 1. Leonid Ganeline  |  September 5, 2012 at 11:25 pm

    The WCF LOB Adapter SDK has pieces to implement the custom WCF adapters. I thought this article about implementing such custom adapter. In reality it is about *using* the WCF SAP adapter. 🙂

    Reply
  • 2. Chris Towles  |  May 7, 2013 at 9:49 am

    Thank you So much for this post, I was working on putting the SAP DLL’s in the correct locations and this entry post was perfect. Thanks for writing it and keep up the great work.

    Reply

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s

Trackback this post  |  Subscribe to the comments via RSS Feed


August 2012
M T W T F S S
« Jul   Sep »
 12345
6789101112
13141516171819
20212223242526
2728293031  

Categories


%d bloggers like this: