The SAP RFC filter provides the ability to execute Remote Function Calls (RFCs) on a SAP server from within Rhapsody. It can be used to do either insertions or lookups. Lookup operations are typically used to lookup missing data from the SAP server, so that message fields can be filled in the message. Insertion operations are typically used to update data in the SAP server, for example by inserting the contents of an IDoc message into the SAP server (however the SAP communication point is more suitable for these operations).

Configuration Properties

Property

Description
Maximum Concurrency The maximum level of concurrency for this filter. A setting of 0 (zero) means unlimited. Limiting the level of concurrency limits memory usage. Refer to Maximum Concurrency for details.

Connection Settings

Specifies how the SAP server connection details will be obtained:

  • From Config File (default).
  • Manual Setting.
SAP Router

The SAP Router string. Typically the format of this string is: /H/<server>/S/<port> where server is the IP address or name of your server that is entitled to access SAP's network, and port is the SAP Router port. If you use the default port (3299), then you can omit the section /S/<port>. Refer to your SAP documentation for more information on SAP Router strings.

This option is only available when Connection Settings is set to Manual Setting. 
SAP Host Name

The hostname or IP address of the SAP server.

This option is only available when Connection Settings is set to Manual Setting. 
System Number

The SAP system number.

This option is only available when Connection Settings is set to Manual Setting. 
SAP Client

The ID of the SAP client on the SAP server.

This option is only available when Connection Settings is set to Manual Setting. 
User Name

The username to use when connecting to the SAP server.

This option is only available when Connection Settings is set to Manual Setting. 
Password

The password to use when connecting to the SAP server.

This option is only available when Connection Settings is set to Manual Setting. 
SAP Language

The language to use to communicate with the SAP server. This must be a valid ISO 639-1 language code.

This option is only available when Connection Settings is set to Manual Setting. 
Configuration File

This is an XML file that controls how the filter interacts with the SAP server. 

To launch the SAP RFC Configuration Editor, click the Create Configuration link (if a configuration has not yet been created) or the Edit Configuration link (if a configuration exists) in the Configuration File field. Refer to SAP Configuration Editor for details. 

Alternatively, to add an existing configuration:

  1. Click the Browse button in the Configuration File field to display the Windows® Open dialog.
  2. Search for and add the configuration file to the filter.
  3. To update the configuration file, click the Edit Configuration link. The SAP RFC Configuration Editor is then displayed, which enables you to edit the configuration file.
Definition File Identifies the message definition used to parse a message. The SAP RFC filter can be configured to extract fields from the message to use in the remote function call, or to insert the results of an RFC into message fields. If this is done, a message definition is required so the message can be parsed.
Conversion Error Behavior

Specifies whether conversion errors encountered when inserting data into a SAP table should be treated as message errors or ignored:

  • Treat As Message Errors (default).
  • Ignore Conversion Errors.

A conversion error typically happens when the wrong data type is used, for example trying to insert a string into a numeric field.

It is recommended you not ignore conversion errors unless you have some specific requirement to do this. Ignoring conversion errors could potentially result in loss or corruption of data.