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.

Only the LCConnection class properties that are relevant to script programming are exposed. In the HEI and DECS products, these properties are specified using the respective connection document.


Property Token	Property Name/Description	Type	Example
LCTOKEN_SERVER	Hostname/Servername Specifies the SAP server or host name. Required. This can also be a messaging/load balancing system when used in conjunction with the DESTINATION property.	Text	123.123.123 sapaix.lotus.com
LCTOKEN_ DATABASE	Function Module Specifies the RFC or BAPI to be called in SAP. In the case of a transaction, set this value to RFC_SYSTEM_INFO.	Text	BAPI_CUSTOMER_GETDETAIL2 BAPI_REQUISITION_CREATE
LCTOKEN_ USERID	User ID Specifies the User ID/ Name used for logging in during connection. Required.	Text	MUSTER
LCTOKEN_ PASSWORD	Password Specifies the password used for logging in during connection. Required.	Text	IDES
LCTOKEN_ METADATA	Metadata object Specifies the name of the table used by the RFC or BAPI call. If a transaction is being used, this specifies the the transaction code.	Text	* --for all tables in RFC or BAPI CUSTOMERBANKDETAIL -- to work with one table of that name Note: RFCs and BAPIs may contain multiple tables that you can work with at one time. This is done through field mapping and fetch operations. The "*' gives access to more than one table of a given RFC or BAPI. You can optionally name one table that you want to work with, for example CUSTOMERBANKDETAIL, to be restricted to only working with your one named table.
LCTOKEN_ MAP_NAME	MapByName Specifies whether to map fields between SAP and the LC API by name instead of by position.	Boolean	True
LCTOKEN_ WRITEBACK	Writeback Specifies whether to perform writeback or non-writeback operations. Always set this property value to true because writeback is always simulated with keyed updates.	Boolean Read-only	True
LCTOKEN_ FIELDNAMES	FieldList Displays a multi-value text list of fields from which to select in order to perform an operation -- used for select operations.	Textlist	CUSTOMERBANKDETAILCUSTOMER EXPORTSRETURN
LCTOKEN_ CONDITION	Condition Specifies a SAP-specific syntax conditional clause used in a select, keyed update, or remove operation. This must be valid syntax for (as an example) a "select <condition>" formula.	Text	PARAM1="*",PARAM2="what", STRUCTURE.FIELD=345, TABLE.1.FIELD="Jon",
LCTOKEN_ TEXT_FORMAT	TextFormat Specifies that the text stream format for this connector is always NATIVE. You can set to any of the other FMT types for non-NATIVE.	Integer Read-only	LCSTREAMFMT_NATIVE
LCTOKEN_ PROCEDURE	Procedure Specifies the transaction code value. This is used for transaction-type (not BAPI or RFC) processes only. Specifies the stored procedure to execute for the Call method. Any returned result set is available to use.	Text	XD02 ME21
1	SystemNo Specifies the system number used during SAP login. The value is the TCP/IP Port minus 3300.	Integer	00 - 99 corresponding to ports (3300 - 3399)
2	Client Specifies the three-digit Client number used during SAP login.	Text	800.00
3	Language Specifies the Language type used during SAP login.	Text	For English, use the following: E = English for SAP version 3.n or earlier EN = English for SAP version 4.n or earlier
4.00	ModuleType Specifies whether the module is an RFC, BAPI, or Transaction.	Integer	0 = BAPI or RFC 1 = Transaction
5	ScreenFields Used to define the screens of a transaction. This is used only when an SAP transaction is the Target connection for an activity. The field definitions for each Screen are defined (by the program name) using a leading $ and the Dynpro (one screen in a given transaction) number as a value. This is followed by the input field names. If a field is assigned a value, the field is assumed to be a constant, not a variable.	TextList	$SAPMF20D = 0101 RF02D-KUNNR RF02D-D0110=X BCD_OKCODE=/00 and so on
6	Message States the message to be returned from an SAP transaction. This was used as an early implementation of output parameter support, which is now available.	Text Read-only	"Changes have been made"
7	Destination Selects the SAP instance and optionally specifies load balancing.	Text	MLP OSS
8	EnableSAPGUI Specifies that the SAPGUI will be available for use. This value must be set to True when calling an RFC or BAPI that invokes the SAPGUI. For a transaction module, this only has value when debugging an LC LSX script.	Boolean	True
9	SAPVersion Species the SAP version to use of the system you are connecting to. This setting is valuable because RFCs and transactions have changed from version to version. This is read-only.	Text Read-only	46C 46D
10.00	NewPassword Specifies a new password value for the user logging in to SAP through LSXLC. This is not available for LEI or DECS. This is used to change the password on SAP.		OpenSesame
11.00	Cookie Specifies a cookie value associated to a specific user ID. If this has a value assigned, it is used instead of USERID and PASSWORD during user login. If this has no value, a request is made to get a SAP cookie, provided SAP is configured to deliver one. This request will be made after a successful login using the USERID and PASSWORD.	Text
12.00	ChangePassword When this has a value that meets SAP password requirements, the user password is changed to this value. In order to use this property, you must first log in using your USERID and current PASSWORD.	Text
13.00	RfcUser Determines whether or not the PASSWORD expiration check is performed or not. If set to 1, the PASSWORD expiration check is disabled.	Text	0 -- default, not an Rfc-ONLY user; enables PASSWORD expiration check 1 -- Rfc-ONLY User; disables PASSWORD expiration check
14.00	SAPReadCodePage Allows you to set the code page that your connection will get/send SAP text in.	Integer	LCSTREAMFMT_NATIVE LCSTREAMFMT_IBMCP819
15.00	SAP_NUMC_TEXT 0 means don't force NUMC data type in SAP to become text. 1 means to force NUMC data type to transfer as text.	Integer
16.00	SAP_DATS_TEXT 0 means don't force DATS data type in SAP to become text. 1 means to force DATS data type to transfer as text.	Integer
17.00	SAP_TIMS_TEXT 0 means don't force TIMS data type in SAP to become text. 1 means to force TIMS data type to transfer as text.	Integer
100.00	DebugLevel Specifies that trace debug levels are passed to the RFC.	Integer	1 -- creates an RFC trace file named rfcxxx_xxx.trc (where x's are numbers) in the directory where the Connector is installed. 69 -- invokes the SAPGUI ABAP debugger.