When you uninstall HCL Domino Connector for SAP Solutions, the SAP connector binary files, sample files, and uninstaller are removed.

The HCL Domino Connector for SAP Solutions is a premium Domino Connector designed to provides access to the SAP ERP system. The Connectors works in conjunction with the HCL Enterprise Integrator for Domino (HEI), Domino Enterprise Connection Services (DECS), and Connector LotusScript Extension classes (LC LSX). It can optionally be used with Domino Access to SAP Business Workflow adjunct products.

The HCL Domino® Connector for SAP Solutions supports HEI Direct Transfer, one-way Replication (SAP as Source only), Archive (SAP as Target only), Scripted, Java, and Virtual Fields activities. The DECS Virtual Fields activity is also supported.

This section describes LotusScript functionality available for the HCL Domino Connector for SAP® Solutions.

HEI requires that connection documents be created to define both the ECC Server access information and the structure of the RFC/BAPI data that the activity will interact with when transferring or querying data.

The HCL Domino Connector for SAP® Solutions connection document options that are applicable to either the RFC or BAPI module type are shown below.

DECS provides the equivalent to the Virtual Fields activity of HEI, incorporated into Domino. The DECS activity document is slightly different than the HEI activity document. The following sections describe the DECS forms and key initialization.

DECS requires that connection documents be created to define both the ECC Server access information and the structure of the RFC/BAPI data that the activity will interact with when transferring or querying data.

The unicode connector version of HCL Domino® Connector for SAP® Solutions uses the unicode SAP .DLL (for example, librfc32u.dll on Windows) to communicate with the SAP ECC server. This connector uses the default operating system's UTF-16 code page for communication with the ECC server. For example, on Windows 32 bit and Windows 64 bit platforms, the unicode connector uses code page UTF-16LE (4103) for communication with the ECC server.

Earlier versions of HCL Domino® Connector for SAP® Solutions used an "RFC_CALL_TRANSACTION" call for working with SAP transactions. With the SAP ECC 6 server, this RFC does not exist; it has been replaced by the RFC "ABAP4_CALL_TRANSACTION" call. In addition to the name change, the interface of this RFC is also different than that of "RFC_CALL_TRANSACTION" call. Starting with version 2.0, Domino Connector for SAP Solutions supports RFC for working with SAP transactions on the SAP ECC server.

When you are ready to develop an application that integrates ECC with HCL Domino®, it is recomended you involve people that have an excellent working knowledge of ECC and Lotus Domino administration.

If you want to read data from ECC you need to find an RFC/BAPI module or a BAPI that returns the data you need. The data you need can be supplied by metadata, field mapping, and finding the values of fixed length fields and columns.

ECC RFC function interfaces vary. The HCL Domino Connector for SAP® Solutions allows you to call any RFC or BAPI that is Remote Function Call enabled in your ECC system.

The preferred method of reading or writing data to ECC is to use a BAPI. If no BAPI is available to do what you need to have done, the second best way is to use an RFC function that writes data back to ECC. If you do not find an appropriate RFC, you may want to create your own RFC that does the job. If you have none of the options mentioned here, refer to the next section, "Transaction-based activity."

The other way of writing data to an SAP connection is by calling an ECC transaction. This method is also referred to as Batch Input. In order to create a transaction-based activity you should be familiar with the concepts of Batch Input. The following section gives you a brief introduction to Batch Input.

Support for mapping multiple fields of the same name is a relatively new capability. Prior to this capability, duplicate fields had been listed side-by-side in field mapping. Duplicate field name support requires the following steps to implement. Conceptual and procedural information is contained below.

It is possible that one screen field will be in more than one screen for a given transaction. For example, screen 0300 may be called twice or the field FOO exists in both screen 0300 and 0302. In this case, order plays a key role in allowing you to set values to the each of the fields correctly.

This section illustrates a transaction-based connection and the Direct Transfer activity that uses it.

The RFC_READ_TABLE is a very widely used RFC in ECC. Special functionality has been added to make working with this call as easy as possible. Normally, the data returned by RFC_READ_TABLE comes in the table DATA, which has one column of text 512 bytes wide. It is normally your job to parse this field and reconvert the text values to the proper data types that exist in the SAP table's "was is" being read.

BAPIs (Business Application Programmers Interfaces) are the methods that get or modify the data of the ECC business objects. A sample object might be a purchase requisition and a sample method might be to create a new one.

The Connector contains several support routines to perform data type conversions between the LC API and SAP. The following tables show the correspondences of SAP and LC API data types.

The HCL Domino Connector for SAP® Solutions uses a series of properties, most of which are specific to itself. When defining an SAP connection to HEI or DECS, values for these properties are specified in a connection document. When using the Domino Connector for SAP Solutions with Connector LotusScript Extensions (LC LSX) classes, values for these properties are specified by setting properties of the LCConnection class. The LC LSX is supplied with Domino.

You can use the LC LSX to create a new SAP password or change your existing password.

To better support working in a single sign-on environment, the connector supports SAP® cookies. The Connector property name is "Cookie".

You can debug the SAPGUI from a LC LSX script if you set your SAP® connection properties correctly.

A sample database (sapexamp.nsf) is included with your HCL Domino Connector for SAP® Solutions.

The LC LSX can be used to develop LotusScript programs that can be invoked through the Domino® server agent manager or as an HEI Scripted Activity.

The HCL Domino Connector for SAP® Solutions provides the standard set of Domino connector methods or function calls to control the interaction with the target connection.