CRMConnectorOutboundSAP

The configuration of CRMConnectorOutboundSAP is stored in the configuration-file (.ini). The installation program creates this file with the settings provided during setup. The configuration of CRMConnectorOutboundSAP can be adjusted by editing this configuration-file. The service must be restarted for the changes to take effect. If a setting is not found, the program’s default value is used.

Only the configuration keys in the [Dynamic]- section are read dynamically, and the service must not be restarted for the changes to take effect.

Unless explicitly specified by a command line argument, the path to the .ini file is the name of the executable file with the .exe extension replaced by “ini” and the instance name used as suffix.

C:\ProgramData\BucherSuter\MCAforSAP\CRMConnectorOutboundSAP\CRMConnectorOutboundSAP_SAP1.ini

To view and manually configure DataStore it is necessary to edit the configuration-file. It is suggested to back up the original file before editing it. The configuration-file can be edited with any text editor like Notepad.

[Logger]

MaxLogFileSize

Default : 50MB

Range : not available

Description : Maximum of bytes in one log file. If the limit is reached, it will begin a new log file. Binary units KB, MB can be used. For example: 50MB.

Required : No

LogFile

Default : log\\logfile.log

Range : not available

Description : Location of the log file

Required : Yes

MaxLogFileCount

Default : 10

Range : 1-10

Description : Maximum log files. If the limit is reached it will delete the oldest log file

Required : No

LogMask

Default : 0x80000003

Range : not available

Description : Log mask in hex notation

Required : Yes

CollectedLogMask

Default : 0x80000003

Range : not available

Description : Collected log mask in hex notation. Please refer to ConnectsforSAP TroubleshootingGuide

Required : No

LogOnConsole

Default : false

Range : true, false

Description : If this setting is “true”, it will automatically display log message on the screen

Required : No

ConsoleLogLevel

Default : debug

Range : debug, 0: off, 1:on info, warn, error, fatal

Description : The minimum log level for message on the screen

Required : No

EnableLocationInfo

Default : true

Range : true, false

Description : Enables the location information (like class name, function name) in log messages. If enabled, performance is only minimally impacted

Required : No

[CRMConnectorOutboundSAP]

TelnetServerPort

Default : 9015

Range : 0-65535

Description : Telnet server port

Required : Yes

AutoStartTelnetServer

Default : true

Range : true, false

Description : Defines if the telnet server starts automatically on the application startup

Required : yes

TelnetAllowedHosts

Default : (\^127\\.)

Range : not available

Description : Regular expression which defines the allowed hosts. For more information check out Regular Expression Filter

Required : No

[RfcServerDestination]

User

Default : empty

Range : not available

Description : User Account

Required : Yes

Password

Default : empty

Range : not available

Description : Password for the User Account. The CRMConnectorOutboundSAP will automatically encrypt the password, after the first usage. You can enter the password in plain text

Required : Yes

Client

Default : 555

Range : 0-999

Description : The backend’s client (or “Mandant”) into which to log in

Required : Yes

Language

Default : EN

Range : not available

Description : Log on language to be used

Required : No

AppServerHost

Default : empty

Range : not available

Description : The hostname of the specific SAP application server, to which all connections are opened

Required : Yes

SystemNumber

Default : 0

Range : 0-99

Description : The SAP system’s system number

Required : Yes

Parameter

Default : empty

Range : not available

Description : Any parameter from RFC client section of [2]. Format: Parameter={Key=Value}

Required : No

[RfcServer]

GatewayHost

Default : empty

Range : not available

Description : The hostname of the gateway at which to register. Needs to be the same as defined in SAP transaction SM59 (if the RFC destination defines an explicit gateway)

Required : Yes

GatewayService

Default : 3300

Range : sapgw00 –sapgw99, 3300 – 3399

Description : The service name (as defined in etc/services) or the port number under which the gateway is listening

Required : Yes

ProgramID

Default : BUCHERSUTER_RFC

Range : not available

Description : The RFC destination’s program ID as defined in SAP transaction SM59. The program ID must be unique

Required : Yes

RegistrationCount

Default : 1

Range : 1 – 10

Description : Defines the number of (initial) registrations on the SAP gateway and thus determines how many (stateless) RFC requests our server is able to process simultaneously

Required : No

MaxShutdownWaitTime

Default : 10000

Range : 1000 – 300000

Description : When shutting down an RFC server via RfcServer. Shutdown (false), the RFC server will wait for currently being processed RFC requests to finish. However, it will wait at most for MaxShutdownWaitTime milliseconds and will then abort any RFC requests that did not finish by then

Required : No

[SapRfcServer]

Version

Default : 5.10BUS

Range : not available

Description : Connector provided application version. See SAPphone Telephony in SAP Systems Integrating SAP Systems with Your CTI System – Interface Description SAPphone Interface Version 4.00A / 5.00A / 5.01ASP / 5.02ASP / 5.03ASP / 5.04ASP / 5.05ASP / 5.10ASP / 5.11ASP [11]

Required : No

[DefaultCsvFile]

PrefixSeparator

Default : \_

Range : not available

Description : The CRMConnectorOutboundSAP can work with more than one dialer importer. For a proper addressing of these importers a distinction has to be made by providing a one to one mapping between SAP call list (campaign) name prefix and importer file name. This separator symbol serves the purpose to qualify this prefix

Required : No

Extension

Default : .csv

Range : not available

Description : File extension used. (Can be superseded by setting of an “Individual Prefix Name” section value)

Required : No

CSVSeparator

Default : ,

Range : not available

Description : CSV file column (record) separator. (Can be superseded by setting of an “Individual Prefix Name” section value)

Required : No

FilePath

Default : C:\BucherSuter\

Range : not available

Description : Used filepath. The file name is the section name: DefaultCsvFile. Full file path : FilePath + (<section name> or <ampaigned>) (Can be superseded by setting of an “Individual Prefix Name” section value)

Required : No

UNCUsage

Default : false

Range : true, false

Description : Use UNC SMB network settings for CSV file write operations

Required : No

UNCDomain

Default : empty

Range : not available

Description : SMB domain

Required : No

UNCUserName

Default : empty

Range : not available

Description : SMB user name

Required : No

UNCPassword

Default : empty

Range : not available

Description : SMB password. The CRMConnectorOutboundSAP will automatically encrypt the password, after the usage. You can enter the password in plain text

Required : No

UNCRootPath

Default : empty

Range : not available

Description : Root for UNC file path access. Full file path : UNCRootPath + FilePath + (<section name> or <ampaigned>+ extension

Required : No

IP Address Regular Expression Filter

The following table contains examples of possible regular expression to filter the allowed telnet clients.

RegEx	Access	Description
(\^127\\.)	Local Machine	Access is only possible from the local machine
(?:25[0-5]\|2[0-4][0-9]\|[01]?[0-9][0-9]?)	All Machines	Access is possible from all machines. The regular expression is only suitable for IPv4 addresses
((\^127\\.)\|(\^192\\.))	Local Machine and machines in the 192 subnet.	Access is possible from the local machine and from the 192 subnet