Welcome
HCL Domino Connector for SAP Solutions User Guide
The following topics describe how to use the HCL Domino® Connector for SAP Solutions.
Terminology

HCL Domino Connector for SAP Solutions 2.0.3 documentation
Welcome to the HCL Domino Connector for SAP Solutions 2.0.3 documentation.
Notices
HCL Domino Connector for SAP Solutions Installation
HCL Domino Connector for SAP Solutions 2.0.3 is a premium Domino connector designed to be used with Lotus HCL Enterprise Integrator for Domino (HEI), HCL Domino® Enterprise Connection Services (DECS), or Domino Connector LotusScript Extensions (LC LSX).
HCL Domino Connector for SAP Solutions User Guide
The following topics describe how to use the HCL Domino® Connector for SAP Solutions.
- What's new in Connector for SAP Solutions?
- Introduction to using the Domino Connector for SAP Solutions
  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.
- Supported HEI and DECS activities
  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.
- Terminology
- Supported characteristics with list of terms
  This section describes LotusScript functionality available for the HCL Domino Connector for SAP® Solutions.
- Considerations specific to using the connector with HEI
- Creating an SAP connection document
  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.
- Fields in the SAP Connection document
  The HCL Domino Connector for SAP® Solutions connection document options that are applicable to either the RFC or BAPI module type are shown below.
- Considerations specific to using the connector with DECS
  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.
- SAP connection document for DECS
  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.
- How to use the unicode connector with HEI, DECS and LC LSX
  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.
- Considerations for SAP transactions on SAP ECC 6 server using LC LSX
  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.
- Developing an ECC and Domino integrated application
  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.
- Considerations when creating and using SAP connections
- Using the SAP connection as the source
  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.
- Using the SAP connection as the target
- RFC and BAPI function interfaces
  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.
- Using a BAPI or an RFC function that accepts table input
  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."
- Creating a 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.
- Mapping multiple fields of the same name
  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.
- Analyzing transactions
- When screen fields reside in more than one screen
  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.
- Sample transaction-based connection and Direct Transfer activity
  This section illustrates a transaction-based connection and the Direct Transfer activity that uses it.
- Special support for RFC_READ_TABLE using Direct Transfer activity
  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.
- Working with BAPIs
  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.
- SAP data types
  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.
- Connector properties
  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.
- Using the LC LSX to change your password
  You can use the LC LSX to create a new SAP password or change your existing password.
- Using the LC LSX to support SAP cookies
  To better support working in a single sign-on environment, the connector supports SAP® cookies. The Connector property name is "Cookie".
- Using the LC LSX for debugging
  You can debug the SAPGUI from a LC LSX script if you set your SAP® connection properties correctly.
- HCL Domino Connector for SAP Solutions LC LSX sample database
  A sample database (sapexamp.nsf) is included with your HCL Domino Connector for SAP® Solutions.
- Accessing SAP from LotusScript using the LC LSX
  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.
- Domino Connector for SAP Solutions methods
  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.
- Notices

Terminology

The table below lists Enterprise Integration terms and the corresponding terms in SAP applications:


LEI/DECS	SAP
Server	Host
Database	RFC Module/BAPI/Transaction
Metadata	Table/Transaction Code
Index	Index
Field	Field
Record	Row
Procedure	SAP Transaction Code